升级承诺期限

---

您可以升级 1 年期承诺的期限，并将其转换为 3 年期承诺，以获得更高的承诺资源折扣率并在更长的时间段内继续享受折扣。

本文档介绍如何将承诺期限从 1 年升级为 3 年。

期限升级的工作原理

当您升级承诺的期限时，承诺的到期日期将提前两年。升级后的承诺期限将于升级操作后的次日零点（美国和加拿大太平洋时间，即 UTC-8，夏令时为 UTC-7）开始生效，并且您将开始获得适用于升级后期限的新折扣百分比。

升级该期限不会影响您的承诺的其他属性。升级操作后，以下承诺属性保持不变：

• 名称
• 开始日期
• 区域
• 项目
• 承诺类型
• 自动续订状态
• 承诺资源

承诺中附加的任何预留，除非手动予以替换，否则将在升级期限的整个生命周期内继续存在。

升级后的承诺示例

下表举例说明了现有承诺 (commitment-1) 的期限在 2 年内升级：

承诺属性	期限升级前	期限升级后
名称	commitment-1	commitment-1
类型	N2	N2
区域	us-central-1	us-central-1
项目	example-project-1	example-project-1
资源	vCPU 数量：200 内存：200 GB	vCPU 数量：200 内存：200 GB
期限	1 年	3 年
开始日期*	2020 年 1 月 1 日	2020 年 1 月 1 日
结束日期†	2021 年 1 月 1 日	2023 年 1 月 1 日
自动续订状态	已停用	已停用

^*承诺从指定开始日期的零点（美国和加拿大太平洋时间，即 UTC-8 或 UTC-7）开始。
^†承诺于指定结束日期的零点（美国和加拿大太平洋时间，即 UTC-8 或 UTC-7）结束。

配额注意事项

升级承诺的期限时，您通常不需要申请额外的配额。但是，如果您在承诺到期的当天进行升级，则必须验证您是否有足够的可用配额。这是因为在承诺到期时，承诺占用的任何配额都会释放回可用配额池中，并且可能会被您的其他业务需求占用。

价格影响

承诺费用是所有承诺的资源的折扣价格总和。升级承诺的期限时，Compute Engine 会应用新的 3 年期 CUD 百分比，并重新计算每个承诺资源的折扣价格。为了进行这种重新计算，Compute Engine 会使用原始期限生效当天每项资源的现行按需价格。即使按需价格发生变化，每项资源的这一新折扣价格在升级期限结束之前也会保持不变。

注意：如果您合并或拆分承诺，则承诺的资源的折扣价格可能会在合并或拆分承诺生效的当天发生变化。

限制

• 您只能为有效承诺升级期限。
• 您无法升级软件许可承诺的期限。

执行期限升级

使用 gcloud CLI、Google Cloud 控制台或 Compute Engine API 升级承诺的期限。

注意：如果您使用 gcloud CLI 或 Compute Engine API 升级承诺的期限，并且还希望针对该承诺启用自动续订，您必须为此执行两项单独的操作。您可以使用 Google Cloud 控制台同时执行这两项操作，但在 gcloud CLI 或 Compute Engine API 上，您必须在升级承诺的期限前后启用自动续订。

执行此任务所需的权限

您必须拥有以下权限才能执行此任务：

• 针对项目或组织的 compute.commitments.update 权限。

控制台

1. 在 Google Cloud 控制台中，选择要升级承诺期限的项目，然后转到承诺使用折扣页面。

   转到“承诺使用折扣”

2. 如需启动承诺的期限升级操作，请在承诺列表页面的硬件承诺标签页中选择有效的硬件承诺，然后点击 升级。

   • 或者，您也可以点击要升级的有效承诺的名称。硬件承诺详情页面打开后，点击 升级。

3. 在出现的升级承诺使用折扣窗格中，验证修改后的承诺的新结束时间，然后点击升级。

4. 如需完成期限升级操作并返回承诺列表页面，请在随即显示的升级您的承诺？对话框中，查看条款及条件然后点击升级。

gcloud

如需升级承诺的期限，请使用带有 --plan 标志的 gcloud compute commitments update command 命令。

gcloud compute commitments update COMMITMENT_NAME \
    --plan=36-month \
    --region=REGION \
    --project=PROJECT_NAME

请替换以下内容：

• COMMITMENT_NAME：您要升级其期限的承诺的名称。
• REGION：您要升级其期限的承诺所在的区域。
• PROJECT_NAME：要为其升级承诺的项目的名称。

例如，请在 us-central1 区域中为项目 project-upgrade-example 考虑 1 年期承诺 commitment-upgrade-example。以下 gcloud CLI 命令会升级承诺的期限，并将其修改为 3 年期的承诺。

gcloud compute commitments update commitment-upgrade-example \
    --plan=36-month \
    --region=us-central1 \
    --project=project-upgrade-example

API

如需升级承诺的期限，请使用 regionCommitments.update 方法。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
{
  "name": COMMITMENT_NAME,
  "plan": "THIRTY_SIX_MONTH",
}

请替换以下内容：

• PROJECT_ID：您要在其中升级承诺期限的项目的 ID。
• REGION：您要升级其期限的承诺所在的区域。
• COMMITMENT_NAME：您要升级其期限的承诺的名称。

例如，请在 us-central1 区域中为项目 project-upgrade-example 考虑 1 年期承诺 commitment-upgrade-example。以下 Compute Engine API 请求会升级承诺的期限，并将其修改为 3 年期的承诺。

PATCH https://compute.googleapis.com/compute/v1/projects/project-upgrade-example/regions/us-central1/commitments/commitment-upgrade-example
{
  "name": "commitment-upgrade-example",
  "plan": "THIRTY_SIX_MONTH",
}

后续步骤

• 了解如何自动续订承诺。
• 了解如何合并和拆分基于资源的承诺。
• 了解如何分析基于资源的承诺使用折扣的有效性。