docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
index bc73de3..f5c9e32 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
@@ -105,73 +105,20 @@
Args:
parent: string, Required. Resource name of the parent reservation. E.g.,
- projects/myproject/locations/US (required)
+ `projects/myproject/locations/US` (required)
body: object, The request body.
The object takes the form of:
{ # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
- },
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
-}
-
- enforceSingleAdminProjectPerOrg: boolean, If true, fail the request if another project in the organization has a
-capacity commitment.
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
# (in the form of slots) with some committed period of usage. Annual
# commitments renew by default. Commitments can be removed after their
# commitment end time passes.
- #
+ #
# In order to remove annual commitment, its plan needs to be changed
# to monthly or flex first.
- #
+ #
# A capacity commitment resource exists as a child resource of the admin
# project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
"plan": "A String", # Capacity commitment commitment plan.
"slotCount": "A String", # Number of slots in this commitment.
"renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
@@ -197,7 +144,60 @@
},
"commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
# capacity commitments.
- }</pre>
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }
+
+ enforceSingleAdminProjectPerOrg: boolean, If true, fail the request if another project in the organization has a
+capacity commitment.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
+ #
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }</pre>
</div>
<div class="method">
@@ -208,7 +208,7 @@
Args:
name: string, Required. Resource name of the capacity commitment to delete. E.g.,
- projects/myproject/locations/US/capacityCommitments/123 (required)
+ `projects/myproject/locations/US/capacityCommitments/123` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -235,7 +235,7 @@
Args:
name: string, Required. Resource name of the capacity commitment to retrieve. E.g.,
- projects/myproject/locations/US/capacityCommitments/123 (required)
+ `projects/myproject/locations/US/capacityCommitments/123` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -245,44 +245,44 @@
An object of the form:
{ # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
#
- # 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.
- },
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- }</pre>
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }</pre>
</div>
<div class="method">
@@ -291,7 +291,7 @@
Args:
parent: string, Required. Resource name of the parent reservation. E.g.,
- projects/myproject/locations/US (required)
+ `projects/myproject/locations/US` (required)
pageToken: string, The next_page_token value returned from a previous List request, if any.
pageSize: integer, The maximum number of items to return.
x__xgafv: string, V1 error format.
@@ -305,44 +305,44 @@
{ # The response for ReservationService.ListCapacityCommitments.
"capacityCommitments": [ # List of capacity commitments visible to the user.
{ # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
#
- # 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.
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
},
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- },
],
"nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
# more results in the list.
@@ -375,7 +375,7 @@
Args:
parent: string, Parent resource that identifies admin project and location e.g.,
-projects/myproject/locations/us (required)
+ `projects/myproject/locations/us` (required)
body: object, The request body.
The object takes the form of:
@@ -396,44 +396,44 @@
An object of the form:
{ # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
#
- # 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.
- },
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- }</pre>
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }</pre>
</div>
<div class="method">
@@ -453,67 +453,15 @@
The object takes the form of:
{ # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
- },
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
-}
-
- updateMask: string, Standard field mask for the set of fields to be updated.
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
# (in the form of slots) with some committed period of usage. Annual
# commitments renew by default. Commitments can be removed after their
# commitment end time passes.
- #
+ #
# In order to remove annual commitment, its plan needs to be changed
# to monthly or flex first.
- #
+ #
# A capacity commitment resource exists as a child resource of the admin
# project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
"plan": "A String", # Capacity commitment commitment plan.
"slotCount": "A String", # Number of slots in this commitment.
"renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
@@ -539,7 +487,59 @@
},
"commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
# capacity commitments.
- }</pre>
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }
+
+ updateMask: string, Standard field mask for the set of fields to be updated.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
+ #
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
+ }</pre>
</div>
<div class="method">
@@ -555,7 +555,7 @@
Args:
name: string, Required. The resource name e.g.,:
- projects/myproject/locations/US/capacityCommitments/123 (required)
+ `projects/myproject/locations/US/capacityCommitments/123` (required)
body: object, The request body.
The object takes the form of:
@@ -573,83 +573,83 @@
{ # The response for ReservationService.SplitCapacityCommitment.
"second": { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs # Second capacity commitment, result of a split.
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
#
- # 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.
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
},
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- },
"first": { # Capacity commitment is a way to purchase compute capacity for BigQuery jobs # First capacity commitment, result of a split.
- # (in the form of slots) with some committed period of usage. Annual
- # commitments renew by default. Commitments can be removed after their
- # commitment end time passes.
- #
- # In order to remove annual commitment, its plan needs to be changed
- # to monthly or flex first.
- #
- # A capacity commitment resource exists as a child resource of the admin
- # project.
- "state": "A String", # Output only. State of the commitment.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "plan": "A String", # Capacity commitment commitment plan.
- "slotCount": "A String", # Number of slots in this commitment.
- "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
- # passes. Once the plan is changed, committed period is extended according to
- # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
- "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
- # 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.
+ # (in the form of slots) with some committed period of usage. Annual
+ # commitments renew by default. Commitments can be removed after their
+ # commitment end time passes.
#
- # 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.
+ # In order to remove annual commitment, its plan needs to be changed
+ # to monthly or flex first.
+ #
+ # A capacity commitment resource exists as a child resource of the admin
+ # project.
+ "plan": "A String", # Capacity commitment commitment plan.
+ "slotCount": "A String", # Number of slots in this commitment.
+ "renewalPlan": "A String", # The plan this capacity commitment is converted to after commitment_end_time
+ # passes. Once the plan is changed, committed period is extended according to
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. For FAILED commitment plan, provides the reason of failure.
+ # 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.
+ },
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
+ # capacity commitments.
+ "state": "A String", # Output only. State of the commitment.
+ "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
+ # `projects/myproject/locations/US/capacityCommitments/123`
},
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- },
}</pre>
</div>