Requires authorization
Lists all resources in a given deployment. Try it now .
Request
HTTP request
GET https://www.googleapis.com/deploymentmanager/v2/projects/ project /global/deployments/ deployment /resources
Parameters
Parameter name
Value
Description
Path parameters
deployment
string
The name of the deployment for this request.
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
For example, if you are filtering Compute Engine instances, you can exclude instances named
You can also filter nested fields. For example, you could specify
To filter on multiple expressions, provide each separate expression within parentheses. For example,
=
, !=
, >
, or <
.For example, if you are filtering Compute Engine instances, you can exclude instances named
example-instance
by specifying name != example-instance
.You can also filter nested fields. For example, you could specify
scheduling.automaticRestart = false
to include instances only
if they are not scheduled for automatic restarts. You can use filtering
on nested fields to filter based on resource 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 an AND
expression. However, you
can include AND
and OR
expressions 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 than
maxResults
,
Compute Engine returns a nextPageToken
that can be used to get
the next page of results in subsequent list requests. Acceptable values are 0
to 500
, 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 using
Currently, only sorting by
You can also sort results in descending order based on the creation timestamp using
orderBy="creationTimestamp desc"
. This sorts
results based on the creationTimestamp
field 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 by
name
or creationTimestamp desc
is supported.pageToken
string
Specifies a page token to use. Set
pageToken
to the nextPageToken
returned by a previous list request to get
the next page of results.Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
| Scope |
|---|
https://www.googleapis.com/auth/ndev.cloudman.readonly
|
https://www.googleapis.com/auth/cloud-platform
|
https://www.googleapis.com/auth/ndev.cloudman
|
https://www.googleapis.com/auth/cloud-platform.read-only
|
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{ "resources" : [ resources Resource ], "nextPageToken" : string }
| Property name | Value | Description | Notes |
|---|---|---|---|
resources[]
|
list
|
Resources contained in this list response. | |
nextPageToken
|
string
|
A token used to continue a truncated list request. |
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .
