Configuración remota - IoT Platform - Centro de documentación de Alibaba Cloud

Describe los temas y formatos de datos Alink para las solicitudes de configuración iniciadas por el dispositivo y los envíos de configuración desde IoT Platform.

Las instrucciones de uso paso a paso se encuentran en la guía de usuario Remote Configuration.

Solicitudes de configuración del dispositivo

Enlace ascendente

Tema de solicitud:/sys/${productKey}/${deviceName}/thing/config/get
Tema de respuesta:/sys/${productKey}/${deviceName}/thing/config/get_reply

Formato de datos de solicitud Alink

{
  "id": 123,
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": {
    "configScope": "product",
    "getType": "file"
  },
  "method": "thing.config.get"
}

Formato de datos de respuesta Alink

{
  "id": "123",
  "version": "1.0",
  "code": 200,
  "data": {
    "configId": "123dagdah",
    "configSize": 1234565,
    "sign": "123214adfadgadg",
    "signMethod": "Sha256",
    "url": "https://iotx-config.oss-cn-shanghai.aliyuncs.com/nopoll_0.4.4.tar.gz?Expires=1502955804&OSSAccessKeyId=XXXXXXXXXXXXXXXXXXXX&Signature=XfgJu7P6DWWejstKJgXJEH0qAKU%3D&security-token=CAISuQJ1q6Ft5B2yfSjIpK6MGsyN1Jx5jo6mVnfBglIPTvlvt5D50Tz2IHtIf3NpAusdsv03nWxT7v4flqFyTINVAEvYZJOPKGrGR0DzDbDasumZsJbo4f%2FMQBqEaXPS2MvVfJ%2BzLrf0ceusbFbpjzJ6xaCAGxypQ12iN%2B%2Fr6%2F5gdc9FcQSkL0B8ZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO1wEP4K%2BkkMqH8Uic3h%2Boy%2BgJt8H2PpHhd9NhXuV2WMzn2%2FdtJOiTknxR7ARasaBqhelc4zqA%2FPPlWgAKvkXba7aIoo01fV4jN5JXQfAU8KLO8tRjofHWmojNzBJAAPpYSSy3Rvr7m5efQrrybY1lLO6iZy%2BVio2VSZDxshI5Z3McKARWct06MWV9ABA2TTXXOi40BOxuq%2B3JGoABXC54TOlo7%2F1wTLTsCUqzzeIiXVOK8CfNOkfTucMGHkeYeCdFkm%2FkADhXAnrnGf5a4FbmKMQph2cKsr8y8UfWLC6IzvJsClXTnbJBMeuWIqo5zIynS1pm7gf%2F9N3hVc6%2BEeIk0xfl2tycsUpbL2FoaGk6BAF8hWSWYUXsv59d5Uk%3D",
    "getType": "file"
  }
}

Parámetros

Parámetro	Tipo	Descripción
id	String	ID del mensaje. Cadena numérica única por dispositivo en el rango de `0` a `4294967295`.
version	String	Versión del protocolo. Establezca este valor en `1.0`.
sys	Object	Parámetros de funciones extendidas. Nota Si utiliza un SDK del lado del dispositivo sin configurar las funciones extendidas, este parámetro se omite y se aplican los valores predeterminados.
ack	Integer	Indica si la nube devuelve una respuesta. Campo ubicado dentro de sys. 1: Devuelve una respuesta. 0: No se devuelve ninguna respuesta. Importante Thing Specification Language model usage examples. Si no se configura, este parámetro se omite y se devuelve una respuesta de forma predeterminada.
configScope	String	Alcance de la configuración. Solo es compatible el nivel de producto. Establezca este valor en `product`.
getType	String	Tipo de configuración. Solo es compatible el tipo archivo. Establezca este valor en `file`.
method	String	Método de la solicitud. Establezca este valor en `thing.config.get`.
configId	String	ID del archivo de configuración.
configSize	Long	Tamaño del archivo de configuración, en bytes.
sign	String	Firma.
signMethod	String	Método de firma. Solo es compatible Sha256.
url	String	URL de OSS del archivo de configuración.
code	Integer	Código de resultado. El valor 200 indica éxito. Los demás códigos aparecen en Device-side general codes.

