docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
index 964c842..ea9f410 100644
--- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
+++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
@@ -110,245 +110,21 @@
The object takes the form of:
{ # A Waiter resource waits for some end condition within a RuntimeConfig
- # resource to be met before it returns. For example, assume you have a
- # distributed system where each node writes to a Variable resource indicating
- # the node's readiness as part of the startup process.
- #
- # You then configure a Waiter resource with the success condition set to wait
- # until some number of nodes have checked in. Afterwards, your application
- # runs some arbitrary code after the condition has been met and the waiter
- # returns successfully.
- #
- # Once created, a Waiter resource is immutable.
- #
- # To learn more about using waiters, read the
- # [Creating a
- # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
- # documentation.
- "name": "A String", # The name of the Waiter resource, in the format:
- #
- # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
- #
- # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
- # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
- # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
- # of `[WAITER_NAME]` must be less than 64 bytes.
- #
- # After you create a Waiter resource, you cannot change the resource name.
- "error": { # 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
- # will be set.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- },
- "failure": { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
- # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
- # The failure condition takes precedence over the success condition. If both
- # conditions are met, a failure will be indicated. This value is optional; if
- # no failure condition is set, the only failure scenario will be a timeout.
- "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
- # met when the number of variables under a specified path prefix reaches a
- # predefined number. For example, if you set a Cardinality condition where
- # the `path` is set to `/foo` and the number of paths is set to `2`, the
- # following variables would meet the condition in a RuntimeConfig resource:
- #
- # + `/foo/variable1 = "value1"`
- # + `/foo/variable2 = "value2"`
- # + `/bar/variable3 = "value3"`
- #
- # It would not satisfy the same condition with the `number` set to
- # `3`, however, because there is only 2 paths that start with `/foo`.
- # Cardinality conditions are recursive; all subtrees under the specific
- # path prefix are counted.
- "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
- "number": 42, # The number variables under the `path` that must exist to meet this
- # condition. Defaults to 1 if not specified.
- },
- },
- "success": { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
- # set to `true` and the `error` value will remain unset. The failure
- # condition takes precedence over the success condition. If both conditions
- # are met, a failure will be indicated.
- "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
- # met when the number of variables under a specified path prefix reaches a
- # predefined number. For example, if you set a Cardinality condition where
- # the `path` is set to `/foo` and the number of paths is set to `2`, the
- # following variables would meet the condition in a RuntimeConfig resource:
- #
- # + `/foo/variable1 = "value1"`
- # + `/foo/variable2 = "value2"`
- # + `/bar/variable3 = "value3"`
- #
- # It would not satisfy the same condition with the `number` set to
- # `3`, however, because there is only 2 paths that start with `/foo`.
- # Cardinality conditions are recursive; all subtrees under the specific
- # path prefix are counted.
- "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
- "number": 42, # The number variables under the `path` that must exist to meet this
- # condition. Defaults to 1 if not specified.
- },
- },
- "done": True or False, # Output only. If the value is `false`, it means the waiter is still waiting
- # for one of its conditions to be met.
- #
- # If true, the waiter has finished. If the waiter finished due to a timeout
- # or failure, `error` will be set.
- "createTime": "A String", # Output only. The instant at which this Waiter resource was created. Adding
- # the value of `timeout` to this instant yields the timeout deadline for the
- # waiter.
- "timeout": "A String", # [Required] Specifies the timeout of the waiter in seconds, beginning from
- # the instant that `waiters().create` method is called. If this time elapses
- # before the success or failure conditions are met, the waiter fails and sets
- # the `error` code to `DEADLINE_EXCEEDED`.
-}
-
- requestId: string, An optional but recommended unique `request_id`. If the server
-receives two `create()` requests with the same
-`request_id`, then the second request will be ignored and the
-first resource created and stored in the backend is returned.
-Empty `request_id` fields are ignored.
-
-It is responsibility of the client to ensure uniqueness of the
-`request_id` strings.
-
-`request_id` strings are limited to 64 characters.
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # This resource represents a long-running operation that is the result of a
- # network API call.
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
- "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- },
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
- "response": { # The normal response of the operation in case of success. If the original
- # method returns no data on success, such as `Delete`, the response is
- # `google.protobuf.Empty`. If the original method is standard
- # `Get`/`Create`/`Update`, the response should be the resource. For other
- # methods, the response should have the type `XxxResponse`, where `Xxx`
- # is the original method name. For example, if the original method name
- # is `TakeSnapshot()`, the inferred response type is
- # `TakeSnapshotResponse`.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- }</pre>
-</div>
-
-<div class="method">
- <code class="details" id="delete">delete(name, x__xgafv=None)</code>
- <pre>Deletes the waiter with the specified name.
-
-Args:
- name: string, The Waiter resource to delete, in the format:
-
- `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # A generic empty message that you can re-use to avoid defining duplicated
- # empty messages in your APIs. A typical example is to use it as the request
- # or the response type of an API method. For instance:
- #
- # service Foo {
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
- }</pre>
-</div>
-
-<div class="method">
- <code class="details" id="get">get(name, x__xgafv=None)</code>
- <pre>Gets information about a single waiter.
-
-Args:
- name: string, The fully-qualified name of the Waiter resource object to retrieve, in the
-format:
-
-`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # A Waiter resource waits for some end condition within a RuntimeConfig
# resource to be met before it returns. For example, assume you have a
# distributed system where each node writes to a Variable resource indicating
# the node's readiness as part of the startup process.
- #
+ #
# You then configure a Waiter resource with the success condition set to wait
# until some number of nodes have checked in. Afterwards, your application
# runs some arbitrary code after the condition has been met and the waiter
# returns successfully.
- #
+ #
# Once created, a Waiter resource is immutable.
- #
+ #
# To learn more about using waiters, read the
# [Creating a
# Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
# documentation.
- "name": "A String", # The name of the Waiter resource, in the format:
- #
- # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
- #
- # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
- # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
- # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
- # of `[WAITER_NAME]` must be less than 64 bytes.
- #
- # After you create a Waiter resource, you cannot change the resource name.
"error": { # 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
# will be set.
# different programming environments, including REST APIs and RPC APIs. It is
@@ -417,7 +193,7 @@
},
"done": True or False, # Output only. If the value is `false`, it means the waiter is still waiting
# for one of its conditions to be met.
- #
+ #
# If true, the waiter has finished. If the waiter finished due to a timeout
# or failure, `error` will be set.
"createTime": "A String", # Output only. The instant at which this Waiter resource was created. Adding
@@ -427,10 +203,234 @@
# the instant that `waiters().create` method is called. If this time elapses
# before the success or failure conditions are met, the waiter fails and sets
# the `error` code to `DEADLINE_EXCEEDED`.
+ "name": "A String", # The name of the Waiter resource, in the format:
+ #
+ # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
+ #
+ # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
+ # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
+ # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
+ # of `[WAITER_NAME]` must be less than 64 bytes.
+ #
+ # After you create a Waiter resource, you cannot change the resource name.
+ }
+
+ requestId: string, An optional but recommended unique `request_id`. If the server
+receives two `create()` requests with the same
+`request_id`, then the second request will be ignored and the
+first resource created and stored in the backend is returned.
+Empty `request_id` fields are ignored.
+
+It is responsibility of the client to ensure uniqueness of the
+`request_id` strings.
+
+`request_id` strings are limited to 64 characters.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a
+ # network API call.
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
+ "response": { # The normal response of the operation in case of success. If the original
+ # method returns no data on success, such as `Delete`, the response is
+ # `google.protobuf.Empty`. If the original method is standard
+ # `Get`/`Create`/`Update`, the response should be the resource. For other
+ # methods, the response should have the type `XxxResponse`, where `Xxx`
+ # is the original method name. For example, if the original method name
+ # is `TakeSnapshot()`, the inferred response type is
+ # `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
+ "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ },
}</pre>
</div>
<div class="method">
+ <code class="details" id="delete">delete(name, x__xgafv=None)</code>
+ <pre>Deletes the waiter with the specified name.
+
+Args:
+ name: string, The Waiter resource to delete, in the format:
+
+ `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A generic empty message that you can re-use to avoid defining duplicated
+ # empty messages in your APIs. A typical example is to use it as the request
+ # or the response type of an API method. For instance:
+ #
+ # service Foo {
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ # }
+ #
+ # The JSON representation for `Empty` is empty JSON object `{}`.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="get">get(name, x__xgafv=None)</code>
+ <pre>Gets information about a single waiter.
+
+Args:
+ name: string, The fully-qualified name of the Waiter resource object to retrieve, in the
+format:
+
+`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]` (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A Waiter resource waits for some end condition within a RuntimeConfig
+ # resource to be met before it returns. For example, assume you have a
+ # distributed system where each node writes to a Variable resource indicating
+ # the node's readiness as part of the startup process.
+ #
+ # You then configure a Waiter resource with the success condition set to wait
+ # until some number of nodes have checked in. Afterwards, your application
+ # runs some arbitrary code after the condition has been met and the waiter
+ # returns successfully.
+ #
+ # Once created, a Waiter resource is immutable.
+ #
+ # To learn more about using waiters, read the
+ # [Creating a
+ # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
+ # documentation.
+ "error": { # 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
+ # will be set.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ },
+ "failure": { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
+ # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
+ # The failure condition takes precedence over the success condition. If both
+ # conditions are met, a failure will be indicated. This value is optional; if
+ # no failure condition is set, the only failure scenario will be a timeout.
+ "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
+ # met when the number of variables under a specified path prefix reaches a
+ # predefined number. For example, if you set a Cardinality condition where
+ # the `path` is set to `/foo` and the number of paths is set to `2`, the
+ # following variables would meet the condition in a RuntimeConfig resource:
+ #
+ # + `/foo/variable1 = "value1"`
+ # + `/foo/variable2 = "value2"`
+ # + `/bar/variable3 = "value3"`
+ #
+ # It would not satisfy the same condition with the `number` set to
+ # `3`, however, because there is only 2 paths that start with `/foo`.
+ # Cardinality conditions are recursive; all subtrees under the specific
+ # path prefix are counted.
+ "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
+ "number": 42, # The number variables under the `path` that must exist to meet this
+ # condition. Defaults to 1 if not specified.
+ },
+ },
+ "success": { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
+ # set to `true` and the `error` value will remain unset. The failure
+ # condition takes precedence over the success condition. If both conditions
+ # are met, a failure will be indicated.
+ "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
+ # met when the number of variables under a specified path prefix reaches a
+ # predefined number. For example, if you set a Cardinality condition where
+ # the `path` is set to `/foo` and the number of paths is set to `2`, the
+ # following variables would meet the condition in a RuntimeConfig resource:
+ #
+ # + `/foo/variable1 = "value1"`
+ # + `/foo/variable2 = "value2"`
+ # + `/bar/variable3 = "value3"`
+ #
+ # It would not satisfy the same condition with the `number` set to
+ # `3`, however, because there is only 2 paths that start with `/foo`.
+ # Cardinality conditions are recursive; all subtrees under the specific
+ # path prefix are counted.
+ "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
+ "number": 42, # The number variables under the `path` that must exist to meet this
+ # condition. Defaults to 1 if not specified.
+ },
+ },
+ "done": True or False, # Output only. If the value is `false`, it means the waiter is still waiting
+ # for one of its conditions to be met.
+ #
+ # If true, the waiter has finished. If the waiter finished due to a timeout
+ # or failure, `error` will be set.
+ "createTime": "A String", # Output only. The instant at which this Waiter resource was created. Adding
+ # the value of `timeout` to this instant yields the timeout deadline for the
+ # waiter.
+ "timeout": "A String", # [Required] Specifies the timeout of the waiter in seconds, beginning from
+ # the instant that `waiters().create` method is called. If this time elapses
+ # before the success or failure conditions are met, the waiter fails and sets
+ # the `error` code to `DEADLINE_EXCEEDED`.
+ "name": "A String", # The name of the Waiter resource, in the format:
+ #
+ # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
+ #
+ # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
+ # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
+ # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
+ # of `[WAITER_NAME]` must be less than 64 bytes.
+ #
+ # After you create a Waiter resource, you cannot change the resource name.
+ }</pre>
+</div>
+
+<div class="method">
<code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>List waiters within the given configuration.
@@ -460,110 +460,110 @@
# paging through the results
"waiters": [ # Found waiters in the project.
{ # A Waiter resource waits for some end condition within a RuntimeConfig
- # resource to be met before it returns. For example, assume you have a
- # distributed system where each node writes to a Variable resource indicating
- # the node's readiness as part of the startup process.
- #
- # You then configure a Waiter resource with the success condition set to wait
- # until some number of nodes have checked in. Afterwards, your application
- # runs some arbitrary code after the condition has been met and the waiter
- # returns successfully.
- #
- # Once created, a Waiter resource is immutable.
- #
- # To learn more about using waiters, read the
- # [Creating a
- # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
- # documentation.
- "name": "A String", # The name of the Waiter resource, in the format:
+ # resource to be met before it returns. For example, assume you have a
+ # distributed system where each node writes to a Variable resource indicating
+ # the node's readiness as part of the startup process.
#
- # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
+ # You then configure a Waiter resource with the success condition set to wait
+ # until some number of nodes have checked in. Afterwards, your application
+ # runs some arbitrary code after the condition has been met and the waiter
+ # returns successfully.
#
- # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
- # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
- # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
- # of `[WAITER_NAME]` must be less than 64 bytes.
+ # Once created, a Waiter resource is immutable.
#
- # After you create a Waiter resource, you cannot change the resource name.
- "error": { # 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
- # will be set.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ # To learn more about using waiters, read the
+ # [Creating a
+ # Waiter](/deployment-manager/runtime-configurator/creating-a-waiter)
+ # documentation.
+ "error": { # 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
+ # will be set.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ },
+ "failure": { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
+ # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
+ # The failure condition takes precedence over the success condition. If both
+ # conditions are met, a failure will be indicated. This value is optional; if
+ # no failure condition is set, the only failure scenario will be a timeout.
+ "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
+ # met when the number of variables under a specified path prefix reaches a
+ # predefined number. For example, if you set a Cardinality condition where
+ # the `path` is set to `/foo` and the number of paths is set to `2`, the
+ # following variables would meet the condition in a RuntimeConfig resource:
+ #
+ # + `/foo/variable1 = "value1"`
+ # + `/foo/variable2 = "value2"`
+ # + `/bar/variable3 = "value3"`
+ #
+ # It would not satisfy the same condition with the `number` set to
+ # `3`, however, because there is only 2 paths that start with `/foo`.
+ # Cardinality conditions are recursive; all subtrees under the specific
+ # path prefix are counted.
+ "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
+ "number": 42, # The number variables under the `path` that must exist to meet this
+ # condition. Defaults to 1 if not specified.
},
- ],
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- },
- "failure": { # The condition that a Waiter resource is waiting for. # [Optional] The failure condition of this waiter. If this condition is met,
- # `done` will be set to `true` and the `error` code will be set to `ABORTED`.
- # The failure condition takes precedence over the success condition. If both
- # conditions are met, a failure will be indicated. This value is optional; if
- # no failure condition is set, the only failure scenario will be a timeout.
- "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
- # met when the number of variables under a specified path prefix reaches a
- # predefined number. For example, if you set a Cardinality condition where
- # the `path` is set to `/foo` and the number of paths is set to `2`, the
- # following variables would meet the condition in a RuntimeConfig resource:
- #
- # + `/foo/variable1 = "value1"`
- # + `/foo/variable2 = "value2"`
- # + `/bar/variable3 = "value3"`
- #
- # It would not satisfy the same condition with the `number` set to
- # `3`, however, because there is only 2 paths that start with `/foo`.
- # Cardinality conditions are recursive; all subtrees under the specific
- # path prefix are counted.
- "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
- "number": 42, # The number variables under the `path` that must exist to meet this
- # condition. Defaults to 1 if not specified.
},
- },
- "success": { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
- # set to `true` and the `error` value will remain unset. The failure
- # condition takes precedence over the success condition. If both conditions
- # are met, a failure will be indicated.
- "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
- # met when the number of variables under a specified path prefix reaches a
- # predefined number. For example, if you set a Cardinality condition where
- # the `path` is set to `/foo` and the number of paths is set to `2`, the
- # following variables would meet the condition in a RuntimeConfig resource:
- #
- # + `/foo/variable1 = "value1"`
- # + `/foo/variable2 = "value2"`
- # + `/bar/variable3 = "value3"`
- #
- # It would not satisfy the same condition with the `number` set to
- # `3`, however, because there is only 2 paths that start with `/foo`.
- # Cardinality conditions are recursive; all subtrees under the specific
- # path prefix are counted.
- "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
- "number": 42, # The number variables under the `path` that must exist to meet this
- # condition. Defaults to 1 if not specified.
+ "success": { # The condition that a Waiter resource is waiting for. # [Required] The success condition. If this condition is met, `done` will be
+ # set to `true` and the `error` value will remain unset. The failure
+ # condition takes precedence over the success condition. If both conditions
+ # are met, a failure will be indicated.
+ "cardinality": { # A Cardinality condition for the Waiter resource. A cardinality condition is # The cardinality of the `EndCondition`.
+ # met when the number of variables under a specified path prefix reaches a
+ # predefined number. For example, if you set a Cardinality condition where
+ # the `path` is set to `/foo` and the number of paths is set to `2`, the
+ # following variables would meet the condition in a RuntimeConfig resource:
+ #
+ # + `/foo/variable1 = "value1"`
+ # + `/foo/variable2 = "value2"`
+ # + `/bar/variable3 = "value3"`
+ #
+ # It would not satisfy the same condition with the `number` set to
+ # `3`, however, because there is only 2 paths that start with `/foo`.
+ # Cardinality conditions are recursive; all subtrees under the specific
+ # path prefix are counted.
+ "path": "A String", # The root of the variable subtree to monitor. For example, `/foo`.
+ "number": 42, # The number variables under the `path` that must exist to meet this
+ # condition. Defaults to 1 if not specified.
+ },
},
+ "done": True or False, # Output only. If the value is `false`, it means the waiter is still waiting
+ # for one of its conditions to be met.
+ #
+ # If true, the waiter has finished. If the waiter finished due to a timeout
+ # or failure, `error` will be set.
+ "createTime": "A String", # Output only. The instant at which this Waiter resource was created. Adding
+ # the value of `timeout` to this instant yields the timeout deadline for the
+ # waiter.
+ "timeout": "A String", # [Required] Specifies the timeout of the waiter in seconds, beginning from
+ # the instant that `waiters().create` method is called. If this time elapses
+ # before the success or failure conditions are met, the waiter fails and sets
+ # the `error` code to `DEADLINE_EXCEEDED`.
+ "name": "A String", # The name of the Waiter resource, in the format:
+ #
+ # projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
+ #
+ # The `[PROJECT_ID]` must be a valid Google Cloud project ID,
+ # the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
+ # `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
+ # of `[WAITER_NAME]` must be less than 64 bytes.
+ #
+ # After you create a Waiter resource, you cannot change the resource name.
},
- "done": True or False, # Output only. If the value is `false`, it means the waiter is still waiting
- # for one of its conditions to be met.
- #
- # If true, the waiter has finished. If the waiter finished due to a timeout
- # or failure, `error` will be set.
- "createTime": "A String", # Output only. The instant at which this Waiter resource was created. Adding
- # the value of `timeout` to this instant yields the timeout deadline for the
- # waiter.
- "timeout": "A String", # [Required] Specifies the timeout of the waiter in seconds, beginning from
- # the instant that `waiters().create` method is called. If this time elapses
- # before the success or failure conditions are met, the waiter fails and sets
- # the `error` code to `DEADLINE_EXCEEDED`.
- },
],
}</pre>
</div>