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)(即“祖鲁时”)格式,且精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

CommitmentPlan

承诺方案决定承诺期的结束时间。

枚举
COMMITMENT_PLAN_UNSPECIFIED 方案值无效。使用此值的请求将被拒绝,错误代码为 google.rpc.Code.INVALID_ARGUMENT
MONTHLY 在容量承诺变为 ACTIVE 状态后的 30 天内无法将其移除。
ANNUAL 在容量承诺变为 ACTIVE 状态后的 365 天内无法将其移除。

State

容量承诺可以立即变为 ACTIVE 状态,也可以从 PENDING 状态转换为 ACTIVE 状态。

枚举
STATE_UNSPECIFIED 状态值无效。
PENDING 容量承诺正在等待预配。待处理的容量承诺不会添加到父级 slotCapacity。
ACTIVE 槽预配完成后,容量承诺即会生效。系统会将 slotCount 添加到父级 slotCapacity。

方法

delete

删除容量承诺。

get

返回有关容量承诺的信息。

list

列出管理项目的所有容量承诺。