免責事項
このページに掲載されているすべてのコンテンツは、Tuya (HK) Limited によって提供されていることにご注意ください。Alibaba Cloud は、かかるコンテンツの真正性または正確性について、明示的または黙示的に表明または保証するものではなく、Tuya (HK) Limited が提供する製品および/またはサービスの状態、品質、耐久性、性能、信頼性、商品性、特定の目的への適合性、または非侵害性についても一切保証するものではありません。
このインターフェイスを呼び出して、指定されたデバイスのラベルを設定します。
使用方法
●単一デバイスのデバイスタグの総数は 100 を超えません。 ●一度に変更または追加される機器タグの数は 100 を超えません。
リクエストパラメーター
名前 | タイプ | 必須 | サンプル値 | 説明 |
Action | String | はい | SaveDeviceProp | システム定義パラメーター。値: SaveDeviceProp。 |
Props | String | はい | {"color":"red"} | 設定するデバイスタグ。複数のタグがサポートされています。 デバイスタグは JSON 形式です。各タグの具体的な構造は次のとおりです: Key:Value 。 Key はラベル名、 Valueは対応するタグ値です。 複数のラベルは半角コンマで区切ります。例: Props={"color":"red","shape":"round"} 。 |
ProductKey | String | いいえ | A1BwAGV * * * * | デバイスが属するプロダクトの ProductKey。 |
DeviceName | String | いいえ | Light | デバイス名。 |
IoTID | String | いいえ | **** 00100 | デバイス ID。IoT プラットフォームがデバイスに発行した ID。デバイスの一意の識別子。 |
注: API を呼び出すときは、このトピックで説明されている API 固有のリクエストパラメーターに加えて、共通のリクエストパラメーターも渡す必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。
戻りデータ
名前 | タイプ | サンプル値 | 説明 |
Code | String | Iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
ErrorMessage | String | System Exception | 呼び出しが失敗した場合に返されるエラー情報。 |
リクエスト ID ID | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | このリクエストに対して生成された一意の識別子。 |
Success | ブール値 | True | 呼び出しが成功したかどうかを示します。 ●True : 呼び出しは成功しました。 ●False : 呼び出しは失敗しました。 |
例
リクエスト例
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=SaveDeviceProp&SignatureNonce=54dbd8cf9ffa4e448b87f9283499f290&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Props=%7B%22color%22%3A%22red%22%7D&Timestamp=2024-11-19T08%3A42%3A04Z&ProductKey=k1ymv1DuLfE&DeviceName=myTestDevice&Signature=8Z9ZAjG4BUAq987AilVJRVnWVh0%3D'正常な戻り値の例
{
"RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
"Success": true
}