Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / a527de24cda7c7d62a371203158fd5f617a1c08c / . / docs / dyn / deploymentmanager_v2.resources.html
blob: cf36dacf3f999a81ce285c82a926e1c486ca8682 [file] [log] [blame]
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="deploymentmanager_v2.html">Google Cloud Deployment Manager API</a> . <a href="deploymentmanager_v2.resources.html">resources</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#get">get(project, deployment, resource)</a></code></p>
79<p class="firstline">Gets information about a single resource.</p>
80<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]81 <code><a href="#list">list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None)</a></code></p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]82<p class="firstline">Lists all resources in a given deployment.</p>
83<p class="toc_element">
84 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="get">get(project, deployment, resource)</code>
89 <pre>Gets information about a single resource.
90
91Args:
92 project: string, The project ID for this request. (required)
93 deployment: string, The name of the deployment for this request. (required)
94 resource: string, The name of the resource for this request. (required)
95
96Returns:
97 An object of the form:
98
99 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]100 &quot;accessControl&quot;: { # The access controls set on the resource. # The Access Control Policy set on this resource.
101 &quot;gcpIamPolicy&quot;: &quot;A String&quot;, # The GCP IAM Policy to set on the resource.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]102 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]103 &quot;finalProperties&quot;: &quot;A String&quot;, # Output only. The evaluated properties of the resource with references expanded. Returned as serialized YAML.
104 &quot;id&quot;: &quot;A String&quot;,
105 &quot;insertTime&quot;: &quot;A String&quot;, # Output only. Creation timestamp in RFC3339 text format.
106 &quot;manifest&quot;: &quot;A String&quot;, # Output only. URL of the manifest representing the current configuration of this resource.
107 &quot;name&quot;: &quot;A String&quot;, # Output only. The name of the resource as it appears in the YAML config.
108 &quot;properties&quot;: &quot;A String&quot;, # Output only. The current properties of the resource before any references have been filled in. Returned as serialized YAML.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]109 &quot;type&quot;: &quot;A String&quot;, # Output only. The type of the resource, for example `compute.v1.instance`, or `cloudfunctions.v1beta1.function`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]110 &quot;update&quot;: { # Output only. If Deployment Manager is currently updating or previewing an update to this resource, the updated configuration appears here.
111 &quot;accessControl&quot;: { # The access controls set on the resource. # The Access Control Policy to set on this resource after updating the resource itself.
112 &quot;gcpIamPolicy&quot;: &quot;A String&quot;, # The GCP IAM Policy to set on the resource.
113 },
114 &quot;error&quot;: { # Output only. If errors are generated during update of the resource, this field will be populated.
115 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this operation.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]116 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]117 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
118 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error. This property is optional.
119 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]120 },
121 ],
122 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]123 &quot;finalProperties&quot;: &quot;A String&quot;, # Output only. The expanded properties of the resource with reference values expanded. Returned as serialized YAML.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]124 &quot;intent&quot;: &quot;A String&quot;, # Output only. The intent of the resource: `PREVIEW`, `UPDATE`, or `CANCEL`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]125 &quot;manifest&quot;: &quot;A String&quot;, # Output only. URL of the manifest representing the update configuration of this resource.
126 &quot;properties&quot;: &quot;A String&quot;, # Output only. The set of updated properties for this resource, before references are expanded. Returned as serialized YAML.
127 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the resource.
128 &quot;warnings&quot;: [ # Output only. If warning messages are generated during processing of this resource, this field will be populated.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]129 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]130 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
131 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key: value format. For example:
132 # &quot;data&quot;: [ { &quot;key&quot;: &quot;scope&quot;, &quot;value&quot;: &quot;zones/us-east1-d&quot; }
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]133 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]134 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
135 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]136 },
137 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]138 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]139 },
140 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]141 },
142 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Update timestamp in RFC3339 text format.
143 &quot;url&quot;: &quot;A String&quot;, # Output only. The URL of the actual resource.
144 &quot;warnings&quot;: [ # Output only. If warning messages are generated during processing of this resource, this field will be populated.
145 {
146 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
147 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key: value format. For example:
148 # &quot;data&quot;: [ { &quot;key&quot;: &quot;scope&quot;, &quot;value&quot;: &quot;zones/us-east1-d&quot; }
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]149 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]150 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
151 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]152 },
153 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]154 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]155 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]156 ],
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]157 }</pre>
158</div>
159
160<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]161 <code class="details" id="list">list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None)</code>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]162 <pre>Lists all resources in a given deployment.
163
164Args:
165 project: string, The project ID for this request. (required)
166 deployment: string, The name of the deployment for this request. (required)
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]167 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 `=`, `!=`, `&gt;`, or `&lt;`.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]168
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]169For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]170
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]171You 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.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]172
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]173To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = &quot;Intel Skylake&quot;) ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = &quot;Intel Skylake&quot;) OR (cpuPlatform = &quot;Intel Broadwell&quot;) AND (scheduling.automaticRestart = true) ```
174 maxResults: 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`)
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]175 orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
176
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]177You can also sort results in descending order based on the creation timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. 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.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]178
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]179Currently, only sorting by `name` or `creationTimestamp desc` is supported.
180 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.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]181
182Returns:
183 An object of the form:
184
185 { # A response containing a partial list of resources and a page token used to build the next request if the request has been truncated.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]186 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token used to continue a truncated list request.
187 &quot;resources&quot;: [ # Resources contained in this list response.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]188 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]189 &quot;accessControl&quot;: { # The access controls set on the resource. # The Access Control Policy set on this resource.
190 &quot;gcpIamPolicy&quot;: &quot;A String&quot;, # The GCP IAM Policy to set on the resource.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]191 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]192 &quot;finalProperties&quot;: &quot;A String&quot;, # Output only. The evaluated properties of the resource with references expanded. Returned as serialized YAML.
193 &quot;id&quot;: &quot;A String&quot;,
194 &quot;insertTime&quot;: &quot;A String&quot;, # Output only. Creation timestamp in RFC3339 text format.
195 &quot;manifest&quot;: &quot;A String&quot;, # Output only. URL of the manifest representing the current configuration of this resource.
196 &quot;name&quot;: &quot;A String&quot;, # Output only. The name of the resource as it appears in the YAML config.
197 &quot;properties&quot;: &quot;A String&quot;, # Output only. The current properties of the resource before any references have been filled in. Returned as serialized YAML.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]198 &quot;type&quot;: &quot;A String&quot;, # Output only. The type of the resource, for example `compute.v1.instance`, or `cloudfunctions.v1beta1.function`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]199 &quot;update&quot;: { # Output only. If Deployment Manager is currently updating or previewing an update to this resource, the updated configuration appears here.
200 &quot;accessControl&quot;: { # The access controls set on the resource. # The Access Control Policy to set on this resource after updating the resource itself.
201 &quot;gcpIamPolicy&quot;: &quot;A String&quot;, # The GCP IAM Policy to set on the resource.
202 },
203 &quot;error&quot;: { # Output only. If errors are generated during update of the resource, this field will be populated.
204 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this operation.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]205 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]206 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
207 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error. This property is optional.
208 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]209 },
210 ],
211 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]212 &quot;finalProperties&quot;: &quot;A String&quot;, # Output only. The expanded properties of the resource with reference values expanded. Returned as serialized YAML.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]213 &quot;intent&quot;: &quot;A String&quot;, # Output only. The intent of the resource: `PREVIEW`, `UPDATE`, or `CANCEL`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]214 &quot;manifest&quot;: &quot;A String&quot;, # Output only. URL of the manifest representing the update configuration of this resource.
215 &quot;properties&quot;: &quot;A String&quot;, # Output only. The set of updated properties for this resource, before references are expanded. Returned as serialized YAML.
216 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the resource.
217 &quot;warnings&quot;: [ # Output only. If warning messages are generated during processing of this resource, this field will be populated.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]218 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]219 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
220 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key: value format. For example:
221 # &quot;data&quot;: [ { &quot;key&quot;: &quot;scope&quot;, &quot;value&quot;: &quot;zones/us-east1-d&quot; }
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]222 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]223 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
224 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]225 },
226 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]227 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]228 },
229 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]230 },
231 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Update timestamp in RFC3339 text format.
232 &quot;url&quot;: &quot;A String&quot;, # Output only. The URL of the actual resource.
233 &quot;warnings&quot;: [ # Output only. If warning messages are generated during processing of this resource, this field will be populated.
234 {
235 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
236 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key: value format. For example:
237 # &quot;data&quot;: [ { &quot;key&quot;: &quot;scope&quot;, &quot;value&quot;: &quot;zones/us-east1-d&quot; }
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]238 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]239 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
240 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]241 },
242 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]243 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]244 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]245 ],
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]246 },
247 ],
248 }</pre>
249</div>
250
251<div class="method">
252 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
253 <pre>Retrieves the next page of results.
254
255Args:
256 previous_request: The request for the previous page. (required)
257 previous_response: The response from the request for the previous page. (required)
258
259Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]260 A request object that you can call &#x27;execute()&#x27; on to request the next
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]261 page. Returns None if there are no more items in the collection.
262 </pre>
263</div>
264
265</body></html>