Method: projects.locations.units.list

Retrieve a collection of units.

HTTP request

GET https://saasservicemgmt.googleapis.com/v1beta1/{parent=projects/*/locations/*}/units

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent of the unit.

Query parameters

Parameters
pageSize

integer

The maximum number of units to send per page.

pageToken

string

The page token: If the nextPageToken from a previous response is provided, this request will send the subsequent page.

filter

string

Filter the list as specified in https://google.aip.dev/160.

orderBy

string

Order results as specified in https://google.aip.dev/132.

Request body

The request body must be empty.

Response body

The response structure for the units.list method.

If successful, the response body contains data with the following structure:

JSON representation
{
  "units": [
    {
      object (Unit)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Fields
units[]

object (Unit)

The resulting units.

nextPageToken

string

If present, the next page token can be provided to a subsequent units.list call to list the next page. If empty, there are no more pages.

unreachable[]

string

Locations that could not be reached.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • saasservicemgmt.units.list

For more information, see the IAM documentation.