Champs supplémentaires, paire clé-valeur spécifiée par le fournisseur.
Comportement en cas d'erreur
Si une erreur se produit, la bibliothèque génère une CommonException contenant l'un des codes d'erreur suivants:
Code d'erreur
AUTHORIZATION_FAIL
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
NOT_IMPLEMENTED
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 method \u003ccode\u003eunclaimDevice\u003c/code\u003e allows for the synchronous unclaiming of a single device from a customer.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eResellerService\u003c/code\u003e class does not support this API; users should utilize \u003ccode\u003eunclaimDeviceAsync\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eDeviceUnclaim\u003c/code\u003e object, which must include either \u003ccode\u003edeviceId\u003c/code\u003e or \u003ccode\u003edeviceIdentifier\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eErrors are communicated through a \u003ccode\u003eCommonException\u003c/code\u003e, with potential error codes like \u003ccode\u003eAUTHORIZATION_FAIL\u003c/code\u003e or \u003ccode\u003eINVALID_DEVICE_IMEI\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003evendorParams\u003c/code\u003e, are an optional field for vendor-specific key-value pairs related to the unclaim request.\u003c/p\u003e\n"]]],["The `unclaimDevice` method synchronously unclaims a single device. It requires an `UnclaimDeviceRequest` containing a `DeviceUnclaim` object. This object needs either a `deviceId` or a `deviceIdentifier` to specify the device. Optional `vendorParams` can also be included. The method throws a `CommonException` with specific error codes like `AUTHORIZATION_FAIL`, or `INVALID_DEVICE_IMEI` if errors occur. Note this method isn't supported by the `ResellerService` class, and `unclaimDeviceAsync` should be used instead.\n"],null,["# unclaimDevice\n\nSynchronous request to unclaim a single device from a customer.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` class doesn't support this API. Use [`unclaimDeviceAsync`](/zero-touch/reseller-library/reference/methods/unclaimdevicesasync) instead.\n\nMethod signature\n----------------\n\n public void unclaimDevice(UnclaimDeviceRequest request) throws CommonException;\n\nUnclaimDeviceRequest\n--------------------\n\n| Property name | Value | Required | Description |\n|---------------|-------------------------|----------|-------------------------------------|\n| `unclaim` | `object(DeviceUnclaim)` | Yes | The device unclaim to be processed. |\n\nDeviceUnclaim\n-------------\n\nYou must specify `deviceId` **or** `deviceIdentifier`.\n\n| Property name | Value | Required | Description |\n|--------------------|---------------------------------------------------------------------------------------------------|----------|------------------------------------------------|\n| `deviceId` | `string` | No | The device ID. |\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](/zero-touch/reseller-library/reference/objects#deviceidentifier)`)` | No | The device identifier. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nError behavior\n--------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|--------------------------|\n| `AUTHORIZATION_FAIL` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |\n| `NOT_IMPLEMENTED` |"]]
