Method: devices.create

Creates a device. Only company-owned device may be created.

Note: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium

HTTP request

POST https://cloudidentity.googleapis.com/v1beta1/devices

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{ "device" : { object ( `Device` ) } , "customer" : string }

Fields

Fields
`device`	`object ( Device )` Required. The device to be created. The name field within this device is ignored in the create method. A new name is created by the method, and returned within the response. Only the fields `deviceType` , `serialNumber` and `assetTag` (if present) are used to create the device. All other fields are ignored. The `deviceType` and `serialNumber` fields are required.
`customer`	`string` Optional. Resource name of the customer. If you're using this API for your own organization, use `customers/my_customer` If you're using this API to manage another organization, use `customers/{customerId}` , where customerId is the customer to whom the device belongs.

device

object ( Device )

Required. The device to be created. The name field within this device is ignored in the create method. A new name is created by the method, and returned within the response. Only the fields deviceType , serialNumber and assetTag (if present) are used to create the device. All other fields are ignored. The deviceType and serialNumber fields are required.

customer

string

Optional. Resource name of the customer. If you're using this API for your own organization, use customers/my_customer If you're using this API to manage another organization, use customers/{customerId} , where customerId is the customer to whom the device belongs.

Response body

If successful, the response body contains a newly created instance of Operation .

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/cloud-identity.devices
https://www.googleapis.com/auth/cloud-identity

For more information, see the Authorization guide .