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

IoT Platform:ConfirmOTATask

最終更新日:Apr 17, 2025

保留確認状態のデバイス更新タスクを確認します。

使用上の注意

  • スケジュールされた更新バッチで更新タスクを確認するには、指定された時間内にこの操作を呼び出す必要があります。
  • この操作を呼び出すには、POST リクエストメソッドのみを使用できます。

QPS 制限

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

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

デバッグ

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

リクエストパラメーター

パラメーター タイプ 必須 説明
Action String Yes ConfirmOTATask

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

TaskId.N RepeatList Yes y3tOmCDNgpR8F9jnVEzC01****

確認する更新タスクの ID。 最大 10 個のタスク ID を指定できます。

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

インスタンスの ID。 IoT Platform コンソールの [概要] ページでインスタンスの ID を表示できます。

重要
  • インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。 指定しないと、呼び出しは失敗します。
  • インスタンスに対して [概要] ページまたは ID が生成されていない場合は、このパラメーターを設定する必要はありません。

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

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

レスポンスパラメーター

パラメーター タイプ 説明
Code String iot.system.SystemException

呼び出しが失敗した場合に返されるエラーコード。 エラーコードの詳細については、「エラーコード」をご参照ください。

ErrorMessage String A system exception occurred.

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

RequestId String A59D3BE1-E9A3-43F3-9B50-B7C8DE165D9B

リクエストの ID。

Success Boolean true

呼び出しが成功したかどうかを示します。

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

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=ConfirmOTATask
&TaskId.1=y3tOmCDNgpR8F9jnVEzC01****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<ConfirmOTATask>
  <RequestId>A59D3BE1-E9A3-43F3-9B50-B7C8DE165D9B</RequestId>
  <Success>true</Success>
</ConfirmOTATask>

JSON 形式

{
    "RequestId": "A59D3BE1-E9A3-43F3-9B50-B7C8DE165D9B",
    "Success": true
}

エラーコード

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