با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
درخواست ناهمزمان برای لغو ادعای تا 100000 دستگاه برای یک یا چند مشتری.
روش‌های API ناهمزمان قبل از تکمیل پردازش، نتیجه را برمی‌گردانند. آنها همچنین به برنامه (یا ابزار) شما کمک می کنند تا زمانی که کاربران منتظر تکمیل یک عملیات طولانی مدت هستند، پاسخگو باقی بماند. برنامه شما باید getOperation صدا کند تا وضعیت عملکرد را به صورت دوره ای بررسی کند.
فیلدهای اضافی، جفت کلید-مقدار مشخص شده توسط فروشنده. توجه: درخواست‌های کلاس ResellerService ایجاد شده توسط SamsungResellerServiceFactory باید یک customerId در vendorParams مشخص کنند.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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` |"]]
