すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:ResetDeviceTimeline

最終更新日:Apr 17, 2025

デバイスに保存されている時系列データを削除します。

使用上の注意

この操作は、ホワイトリストに追加されているユーザーのみが呼び出すことができます。 操作を呼び出す場合は、チケットを送信してください。

QPS 制限

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

説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター

タイプ

必須

説明

Action String Yes ResetDeviceTimeline

実行する操作。 値を ResetDeviceTimeline に設定します。

ProductKey String Yes a1BwAGV****

デバイスが属するプロダクトの ProductKey

DeviceName String Yes light

デバイスの DeviceName。

IotInstanceId String No iot-v64******

インスタンスの ID。インスタンス ID は、IoT Platform コンソールの [概要] タブで確認できます。

重要
  • インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。 指定しないと、呼び出しは失敗します。
  • インスタンスに ID がない場合は、パラメーターを設定する必要はありません。

詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター

タイプ

説明

Code String iot.device.NotExistedDevice

呼び出しが失敗した場合に返されるエラーコード。

  • 呼び出しが成功した場合、このパラメーターは空です。
  • 詳細については、このトピックの [エラーコード] セクションを参照してください。
ErrorMessage String device not found.

呼び出しが失敗した場合に返されるエラーメッセージ。

RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

リクエストの ID。

Success Boolean true

呼び出しが成功したかどうかを示します。有効な値:

  • true: 呼び出しは成功しました。
  • false: 呼び出しは失敗しました。

リクエストの例

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 リクエストパラメーターが無効です。

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