Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / c72efbc6b71c963997c5728d471c04ab33d95e4f / . / docs / dyn / runtimeconfig_v1beta1.projects.configs.waiters.html
blob: ea9f4107131692b2e02f00d720010e522d62143b [file] [log] [blame]
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -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
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]75<h1><a href="runtimeconfig_v1beta1.html">Cloud Runtime Configuration API</a> . <a href="runtimeconfig_v1beta1.projects.html">projects</a> . <a href="runtimeconfig_v1beta1.projects.configs.html">configs</a> . <a href="runtimeconfig_v1beta1.projects.configs.waiters.html">waiters</a></h1>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]76<h2>Instance Methods</h2>
77<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]78 <code><a href="#create">create(parent, body=None, requestId=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]79<p class="firstline">Creates a Waiter resource. This operation returns a long-running Operation</p>
80<p class="toc_element">
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame]81 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]82<p class="firstline">Deletes the waiter with the specified name.</p>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]83<p class="toc_element">
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame]84 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]85<p class="firstline">Gets information about a single waiter.</p>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]86<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]87 <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]88<p class="firstline">List waiters within the given configuration.</p>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]89<p class="toc_element">
90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
91<p class="firstline">Retrieves the next page of results.</p>
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]92<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]93 <code><a href="#testIamPermissions">testIamPermissions(resource, body=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]94<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]95<h3>Method Details</h3>
96<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]97 <code class="details" id="create">create(parent, body=None, requestId=None, x__xgafv=None)</code>
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]98 <pre>Creates a Waiter resource. This operation returns a long-running Operation
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]99resource which can be polled for completion. However, a waiter with the
100given name will exist (and can be retrieved) prior to the operation
101completing. If the operation fails, the failed Waiter resource will
102still exist and must be deleted prior to subsequent creation attempts.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]103
104Args:
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]105 parent: string, The path to the configuration that will own the waiter.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]106The configuration must exist beforehand; the path must be in the format:
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]107
108`projects/[PROJECT_ID]/configs/[CONFIG_NAME]`. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]109 body: object, The request body.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]110 The object takes the form of:
111
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]112{ # A Waiter resource waits for some end condition within a RuntimeConfig
113 # resource to be met before it returns. For example, assume you have a
114 # distributed system where each node writes to a Variable resource indicating
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]115 # the node&#x27;s readiness as part of the startup process.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]116 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]117 # You then configure a Waiter resource with the success condition set to wait
118 # until some number of nodes have checked in. Afterwards, your application
119 # runs some arbitrary code after the condition has been met and the waiter
120 # returns successfully.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]121 #
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]122 # Once created, a Waiter resource is immutable.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]123 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]124 # To learn more about using waiters, read the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]125 # [Creating a
126 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]127 # documentation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]128 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # Output only. If the waiter ended due to a failure or timeout, this value
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]129 # will be set.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]130 # different programming environments, including REST APIs and RPC APIs. It is
131 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
132 # three pieces of data: error code, error message, and error details.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]133 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]134 # You can find out more about this error model and how to work with it in the
135 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]136 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]137 # message types for APIs to use.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]138 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]139 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]140 },
141 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]142 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
143 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
144 # user-facing error message should be localized and sent in the
145 # google.rpc.Status.details field, or localized by the client.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]146 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]147 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
148 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
149 # The failure condition takes precedence over the success condition. If both
150 # conditions are met, a failure will be indicated. This value is optional; if
151 # no failure condition is set, the only failure scenario will be a timeout.
152 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
153 # met when the number of variables under a specified path prefix reaches a
154 # predefined number. For example, if you set a Cardinality condition where
155 # the `path` is set to `/foo` and the number of paths is set to `2`, the
156 # following variables would meet the condition in a RuntimeConfig resource:
157 #
158 # + `/foo/variable1 = &quot;value1&quot;`
159 # + `/foo/variable2 = &quot;value2&quot;`
160 # + `/bar/variable3 = &quot;value3&quot;`
161 #
162 # It would not satisfy the same condition with the `number` set to
163 # `3`, however, because there is only 2 paths that start with `/foo`.
164 # Cardinality conditions are recursive; all subtrees under the specific
165 # path prefix are counted.
166 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
167 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
168 # condition. Defaults to 1 if not specified.
169 },
170 },
171 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
172 # set to `true` and the `error` value will remain unset. The failure
173 # condition takes precedence over the success condition. If both conditions
174 # are met, a failure will be indicated.
175 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
176 # met when the number of variables under a specified path prefix reaches a
177 # predefined number. For example, if you set a Cardinality condition where
178 # the `path` is set to `/foo` and the number of paths is set to `2`, the
179 # following variables would meet the condition in a RuntimeConfig resource:
180 #
181 # + `/foo/variable1 = &quot;value1&quot;`
182 # + `/foo/variable2 = &quot;value2&quot;`
183 # + `/bar/variable3 = &quot;value3&quot;`
184 #
185 # It would not satisfy the same condition with the `number` set to
186 # `3`, however, because there is only 2 paths that start with `/foo`.
187 # Cardinality conditions are recursive; all subtrees under the specific
188 # path prefix are counted.
189 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
190 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
191 # condition. Defaults to 1 if not specified.
192 },
193 },
194 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
195 # for one of its conditions to be met.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]196 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]197 # If true, the waiter has finished. If the waiter finished due to a timeout
198 # or failure, `error` will be set.
199 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The instant at which this Waiter resource was created. Adding
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]200 # the value of `timeout` to this instant yields the timeout deadline for the
201 # waiter.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]202 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
203 # the instant that `waiters().create` method is called. If this time elapses
204 # before the success or failure conditions are met, the waiter fails and sets
205 # the `error` code to `DEADLINE_EXCEEDED`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]206 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
207 #
208 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
209 #
210 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
211 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
212 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
213 # of `[WAITER_NAME]` must be less than 64 bytes.
214 #
215 # After you create a Waiter resource, you cannot change the resource name.
216 }
217
218 requestId: string, An optional but recommended unique `request_id`. If the server
219receives two `create()` requests with the same
220`request_id`, then the second request will be ignored and the
221first resource created and stored in the backend is returned.
222Empty `request_id` fields are ignored.
223
224It is responsibility of the client to ensure uniqueness of the
225`request_id` strings.
226
227`request_id` strings are limited to 64 characters.
228 x__xgafv: string, V1 error format.
229 Allowed values
230 1 - v1 error format
231 2 - v2 error format
232
233Returns:
234 An object of the form:
235
236 { # This resource represents a long-running operation that is the result of a
237 # network API call.
238 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
239 # contains progress information and common metadata such as create time.
240 # Some services might not provide such metadata. Any method that returns a
241 # long-running operation should document the metadata type, if any.
242 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
243 },
244 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
245 # If `true`, the operation is completed, and either `error` or `response` is
246 # available.
247 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
248 # method returns no data on success, such as `Delete`, the response is
249 # `google.protobuf.Empty`. If the original method is standard
250 # `Get`/`Create`/`Update`, the response should be the resource. For other
251 # methods, the response should have the type `XxxResponse`, where `Xxx`
252 # is the original method name. For example, if the original method name
253 # is `TakeSnapshot()`, the inferred response type is
254 # `TakeSnapshotResponse`.
255 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
256 },
257 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
258 # originally returns it. If you use the default HTTP mapping, the
259 # `name` should be a resource name ending with `operations/{unique_id}`.
260 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
261 # different programming environments, including REST APIs and RPC APIs. It is
262 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
263 # three pieces of data: error code, error message, and error details.
264 #
265 # You can find out more about this error model and how to work with it in the
266 # [API Design Guide](https://cloud.google.com/apis/design/errors).
267 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
268 # message types for APIs to use.
269 {
270 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
271 },
272 ],
273 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
274 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
275 # user-facing error message should be localized and sent in the
276 # google.rpc.Status.details field, or localized by the client.
277 },
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]278 }</pre>
279</div>
280
281<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]282 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
283 <pre>Deletes the waiter with the specified name.
284
285Args:
286 name: string, The Waiter resource to delete, in the format:
287
288 `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
289 x__xgafv: string, V1 error format.
290 Allowed values
291 1 - v1 error format
292 2 - v2 error format
293
294Returns:
295 An object of the form:
296
297 { # A generic empty message that you can re-use to avoid defining duplicated
298 # empty messages in your APIs. A typical example is to use it as the request
299 # or the response type of an API method. For instance:
300 #
301 # service Foo {
302 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
303 # }
304 #
305 # The JSON representation for `Empty` is empty JSON object `{}`.
306 }</pre>
307</div>
308
309<div class="method">
310 <code class="details" id="get">get(name, x__xgafv=None)</code>
311 <pre>Gets information about a single waiter.
312
313Args:
314 name: string, The fully-qualified name of the Waiter resource object to retrieve, in the
315format:
316
317`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
318 x__xgafv: string, V1 error format.
319 Allowed values
320 1 - v1 error format
321 2 - v2 error format
322
323Returns:
324 An object of the form:
325
326 { # A Waiter resource waits for some end condition within a RuntimeConfig
327 # resource to be met before it returns. For example, assume you have a
328 # distributed system where each node writes to a Variable resource indicating
329 # the node&#x27;s readiness as part of the startup process.
330 #
331 # You then configure a Waiter resource with the success condition set to wait
332 # until some number of nodes have checked in. Afterwards, your application
333 # runs some arbitrary code after the condition has been met and the waiter
334 # returns successfully.
335 #
336 # Once created, a Waiter resource is immutable.
337 #
338 # To learn more about using waiters, read the
339 # [Creating a
340 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
341 # documentation.
342 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # Output only. If the waiter ended due to a failure or timeout, this value
343 # will be set.
344 # different programming environments, including REST APIs and RPC APIs. It is
345 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
346 # three pieces of data: error code, error message, and error details.
347 #
348 # You can find out more about this error model and how to work with it in the
349 # [API Design Guide](https://cloud.google.com/apis/design/errors).
350 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
351 # message types for APIs to use.
352 {
353 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
354 },
355 ],
356 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
357 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
358 # user-facing error message should be localized and sent in the
359 # google.rpc.Status.details field, or localized by the client.
360 },
361 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
362 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
363 # The failure condition takes precedence over the success condition. If both
364 # conditions are met, a failure will be indicated. This value is optional; if
365 # no failure condition is set, the only failure scenario will be a timeout.
366 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
367 # met when the number of variables under a specified path prefix reaches a
368 # predefined number. For example, if you set a Cardinality condition where
369 # the `path` is set to `/foo` and the number of paths is set to `2`, the
370 # following variables would meet the condition in a RuntimeConfig resource:
371 #
372 # + `/foo/variable1 = &quot;value1&quot;`
373 # + `/foo/variable2 = &quot;value2&quot;`
374 # + `/bar/variable3 = &quot;value3&quot;`
375 #
376 # It would not satisfy the same condition with the `number` set to
377 # `3`, however, because there is only 2 paths that start with `/foo`.
378 # Cardinality conditions are recursive; all subtrees under the specific
379 # path prefix are counted.
380 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
381 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
382 # condition. Defaults to 1 if not specified.
383 },
384 },
385 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
386 # set to `true` and the `error` value will remain unset. The failure
387 # condition takes precedence over the success condition. If both conditions
388 # are met, a failure will be indicated.
389 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
390 # met when the number of variables under a specified path prefix reaches a
391 # predefined number. For example, if you set a Cardinality condition where
392 # the `path` is set to `/foo` and the number of paths is set to `2`, the
393 # following variables would meet the condition in a RuntimeConfig resource:
394 #
395 # + `/foo/variable1 = &quot;value1&quot;`
396 # + `/foo/variable2 = &quot;value2&quot;`
397 # + `/bar/variable3 = &quot;value3&quot;`
398 #
399 # It would not satisfy the same condition with the `number` set to
400 # `3`, however, because there is only 2 paths that start with `/foo`.
401 # Cardinality conditions are recursive; all subtrees under the specific
402 # path prefix are counted.
403 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
404 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
405 # condition. Defaults to 1 if not specified.
406 },
407 },
408 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
409 # for one of its conditions to be met.
410 #
411 # If true, the waiter has finished. If the waiter finished due to a timeout
412 # or failure, `error` will be set.
413 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The instant at which this Waiter resource was created. Adding
414 # the value of `timeout` to this instant yields the timeout deadline for the
415 # waiter.
416 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
417 # the instant that `waiters().create` method is called. If this time elapses
418 # before the success or failure conditions are met, the waiter fails and sets
419 # the `error` code to `DEADLINE_EXCEEDED`.
420 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
421 #
422 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
423 #
424 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
425 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
426 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
427 # of `[WAITER_NAME]` must be less than 64 bytes.
428 #
429 # After you create a Waiter resource, you cannot change the resource name.
430 }</pre>
431</div>
432
433<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]434 <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]435 <pre>List waiters within the given configuration.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]436
437Args:
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]438 parent: string, The path to the configuration for which you want to get a list of waiters.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]439The configuration must exist beforehand; the path must be in the format:
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]440
441`projects/[PROJECT_ID]/configs/[CONFIG_NAME]` (required)
442 pageToken: string, Specifies a page token to use. Set `pageToken` to a `nextPageToken`
443returned by a previous list request to get the next page of results.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]444 pageSize: integer, Specifies the number of results to return per page. If there are fewer
445elements than the specified number, returns all elements.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]446 x__xgafv: string, V1 error format.
447 Allowed values
448 1 - v1 error format
449 2 - v2 error format
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]450
451Returns:
452 An object of the form:
453
454 { # Response for the `ListWaiters()` method.
455 # Order of returned waiter objects is arbitrary.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]456 &quot;nextPageToken&quot;: &quot;A String&quot;, # This token allows you to get the next page of results for list requests.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]457 # If the number of results is larger than `pageSize`, use the `nextPageToken`
458 # as a value for the query parameter `pageToken` in the next list request.
459 # Subsequent list requests will have their own `nextPageToken` to continue
460 # paging through the results
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]461 &quot;waiters&quot;: [ # Found waiters in the project.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]462 { # A Waiter resource waits for some end condition within a RuntimeConfig
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]463 # resource to be met before it returns. For example, assume you have a
464 # distributed system where each node writes to a Variable resource indicating
465 # the node&#x27;s readiness as part of the startup process.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]466 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]467 # You then configure a Waiter resource with the success condition set to wait
468 # until some number of nodes have checked in. Afterwards, your application
469 # runs some arbitrary code after the condition has been met and the waiter
470 # returns successfully.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]471 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]472 # Once created, a Waiter resource is immutable.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]473 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]474 # To learn more about using waiters, read the
475 # [Creating a
476 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
477 # documentation.
478 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # Output only. If the waiter ended due to a failure or timeout, this value
479 # will be set.
480 # different programming environments, including REST APIs and RPC APIs. It is
481 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
482 # three pieces of data: error code, error message, and error details.
483 #
484 # You can find out more about this error model and how to work with it in the
485 # [API Design Guide](https://cloud.google.com/apis/design/errors).
486 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
487 # message types for APIs to use.
488 {
489 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
490 },
491 ],
492 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
493 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
494 # user-facing error message should be localized and sent in the
495 # google.rpc.Status.details field, or localized by the client.
496 },
497 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
498 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
499 # The failure condition takes precedence over the success condition. If both
500 # conditions are met, a failure will be indicated. This value is optional; if
501 # no failure condition is set, the only failure scenario will be a timeout.
502 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
503 # met when the number of variables under a specified path prefix reaches a
504 # predefined number. For example, if you set a Cardinality condition where
505 # the `path` is set to `/foo` and the number of paths is set to `2`, the
506 # following variables would meet the condition in a RuntimeConfig resource:
507 #
508 # + `/foo/variable1 = &quot;value1&quot;`
509 # + `/foo/variable2 = &quot;value2&quot;`
510 # + `/bar/variable3 = &quot;value3&quot;`
511 #
512 # It would not satisfy the same condition with the `number` set to
513 # `3`, however, because there is only 2 paths that start with `/foo`.
514 # Cardinality conditions are recursive; all subtrees under the specific
515 # path prefix are counted.
516 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
517 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
518 # condition. Defaults to 1 if not specified.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]519 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]520 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]521 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
522 # set to `true` and the `error` value will remain unset. The failure
523 # condition takes precedence over the success condition. If both conditions
524 # are met, a failure will be indicated.
525 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
526 # met when the number of variables under a specified path prefix reaches a
527 # predefined number. For example, if you set a Cardinality condition where
528 # the `path` is set to `/foo` and the number of paths is set to `2`, the
529 # following variables would meet the condition in a RuntimeConfig resource:
530 #
531 # + `/foo/variable1 = &quot;value1&quot;`
532 # + `/foo/variable2 = &quot;value2&quot;`
533 # + `/bar/variable3 = &quot;value3&quot;`
534 #
535 # It would not satisfy the same condition with the `number` set to
536 # `3`, however, because there is only 2 paths that start with `/foo`.
537 # Cardinality conditions are recursive; all subtrees under the specific
538 # path prefix are counted.
539 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
540 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
541 # condition. Defaults to 1 if not specified.
542 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]543 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]544 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
545 # for one of its conditions to be met.
546 #
547 # If true, the waiter has finished. If the waiter finished due to a timeout
548 # or failure, `error` will be set.
549 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The instant at which this Waiter resource was created. Adding
550 # the value of `timeout` to this instant yields the timeout deadline for the
551 # waiter.
552 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
553 # the instant that `waiters().create` method is called. If this time elapses
554 # before the success or failure conditions are met, the waiter fails and sets
555 # the `error` code to `DEADLINE_EXCEEDED`.
556 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
557 #
558 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
559 #
560 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
561 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
562 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
563 # of `[WAITER_NAME]` must be less than 64 bytes.
564 #
565 # After you create a Waiter resource, you cannot change the resource name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]566 },
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]567 ],
568 }</pre>
569</div>
570
571<div class="method">
572 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
573 <pre>Retrieves the next page of results.
574
575Args:
576 previous_request: The request for the previous page. (required)
577 previous_response: The response from the request for the previous page. (required)
578
579Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]580 A request object that you can call &#x27;execute()&#x27; on to request the next
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]581 page. Returns None if there are no more items in the collection.
582 </pre>
583</div>
584
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]585<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]586 <code class="details" id="testIamPermissions">testIamPermissions(resource, body=None, x__xgafv=None)</code>
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]587 <pre>Returns permissions that a caller has on the specified resource.
588If the resource does not exist, this will return an empty set of
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]589permissions, not a `NOT_FOUND` error.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]590
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]591Note: This operation is designed to be used for building permission-aware
592UIs and command-line tools, not for authorization checking. This operation
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]593may &quot;fail open&quot; without warning.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]594
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]595Args:
596 resource: string, REQUIRED: The resource for which the policy detail is being requested.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]597See the operation documentation for the appropriate value for this field. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]598 body: object, The request body.
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400[diff] [blame]599 The object takes the form of:
600
601{ # Request message for `TestIamPermissions` method.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]602 &quot;permissions&quot;: [ # The set of permissions to check for the `resource`. Permissions with
603 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed. For more
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400[diff] [blame]604 # information see
605 # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]606 &quot;A String&quot;,
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400[diff] [blame]607 ],
608 }
609
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]610 x__xgafv: string, V1 error format.
611 Allowed values
612 1 - v1 error format
613 2 - v2 error format
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]614
615Returns:
616 An object of the form:
617
618 { # Response message for `TestIamPermissions` method.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]619 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]620 # allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]621 &quot;A String&quot;,
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]622 ],
623 }</pre>
624</div>
625
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]626</body></html>