异步请求,为一个或多个客户取消声明最多 10 万台设备的使用权。
异步 API 方法会在处理完成之前返回结果。它们还有助于您的应用(或工具)在用户等待长时间运行的操作完成时及时响应。您的应用应调用 getOperation
以定期检查操作状态。
方法签名
public UnclaimDevicesResponse unclaimDevicesAsync(UnclaimDevicesRequest request);
UnclaimDevicesRequest
属性名称 | 值 | 必填 | 说明 |
---|---|---|---|
unclaims |
object(DeviceUnclaim) 的列表 |
是 | 设备取消声明要处理。 |
vendorParams |
map |
否 | 额外字段,供应商指定的键值对。注意:来自 SamsungResellerServiceFactory 创建的 ResellerService 类的请求必须在 vendorParams 中指定 customerId 。 |
UnclaimDevicesResponse
属性名称 | 值 | 说明 |
---|---|---|
operations |
object( Operation ) 的列表 |
一个或多个 UnclaimDevices Operation 实例。 |
错误行为
如果发生错误,Operation
对象会返回以下某个错误代码:
错误代码 |
---|
DEVICE_UPLOAD_COUNT_EXCEEDED |
INTERNAL_SERVER_ERROR |
INVALID_DEVICE_IMEI |
INVALID_DEVICE_MEID |
INVALID_DEVICE_SERIAL |
INVALID_IDENTIFIER_SET |