Method: projects.locations.deployments.list

Lists Deployments in a given project and location.

HTTP request

GET https://config.googleapis.com/v1/{parent=projects/*/locations/*}/deployments

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent in whose context the Deployments are listed. The parent value is in the format: 'projects/{projectId}/locations/{location}'. It takes the form projects/{project}/locations/{location}.

Authorization requires the following IAM permission on the specified resource parent:

  • config.deployments.list

Query parameters

Parameters
pageSize

integer

When requesting a page of resources, 'pageSize' specifies number of resources to return. If unspecified, at most 500 will be returned. The maximum value is 1000.
pageToken

string

Token returned by previous call to 'deployments.list' which specifies the position in the list from where to continue listing the resources.
filter

string

Lists the Deployments that match the filter expression. A filter expression filters the resources listed in the response. The expression must be of the form '{field} {operator} {value}' where operators: '<', '>', '<=', '>=', '!=', '=', ':' are supported (colon ':' represents a HAS operator which is roughly synonymous with equality). {field} can refer to a proto or JSON field, or a synthetic field. Field names can be camelCase or snake_case.

Examples: - Filter by name: name = "projects/foo/locations/us-central1/deployments/bar

  • Filter by labels:
  • Resources that have a key called 'foo' labels.foo:*
  • Resources that have a key called 'foo' whose value is 'bar' labels.foo = bar

  • Filter by state:

  • Deployments in CREATING state. state=CREATING
orderBy

string

Field to use to sort the list.

Request body

The request body must be empty.

Response body

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

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

object (Deployment)

List of Deployments.
nextPageToken

string

Token to be supplied to the next deployments.list request via pageToken to obtain the next set of results.
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:

  • config.googleapis.com/config.deployments.list

For more information, see the IAM documentation.