Todos los productos
Search
Centro de documentos

IoT Platform:QueryThingModelExtendConfig

Última actualización: Sep 03, 2026

Consulta la información de los parámetros extendidos de Thing Specification Language (TSL) de un producto.

Límites de QPS

Puede llamar a esta operación de API hasta 20 veces por segundo por cuenta.

Nota

Los usuarios de Resource Access Management (RAM) de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

QueryThingModelExtendConfig

La operación que desea ejecutar. Establezca el valor en QueryThingModelExtendConfig.

ProductKey

String

Sí

a1T27vz****

El ProductKey del producto.

IotInstanceId

String

No

iot-cn-0pp1n8t****

El ID de la instancia. Consulte el ID de la instancia en la pestaña Overview de la consola de IoT Platform.

Importante
  • Si la instancia tiene un ID, especifique este parámetro. De lo contrario, la solicitud fallará.

  • Si la pestaña Overview o el ID de la instancia no se muestran en la consola de IoT Platform, omita este parámetro.

Para obtener más información sobre las instancias, consulte Descripción general.

ResourceGroupId

String

No

123***

El ID del resource group.

Importante

IoT Platform admite la gestión de resource groups únicamente por instancia. El parámetro ResourceGroupId no es válido. Omita este parámetro.

ModelVersion

String

No

v1.0.0

El número de versión del modelo TSL.

Llame a la operación ListThingModelVersion para consultar los números de versión del modelo TSL de un producto.

Si no especifica este parámetro, se devuelve la última versión publicada.

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 mencionados anteriormente, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

ErrorMessage

String

A system exception occurred.

El mensaje de error devuelto si la solicitud presenta errores.

Data

Struct

Los datos devueltos si la solicitud fue exitosa.

Configuration

String

{\"profile\":{\"productKey\":\"a114x\"},\"properties\":[{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}]}

La información de los parámetros extendidos de TSL. Para obtener más información sobre la definición de los parámetros extendidos, consulte la descripción de extendConfig en el tema CreateThingModel.

Code

String

iot.system.SystemException

El código de error devuelto si la solicitud presenta errores. Para obtener más información sobre los códigos de error, consulte Códigos de error.

RequestId

String

E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

El ID de la solicitud.

Success

Boolean

true

Indica si la solicitud fue exitosa. Valores válidos:

  • true

  • false

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryThingModelExtendConfig
&ProductKey=a1T27vz****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<QueryThingModelExtendConfigResponse>
    <Data>
        <Configuration>{"profile":{"productKey":"a114x******"},"properties":[{"originalDataType":{"specs":{"registerCount":1,"reverseRegister":0,"swap16":0},"type":"bool"},"identifier":"WakeUpData","registerAddress":"0x04","scaling":1,"writeFunctionCode":0,"operateType":"inputStatus","pollingTime":1000,"trigger":1}]}</Configuration>
    </Data>
    <RequestId>6DDF9D04-24C3-40D8-B490-2A528E59EA67</RequestId>
    <Success>true</Success>
</QueryThingModelExtendConfigResponse>

Formato JSON

{
   "Data": {
      "Configuration": "{\"profile\":{\"productKey\":\"a114x******\"},\"properties\":[{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}]}"
   },
   "RequestId": "6DDF9D04-24C3-40D8-B490-2A528E59EA67",
   "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.