Method: projects.locations.deployments.revisions.list

Lists Revisions of a deployment.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

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

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

  • config.revisions.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 'revisions.list' which specifies the position in the list from where to continue listing the resources.

filter

string

Lists the Revisions 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/dep/revisions/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:

  • Revisions in CREATING state. state=CREATING
orderBy

string

Field to use to sort the list.

Request body

The request body must be empty.

Response body

A response to a 'revisions.list' call. Contains a list of Revisions.

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

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

object (Revision)

List of Revisions.

nextPageToken

string

A token to request the next page of resources from the 'revisions.list' method. The value of an empty string means that there are no more resources to return.

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.revisions.list

For more information, see the IAM documentation.