Cloud Deployment Manager will reach end of support onDecember 31, 2025. If you currently use Deployment Manager, please migrate to Infrastructure Manager or an alternative deployment technology by December 31, 2025 to ensure your services continue without interruption.
Lists all deployments for a given project.Try it now.
Request
HTTP request
GET https://www.googleapis.com/deploymentmanager/v2beta2/projects/project/global/deployments
Parameters
Parameter name
Value
Description
Path parameters
project
string
The project ID for this request.
Optional query parameters
filter
string
Sets a filter expression for filtering listed resources, in the formfilter={expression}. Your{expression}must
be in the format:field_name comparison_string literal_string.
Thefield_nameis the name of the field you want to compare.
Only atomic field types are supported (string, number, boolean). Thecomparison_stringmust be eithereq(equals) orne(not equals). Theliteral_stringis the string
value to filter to. The literal value must be valid for the type of field
you are filtering by (string, number, boolean). For string fields, the
literal value is interpreted as a regular expression
usingRE2syntax. The literal value must match the entire field.
For example,filter=name ne example-instance.
Compute Engine Beta API Only:If you use filtering in theBeta API, you can also filter
on nested fields. For example, you could filter on instances that have
set thescheduling.automaticRestartfield totrue. In particular, use filtering on nested fields to take
advantage ofinstance labelsto organize and filter results based on label values.
The Beta API also supports filtering on multiple expressions by providing
each separate expression within parentheses.
For example,(scheduling.automaticRestart eq true) (zone eq us-central1-f).
Multiple expressions are treated asANDexpressions meaning
that resources must match all expressions to pass the filters.
maxResults
unsigned integer
The maximum number of results per page that should be returned.
If the number of available results is larger thanmaxResults,
Compute Engine returns anextPageTokenthat can be used to get
the next page of results in subsequent list requests.
Acceptable values are0to500, inclusive.
(Default:500)
pageToken
string
Specifies a page token to use. SetpageTokento thenextPageTokenreturned by a previous list request to get
the next page of results.
[[["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-04-30 UTC."],[[["\u003cp\u003eThis API version is deprecated; users should switch to the latest API version available at the provided link.\u003c/p\u003e\n"],["\u003cp\u003eThis API endpoint lists all deployments for a specific project, and it requires authorization with one of the listed scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe API request is a \u003ccode\u003eGET\u003c/code\u003e request to the specified URL, and it includes path and optional query parameters for customization.\u003c/p\u003e\n"],["\u003cp\u003eUsers can filter listed resources using a filter expression with \u003ccode\u003eeq\u003c/code\u003e (equals) or \u003ccode\u003ene\u003c/code\u003e (not equals) operators on atomic fields or nested fields in the beta version.\u003c/p\u003e\n"],["\u003cp\u003eThe response to the API request includes a list of deployments and a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results.\u003c/p\u003e\n"]]],[],null,["# Deployments: list\n\n**Caution:** This is a **deprecated** version of the Deployment Manager API. Please use the [latest API version](/deployment-manager/latest) instead.\n\n\n**Requires [authorization](#auth)**\n\nLists all deployments for a given project.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/deploymentmanager/v2beta2/projects/project/global/deployments\n```\n\n### Parameters\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/deployment-manager/docs/reference/latest/authorization)).\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"deployments\": [\n deployments Resource\n ],\n \"nextPageToken\": string\n}\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/deploymentmanager/v2beta2/deploymentmanager.deployments.list)."]]