Unclaim Async

Unclaims a batch of devices for a customer asynchronously

12 variables
11 variables

Unclaims a batch of devices for a customer asynchronously. Removes the devices from zero-touch enrollment. To learn more, read Long‑running batch operations

Input

This building block consumes 12 input parameters

  = Parameter name
  = Format

partnerId INTEGER Required

Required. The reseller partner ID

unclaims[] OBJECT

Identifies one unclaim request

unclaims[].deviceId INTEGER

Device ID of the device

unclaims[].deviceIdentifier OBJECT

Encapsulates hardware and product IDs to identify a manufactured device. To understand requirements on identifier sets, read Identifiers

unclaims[].deviceIdentifier.meid STRING

The device’s MEID number

unclaims[].deviceIdentifier.manufacturer STRING

The device manufacturer’s name. Matches the device's built-in value returned from android.os.Build.MANUFACTURER. Allowed values are listed in manufacturers

unclaims[].deviceIdentifier.serialNumber STRING

The manufacturer's serial number for the device. This value might not be unique across different device models

unclaims[].deviceIdentifier.model STRING

The device model's name. Matches the device's built-in value returned from android.os.Build.MODEL. Allowed values are listed in models

unclaims[].deviceIdentifier.imei STRING

The device’s IMEI number. Validated on input

unclaims[].sectionType ENUMERATION

Required. The section type of the device's provisioning record

unclaims[].vacationModeDays INTEGER

The duration of the vacation unlock starting from when the request is processed. (1 day is treated as 24 hours)

unclaims[].vacationModeExpireTime ANY

The expiration time of the vacation unlock

Output

This building block provides 11 output parameters

  = Parameter name
  = Format

response OBJECT

This field will contain a DevicesLongRunningOperationResponse object if the operation is created by claimAsync, unclaimAsync, or updateMetadataAsync

response.customKey.value ANY

This field will contain a DevicesLongRunningOperationResponse object if the operation is created by claimAsync, unclaimAsync, or updateMetadataAsync

name STRING

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}

error OBJECT

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

You can find out more about this error model and how to work with it in the API Design Guide

error.code INTEGER

The status code, which should be an enum value of google.rpc.Code

error.message STRING

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client

error.details[] OBJECT

error.details[].customKey.value ANY

metadata OBJECT

This field will contain a DevicesLongRunningOperationMetadata object if the operation is created by claimAsync, unclaimAsync, or updateMetadataAsync

metadata.customKey.value ANY

This field will contain a DevicesLongRunningOperationMetadata object if the operation is created by claimAsync, unclaimAsync, or updateMetadataAsync

done BOOLEAN

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available