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:
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eThis document outlines the process for listing revisions of a deployment using a \u003ccode\u003eGET\u003c/code\u003e request to the specified URL: \u003ccode\u003ehttps://config.googleapis.com/v1/{parent=projects/*/locations/*/deployments/*}/revisions\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eparent\u003c/code\u003e path parameter that specifies the project, location, and deployment from which to list revisions, and it requires the IAM permission \u003ccode\u003econfig.revisions.list\u003c/code\u003e on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e can be utilized to manage the list of returned revisions, allowing control over pagination, filtering, and sorting.\u003c/p\u003e\n"],["\u003cp\u003eThe response to a successful request is structured as a JSON object containing a list of \u003ccode\u003erevisions\u003c/code\u003e, a \u003ccode\u003enextPageToken\u003c/code\u003e to continue pagination, and an \u003ccode\u003eunreachable\u003c/code\u003e list specifying locations that could not be reached.\u003c/p\u003e\n"],["\u003cp\u003eThe authorization for the request involves the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003econfig.googleapis.com/config.revisions.list\u003c/code\u003e IAM permission.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deployments.revisions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRevisionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nLists [Revision](/infrastructure-manager/docs/reference/rest/v1/projects.locations.deployments.revisions#Revision)s of a deployment.\n\n### HTTP request\n\n`GET https://config.googleapis.com/v1/{parent=projects/*/locations/*/deployments/*}/revisions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response to a 'revisions.list' call. Contains a list of Revisions.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `config.googleapis.com/config.revisions.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
