免責事項
このページに掲載されているすべてのコンテンツは、Tuya (HK) Limited によって提供されていることにご注意ください。Alibaba Cloud は、かかるコンテンツの真正性または正確性について、明示的または黙示的に表明または保証するものではなく、Tuya (HK) Limited が提供する製品およびサービスの状態、品質、耐久性、性能、信頼性、商品性、特定の目的への適合性、または権利の非侵害についても一切保証するものではありません。
このインターフェイスを呼び出して、デバイス属性値を一括設定します。
使用方法
TSL 関数でデータ型を float または double として定義した場合、対応するパラメーター値 (値が整数の場合でも) は、少なくとも小数点以下 1 桁を持ちます。たとえば、10.0、11.1 などです。
リクエストパラメーター
名前 | 型 | 必須 | サンプル値 | 説明 |
Action | String | はい | SetDevicesProperty | システム定義パラメーター。値: SetDevicesProperty。 |
DeviceName.N | RepeatList | はい | Light | プロパティ値を設定するデバイス名のリスト。デバイス名は 1 ～ 100 個です。 |
Items | String | はい | {"Switch":1,"Color":"blue"} | 設定する属性情報。データ形式は JSON です。 各属性情報は、識別子と属性値 (key:value) の組み合わせで指定し、複数の属性はカンマで区切ります。 たとえば、スマートライトの 2 つのプロパティを設定する場合:
|
ProductKey | String | はい | A1BwAGV * * * * | プロパティ値を設定するデバイスが属するプロダクトの ProductKey。 |
Note: API を呼び出すときは、このトピックで説明されている API 固有のリクエストパラメーターに加えて、共通のリクエストパラメーターも渡す必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。
戻りデータ
名前 | 型 | サンプル値 | 説明 |
Code | String | Iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
ErrorMessage | String | System Exception | 呼び出しが失敗した場合に返されるエラー情報。 |
RequestID | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | このリクエストに対して生成された一意の識別子。 |
Success | Boolean | True | 呼び出しが成功したかどうかを示します。
|
例
リクエスト例
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=SetDevicesProperty&SignatureNonce=50f8bd97342f4414bdffbce9503b3f9b&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&DeviceName.1=myTestDevice&SignatureMethod=HMAC-SHA1&Items=%7B%22rain%22%3A3%7D&Timestamp=2024-11-19T10%3A15%3A23Z&ProductKey=k1ymv1DuLfE&Signature=lp3WdUaJABpJbOK0BnUt7e6PKLI%3D'正常な戻り値の例
{
"RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
"Success": true
}