Method: partners.devices.unclaimAsync
Unclaims a batch of devices for a customer asynchronously. Removes the devices from zero-touch enrollment. To learn more, read Long‑running batch operations.
HTTP request
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:unclaimAsync
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
partnerId |
string (int64 format)
Required. The reseller partner ID.
|
Request body
The request body contains data with the following structure:
| Fields |
unclaims[] |
object (PartnerUnclaim)
Required. The list of devices to unclaim.
|
Response body
If successful, the response body contains an instance of Operation.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/androidworkprovisioning
For more information, see the OAuth 2.0 Overview.
PartnerUnclaim
Identifies one unclaim request.
| JSON representation |
{
"sectionType": enum (DeviceProvisioningSectionType),
// Union field device can be only one of the following:
"deviceIdentifier": {
object (DeviceIdentifier)
},
"deviceId": string
// End of list of possible types for union field device.
} |
| Fields |
sectionType |
enum (DeviceProvisioningSectionType)
Required. The section type of the device's provisioning record.
|
Union field device. The device to unclaim. device can be only one of the following: |
deviceIdentifier |
object (DeviceIdentifier)
Required. Device identifier of the device.
|
deviceId |
string (int64 format)
Required. Device ID of the device.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-07 UTC.
[null,null,["Last updated 2024-08-07 UTC."],[[["This endpoint facilitates the asynchronous unclaiming of a batch of devices for a customer, effectively removing them from zero-touch enrollment."],["The HTTP request to unclaim devices is a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:unclaimAsync`, utilizing gRPC Transcoding syntax."],["The request requires a `partnerId` path parameter, representing the reseller partner ID, and the request body contains a list of `unclaims`, each specifying a device to be unclaimed."],["The `PartnerUnclaim` object uses a union field `device` that accepts either a `deviceIdentifier` or a `deviceId` to specify which device should be unclaimed, along with the `sectionType` of the device."],["The endpoint requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope and returns an instance of `Operation` upon successful completion."]]],["This describes how to unclaim devices from zero-touch enrollment asynchronously via a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:unclaimAsync`. The request requires a `partnerId` path parameter and a JSON body containing an array of `unclaims`. Each unclaim specifies a device by either `deviceIdentifier` or `deviceId`, and its `sectionType`. Successful requests return an `Operation`. Authorization needs the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope.\n"]]