Class CapacityCommitment (1.11.0)

Version 1.11.0

• 1.14.1 (latest)
• 1.14.0
• 1.13.5
• 1.12.0
• 1.11.3
• 1.10.0
• 1.9.1
• 1.8.0
• 1.7.3
• 1.6.3
• 1.5.0
• 1.4.1
• 1.3.1
• 1.2.2
• 1.1.0
• 1.0.1
• 0.4.2
• 0.3.0
• 0.2.0
• 0.1.0

CapacityCommitment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

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.

Attributes

Name	Description
name	str Output only. The resource name of the capacity commitment, e.g., projects/myproject/locations/US/capacityCommitments/123 The commitment_id must only contain lower case alphanumeric characters or dashes. It must start with a letter and must not end with a dash. Its maximum length is 64 characters.
slot_count	int Number of slots in this commitment.
plan	google.cloud.bigquery_reservation_v1.types.CapacityCommitment.CommitmentPlan Capacity commitment commitment plan.
state	google.cloud.bigquery_reservation_v1.types.CapacityCommitment.State Output only. State of the commitment.
commitment_start_time	google.protobuf.timestamp_pb2.Timestamp Output only. The start of the current commitment period. It is applicable only for ACTIVE capacity commitments.
commitment_end_time	google.protobuf.timestamp_pb2.Timestamp Output only. The end of the current commitment period. It is applicable only for ACTIVE capacity commitments.
failure_status	google.rpc.status_pb2.Status Output only. For FAILED commitment plan, provides the reason of failure.
renewal_plan	google.cloud.bigquery_reservation_v1.types.CapacityCommitment.CommitmentPlan 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.
multi_region_auxiliary	bool Applicable only for commitments located within one of the BigQuery multi-regions (US or EU). If set to true, this commitment is placed in the organization's secondary region which is designated for disaster recovery purposes. If false, this commitment is placed in the organization's default region.
edition	google.cloud.bigquery_reservation_v1.types.Edition Edition of the capacity commitment.

Classes

CommitmentPlan

CommitmentPlan(value)

Commitment plan defines the current committed period. Capacity commitment cannot be deleted during it's committed period.

Values: COMMITMENT_PLAN_UNSPECIFIED (0): Invalid plan value. Requests with this value will be rejected with error code google.rpc.Code.INVALID_ARGUMENT. FLEX (3): Flex commitments have committed period of 1 minute after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time. FLEX_FLAT_RATE (7): Same as FLEX, should only be used if flat-rate commitments are still available. TRIAL (5): Trial commitments have a committed period of 182 days after becoming ACTIVE. After that, they are converted to a new commitment based on the renewal_plan. Default renewal_plan for Trial commitment is Flex so that it can be deleted right after committed period ends. MONTHLY (2): Monthly commitments have a committed period of 30 days after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time. MONTHLY_FLAT_RATE (8): Same as MONTHLY, should only be used if flat-rate commitments are still available. ANNUAL (4): Annual commitments have a committed period of 365 days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan. ANNUAL_FLAT_RATE (9): Same as ANNUAL, should only be used if flat-rate commitments are still available. THREE_YEAR (10): 3-year commitments have a committed period of 1095(3 * 365) days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan. NONE (6): Should only be used for renewal_plan and is only meaningful if edition is specified to values other than EDITION_UNSPECIFIED. Otherwise CreateCapacityCommitmentRequest or UpdateCapacityCommitmentRequest will be rejected with error code google.rpc.Code.INVALID_ARGUMENT. If the renewal_plan is NONE, capacity commitment will be removed at the end of its commitment period.

State

State(value)

Capacity commitment can either become ACTIVE right away or transition from PENDING to ACTIVE or FAILED.

Values: STATE_UNSPECIFIED (0): Invalid state value. PENDING (1): Capacity commitment is pending provisioning. Pending capacity commitment does not contribute to the project's slot_capacity. ACTIVE (2): Once slots are provisioned, capacity commitment becomes active. slot_count is added to the project's slot_capacity. FAILED (3): Capacity commitment is failed to be activated by the backend.