Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / b8458c0b73030155b64a3c2392b2f70e5fbc3baf / . / docs / dyn / runtimeconfig_v1beta1.projects.configs.waiters.html
blob: 964c842d3a21f403683f76e90c8acf2011f462be [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
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]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.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]116 #
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.
121 #
122 # Once created, a Waiter resource is immutable.
123 #
124 # To learn more about using waiters, read the
125 # [Creating a
126 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
127 # documentation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]128 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]129 #
130 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
131 #
132 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
133 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
134 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
135 # of `[WAITER_NAME]` must be less than 64 bytes.
136 #
137 # After you create a Waiter resource, you cannot change the resource name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]138 &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
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]139 # will be set.
140 # different programming environments, including REST APIs and RPC APIs. It is
141 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
142 # three pieces of data: error code, error message, and error details.
143 #
144 # You can find out more about this error model and how to work with it in the
145 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]146 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]147 # message types for APIs to use.
148 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]149 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]150 },
151 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]152 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
153 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
154 # user-facing error message should be localized and sent in the
155 # google.rpc.Status.details field, or localized by the client.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]156 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]157 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
158 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
159 # The failure condition takes precedence over the success condition. If both
160 # conditions are met, a failure will be indicated. This value is optional; if
161 # no failure condition is set, the only failure scenario will be a timeout.
162 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
163 # met when the number of variables under a specified path prefix reaches a
164 # predefined number. For example, if you set a Cardinality condition where
165 # the `path` is set to `/foo` and the number of paths is set to `2`, the
166 # following variables would meet the condition in a RuntimeConfig resource:
167 #
168 # + `/foo/variable1 = &quot;value1&quot;`
169 # + `/foo/variable2 = &quot;value2&quot;`
170 # + `/bar/variable3 = &quot;value3&quot;`
171 #
172 # It would not satisfy the same condition with the `number` set to
173 # `3`, however, because there is only 2 paths that start with `/foo`.
174 # Cardinality conditions are recursive; all subtrees under the specific
175 # path prefix are counted.
176 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
177 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
178 # condition. Defaults to 1 if not specified.
179 },
180 },
181 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
182 # set to `true` and the `error` value will remain unset. The failure
183 # condition takes precedence over the success condition. If both conditions
184 # are met, a failure will be indicated.
185 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
186 # met when the number of variables under a specified path prefix reaches a
187 # predefined number. For example, if you set a Cardinality condition where
188 # the `path` is set to `/foo` and the number of paths is set to `2`, the
189 # following variables would meet the condition in a RuntimeConfig resource:
190 #
191 # + `/foo/variable1 = &quot;value1&quot;`
192 # + `/foo/variable2 = &quot;value2&quot;`
193 # + `/bar/variable3 = &quot;value3&quot;`
194 #
195 # It would not satisfy the same condition with the `number` set to
196 # `3`, however, because there is only 2 paths that start with `/foo`.
197 # Cardinality conditions are recursive; all subtrees under the specific
198 # path prefix are counted.
199 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
200 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
201 # condition. Defaults to 1 if not specified.
202 },
203 },
204 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
205 # for one of its conditions to be met.
206 #
207 # If true, the waiter has finished. If the waiter finished due to a timeout
208 # or failure, `error` will be set.
209 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The instant at which this Waiter resource was created. Adding
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]210 # the value of `timeout` to this instant yields the timeout deadline for the
211 # waiter.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]212 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
213 # the instant that `waiters().create` method is called. If this time elapses
214 # before the success or failure conditions are met, the waiter fails and sets
215 # the `error` code to `DEADLINE_EXCEEDED`.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]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.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]238 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
239 # originally returns it. If you use the default HTTP mapping, the
240 # `name` should be a resource name ending with `operations/{unique_id}`.
241 &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.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]242 # different programming environments, including REST APIs and RPC APIs. It is
243 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
244 # three pieces of data: error code, error message, and error details.
245 #
246 # You can find out more about this error model and how to work with it in the
247 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]248 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]249 # message types for APIs to use.
250 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]251 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]252 },
253 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]254 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
255 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
256 # user-facing error message should be localized and sent in the
257 # google.rpc.Status.details field, or localized by the client.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]258 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]259 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
260 # contains progress information and common metadata such as create time.
261 # Some services might not provide such metadata. Any method that returns a
262 # long-running operation should document the metadata type, if any.
263 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
264 },
265 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]266 # If `true`, the operation is completed, and either `error` or `response` is
267 # available.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]268 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]269 # method returns no data on success, such as `Delete`, the response is
270 # `google.protobuf.Empty`. If the original method is standard
271 # `Get`/`Create`/`Update`, the response should be the resource. For other
272 # methods, the response should have the type `XxxResponse`, where `Xxx`
273 # is the original method name. For example, if the original method name
274 # is `TakeSnapshot()`, the inferred response type is
275 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]276 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]277 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]278 }</pre>
279</div>
280
281<div class="method">
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
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]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
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]329 # the node&#x27;s readiness as part of the startup process.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]330 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]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.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]335 #
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]336 # Once created, a Waiter resource is immutable.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]337 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]338 # To learn more about using waiters, read the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]339 # [Creating a
340 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]341 # documentation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]342 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]343 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]344 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]345 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]346 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
347 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
348 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
349 # of `[WAITER_NAME]` must be less than 64 bytes.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]350 #
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]351 # After you create a Waiter resource, you cannot change the resource name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]352 &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]353 # will be set.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]354 # different programming environments, including REST APIs and RPC APIs. It is
355 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
356 # three pieces of data: error code, error message, and error details.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]357 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]358 # You can find out more about this error model and how to work with it in the
359 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]360 &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]361 # message types for APIs to use.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]362 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]363 &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]364 },
365 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]366 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
367 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
368 # user-facing error message should be localized and sent in the
369 # google.rpc.Status.details field, or localized by the client.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]370 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]371 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
372 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
373 # The failure condition takes precedence over the success condition. If both
374 # conditions are met, a failure will be indicated. This value is optional; if
375 # no failure condition is set, the only failure scenario will be a timeout.
376 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
377 # met when the number of variables under a specified path prefix reaches a
378 # predefined number. For example, if you set a Cardinality condition where
379 # the `path` is set to `/foo` and the number of paths is set to `2`, the
380 # following variables would meet the condition in a RuntimeConfig resource:
381 #
382 # + `/foo/variable1 = &quot;value1&quot;`
383 # + `/foo/variable2 = &quot;value2&quot;`
384 # + `/bar/variable3 = &quot;value3&quot;`
385 #
386 # It would not satisfy the same condition with the `number` set to
387 # `3`, however, because there is only 2 paths that start with `/foo`.
388 # Cardinality conditions are recursive; all subtrees under the specific
389 # path prefix are counted.
390 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
391 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
392 # condition. Defaults to 1 if not specified.
393 },
394 },
395 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
396 # set to `true` and the `error` value will remain unset. The failure
397 # condition takes precedence over the success condition. If both conditions
398 # are met, a failure will be indicated.
399 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
400 # met when the number of variables under a specified path prefix reaches a
401 # predefined number. For example, if you set a Cardinality condition where
402 # the `path` is set to `/foo` and the number of paths is set to `2`, the
403 # following variables would meet the condition in a RuntimeConfig resource:
404 #
405 # + `/foo/variable1 = &quot;value1&quot;`
406 # + `/foo/variable2 = &quot;value2&quot;`
407 # + `/bar/variable3 = &quot;value3&quot;`
408 #
409 # It would not satisfy the same condition with the `number` set to
410 # `3`, however, because there is only 2 paths that start with `/foo`.
411 # Cardinality conditions are recursive; all subtrees under the specific
412 # path prefix are counted.
413 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
414 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
415 # condition. Defaults to 1 if not specified.
416 },
417 },
418 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
419 # for one of its conditions to be met.
420 #
421 # If true, the waiter has finished. If the waiter finished due to a timeout
422 # or failure, `error` will be set.
423 &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]424 # the value of `timeout` to this instant yields the timeout deadline for the
425 # waiter.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]426 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
427 # the instant that `waiters().create` method is called. If this time elapses
428 # before the success or failure conditions are met, the waiter fails and sets
429 # the `error` code to `DEADLINE_EXCEEDED`.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]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
Dan O'Mearadd494642020-05-01 07:42:23 -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
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]465 # the node&#x27;s readiness as part of the startup process.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]466 #
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.
471 #
472 # Once created, a Waiter resource is immutable.
473 #
474 # To learn more about using waiters, read the
475 # [Creating a
476 # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
477 # documentation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]478 &quot;name&quot;: &quot;A String&quot;, # The name of the Waiter resource, in the format:
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]479 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]480 # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]481 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]482 # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
483 # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
484 # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
485 # of `[WAITER_NAME]` must be less than 64 bytes.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]486 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]487 # After you create a Waiter resource, you cannot change the resource name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]488 &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
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]489 # will be set.
490 # different programming environments, including REST APIs and RPC APIs. It is
491 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
492 # three pieces of data: error code, error message, and error details.
493 #
494 # You can find out more about this error model and how to work with it in the
495 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]496 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]497 # message types for APIs to use.
498 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]499 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]500 },
501 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]502 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
503 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
504 # user-facing error message should be localized and sent in the
505 # google.rpc.Status.details field, or localized by the client.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]506 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]507 &quot;failure&quot;: { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
508 # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
509 # The failure condition takes precedence over the success condition. If both
510 # conditions are met, a failure will be indicated. This value is optional; if
511 # no failure condition is set, the only failure scenario will be a timeout.
512 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
513 # met when the number of variables under a specified path prefix reaches a
514 # predefined number. For example, if you set a Cardinality condition where
515 # the `path` is set to `/foo` and the number of paths is set to `2`, the
516 # following variables would meet the condition in a RuntimeConfig resource:
517 #
518 # + `/foo/variable1 = &quot;value1&quot;`
519 # + `/foo/variable2 = &quot;value2&quot;`
520 # + `/bar/variable3 = &quot;value3&quot;`
521 #
522 # It would not satisfy the same condition with the `number` set to
523 # `3`, however, because there is only 2 paths that start with `/foo`.
524 # Cardinality conditions are recursive; all subtrees under the specific
525 # path prefix are counted.
526 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
527 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
528 # condition. Defaults to 1 if not specified.
529 },
530 },
531 &quot;success&quot;: { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
532 # set to `true` and the `error` value will remain unset. The failure
533 # condition takes precedence over the success condition. If both conditions
534 # are met, a failure will be indicated.
535 &quot;cardinality&quot;: { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
536 # met when the number of variables under a specified path prefix reaches a
537 # predefined number. For example, if you set a Cardinality condition where
538 # the `path` is set to `/foo` and the number of paths is set to `2`, the
539 # following variables would meet the condition in a RuntimeConfig resource:
540 #
541 # + `/foo/variable1 = &quot;value1&quot;`
542 # + `/foo/variable2 = &quot;value2&quot;`
543 # + `/bar/variable3 = &quot;value3&quot;`
544 #
545 # It would not satisfy the same condition with the `number` set to
546 # `3`, however, because there is only 2 paths that start with `/foo`.
547 # Cardinality conditions are recursive; all subtrees under the specific
548 # path prefix are counted.
549 &quot;path&quot;: &quot;A String&quot;, # The root of the variable subtree to monitor. For example, `/foo`.
550 &quot;number&quot;: 42, # The number variables under the `path` that must exist to meet this
551 # condition. Defaults to 1 if not specified.
552 },
553 },
554 &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the waiter is still waiting
555 # for one of its conditions to be met.
556 #
557 # If true, the waiter has finished. If the waiter finished due to a timeout
558 # or failure, `error` will be set.
559 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The instant at which this Waiter resource was created. Adding
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]560 # the value of `timeout` to this instant yields the timeout deadline for the
561 # waiter.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]562 &quot;timeout&quot;: &quot;A String&quot;, # [Required] Specifies the timeout of the waiter in seconds, beginning from
563 # the instant that `waiters().create` method is called. If this time elapses
564 # before the success or failure conditions are met, the waiter fails and sets
565 # the `error` code to `DEADLINE_EXCEEDED`.
Dan O'Mearadd494642020-05-01 07:42:23 -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>