ListThingTemplates - IoT Platform: Central de Documentação do Alibaba Cloud

Observações de uso

O IoT Platform oferece categorias de produtos com modelos TSL predefinidos, como lâmpadas de rua, cartões de localização veicular e detectores de imersão em água.

Ao chamar a operação CreateProduct para criar um produto, defina o parâmetro CategoryKey para especificar uma categoria. O produto criado referenciará o modelo TSL padronizado da categoria especificada.

Limites

Cada conta Alibaba Cloud pode executar no máximo 5 consultas por segundo (QPS).

Nota

Os usuários RAM de uma conta Alibaba Cloud compartilham a cota dessa conta.

Depuração

A Alibaba Cloud disponibiliza o OpenAPI Explorer para simplificar o uso de APIs. O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ListThingTemplates

Operação a ser executada. Defina o valor como ListThingTemplates.

IotInstanceId

String

Não

iot_instc_pu****_c*-v64********

ID da instância. Visualize o ID da instância na página Overview do console do IoT Platform.

Importante

Se a instância tiver um ID, configure este parâmetro. Caso contrário, a chamada falhará.
Se a instância não tiver uma página Overview ou ID, não é necessário definir este parâmetro.

Para mais informações, consulte Visão geral.

Além dos parâmetros específicos desta operação, especifique os parâmetros comuns de solicitação. Para mais detalhes, consulte Parâmetros comuns de solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.system.SystemException	Código de erro retornado se a chamada falhar. Para mais informações, consulte Códigos de erro.
Data	Array of CategoryInfo		Lista de categorias padrão retornada se a chamada for bem-sucedida.
CategoryKey	String	lighting	Identificador da categoria.
CategoryName	String	Street Lamp	Nome da categoria.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada se a chamada falhar.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada foi bem-sucedida. false: A chamada falhou.

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=ListThingTemplates
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ListThingTemplatesResponse>
  <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
  <Success>true</Success>
  <Data>
        <CategoryName>Smart Rear-view Mirror</CategoryName>
        <CategoryKey>SmartRearviewMirror</CategoryKey>
  </Data>
  <Data>
        <CategoryName>Smart In-vehicle Infotainment</CategoryName>
        <CategoryKey>SmartTox</CategoryKey>
  </Data>
</ListThingTemplatesResponse>

Formato JSON

{
  "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
  "Success":true,
  "Data": [
    {
      "CategoryName": "Smart Rearview Mirror",
      "CategoryKey": "SmartRearviewMirror"
    },
    {
      "CategoryName": "Smart In-vehicle Infotainment",
      "CategoryKey": "SmartTox"
    }
  ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.