docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
index 1f071e5..8310e1a 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
@@ -75,11 +75,14 @@
<h1><a href="bigqueryreservation_v1.html">BigQuery Reservation API</a> . <a href="bigqueryreservation_v1.projects.html">projects</a> . <a href="bigqueryreservation_v1.projects.locations.html">locations</a> . <a href="bigqueryreservation_v1.projects.locations.capacityCommitments.html">capacityCommitments</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(parent, body=None, enforceSingleAdminProjectPerOrg=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a new capacity commitment resource.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a capacity commitment. Attempting to delete capacity commitment</p>
+<p class="firstline">Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Returns information about the capacity commitment.</p>
@@ -91,68 +94,48 @@
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
<code><a href="#merge">merge(parent, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Merges capacity commitments of the same plan into a single commitment.</p>
+<p class="firstline">Merges capacity commitments of the same plan into a single commitment. The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments. Attempting to merge capacity commitments of different plan will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.</p>
<p class="toc_element">
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates an existing capacity commitment.</p>
+<p class="firstline">Updates an existing capacity commitment. Only `plan` and `renewal_plan` fields can be updated. Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.</p>
<p class="toc_element">
<code><a href="#split">split(name, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Splits capacity commitment to two commitments of the same plan and</p>
+<p class="firstline">Splits capacity commitment to two commitments of the same plan and `commitment_end_time`. A common use case is to enable downgrading commitments. For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you would change the plan of the first one to `FLEX` and then delete it.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(parent, body=None, enforceSingleAdminProjectPerOrg=None, x__xgafv=None)</code>
<pre>Creates a new capacity commitment resource.
Args:
- parent: string, Required. Resource name of the parent reservation. E.g.,
- `projects/myproject/locations/US` (required)
+ parent: string, Required. Resource name of the parent reservation. E.g., `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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+{ # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start 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.
+ 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
@@ -161,58 +144,32 @@
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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
}</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, x__xgafv=None)</code>
- <pre>Deletes a capacity commitment. Attempting to delete capacity commitment
-before its commitment_end_time will fail with the error code
-`google.rpc.Code.FAILED_PRECONDITION`.
+ <pre>Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.
Args:
- name: string, Required. Resource name of the capacity commitment to delete. E.g.,
- `projects/myproject/locations/US/capacityCommitments/123` (required)
+ name: string, Required. Resource name of the capacity commitment to delete. E.g., `projects/myproject/locations/US/capacityCommitments/123` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -221,15 +178,7 @@
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 `{}`.
+ { # 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>
@@ -238,8 +187,7 @@
<pre>Returns information about the capacity commitment.
Args:
- name: string, Required. Resource name of the capacity commitment to retrieve. E.g.,
- `projects/myproject/locations/US/capacityCommitments/123` (required)
+ name: string, Required. Resource name of the capacity commitment to retrieve. E.g., `projects/myproject/locations/US/capacityCommitments/123` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -248,46 +196,23 @@
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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
}</pre>
</div>
@@ -296,8 +221,7 @@
<pre>Lists all the capacity commitments for the admin project.
Args:
- parent: string, Required. Resource name of the parent reservation. E.g.,
- `projects/myproject/locations/US` (required)
+ parent: string, Required. Resource name of the parent reservation. E.g., `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.
@@ -309,49 +233,25 @@
An object of the form:
{ # The response for ReservationService.ListCapacityCommitments.
- "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
- # more results in the list.
+ "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
"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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
},
],
}</pre>
@@ -373,26 +273,15 @@
<div class="method">
<code class="details" id="merge">merge(parent, body=None, x__xgafv=None)</code>
- <pre>Merges capacity commitments of the same plan into a single commitment.
-
-The resulting capacity commitment has the greater commitment_end_time
-out of the to-be-merged capacity commitments.
-
-Attempting to merge capacity commitments of different plan will fail
-with the error code `google.rpc.Code.FAILED_PRECONDITION`.
+ <pre>Merges capacity commitments of the same plan into a single commitment. The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments. Attempting to merge capacity commitments of different plan will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.
Args:
- parent: string, Parent resource that identifies admin project and location e.g.,
- `projects/myproject/locations/us` (required)
+ parent: string, Parent resource that identifies admin project and location e.g., `projects/myproject/locations/us` (required)
body: object, The request body.
The object takes the form of:
{ # The request for ReservationService.MergeCapacityCommitments.
- "capacityCommitmentIds": [ # Ids of capacity commitments to merge.
- # These capacity commitments must exist under admin project and location
- # specified in the parent.
- # ID is the last portion of capacity commitment name e.g., 'abc' for
- # projects/myproject/locations/US/capacityCommitments/abc
+ "capacityCommitmentIds": [ # Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc
"A String",
],
}
@@ -405,105 +294,52 @@
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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
}</pre>
</div>
<div class="method">
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
- <pre>Updates an existing capacity commitment.
-
-Only `plan` and `renewal_plan` fields can be updated.
-
-Plan can only be changed to a plan of a longer commitment period.
-Attempting to change to a plan with shorter commitment period will fail
-with the error code `google.rpc.Code.FAILED_PRECONDITION`.
+ <pre>Updates an existing capacity commitment. Only `plan` and `renewal_plan` fields can be updated. Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.
Args:
- name: string, Output only. The resource name of the capacity commitment, e.g.,
-`projects/myproject/locations/US/capacityCommitments/123` (required)
+ name: string, Output only. The resource name of the capacity commitment, e.g., `projects/myproject/locations/US/capacityCommitments/123` (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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+{ # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start 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.
@@ -515,63 +351,32 @@
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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # 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.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
}</pre>
</div>
<div class="method">
<code class="details" id="split">split(name, body=None, x__xgafv=None)</code>
- <pre>Splits capacity commitment to two commitments of the same plan and
-`commitment_end_time`.
-
-A common use case is to enable downgrading commitments.
-
-For example, in order to downgrade from 10000 slots to 8000, you might
-split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
-you would change the plan of the first one to `FLEX` and then delete it.
+ <pre>Splits capacity commitment to two commitments of the same plan and `commitment_end_time`. A common use case is to enable downgrading commitments. For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you would change the plan of the first one to `FLEX` and then delete it.
Args:
- name: string, Required. The resource name e.g.,:
- `projects/myproject/locations/US/capacityCommitments/123` (required)
+ name: string, Required. The resource name e.g.,: `projects/myproject/locations/US/capacityCommitments/123` (required)
body: object, The request body.
The object takes the form of:
@@ -588,87 +393,41 @@
An object of the form:
{ # 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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ "first": { # 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. # First capacity commitment, result of a split.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start 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.
- "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE
- # capacity commitments.
- "name": "A String", # Output only. The resource name of the capacity commitment, e.g.,
- # `projects/myproject/locations/US/capacityCommitments/123`
- "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for
- # ACTIVE capacity commitments.
- "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.
- "plan": "A String", # Capacity commitment commitment plan.
- "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).
- "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.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ "second": { # 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. # Second capacity commitment, result of a split.
+ "failureStatus": { # The `Status` type defines a logical error model that is suitable for 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). # Output only. For FAILED commitment plan, provides the reason of failure.
+ "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.
+ "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.
},
"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.
+ "commitmentEndTime": "A String", # Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
+ "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.
"state": "A String", # Output only. State of the commitment.
+ "commitmentStartTime": "A String", # Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
},
}</pre>
</div>