Lists/Searches DeviceUsers.
HTTP request
GET https://cloudidentity.googleapis.com/v1beta1/{parent=devices/*}/deviceUsers
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. To list all DeviceUsers, set this to "devices/-". To list all DeviceUsers owned by a device, set this to the resource name of the device. Format: devices/{device} |
Query parameters
Parameters | |
---|---|
customer |
Optional. Resource name of the customer. If you're using this API for your own organization, use |
filter |
Optional. Additional restrictions when fetching list of devices. For a list of search fields, refer to Mobile device search fields. Multiple search fields are separated by the space character. |
pageSize |
Optional. The maximum number of DeviceUsers to return. If unspecified, at most 5 DeviceUsers will be returned. The maximum value is 20; values above 20 will be coerced to 20. |
pageToken |
Optional. A page token, received from a previous When paginating, all other parameters provided to |
orderBy |
Optional. Order specification for devices in the response. |
Request body
The request body must be empty.
Response body
Response message that is returned from the deviceUsers.list method.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"deviceUsers": [
{
object ( |
Fields | |
---|---|
deviceUsers[] |
Devices meeting the list restrictions. |
nextPageToken |
Token to retrieve the next page of results. Empty if there are no more results. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud-identity.devices.readonly
https://www.googleapis.com/auth/cloud-identity.devices
https://www.googleapis.com/auth/cloud-identity
For more information, see the Authentication Overview.