Códigos de error

Código de error	Mensaje	Descripción
6713	thing config function is not available	La configuración remota no está habilitada para el producto. En la consola de IoT Platform, vaya a Monitoring > Remote Configuration y habilítela.
6710	no data	No existen datos de configuración.

Envío de configuración

Enlace descendente

Tema de solicitud:/sys/${productKey}/${deviceName}/thing/config/push
Tema de respuesta:/sys/${productKey}/${deviceName}/thing/config/push_reply

Cuando el dispositivo se suscribe a este tema, IoT Platform envía la información de configuración de forma asíncrona al realizar un envío masivo desde la consola.

Formato de datos de solicitud Alink

{
  "id": "123",
  "version": "1.0",
  "params": {
    "configId": "123dagdah",
    "configSize": 1234565,
    "sign": "123214adfadgadg",
    "signMethod": "Sha256",
    "url": "https://iotx-config.oss-cn-shanghai.aliyuncs.com/nopoll_0.4.4.tar.gz?Expires=1502955804&OSSAccessKeyId=XXXXXXXXXXXXXXXXXXXX&Signature=XfgJu7P6DWWejstKJgXJEH0qAKU%3D&security-token=CAISuQJ1q6Ft5B2yfSjIpK6MGsyN1Jx5jo6mVnfBglIPTvlvt5D50Tz2IHtIf3NpAusdsv03nWxT7v4flqFyTINVAEvYZJOPKGrGR0DzDbDasumZsJbo4f%2FMQBqEaXPS2MvVfJ%2BzLrf0ceusbFbpjzJ6xaCAGxypQ12iN%2B%2Fr6%2F5gdc9FcQSkL0B8ZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO1wEP4K%2BkkMqH8Uic3h%2Boy%2BgJt8H2PpHhd9NhXuV2WMzn2%2FdtJOiTknxR7ARasaBqhelc4zqA%2FPPlWgAKvkXba7aIoo01fV4jN5JXQfAU8KLO8tRjofHWmojNzBJAAPpYSSy3Rvr7m5efQrrybY1lLO6iZy%2BVio2VSZDxshI5Z3McKARWct06MWV9ABA2TTXXOi40BOxuq%2B3JGoABXC54TOlo7%2F1wTLTsCUqzzeIiXVOK8CfNOkfTucMGHkeYeCdFkm%2FkADhXAnrnGf5a4FbmKMQph2cKsr8y8UfWLC6IzvJsClXTnbJBMeuWIqo5zIynS1pm7gf%2F9N3hVc6%2BEeIk0xfl2tycsUpbL2FoaGk6BAF8hWSWYUXsv59d5Uk%3D",
    "getType": "file"
  },
  "method": "thing.config.push"
}

Formato de datos de respuesta Alink

{
  "id": "123",
  "code": 200,
  "data": {}
}

Parámetros

Parámetro	Tipo	Descripción
id	String	ID del mensaje. Cadena numérica única por dispositivo en el rango de 0 a 4294967295.
version	String	Versión del protocolo. Establezca este valor en 1.0.
configScope	String	Alcance de la configuración. Solo es compatible el nivel de producto. Establezca este valor en product.
getType	String	Tipo de configuración. Solo es compatible el tipo archivo. Establezca este valor en file.
configId	String	ID de la configuración.
configSize	Long	Tamaño de la configuración, en bytes.
sign	String	Firma.
signMethod	String	Método de firma. Solo es compatible sha256.
url	String	URL de OSS del archivo de configuración.
method	String	Método de la solicitud. Establezca este valor en thing.config.push.
code	Integer	Código de resultado. Los valores posibles aparecen en Device-side general codes.

Utilice la data forwarding feature of the rules engine para reenviar las respuestas del dispositivo a otros temas y servicios de Alibaba Cloud. Los temas y formatos de respuesta se describen en Data forwarding for device responses to downlink instructions.