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

Consulta as versões do modelo TSL (Thing Specification Language) de um produto especificado.

Observações de uso

Gerencie modelos TSL por versão. Após importar um modelo TSL com a operação ImportThingModelTsl, copiá-lo com a operação CopyThingModel ou editá-lo, publique-o com a operação PublishThingModel para habilitar seu uso. Cada publicação de um modelo TSL de um produto gera uma nova versão.

Limites

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

Nota

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

Depuração

A Alibaba Cloud oferece o OpenAPI Explorer para simplificar o uso da API. 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	ListThingModelVersion	Operação a ser executada. Defina o valor como ListThingModelVersion.
ProductKey	String	Sim	a1BwAGV****	ProductKey do produto. Visualize o ProductKey na página Product Details do console IoT Platform ou obtenha-o chamando a operação QueryProductList.
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 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 defina este parâmetro. Para mais informações, consulte Overview.

Além dos parâmetros específicos da operação mencionados acima, especifique os parâmetros de solicitação comuns ao chamar esta operação. Para mais informações, consulte Parâmetros de solicitação comuns.

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	Struct		Dados retornados se a chamada for bem-sucedida.
ModelVersions	Array of ModelVersion		Lista de versões do modelo TSL, exibidas em ordem decrescente de publicação. A primeira versão é a atual.
Description	String	Add a light property	Descrição da versão do modelo TSL.
GmtCreate	Long	1579235657535	Timestamp de publicação da versão do modelo TSL, em UTC. Unidade: milissegundos.
ModelVersion	String	V1.0.0	Número da versão do modelo TSL.
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=ListThingModelVersion
&ProductKey=a1rYuVF****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ListThingModelVersionResponse>
  <Data>
        <ModelVersions>
              <ModelVersion>V3.0.0</ModelVersion>
              <GmtCreate>1579235682421</GmtCreate>
              <Description>new properties</Description>
        </ModelVersions>
        <ModelVersions>
              <ModelVersion>V2.0.0</ModelVersion>
              <GmtCreate>1579235657535</GmtCreate>
              <Description>new properties</Description>
        </ModelVersions>
        <ModelVersions>
              <ModelVersion>V1.0.0</ModelVersion>
              <GmtCreate>1579235637994</GmtCreate>
              <Description>Lighting</Description>
        </ModelVersions>
  </Data>
  <RequestId>9BA34AE5-2D94-4BDE-BD78-E7D3FC7985BC</RequestId>
  <Success>true</Success>
</ListThingModelVersionResponse>

Formato JSON

{
  "Data": {
    "ModelVersions": [
      {
        "ModelVersion": "V3.0.0",
        "GmtCreate": 1579235682421,
        "Description": "new properties"
      },
      {
        "ModelVersion": "V2.0.0",
        "GmtCreate": 1579235657535,
        "Description": "new properties"
      },
      {
        "ModelVersion": "V1.0.0",
        "GmtCreate": 1579235637994,
        "Description": "Lighting"
      }
    ]
  },
  "RequestId": "9BA34AE5-2D94-4BDE-BD78-E7D3FC7985BC",
  "Success": true
}

Códigos de erro

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