請求デバイス非同期

1 人以上のお客様に対して最大 100,000 台のデバイスをリクエストするための非同期リクエスト。

非同期 API メソッドは、処理が完了する前に結果を返します。また、長時間実行オペレーションの完了を待つ間、アプリ(またはツール)がユーザーの応答性を維持できるようにします。アプリは getOperation を呼び出して、オペレーションのステータスを定期的に確認する必要があります。

メソッド シグネチャ

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

申し立てデバイス リクエスト

プロパティ名 必須 説明
claims object(DeviceClaim) のリスト 対応 デバイスに対するお客様の申し立てのリスト。

DeviceClaim

プロパティ名 必須 説明
deviceIdentifier object(DeviceIdentifier) 対応 デバイス ID。
customer CompanyReference オブジェクト 対応 デバイスが割り当てられているお客様についての会社参照情報。
orderNumber string × 注文番号。
vendorParams map × 追加フィールド、ベンダー指定の Key-Value ペア。

クレーム デバイス レスポンス

プロパティ名 説明
operations Operation オブジェクトのリスト 1 つ以上の ClaimDevices Operation インスタンス。

エラーの動作

エラーが発生した場合、Operation オブジェクトは次のいずれかのエラーコードを返します。

エラーコード
DEVICE_UPLOAD_COUNT_EXCEEDED
DUPLICATE_DEVICES
INTERNAL_SERVER_ERROR
INVALID_CUSTOMER_ID
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
INVALID_MANUFACTURER
INVALID_MODEL