docs: update generated docs (#981)
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
index f5c9e32..1f071e5 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html
@@ -110,44 +110,46 @@
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.
- "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`
- }
+ # (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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+}
enforceSingleAdminProjectPerOrg: boolean, If true, fail the request if another project in the organization has a
capacity commitment.
@@ -160,44 +162,46 @@
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 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.
#
- # 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>
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ }</pre>
</div>
<div class="method">
@@ -245,44 +249,46 @@
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 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.
#
- # 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>
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ }</pre>
</div>
<div class="method">
@@ -303,49 +309,51 @@
An object of the form:
{ # 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.
- "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`
- },
- ],
"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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ },
+ ],
}</pre>
</div>
@@ -383,6 +391,8 @@
"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",
],
}
@@ -396,44 +406,46 @@
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 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.
#
- # 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>
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ }</pre>
</div>
<div class="method">
@@ -453,44 +465,46 @@
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.
- "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`
- }
+ # (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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+}
updateMask: string, Standard field mask for the set of fields to be updated.
x__xgafv: string, V1 error format.
@@ -502,44 +516,46 @@
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 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.
#
- # 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>
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ }</pre>
</div>
<div class="method">
@@ -573,83 +589,87 @@
{ # 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 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.
#
- # 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`
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ },
"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 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.
#
- # 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`
+ # 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.
+ {
+ "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.
+ "state": "A String", # Output only. State of the commitment.
+ },
}</pre>
</div>