异步请求,可以为一个或多个客户取消最多 10 万台设备的声明。
异步 API 方法会在处理完成之前返回结果。还可以帮助您的应用(或工具)在用户等待长时间运行的操作完成时始终保持响应。您的应用应定期调用 getOperation
以检查操作的状态。
方法签名
public UnclaimDevicesResponse unclaimDevicesAsync(UnclaimDevicesRequest request);
取消认领设备请求
属性名称 | 价值 | 必需 | 说明 |
---|---|---|---|
unclaims |
object(DeviceUnclaim) 的列表 |
兼容 | 设备取消声明要处理。 |
vendorParams |
map |
否 | 额外字段,供应商指定的键值对。注意:来自 SamsungResellerServiceFactory 创建的 ResellerService 类的请求必须在 vendorParams 中指定 customerId 。 |
取消声明设备响应
属性名称 | 价值 | 说明 |
---|---|---|
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 |