ベンダーやデバイスモデルなど、デバイスに関する一部の情報は、デバイスタグとしてIoT Platformに報告できます。 デバイスのタグを照会して削除することもできます。 このトピックでは、デバイスタグの送信、クエリ、および削除に使用されるトピックとデータ形式について説明します。
タグの送信
次のトピックは、デバイスがIoT Platformにリクエストを送信し、IoT Platformがデバイスに応答を送信するときに使用されます。
- リクエストトピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update
- レスポンストピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply
Alink JSON形式のサンプルリクエスト:
{
"id": "123",
"version": "1.0"、
"sys":{
"ack":0
},
"params":[
{
"attrKey": "Temperature",
"attrValue": "36.8"
}
],
"method": "thing.de viceinfo.update"
}
Alink JSON形式のサンプル応答:
{
"id": "123",
"code": 200,
"data": {}
}
パラメーター
パラメーター | データ型 | 説明 |
id | String | メッセージの ID 。 有効な値: 0 ~ 4294967295 各メッセージIDは、デバイスに対して一意である必要があります。 |
バージョン | String | プロトコルのバージョン番号。 値を 1.0 に設定します。 |
sys | オブジェクト | 拡張フィーチャのパラメータ。The parameter for extended features. 値には、各フィーチャのフィールドが含まれます。 説明 デバイスSDKを使用してデバイス機能を開発するときに拡張機能が設定されていない場合、このパラメーターは使用できません。 拡張機能はデフォルトの設定を使用します。 |
ack | Integer | sysパラメーターの拡張機能フィールド。 このフィールドは、IoT Platformが登録要求の応答データを返すかどうかを指定します。 有効な値:
重要 パラメーターの詳細については、「TSLモデルの使用方法の例」をご参照ください。 機能が設定されていない場合、このパラメーターは使用できません。 デフォルトでは、IoT Platformは登録リクエストの応答データを返します。 |
params | オブジェクト | リクエストのパラメーター attrKeyパラメーターはタグキーを指定し、attrValueパラメーターはタグ値を指定します。 paramsパラメーターには、配列に最大200個の要素を含めることができます。 |
メソッド | String | リクエスト方式。 値をthing.de viceinfo.update に設定します。 |
attrKey | String | タグのキー。 キーの長さは1 ~ 30文字で、英数字、アンダースコア (_) 、ハイフン (-) 、数字記号 (#) 、位置記号 (@) 、パーセント記号 (%) 、アンパサンド (&) 、アスタリスク (*) 、およびピリオド (.) を使用できます。 |
attrValue | String | タグの値。 値の長さは1 ~ 128文字で、漢字、文字、数字、日本語、アンダースコア (_) 、ハイフン (-) 、数字記号 (#) 、位置記号 (@) 、パーセント記号 (%) 、アンパサンド (&) 、コロン (:) 、ピリオド (.) を使用できます。 各漢字または日本語文字は2文字を使用します。 |
コード | Integer | レスポンス内のHTTPステータスコード。 値200は、リクエストが成功したことを示します。 |
エラーコード
エラーコード | エラーメッセージ | 説明 |
460 | request parameter error | リクエストパラメーターが無効な場合に返されるエラーメッセージ。 |
6100 | device not found | デバイスが存在しない場合に返されるエラーメッセージ。 |
タグの照会
- 一度に最大10個のタグをクエリできます。
- カスタムタグのみを照会できます。 IoT Platformの内部タグを照会することはできません。
- 照会するタグのキーを指定する必要があります。 タグキーを指定しない場合、データは返されません。
次のトピックは、デバイスがIoT Platformにリクエストを送信し、IoT Platformがデバイスに応答を送信するときに使用されます。
- リクエストトピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/get
- レスポンストピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/get_reply
{
"id": "123",
"version": "1.0"、
"param": {
"attrKeys":["attrKey1", "attrKey2", "attrKey3"]
},
"method": "thing.de viceinfo.get"
}
{
"id": "123",
"code": 200,
"data": [
{
"attrKey1":"v1"
},
{
"attrKey2":"v2"
},
{
"attrKey3":"v3"
}
]
}
パラメーター | データ型 | 説明 |
id | String | メッセージの ID 。 有効な値: 0 ~ 4294967295 各メッセージIDは、デバイスに対して一意である必要があります。 |
バージョン | String | プロトコルのバージョン番号。 値を 1.0 に設定します。 |
params | オブジェクト | リクエストのパラメーター attrKeysパラメーターは、クエリするタグのキーを指定します。 |
attrKeys | JSONArray | 照会するタグキー。 説明
|
メソッド | String | リクエスト方式。 値をthing.de viceinfo.get に設定します。 |
データ | JSONArray | タグのキーと値を含む、タグに関する返された情報。 |
コード | Integer | レスポンス内のHTTPステータスコード。 値200は、リクエストが成功したことを示します。 |
エラーコード | エラーメッセージ | 説明 |
460 | request parameter error | リクエストパラメーターが無効な場合に返されるエラーメッセージ。 たとえば、attrKeysパラメーターの値がJSON配列ではない、タグキーが指定されていない、指定されたタグキーが重複している、または指定されたタグキーの数が10を超えている場合などです。 |
429 | too many requests | 1秒あたりのクエリ数 (QPS) が多すぎるためにスロットリングがトリガーされた場合に返されるエラーメッセージ。 このAPI操作は、アカウントごとに1秒あたり最大50回呼び出すことができます。 説明 Alibaba CloudアカウントのRAMユーザーは、アカウントのクォータを共有します。 |
タグの削除
次のトピックは、デバイスがIoT Platformにリクエストを送信し、IoT Platformがデバイスに応答を送信するときに使用されます。
- リクエストトピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/delete
- レスポンストピック:
/sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply
Alink JSON形式のサンプルリクエスト:
{
"id": "123",
"version": "1.0"、
"sys":{
"ack":0
},
"params": [
{
"attrKey": "Temperature"
}
],
"method": "thing.deviceinfo.de lete"
}
Alink JSON形式のサンプル応答:
{
"id": "123",
"code": 200,
"data": {}
}
パラメーター
パラメーター | データ型 | 説明 |
id | String | メッセージの ID 。 有効な値: 0 ~ 4294967295 各メッセージIDは、デバイスに対して一意である必要があります。 |
バージョン | String | プロトコルのバージョン番号。 値を 1.0 に設定します。 |
sys | オブジェクト | 拡張フィーチャのパラメータ。The parameter for extended features. 値には、各フィーチャのフィールドが含まれます。 説明 デバイスSDKを使用してデバイス機能を開発するときに拡張機能が設定されていない場合、このパラメーターは使用できません。 拡張機能はデフォルトの設定を使用します。 |
ack | Integer | sysパラメーターの拡張機能フィールド。 このフィールドは、IoT Platformが登録要求の応答データを返すかどうかを指定します。 有効な値:
重要 パラメーターの詳細については、「TSLモデルの使用方法の例」をご参照ください。 機能が設定されていない場合、このパラメーターは使用できません。 デフォルトでは、IoT Platformは登録リクエストの応答データを返します。 |
params | オブジェクト | リクエストのパラメーター attrKeyパラメーターは、削除するタグのキーを指定します。 |
メソッド | String | リクエスト方式。 値をthing.deviceinfo.de lete に設定します。 |
attrKey | String | 削除するタグのキー。 |
コード | Integer | レスポンス内のHTTPステータスコード。 値200は、リクエストが成功したことを示します。 |
エラーコード
エラーコード | エラーメッセージ | 説明 |
460 | request parameter error | リクエストパラメーターが無効な場合に返されるエラーメッセージ。 |
6100 | device not found | デバイスが存在しない場合に返されるエラーメッセージ。 |