REST 리소스: projects.locations.capacityCommitments

리소스: CapacityCommitment

용량 약정을 사용하면 최소 사용 기간을 약정하여 BigQuery 작업의 컴퓨팅 용량을 슬롯 단위로 구매할 수 있습니다. 용량 약정은 변경할 수 없으며 약정 기간이 끝날 때까지 삭제할 수 없습니다. 약정 기간이 종료된 후에도 슬롯을 계속 사용할 수 있지만 원할 때에 삭제할 수 있습니다.

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

JSON 표현

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

string

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

slotCount

string (int64 format)

이 약정의 슬롯 수입니다.

plan

CommitmentPlanenum ()

용량 약정 요금제입니다.

state

Stateenum ()

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

commitmentEndTime

Timestampstring ( format)

출력 전용. 약정 기간 종료 시점입니다. commitmentEndTime 이전에 용량 약정을 삭제할 수 없습니다. ACTIVE 상태의 용량 약정에만 적용되며, 용량 약정이 ACTIVE 상태가 된 시간과 요금제의 조합으로 계산됩니다.

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

CommitmentPlan

약정 요금제는 약정 기간의 종료 시점을 정의합니다.

열거형
COMMITMENT_PLAN_UNSPECIFIED 잘못된 요금제 값. 이 값이 포함된 요청은 오류 코드 google.rpc.Code.INVALID_ARGUMENT와 함께 거부됩니다.
MONTHLY ACTIVE 상태가 된 후 30일 동안 용량 약정을 삭제할 수 없습니다.
ANNUAL ACTIVE 상태가 된 후 365일 동안 용량 약정을 삭제할 수 없습니다.

상태

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

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

메서드

delete

용량 약정을 삭제합니다.

get

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

list

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