Consulta las definiciones de funciones en el modelo de Thing Specification Language (TSL) publicado de un producto específico.
Límites de QPS
Puede invocar esta operación hasta 10 veces por segundo por cuenta.
Los usuarios de Resource Access Management (RAM) de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
Action |
String |
Sí |
QueryThingModelPublished |
La operación que desea ejecutar. Establezca el valor en QueryThingModelPublished. |
|
ProductKey |
String |
Sí |
a1BwAGV**** |
El ProductKey del producto. |
|
IotInstanceId |
String |
No |
iot-cn-0pp1n8t**** |
El ID de la instancia. Puede encontrar el ID de instancia en la página Descripción general de la consola de IoT Platform. Importante
Para obtener más información, consulte Descripción general. |
|
ResourceGroupId |
String |
No |
rg-acfm4l5tcwd*** |
El ID del resource group. Importante
IoT Platform admite la gestión de recursos únicamente por instancia. ResourceGroupId no surte efecto en esta solicitud. No es necesario especificar este parámetro. |
|
ModelVersion |
String |
No |
v1.0.0 |
El número de versión del modelo TSL. Puede invocar la operación ListThingModelVersion para consultar el número de versión del modelo TSL de un producto. Si no especifica este parámetro, se devuelve la última versión publicada del modelo TSL. |
|
FunctionBlockId |
String |
No |
BatteryModule |
El identificador del módulo TSL personalizado. Cada identificador es único dentro de un producto. Si no especifica este parámetro, se consulta el módulo predeterminado. |
Además de los parámetros específicos de la operación, debe especificar los parámetros de solicitud comunes al invocar esta operación. Para obtener más información, consulte Parámetros comunes.
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
Code |
String |
iot.system.SystemException |
El código de error devuelto si la solicitud falla. Para obtener más información, consulte Códigos de error. |
|
Data |
Struct |
Los datos devueltos. |
|
|
ThingModelJson |
String |
{\"_ppk\":{\"version\":\"1594253010934\"},\"events\":[],\"productKey\":\"a1BwAGV****\",\"properties\":[{\"configCode\":\"8C03F0EEC63D4897BF2637F89AE36B011594227294067\",\"custom\":true,\"customFlag\":true,\"dataSpecs\":{\"custom\":true,\"dataType\":\"INT\",\"max\":\"1\",\"min\":\"0\",\"step\":\"1\",\"unit\":\"ppb\"},\"dataType\":\"INT\",\"description\":\"1\",\"extendConfig\":\"{\\\"originalDataType\\\":{\\\"specs\\\":{\\\"registerCount\\\":1,\\\"reverseRegister\\\":0,\\\"swap16\\\":0},\\\"type\\\":\\\"bool\\\"},\\\"identifier\\\":\\\"WakeUpData\\\",\\\"registerAddress\\\":\\\"0x04\\\",\\\"scaling\\\":1,\\\"writeFunctionCode\\\":0,\\\"operateType\\\":\\\"inputStatus\\\",\\\"pollingTime\\\":1000,\\\"trigger\\\":1}\",\"identifier\":\"WakeUpData\",\"name\":\"WakeUp_Data\",\"productKey\":\"a114xeJGj2p\",\"required\":false,\"rwFlag\":\"READ_ONLY\",\"std\":false}],\"services\":[]} |
Las definiciones de funciones en el modelo TSL. Para obtener más información sobre el formato de datos de ThingModelJson, consulte Estructura de datos de ThingModelJson. |
|
ErrorMessage |
String |
A system exception occurred. |
El mensaje de error devuelto si la solicitud falla. |
|
ProductKey |
String |
a1BwAGV**** |
El ProductKey del producto. |
|
RequestId |
String |
E4C0FF92-2A86-41DB-92D3-73B60310D25E |
El ID de la solicitud. |
|
Success |
Boolean |
true |
Indica si la solicitud se realizó correctamente. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
https://iot.cn-shanghai.aliyuncs.com/?Action=QueryThingModelPublished
&ProductKey=a1BwAGV****
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
<QueryThingModelPublishedResponse>
<RequestId>1F9041A2-ED5B-4A5A-9C44-598E28C0B434</RequestId>
<Data>
<ThingModelJson>{"_ppk":{"version":"1594253010934"},"events":[],"productKey":"a1BwAGV****","properties":[{"configCode":"8C03F0EEC63D4897BF2637F89AE36B011594227294067","custom":true,"customFlag":true,"dataSpecs":{"custom":true,"dataType":"INT","max":"1","min":"0","step":"1","unit":"ppb"},"dataType":"INT","description":"1","extendConfig":"{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}","identifier":"WakeUpData","name":"WakeUp_Data","productKey":"a114xeJ****","required":false,"rwFlag":"READ_ONLY","std":false}],"services":[]}</ThingModelJson>
</Data>
<Success>true</Success>
</QueryThingModelPublishedResponse>Formato JSON
{
"RequestId": "1F9041A2-ED5B-4A5A-9C44-598E28C0B434",
"Data": {
"ThingModelJson": "{\"_ppk\":{\"version\":\"1594253010934\"},\"events\":[],\"productKey\":\"a1BwAGV****\",\"properties\":[{\"configCode\":\"8C03F0EEC63D4897BF2637F89AE36B011594227294067\",\"custom\":true,\"customFlag\":true,\"dataSpecs\":{\"custom\":true,\"dataType\":\"INT\",\"max\":\"1\",\"min\":\"0\",\"step\":\"1\",\"unit\":\"ppb\"},\"dataType\":\"INT\",\"description\":\"1\",\"extendConfig\":\"{\\\"originalDataType\\\":{\\\"specs\\\":{\\\"registerCount\\\":1,\\\"reverseRegister\\\":0,\\\"swap16\\\":0},\\\"type\\\":\\\"bool\\\"},\\\"identifier\\\":\\\"WakeUpData\\\",\\\"registerAddress\\\":\\\"0x04\\\",\\\"scaling\\\":1,\\\"writeFunctionCode\\\":0,\\\"operateType\\\":\\\"inputStatus\\\",\\\"pollingTime\\\":1000,\\\"trigger\\\":1}\",\"identifier\":\"WakeUpData\",\"name\":\"WakeUp_Data\",\"productKey\":\"a114xeJGj2p\",\"required\":false,\"rwFlag\":\"READ_ONLY\",\"std\":false}],\"services\":[]}"
},
"Success": true
}Códigos de error
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.