QueryDeviceDistributeDetail - IoT Platform - Alibaba Cloud ドキュメントセンター

デバイス配布タスクの結果を照会します。

使用方法

この操作は、次の エンドポイント のみを使用して呼び出すことができます: iot.cn-shanghai.aliyuncs.com。
Alibaba Cloud アカウントごとに、最大 5 クエリ/秒 (QPS) を実行できます。
説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	QueryDeviceDistributeDetail	実行する操作。値を QueryDeviceDistributeDetail に設定します。
JobId	String	はい	UbmsMHmkqv0PiAG****010001	配布タスクの ID。この ID は、タスクをグローバルに識別します。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	iot.system.SystemException	呼び出しが失敗した場合に返されるエラーコード。詳細については、エラーコードを参照してください。
ErrorMessage	String	システム例外が発生しました。	呼び出しが失敗した場合に返されるエラーメッセージ。
File	String	https://iotx-*.oss-cn-shanghai.aliyuncs.com/job/7u**	配布結果を含むファイルの URL。 URL は、Object Storage Service (OSS) 内のファイルの格納場所を示します。 URL は 10 分間有効です。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。 true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。

例

リクエストの例

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

成功レスポンスの例

XML 形式

<QueryDeviceDistributeDetailResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <File>https://iotx-***.oss-cn-shanghai.aliyuncs.com/job***/7u***</File>
  <Success>true</Success>
</QueryDeviceDistributeDetailResponse>

JSON 形式

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "File": "https://iotx-***.oss-cn-shanghai.aliyuncs.com/job***/7u***",
    "Success": true
}

エラーコード

エラーコードの一覧については、API エラーセンターをご覧ください。