REST 리소스: projects.locations.capacityCommitments

리소스: CapacityCommitment

용량 약정을 사용하면 사용 기간을 약정하여 BigQuery 작업의 컴퓨팅 용량을 슬롯 단위로 구매할 수 있습니다. 연간 약정은 기본적으로 갱신됩니다. 약정 종료 시간이 지난 후에 약정을 삭제할 수 있습니다.

연간 약정을 삭제하려면 먼저 요금제를 월간 또는 탄력 요금제로 변경해야 합니다.

용량 약정 리소스는 관리자 프로젝트의 하위 리소스로 존재합니다.

JSON 표현

{
  "name": string,
  "slotCount": string,
  "plan": enum (CommitmentPlan),
  "state": enum (State),
  "commitmentEndTime": string,
  "failureStatus": {
    object (Status)
  },
  "renewalPlan": enum (CommitmentPlan)
}
필드
name

string

출력 전용. 용량 약정의 리소스 이름입니다. 예: projects/myproject/locations/US/capacityCommitments/123

slotCount

string (int64 format)

이 약정의 슬롯 수입니다.

plan

enum (CommitmentPlan)

용량 약정 요금제입니다.

state

enum (State)

출력 전용. 약정 상태입니다.

commitmentEndTime

string (Timestamp format)

출력 전용. 현재 약정 기간의 종료 시점입니다. ACTIVE 용량 약정에만 적용할 수 있습니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.

failureStatus

object (Status)

출력 전용. FAILED 약정 요금제의 경우 실패 이유를 제공합니다.

renewalPlan

enum (CommitmentPlan)

이 용량 약정은 commitmentEndTime이 지난 후에 전환됩니다. 요금제를 변경하면 약정 요금제에 따라 약정 기간이 연장됩니다. ANNUAL 및 TRIAL 약정에만 적용됩니다.

CommitmentPlan

약정 요금제는 현재 약정 기간을 정의합니다. 약정 기간에는 용량 약정을 삭제할 수 없습니다.

열거형
COMMITMENT_PLAN_UNSPECIFIED 잘못된 요금제 값. 이 값이 포함된 요청은 오류 코드 google.rpc.Code.INVALID_ARGUMENT와 함께 거부됩니다.
FLEX 가변형 약정 기간은 ACTIVE가 된 후 1분입니다. 이후에는 약정 기간이 아니므로 언제든지 삭제할 수 있습니다.
TRIAL 무료 체험판 약정 기간은 ACTIVE 상태가 된 후 182일입니다. 이후 renewalPlan에 따라 새 약정으로 전환됩니다. 무료 체험판 약정의 기본 renewalPlan은 약정 기간이 종료된 후 바로 삭제할 수 있는 Flex입니다.
MONTHLY 월간 약정 기간은 ACTIVE 상태가 된 후 30일입니다. 이후에는 약정 기간이 아니므로 언제든지 삭제할 수 있습니다.
ANNUAL 연간 약정 기간은 ACTIVE 상태가 된 후 365일입니다. 이후 renewalPlan에 따라 새 약정으로 전환됩니다.

상태

용량 약정은 즉시 ACTIVE 상태가 되거나 PENDING 상태에서 ACTIVE 또는 FAILED 상태로 전환될 수 있습니다.

열거형
STATE_UNSPECIFIED 잘못된 상태 값입니다.
PENDING 용량 약정이 프로비저닝 대기 중입니다. 대기 중인 용량 약정은 상위 slotCapacity에 영향을 미치지 않습니다.
ACTIVE 슬롯이 프로비저닝되면 용량 약정이 ACTIVE 상태가 됩니다. slotCount가 상위 slotCapacity에 추가됩니다.
FAILED 백엔드에서 용량 약정을 활성화하지 못했습니다.

메서드

create

새 용량 약정 리소스를 만듭니다.

delete

용량 약정을 삭제합니다.

get

용량 약정 정보를 반환합니다.

list

관리자 프로젝트의 모든 용량 약정을 나열합니다.

merge

동일한 요금제의 용량 약정을 단일 약정으로 병합합니다.

patch

기존 용량 약정을 업데이트합니다.

split

용량 약정을 동일한 요금제와 commitment_end_time의 두 약정으로 분할합니다.