Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Requête asynchrone pour annuler la revendication de jusqu'à 100 000 appareils pour un ou plusieurs clients.
Les méthodes d'API asynchrones renvoient un résultat avant la fin du traitement. Ils permettent également à votre application (ou outil) de rester responsive pour les utilisateurs pendant qu'ils attendent la fin d'une opération de longue durée. Votre application doit appeler getOperation pour vérifier régulièrement l'état de l'opération.
Champs supplémentaires, paire clé-valeur spécifiée par le fournisseur. Remarque: Les requêtes de la classe ResellerService créées par SamsungResellerServiceFactory doivent spécifier un customerId dans vendorParams.
Une ou plusieurs instances OperationUnclaimDevices.
Comportement en cas d'erreur
Si une erreur se produit, l'objet Operation renvoie l'un des codes d'erreur suivants:
Code d'erreur
DEVICE_UPLOAD_COUNT_EXCEEDED
INTERNAL_SERVER_ERROR
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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` |"]]
