Requires authorization
Lists all resources in a given deployment. Try it now.
Request
HTTP request
GET https://www.googleapis.com/deploymentmanager/v2beta2/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 |
Sets a filter expression for filtering listed resources, in the form
filter={expression} . Your {expression} must
be in the format: field_name comparison_string literal_string .
The field_name is the name of the field you want to compare.
Only atomic field types are supported (string, number, boolean). The
comparison_string must be either eq (equals) or
ne (not equals). The literal_string is 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
using RE2
syntax. 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 the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to
true . In particular, use filtering on nested fields to take
advantage of
instance labels
to 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 as AND expressions 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 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 )
|
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.