デバイスに保存されている時系列データを削除します。
使用上の注意
この操作は、ホワイトリストに追加されているユーザーのみが呼び出すことができます。 操作を呼び出す場合は、チケットを送信してください。
QPS 制限
この API 操作は、アカウントごとに 1 秒あたり最大 30 回呼び出すことができます。
説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。
デバッグ
リクエストパラメーター
|
パラメーター |
タイプ |
必須 |
例 |
説明 |
| Action | String | Yes | ResetDeviceTimeline | 実行する操作。 値を ResetDeviceTimeline に設定します。 |
| ProductKey | String | Yes | a1BwAGV**** | デバイスが属するプロダクトの ProductKey。 |
| DeviceName | String | Yes | light | デバイスの DeviceName。 |
| IotInstanceId | String | No | iot-v64****** | インスタンスの ID。インスタンス ID は、IoT Platform コンソールの [概要] タブで確認できます。 重要
詳細については、「概要」をご参照ください。 |
上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを設定する必要があります。 共通のリクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。
レスポンスパラメーター
パラメーター |
タイプ |
例 |
説明 |
| Code | String | iot.device.NotExistedDevice | 呼び出しが失敗した場合に返されるエラーコード。
|
| ErrorMessage | String | device not found. | 呼び出しが失敗した場合に返されるエラーメッセージ。 |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | リクエストの ID。 |
| Success | Boolean | true | 呼び出しが成功したかどうかを示します。有効な値:
|
例
リクエストの例
https://iot.cn-shanghai.aliyuncs.com/?Action=ResetDeviceTimeline
&DeviceName=light
&ProductKey=a1BwAGV****
&IotInstanceId=iot-v64******
&<共通リクエストパラメーター>
成功レスポンスの例
XML 形式
<ResetDeviceTimelineResponse>
<RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
<Code></Code>
<Success>true</Success>
</ResetDeviceTimelineResponse>
JSON 形式
{
"RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
"Code": "",
"Success": true
}
エラーコード
|
HttpCode |
エラーコード |
エラーメッセージ |
説明 |
| 400 | iot.device.NotExistedDevice | device not found. | デバイスが存在しません。 |
| 400 | iot.common.AuthActionPermissionDeny | auth action permission deny. | 操作を実行する権限がありません。 |
| 400 | iot.system.IllegalRequest | The request parameter is invalid.%s. | %s リクエストパラメーターが無効です。 |
エラーコードの一覧については、「サービスエラーコード」をご参照ください。