IoT Platform:ClearDeviceDesiredProperty

使用方法

• この操作を呼び出すたびに、Identifies パラメーターに、目標値を削除するプロパティの識別子を指定する必要があります。Identifies パラメーターを設定しない場合、呼び出しは失敗します。
• 1 回の呼び出しで、Identifies パラメーターに最大 10 個のプロパティ識別子を指定できます。
• この操作を呼び出してデバイスのプロパティの目標値を削除した後、QueryDeviceDesiredProperty 操作を呼び出して、デバイスのプロパティの目標値を照会できます。この場合、QueryDeviceDesiredProperty 操作は、Value パラメーターではなく、Identifier パラメーターを返します。

QPS 制限

この API 操作は、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。

リクエストパラメーター

上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを設定する必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスパラメーター

例

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=ClearDeviceDesiredProperty
&ProductKey=a1BwAGV****
&DeviceName=device1
&Identifies.1=temperature
&<Common request parameters>

成功レスポンスの例

XML 形式

<ClearDeviceDesiredPropertyResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Data>
        <Versions>{"temperature":0}</Versions>
  </Data>
  <Code></Code>
  <Success>true</Success>
</ClearDeviceDesiredPropertyResponse>

JSON 形式

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Data": {
        "Versions": "{\"temperature\":0}"
    },
    "Code": "",
    "Success": true
}

エラーコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。