하나 이상의 고객에 대해 최대 100,000대의 기기의 소유권 주장을 취소하는 비동기 요청입니다.
비동기 API 메서드는 처리가 완료되기 전에 결과를 반환합니다. 또한 장기 실행 작업이 완료될 때까지 사용자가 기다리는 동안 앱 (또는 도구)이 사용자에게 응답을 계속 제공하는 데 도움이 됩니다. 앱은 getOperation를 호출하여 주기적으로 작업 상태를 확인해야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis API provides an asynchronous method to unclaim up to 100,000 devices from one or more customers.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunclaimDevicesAsync\u003c/code\u003e method is used to initiate the unclaiming process, and it allows your application to remain responsive during long operations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eResellerService\u003c/code\u003e only allows unclaiming for one customer per request and will fail with \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e if multiple customer IDs are in a single request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eUnclaimDevicesRequest\u003c/code\u003e requires a list of \u003ccode\u003eDeviceUnclaim\u003c/code\u003e objects and may include vendor-specific parameters, while requests from the \u003ccode\u003eSamsungResellerServiceFactory\u003c/code\u003e must specify a \u003ccode\u003ecustomerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetOperation\u003c/code\u003e method can be used to check the status of the \u003ccode\u003eUnclaimDevices\u003c/code\u003e operation, which can return a list of error codes if an issue happens.\u003c/p\u003e\n"]]],["The `unclaimDevicesAsync` method facilitates asynchronous unclaiming of up to 100,000 devices. It requires a list of `DeviceUnclaim` objects and optionally accepts `vendorParams`, which must contain a `customerId` for requests from `SamsungResellerServiceFactory`. The API returns an `UnclaimDevicesResponse` with a list of `Operation` instances to track the status, and users need to periodically use `getOperation` to check progress. The method can return the errors: `DEVICE_UPLOAD_COUNT_EXCEEDED`, `INTERNAL_SERVER_ERROR`, `INVALID_DEVICE_IMEI`, `INVALID_DEVICE_MEID`, `INVALID_DEVICE_SERIAL` and `INVALID_IDENTIFIER_SET`.\n"],null,["Asynchronous request to unclaim up to 100,000 devices for one or more customers.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` only supports claiming devices for one customer per request. If devices for multiple customers are put into a single request, the operation will fail and return `INTERNAL_SERVER_ERROR`.\n\nAsynchronous API methods return a result before the processing is complete. They\nalso help your app (or tool) remain responsive for your users while they wait\nfor a long-running operation to complete. Your app should call\n[`getOperation`](/zero-touch/reseller-library/reference/methods/getoperation)\nto check the status of the operation periodically.\n\nMethod signature \n\n public UnclaimDevicesResponse unclaimDevicesAsync(UnclaimDevicesRequest request);\n\nUnclaimDevicesRequest\n\n| Property name | Value | Required | Description |\n|----------------|---------------------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unclaims` | List of `object(DeviceUnclaim)` | Yes | The device unclaims to be processed. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. Note: Requests from the `ResellerService` class created by `SamsungResellerServiceFactory` must specify a `customerId` in `vendorParams`. |\n\nUnclaimDevicesResponse\n\n| Property name | Value | Description |\n|---------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `operations` | List of `object(`[`Operation`](/zero-touch/reseller-library/reference/objects#operation)`)` | One or more `UnclaimDevices` `Operation` instances. |\n\nError behavior\n\nIf an error occurs, the [`Operation`](/zero-touch/reseller-library/reference/objects#operation)\nobject returns one of the following error codes:\n\n| Error code |\n|--------------------------------|\n| `DEVICE_UPLOAD_COUNT_EXCEEDED` |\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |"]]
