本文档介绍设备主动请求配置信息和物联网平台推送配置信息的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"
  }
}

参数说明

参数类型说明
idString消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。
versionString协议版本号,目前协议版本号唯一取值为1.0
sysObject扩展功能的参数,其下包含各功能字段。
说明 使用设备端SDK开发时,如果未设置扩展功能,则无此参数,相关功能保持默认配置。
ackIntegersys下的扩展功能字段,表示是否返回响应数据。
  • 1:云端返回响应数据。
  • 0:云端不返回响应数据。
重要 该功能配置说明,请参见物模型使用示例

如果未配置该功能,则无此参数,云端默认返回响应数据。

configScopeString配置范围, 目前只支持产品维度配置。 取值:product
getTypeString获取配置类型。 目前支持文件类型,取值:file
methodString请求方法,取值:thing.config.get
configIdString配置文件的ID。
configSizeLong配置文件大小,按字节计算。
signString签名。
signMethodString签名方法,仅支持Sha256。
urlString存储配置文件的对象存储(OSS)地址。
codeInteger结果码。返回200表示成功,返回其他状态码,表示失败。具体请参见设备端通用code

错误码

错误码消息描述
6713thing config function is not available产品的远程配置功能不可用,需要在物联网平台控制台对应实例的监控运维 > 远程配置打开配置开关。
6710no 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": {}
}

参数说明

参数类型说明
idString

消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性

versionString协议版本号,目前协议版本号唯一取值为1.0
configScopeString配置范围, 目前只支持产品维度配置。 取值:product
getTypeString获取配置类型,目前支持文件类型,取值:file
configIdString配置的ID。
configSizeLong配置大小,按字节计算。
signString签名。
signMethodString签名方法,仅支持sha256。
urlString存储配置文件的对象存储(OSS)地址。
methodString请求方法,取值:thing.config.push
codeInteger结果信息, 具体请参见设备端通用code

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