ここでは、Topic と Alink の JSON 形式のリクエストとリモート設定のレスポンスについて紹介します。 リモート設定の使用方法については、『ユーザーガイド (User Guide)』の 「リモート設定」 をご参照ください。

デバイスが IoT Platform に設定情報を要求

アップストリーム

  • Topic: /sys/{productKey}/{deviceName}/thing/config/get
  • Reply topic: /sys/{productKey}/{deviceName}/thing/config/get_reply

リクエストメッセージ

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

レスポンスメッセージ

{
  "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 文字列 メッセージ ID
version 文字列 プロトコルバージョンです。 現在の値は 1.0 です。
configScope 文字列 設定スコープです。 現在、IoT Platform がサポートしているのはプロダクトのディメンションの設定だけです。 値 : プロダクト
getType 文字列 設定の目的のファイルタイプです。 現在サポートされているタイプは file です。 値を file に設定します。
configId 文字列 設定の ID
configSize Long 設定ファイルのサイズ (バイト単位)
sign 文字列 署名値
signMethod 文字列 署名メソッドです。 サポートされている署名メソッドは Sha256 です。
url 文字列 設定ファイルが格納されている OSS アドレス
code 整数 結果コードです。 値 200 は操作が成功したことを示し、その他の状況コードは操作が失敗したことを示します。

エラーコード

エラーコード エラーメッセージ 説明
6713 thing config function is not available プロダクトのリモート設定機能が無効になっています。 IoT Platform コンソールの [リモート設定] ページで、プロダクトのリモート設定を有効にします。
6710 no data 設定データが見つかりません。

IoT Platform コンソールの設定をデバイスにプッシュする

ダウンストリーム

  • Topic: /sys/{productKey}/{deviceName}/thing/config/push
  • Reply topic: /sys/{productKey}/{deviceName}/thing/config/push_reply

デバイスは、IoT Platform によってプッシュされる設定のトピックをサブスクライブします。 IoT Platform コンソールで設定ファイルを編集して送信した後、IoT Platform は非同期方式で設定をデバイスにプッシュします。 IoT Platform は、非同期呼び出しの結果のデータ交換トピックをサブスクライブします。 データ交換のトピックは /{productKey}/{deviceName}/thing/downlink/reply/message にあります。

[ルールエンジン] を使用してデバイスが返す結果を別の Alibaba Cloud プロダクトに転送できます。 次の図に、ルールアクションの設定例を示します。

リクエストメッセージ :

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

レスポンスメッセージ

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

パラメーター説明

パラメーター データタイプ 説明
id 文字列 メッセージ ID
version 文字列 プロトコルバージョンです。 現在の値は 1.0 です。
configScope 文字列 設定スコープです。 現在、IoT Platform がサポートしているのはプロダクトのディメンションの設定だけです。 値 : プロダクト
getType 文字列 設定の目的のファイルタイプです。 現在サポートされているタイプはfileです。 値を file に設定します。
configId 文字列 設定の ID
configSize Long 設定ファイルのサイズ (バイト単位)
sign 文字列 署名値
signMethod 文字列 署名メソッドです。 サポートされている署名メソッドは Sha256 です。
url 文字列 設定ファイルが格納されている OSS アドレス
code 整数 結果コードです。 詳細は、「デバイスの共通コード (Common codes on devices)」をご参照ください。