远程配置 - 阿里云物联网平台

本文档介绍设备主动请求配置信息和物联网平台推送配置信息的Topic及Alink数据格式。

远程配置的具体使用方法，请参见用户指南中远程配置文档。

设备主动请求配置信息

上行

请求Topic：/sys/${productKey}/${deviceName}/thing/config/get
响应Topic：/sys/${productKey}/${deviceName}/thing/config/get_reply

Alink请求数据格式

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

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"
  }
}

参数说明


参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围`0`~`4294967295`，且每个消息ID在当前设备中具有唯一性。
version	String	协议版本号，目前协议版本号唯一取值为`1.0`。
sys	Object	扩展功能的参数，其下包含各功能字段。说明使用设备端SDK开发时，如果未设置扩展功能，则无此参数，相关功能保持默认配置。
ack	Integer	sys下的扩展功能字段，表示是否返回响应数据。 1：云端返回响应数据。 0：云端不返回响应数据。重要该功能配置说明，请参见物模型使用示例。如果未配置该功能，则无此参数，云端默认返回响应数据。
configScope	String	配置范围，目前只支持产品维度配置。取值：`product`。
getType	String	获取配置类型。目前支持文件类型，取值：`file`。
method	String	请求方法，取值：`thing.config.get`。
configId	String	配置文件的ID。
configSize	Long	配置文件大小，按字节计算。
sign	String	签名。
signMethod	String	签名方法，仅支持Sha256。
url	String	存储配置文件的对象存储（OSS）地址。
code	Integer	结果码。返回200表示成功，返回其他状态码，表示失败。具体请参见设备端通用code。

错误码


错误码	消息	描述
6713	thing config function is not available	产品的远程配置功能不可用，需要在物联网平台控制台，监控运维 > 远程配置打开配置开关。
6710	no data	没有配置的数据。

配置推送

下行

请求Topic：/sys/${productKey}/${deviceName}/thing/config/push
响应Topic：/sys/${productKey}/${deviceName}/thing/config/push_reply

设备订阅该Topic后，您在物联网控制台批量推送配置信息时，物联网平台采用异步推送方式向设备推送信息。

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"
}

Alink响应数据格式

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

参数说明


参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围`0`~`4294967295`，且每个消息ID在当前设备中具有唯一性
version	String	协议版本号，目前协议版本号唯一取值为`1.0`。
configScope	String	配置范围，目前只支持产品维度配置。取值：`product`。
getType	String	获取配置类型，目前支持文件类型，取值：`file`。
configId	String	配置的ID。
configSize	Long	配置大小，按字节计算。
sign	String	签名。
signMethod	String	签名方法，仅支持sha256。
url	String	存储配置文件的对象存储（OSS）地址。
method	String	请求方法，取值：`thing.config.push`。
code	Integer	结果信息，具体请参见设备端通用code。

您可以使用规则引擎数据流转功能，将设备返回的响应结果转发至其他Topic和其他阿里云服务中。具体的设备响应数据Topic和数据格式请参见设备下行指令结果数据流转。