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/v2/projects/project/global/deployments
Parameters
Parameter name
Value
Description
Path parameters
project
string
The project ID for this request.
Optional query parameters
filter
string
A filter expression that filters resources listed in
the response. The expression must specify the field name, a comparison
operator, and the value that you want to use for filtering. The value
must be a string, a number, or a boolean. The comparison operator
must be either=,!=,>, or<.
For example, if you are filtering Compute Engine instances, you can
exclude instances namedexample-instanceby specifyingname != example-instance.
You can also filter nested fields. For example, you could specifyscheduling.automaticRestart = falseto include instances only
if they are not scheduled for automatic restarts. You can use filtering
on nested fields to filter based onresource labels.
To filter on multiple expressions, provide each separate expression within
parentheses. For example,(scheduling.automaticRestart = true)
(cpuPlatform = "Intel Skylake").
By default, each expression is anANDexpression. However, you
can includeANDandORexpressions explicitly.
For example,(cpuPlatform = "Intel Skylake") OR
(cpuPlatform = "Intel Broadwell") AND
(scheduling.automaticRestart = true).
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)
orderBy
string
Sorts list results by a certain order. By default, results
are returned in alphanumerical order based on the resource name.
You can also sort results in descending order based on the creation
timestamp usingorderBy="creationTimestamp desc". This sorts
results based on thecreationTimestampfield in
reverse chronological order (newest result first). Use this to sort
resources like operations so that the newest operation is returned first.
Currently, only sorting bynameorcreationTimestamp descis supported.
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 endpoint retrieves a list of all deployments for a specified project.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization, and it supports several scopes including read-only and cloud platform access.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the listed resources using various criteria, like resource name or nested fields, employing comparison operators and boolean logic.\u003c/p\u003e\n"],["\u003cp\u003eThe number of returned results can be controlled via the \u003ccode\u003emaxResults\u003c/code\u003e parameter and the returned \u003ccode\u003enextPageToken\u003c/code\u003e can be used for pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe results can be sorted by the name or creation timestamp of the resources, and no request body should be provided with this method.\u003c/p\u003e\n"]]],[],null,["# Deployments: list\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/v2/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/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/v2/deploymentmanager.deployments.list)."]]