Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Richiesta asincrona per annullare la rivendicazione di un massimo di 100.000 dispositivi per uno o più clienti.
I metodi API asincroni restituiscono un risultato prima del completamento dell'elaborazione. Consentono inoltre alla tua app (o al tuo strumento) di rimanere reattiva per gli utenti in attesa del completamento di un'operazione a lunga esecuzione. L'app deve chiamare
getOperation
per controllare periodicamente lo stato dell'operazione.
Il dispositivo annulla la rivendicazione di essere elaborato.
vendorParams
map
No
Campi aggiuntivi, coppia chiave-valore specificata dal fornitore. Nota: le richieste del corso ResellerService creato da SamsungResellerServiceFactory devono specificare un customerId in vendorParams.
[null,null,["Ultimo aggiornamento 2025-08-29 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,["# unclaimDevicesAsync\n\nAsynchronous 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\n public UnclaimDevicesResponse unclaimDevicesAsync(UnclaimDevicesRequest request);\n\nUnclaimDevicesRequest\n---------------------\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\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--------------\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` |"]]
