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:
[[["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 endpoint lists deployments within a specified project and location, using the format \u003ccode\u003eprojects/{project}/locations/{location}\u003c/code\u003e for the parent path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request utilizes HTTP GET method and supports filtering, pagination (using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e), and sorting (using \u003ccode\u003eorderBy\u003c/code\u003e) through query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003eDeployment\u003c/code\u003e objects, a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results, and a list of \u003ccode\u003eunreachable\u003c/code\u003e locations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003econfig.deployments.list\u003c/code\u003e IAM permission on the parent resource, and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the maximum value for \u003ccode\u003epageSize\u003c/code\u003e is 1000.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deployments.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.ListDeploymentsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nLists [Deployment](/infrastructure-manager/docs/reference/rest/v1/projects.locations.deployments#Deployment)s in a given project and location.\n\n### HTTP request\n\n`GET https://config.googleapis.com/v1/{parent=projects/*/locations/*}/deployments`\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\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.deployments.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]