Lists/Searches DeviceUsers.
HTTP request
GET https://cloudidentity.googleapis.com/v1/{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 .