本文档介绍设备主动请求配置信息和物联网平台推送配置信息的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和数据格式请参见设备下行指令结果数据流转