延长承诺期限


本文档介绍了如何将 Compute Engine 基于资源的承诺的期限延长到预设的 1 年和 3 年之后。

借助期限延长功能,您可以灵活地将承诺的期限延长到预设的 1 年或 3 年之后,并指定您选择的自定义期限(例如 2 年、3.5 年或 5.5 年)。通过延长承诺期限,您可以根据自己的资源使用需求量身定制承诺期限,并在更长且自定义的时间段内继续获得由此产生的承诺使用折扣 (CUD)。您可以延长 1 年期和 3 年期的承诺期限,具体方法如下:

  • 1 年期承诺:您可以指定大于 1 年且小于 3 年的自定义期限。
  • 3 年期承诺:您可以指定大于 3 年且小于 6 年的自定义期限。

如需了解让您的承诺保持更长时间有效的其他方法,请参阅以下替代方案:

期限延长功能的运作方式

您可以延长承诺期限,并通过为承诺期限指定您选择的未来结束日期来设置自定义期限。然后,您的承诺将变为自定义期限承诺。对于 1 年期合约,自当前期限的开始日期起,自定义结束日期可以是 1 到 3 年(但不能是整整 3 年)之间的任意日期。对于 3 年期承诺,自当前期限的开始日期起,自定义结束日期可以是 3 到 6 年(但不能是 6 年)之间的任意日期。

您可以按如下方式为新承诺和现有承诺延长期限:

您为承诺提出期限延长请求后,相关更改将于次日零点(美国和加拿大太平洋时间,即 UTC-8,夏令时为 UTC-7)生效。您的承诺使用合约将保持有效状态,直至新的自定义结束日期,并且其期限长度会相应调整。延长承诺的期限不会影响承诺的其他属性:

  • 名称
  • 开始日期
  • 区域
  • 项目
  • 承诺类型
  • 承诺方案
  • 自动续订状态
  • 已提交的资源

延长承诺期限不会改变您因该承诺而获得的 CUD 百分比。

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

学期延期资格申请期限

在合约期开始后,您只有一段时间可以申请延长合约期。这段时间称为“学期延期资格条件申请期限”。

对于预设和自定义期限长度的付款承诺,期限延长资格条件窗口取决于您对付款承诺执行的最近一次操作,并会以以下方式运作:

  • 新购买的承诺:对于 1 年期承诺,资格申请期限在承诺生效后最长可延长 4 个月。对于 3 年期承诺,资格申请期限最长可持续到承诺生效后的 1 年。

  • 自动续订的承诺:如果您的承诺自动续订了新期限,则资格条件期限会在续订期限开始时刷新。对于 1 年期承诺,资格要求的有效期最长为从续订期开始算起的 4 个月。对于 3 年期承诺,资格要求的有效期为自续订期开始之日起最多 1 年。

  • 合并的承诺:如果您合并具有不同资格条件期限的承诺,则对于合并的承诺,Compute Engine 会使用结束时间最早的资格条件期限。

  • 拆分承诺:拆分承诺后,调整后的来源承诺和新的拆分承诺的资格要求期限保持不变。

  • 升级后的承诺:当您将 1 年期承诺升级为 3 年期承诺时,Compute Engine 还会更新该承诺的资格条件期限。更新后的回溯期最长可持续到当前期限的开始日期后 1 年。

    例如,假设您的 1 年期承诺的开始日期为 2024 年 1 月 1 日。原始 1 年期方案的资格申请期限将持续到 2024 年 5 月 1 日。假设您在 2024 年 4 月 1 日将此承诺升级为 3 年期承诺。期限升级后,您的承诺的更新版资格要求期限将持续到 2025 年 1 月 1 日。

执行多次期限延长

您可以在符合期限延长条件的时间范围内,任意次数延长承诺期限。对于任何给定的有效承诺,您可以在任何给定的一天内,在次日凌晨 12 点(美国和加拿大太平洋时间 UTC-8 或 UTC-7)之前提出多次期限延长请求,前提是每次都指定更晚的结束日期。不过,Google 建议您在给定一天内,针对单个承诺提交的期限延期请求数量不要过多。

在针对特定结束日期的期限延长生效且承诺设有新的自定义结束日期后,您将无法撤消期限延长或缩短承诺的期限。您只能针对晚于最近指定的结束日期执行后续延期操作。

待处理的预配更新请求的影响

对于已有的有效承诺,如果已有待处理的更新请求,则只有在待处理的请求也是为了延长期限时,您才能提出新的期限延长请求。如果承诺有任何待处理的更新请求(例如合并、拆分、期限升级或自动续订设置更新),那么您必须等待待处理的操作完成并更新生效,然后才能请求延长期限。在次日零点(更新生效后),您可以申请延长该承诺的期限。

价格影响

承诺费用是所有承诺的资源的折扣价格总和。延长承诺期限后,即使按需价格发生变化,资源的折扣价格在整个自定义期限内也会保持不变。如需详细了解资源价格,请参阅 Compute Engine 价格

配额注意事项

如需在购买承诺时指定自定义结束日期,您必须确保承诺和承诺资源的可用配额充足。如需为现有承诺指定自定义结束日期,您通常不需要申请任何额外的配额。

期限延长对未来的提交操作有何影响

如果您的承诺采用自定义期限,那么对自定义期限承诺执行任何后续承诺管理操作都可能会影响其自定义结束日期和资格条件期限。以下部分介绍了自定义期限承诺在其他承诺操作期间的行为方式:

自动续订自定义期限承诺

自动续订型承诺的续订期限始终与承诺方案定义的预设期限(1 年或 3 年)一致。您也会享受相同的折扣百分比。即使您的承诺具有 自定义期限,Compute Engine 也只会以 1 年或 3 年的预设期限续订您的承诺。自动续订自定义期限承诺不会再续订相同自定义期限。如需查看示例,请参阅以下内容:

  • 如果承诺期限为自定义的 1.5 年,则续订时只会再续订 1 年。
  • 如果承诺期限为自定义的 5.5 年,则续期时只会再续订 3 年。

如果您希望自定义期限承诺的有效期比续订期限更长,则可以在续订后申请再次延长期限。在续订期开始时,您的合约期延长资格期也会随之刷新。对于 1 年期承诺,续订后的资格要求期限最长可持续 4 个月。对于 3 年期承诺,此回溯期在续订后最长可延长 1 年。

例如,假设您的 1 年期承诺的开始日期为 2024 年 1 月 1 日。您延长了此承诺的期限,并指定了自定义结束日期(2025 年 6 月 30 日)。如果您还为承诺启用了自动续订,则在 2025 年 7 月 1 日,您的承诺将续订 1 年。续订期结束日期为 2026 年 6 月 30 日。在续订期内,可申请延长期限的资格申请期将持续到 2025 年 11 月 1 日。

如需详细了解如何自动续订承诺,请参阅自动续订承诺

合并自定义期限承诺

合并具有自定义期限长度的承诺与合并具有预设期限长度的承诺的方式相同。合并的提交会继承以下属性:

  • 来源承诺中较远的将来结束日期,无论该日期是否为自定义结束日期。
  • 来源承诺中结束时间最早的资格要求期限。

例如,假设您要合并两个自定义期限为 1 年的承诺。第一个承诺的开始日期为 2024 年 1 月 1 日,自定义结束日期为 2025 年 6 月 30 日。第一个承诺的资格申请期限将持续到 2024 年 5 月 1 日。第二个承诺的开始日期为 2024 年 2 月 1 日,自定义结束日期为 2025 年 7 月 30 日。第二次承诺的资格申请期限将持续到 2024 年 6 月 1 日。如果您在 2024 年 4 月 1 日合并这些承诺,则合并后的承诺将继承 2025 年 7 月 30 日的结束日期。合并后的承诺的资格申请期限将持续到 2024 年 5 月 1 日。

如需详细了解如何合并承诺,请参阅合并承诺

拆分自定义期限承诺

拆分具有自定义期限长度的承诺与拆分具有预设期限长度的承诺的方式相同。大小调整后的来源承诺和新的拆分承诺将保留相同的自定义结束日期和期限延长资格期。

例如,假设您的 1 年期承诺的开始日期为 2024 年 1 月 1 日,自定义结束日期为 2025 年 6 月 30 日。您的承诺的资格申请期限将持续到 2024 年 5 月 1 日。假设您在 2024 年 3 月 1 日将此承诺拆分为两个单独的承诺。新分割的承诺会继承自定义结束日期(2025 年 6 月 30 日),并且其资格申请期限将持续到 2024 年 5 月 1 日。

如需详细了解如何拆分承诺,请参阅拆分承诺

升级自定义期限承诺

具有自定义期限的 1 年期承诺的升级方式与具有预设期限的承诺相同。升级后,Compute Engine 会将承诺的当前期限的结束日期提前两年。

例如,假设您的 1 年期承诺的开始日期为 2024 年 1 月 1 日,自定义结束日期为 2025 年 6 月 30 日。原始 1 年期方案的资格申请期限将持续到 2024 年 5 月 1 日。假设您在 2024 年 4 月 1 日将此承诺升级为 3 年期承诺。期限升级后,您的承诺将变为 3 年期承诺,结束日期为 2027 年 6 月 30 日。更新后的承诺资格申请期限将持续到 2025 年 1 月 1 日。您还将开始获得适用于 3 年期承诺的 CUD 百分比。

如需详细了解如何升级承诺,请参阅升级承诺期限

限制

基于资源的承诺的期限延长存在以下限制:

  • 您只能延长硬件资源承诺的期限。
  • 您无法延长无效或已过期的承诺的期限。
  • 您无法将 3 年期承诺的期限延长整整 3 年。不妨改为为承诺启用自动续订
  • 您只能按承诺方案定义的预设期限(1 年或 3 年)续订自定义期限承诺。
  • 对于已有待处理的承诺更新请求的现有有效承诺,只有当待处理的请求也是为了延长期限时,您才能提出新的期限延长请求。如果这些付款承诺有任何其他待处理的更新请求(例如合并、拆分、期限升级或自动续订设置更新),那么您必须等到次日午夜之后,待待处理的操作完成并更新生效,然后才能申请期限延长。

使用要求

您必须满足以下要求,才能成功延长承诺期限:

  • 必须在承诺的期限延长资格期限内提出期限延长请求。
  • 对于 1 年期承诺,自当前期限的开始日期起,自定义结束日期必须介于 1 年到 3 年(但不能是整整 3 年)之间。
  • 对于 3 年期承诺,自当前期限的开始日期起,自定义结束日期必须介于 3 年到 6 年(但不能是 6 年)之间。
  • 您不得针对该付款承诺有任何其他正在进行或待处理的合并、拆分、升级或续订操作。

最佳做法

Google 建议您在延长承诺的期限时遵循以下最佳实践:

  • 在提交期限延长请求之前,请等待所有其他待处理的提交操作完成并更新生效。
  • 尽量减少同一天针对单个提交内容提交的期限延长请求的数量。

在承诺购买期间延长期限

购买承诺时,您可以指定自定义结束日期,以延长预设的 1 年或 3 年期限。

如需在购买承诺时延长其期限,请使用以下选项之一:

控制台

在购买预付费用之前,请在 Google Cloud 控制台中选择要用于购买预付费用的项目。如果为 Cloud Billing 账号启用了 CUD 共享,您可以使用该 Cloud Billing 账号中的任何项目购买承诺。

  1. 在 Google Cloud 控制台中,前往承诺使用折扣页面。

    转到“承诺使用折扣”

    系统会打开承诺列表页面,并显示硬件承诺标签页。

  2. 点击 购买承诺

    系统会打开购买承诺使用折扣页面,并显示硬件标签页。

  3. 名称字段中,为承诺输入名称。

  4. 区域字段中,选择您要承诺购买 Compute Engine 资源的区域。

  5. 承诺类型字段中,选择已承诺资源的机器家族系列。可用的承诺类型选项如下:

    • 加速器优化的 A2,适用于 A2 机器类型资源
    • 加速器优化的 A3(适用于 A3 Edge 和 High 机器类型资源)
    • 加速器优化的 A3 Mega(适用于 A3 Mega 机器类型资源)
    • 计算优化的 C2,适用于 C2 机器类型资源
    • 计算优化的 C2D,适用于 C2D 机器类型资源
    • 计算优化型 H3,适用于 H3 机器类型资源
    • 通用 C3,适用于 C3 机器类型资源
    • 通用 C3D,适用于 C3D 机器类型资源
    • 通用 C4,适用于 C4 机器类型资源
    • 通用 C4A,适用于 C4A 机器类型资源
    • 通用 E2,适用于 E2 机器类型资源
    • 通用 N1,适用于 N1 机器类型资源
    • 通用 N2,适用于 N2 机器类型资源
    • 通用 N2D,适用于 N2D 机器资源
    • 通用 N4,适用于 N4 机器类型资源
    • 通用 T2D,适用于 Tau T2D 机器类型资源
    • 图形优化的 G2,适用于 G2 机器类型资源
    • 内存优化的 M1/M2,适用于 M1 或 M2 机器类型资源
    • 内存优化的 M3,适用于 M3 机器类型资源
    • 存储优化型 Z3(适用于 Z3 机器类型资源)

  6. 时长部分,执行以下操作:

    1. 如需指定承诺的预设期限,请选择 1 年3 年
    2. 如需为承诺指定自定义结束日期,请点击延长结束日期切换开关,然后在日期字段中指定自定义结束日期。
  7. 核心字段中,输入您要承诺购买的 vCPU 数量。

  8. 内存字段中,输入您要承诺购买的内存量(以 GB 为单位)。

  9. 如需承诺购买 GPU,请在 GPU 部分中点击 Add GPU(添加 GPU),然后执行以下操作:

    1. GPU 类型字段中,选择 GPU 的类型。
    2. GPU 数量字段中,输入 GPU 的数量。
    3. 可选:如果您的 GPU 模型支持适用于图形工作负载的 NVIDIA RTX 虚拟工作站 (vWS),并且您计划运行图形密集型工作负载,请选中启用虚拟工作站 (NVIDIA GRID) 复选框。
  10. 如需承诺购买本地 SSD 磁盘,请在本地 SSD 部分中点击“添加”图标 Add SSD,然后在 Number of SSDs 字段中指定磁盘数量。

  11. 如果您在承诺中指定了任何 GPU 或本地 SSD 磁盘,请通过以下任一方式为这些资源附加匹配的预留。针对您要附加的每个新预订重复此步骤。

    1. 如需将一个或多个现有预留附加到承诺,请在预留字段中选择附加现有预留,然后按照附加现有预留部分中列出的步骤操作。
    2. 如需创建新的预留并将其附加到承诺,请在预留字段中选择创建预留,然后按照创建要附加的新预留部分中列出的步骤操作。
  12. 如需完成承诺购买交易,请执行以下操作:

    1. 点击购买
    2. 购买承诺使用折扣对话框中,如果您同意服务专用条款,请再次点击购买

gcloud

如需购买具有自定义和延长期限的承诺,请运行 gcloud compute commitments create 命令并添加 --custom-end-time 标志。

例如,如需为 vCPU 和/或内存购买承诺,请使用以下命令:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=COMMITMENT_PLAN \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --custom-end-time=CUSTOM_END_DATE

替换以下内容:

  • COMMITMENT_NAME:承诺的名称
  • REGION:预订的区域,即您要承诺购买 Compute Engine 资源的区域。
  • PROJECT_ID:项目的 ID
  • COMMITMENT_PLAN:您要承诺购买资源的最短预设期限。请指定以下某个值:

    • 对于 1 年期承诺:12-month
    • 对于 3 年期承诺:36-month
  • COMMITMENT_TYPE:您要承诺购买资源的机器系列。您可以使用以下选项:

    • accelerator-optimized(适用于 A2 机器类型资源)
    • accelerator-optimized-a3(适用于 A3 Edge 和 High 机器类型资源)
    • accelerator-optimized-a3-mega(适用于 A3 Mega 机器类型资源)
    • compute-optimized(适用于 C2 机器类型资源)
    • compute-optimized-c2d(适用于 C2D 机器类型资源)
    • compute-optimized-c3(适用于 C3 机器类型资源)
    • compute-optimized-c3d(适用于 C3D 机器类型资源)
    • compute-optimized-h3(适用于 H3 机器类型资源)
    • general-purpose(适用于 N1 机器类型资源)
    • general-purpose-c4(适用于 C4 机器类型资源)
    • general-purpose-c4a(适用于 C4A 机器类型资源)
    • general-purpose-e2(适用于 E2 机器类型资源)
    • general-purpose-n2(适用于 N2 机器类型资源)
    • general-purpose-n2d(适用于 N2D 机器资源)
    • general-purpose-n4(适用于 N4 机器类型资源)
    • general-purpose-t2d(适用于 Tau T2D 机器类型资源)
    • 适用于 G2 机器类型资源的 graphics-optimized
    • memory-optimized(适用于M1 或 M2 机器类型资源)
    • memory-optimized-m3(适用于 M3 机器类型资源)
    • storage-optimized-z3(适用于 Z3 机器类型资源)

    如果您未指定 --type 标志,则 Compute Engine 会使用 general-purpose 作为默认值。

  • NUMBER_VCPUS:您要承诺购买的 vCPU 数量。

  • MEMORY:您要承诺购买的内存量(以 MB 或 GB 为单位),例如 1000MB100GB。如果您未指定单位,Compute Engine 将使用 GB 作为默认单位。您可以按 0.25 GB 的增量指定此值。

  • CUSTOM_END_DATE:学期的自定义结束日期,格式必须为 YYYY-MM-DD。例如,如需指定自定义结束日期(2024 年 4 月 20 日),请将其格式设置为 2024-04-20

如需详细了解如何在为 GPU 和/或本地 SSD 磁盘购买承诺时延长期限,请参阅购买包含附加预留的承诺

例如,设想 us-central1 区域中有一个名为 example-commitment 的 1 年期承诺,其中包含 4 个 N1 vCPU 和 9 GB 内存。假设您想在 2024 年 1 月 1 日购买此承诺,并希望自定义期限为 2025 年 6 月 30 日结束。如需购买此承诺,请运行以下命令:

gcloud compute commitments create example-commitment \
    --region=us-central1 \
    --project=my-project
    --plan=12-month \
    --type=general-purpose
    --resources=memory=9GB,vcpu=4 \
    --custom-end-time=2025-07-01

REST

如需购买具有自定义和延长期限的承诺,请向 regionCommitments.insert 方法发出 POST 请求。在请求正文中,包含 customEndTimestamp 字段。

例如,如需为 vCPU 和/或内存购买承诺,请使用以下 POST 请求正文:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
    "name": "COMMITMENT_NAME",
    "plan": "COMMITMENT_PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
        {
            "amount": "NUMBER_VCPUS",
            "type": "VCPU"
        },
        {
            "amount": "MEMORY",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

替换以下内容:

  • COMMITMENT_NAME:承诺的名称
  • REGION:预订的区域,即您要承诺购买 Compute Engine 资源的区域。
  • PROJECT_ID:项目的 ID
  • COMMITMENT_PLAN:您要承诺购买资源的最短预设期限。请指定以下某个值:

    • 对于 1 年期承诺:TWELVE_MONTH
    • 对于 3 年期承诺:THIRTY_SIX_MONTH
  • COMMITMENT_TYPE:您要承诺购买资源的机器系列。您可以使用以下选项:

    • ACCELERATOR_OPTIMIZED(适用于 A2 机器类型资源)
    • ACCELERATOR_OPTIMIZED_A3(适用于 A3 Edge 和 High 机器类型资源)
    • ACCELERATOR_OPTIMIZED_A3_MEGA(适用于 A3 Mega 机器类型资源)
    • COMPUTE_OPTIMIZED(适用于 C2 机器类型资源)
    • COMPUTE_OPTIMIZED_C2D(适用于 C2D 机器类型资源)
    • COMPUTE_OPTIMIZED_C3(适用于 C3 机器类型资源)
    • COMPUTE_OPTIMIZED_C3D(适用于 C3D 机器类型资源)
    • COMPUTE_OPTIMIZED_H3(适用于 H3 机器类型资源)
    • GENERAL_PURPOSE(适用于 N1 机器类型资源)
    • GENERAL_PURPOSE_C4(适用于 C4 机器类型资源)
    • GENERAL_PURPOSE_C4A(适用于 C4A 机器类型资源)
    • GENERAL_PURPOSE_E2(适用于 E2 机器类型资源)
    • GENERAL_PURPOSE_N2(适用于 N2 机器类型资源)
    • GENERAL_PURPOSE_N2D(适用于 N2D 机器资源)
    • GENERAL_PURPOSE_N4(适用于 N4 机器类型资源)
    • GENERAL_PURPOSE_T2D(适用于 Tau T2D 机器类型资源)
    • 适用于 G2 机器类型资源的 GRAPHICS_OPTIMIZED
    • MEMORY_OPTIMIZED(适用于M1 或 M2 机器类型资源)
    • MEMORY_OPTIMIZED_M3(适用于 M3 机器类型资源)
    • STORAGE_OPTIMIZED_Z3(适用于 Z3 机器类型资源)

  • NUMBER_VCPUS:您要承诺购买的 vCPU 数量。

  • MEMORY:您要承诺购买的内存量(以 MB 为单位),例如 10240MB。您可以以 256 MB 为增量指定此值。

  • CUSTOM_END_DATE:学期的自定义结束日期,格式必须为 YYYY-MM-DD。例如,如需指定自定义结束日期(2024 年 4 月 20 日),请将其格式设置为 2024-04-20

  • END_TIME:美国和加拿大太平洋时间零点(UTC-8 或 UTC-7),采用世界协调时间 (UTC) 的偏移量格式。请指定以下某个值:

    • 在夏令时期间:07:00:00
    • 在其他时间:08:00:00

如需详细了解如何在为 GPU 和/或本地 SSD 磁盘购买承诺时延长期限,请参阅购买包含附加预留的承诺

例如,设想 us-central1 区域中有一个名为 example-commitment 的 1 年期承诺,其中包含 4 个 N1 vCPU 和 9 GB 内存。假设您想在 2024 年 1 月 1 日购买此承诺,并希望自定义期限为 2025 年 6 月 30 日结束。如需购买此承诺,请发出以下请求:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources":
    [
        {
            "amount": "4",
            "type": "VCPU"
        },
        {
            "amount": "9216",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "2025-07-01T07:00:00Z",
}

延长现有承诺的期限

您可以通过更新承诺的属性来指定或更新自定义结束日期,从而延长现有有效承诺的有效期。

如需延长现有承诺的期限,请使用以下任一选项:

控制台

在发起期限延长操作之前,请在 Google Cloud 控制台中选择您要延长承诺期限的项目。

  1. 在 Google Cloud 控制台中,转到承诺使用折扣页面。

    转到“承诺使用折扣”

    系统会打开承诺列表页面,并显示硬件承诺标签页。

  2. 如需为承诺启动期限延长操作,请在硬件承诺标签页中选择有效的承诺,然后点击延长

    或者,您也可以执行以下操作:

    1. 承诺列表页面的硬件承诺标签页中,点击您要延长期限的有效承诺的名称。
    2. 在所选承诺的硬件承诺详情页面上,点击延长

    系统会针对所选的付款承诺显示延长窗格。

  3. 如需完成期限延长操作,请在相应提交的延长窗格中执行以下操作:

    1. 查看承诺详情
    2. 选择结束日期字段中,为您的承诺指定自定义结束日期。
    3. 承诺时间表部分中,查看新结束日期字段。
    4. 如需确认学期延期请求,请点击延期

gcloud

如需延长现有有效承诺的期限,请运行 gcloud compute commitments update 命令并添加 --custom-end-time 标志。

gcloud compute commitments update COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --custom-end-time=CUSTOM_END_DATE

替换以下内容:

  • COMMITMENT_NAME:承诺的名称
  • PROJECT_ID:项目的 ID
  • REGION:预订的区域,即您要承诺购买 Compute Engine 资源的区域。
  • CUSTOM_END_DATE:您为学期指定的自定义结束日期,格式为 YYYY-MM-DD,其中 YYYY 为年份,MM 为月份,DD 为日期。例如,如需指定自定义结束日期(2024 年 4 月 20 日),请将其格式设置为 2024-04-20

例如,请考虑在 us-central1 区域中为 4 个 N1 vCPU 和 9 GB 内存购买的 1 年期自定义期限承诺 example-commitment。此承诺购买于 2024 年 1 月 1 日,将于 2025 年 6 月 30 日到期。如需将其期限进一步延长至 2026 年 6 月 30 日结束,请运行以下命令:

gcloud compute commitments update example-commitment \
    --region=us-central1 \
    --project=my-project \
    --custom-end-time=2026-07-01

REST

如需延长现有有效承诺的期限,请向 regionCommitments.update 方法发出 PATCH 请求。在请求正文中,包含 customEndTimestamp 字段。

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

替换以下内容:

  • COMMITMENT_NAME:承诺的名称
  • REGION:预订的区域,即您要承诺购买 Compute Engine 资源的区域。
  • PROJECT_ID:项目的 ID
  • CUSTOM_END_DATE:您为学期指定的自定义结束日期,格式为 YYYY-MM-DD,其中 YYYY 为年份,MM 为月份,DD 为日期。例如,如需指定自定义结束日期(2024 年 4 月 20 日),请将其格式设置为 2024-04-20
  • END_TIME:美国和加拿大太平洋时间零点(UTC-8 或 UTC-7),采用世界协调时间 (UTC) 的偏移量格式。请指定以下某个值:

    • 在夏令时期间:07:00:00
    • 在其他时间:08:00:00

例如,请考虑在 us-central1 区域中为 4 个 N1 vCPU 和 9 GB 内存购买的 1 年期自定义期限承诺 example-commitment。此承诺购买于 2024 年 1 月 1 日,将于 2025 年 6 月 30 日到期。如需将其期限进一步延长至 2026 年 6 月 30 日结束,请发出以下请求:

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments/example-commitment
{
    "name": "example-commitment",
    "customEndTimestamp": "2026-07-01T07:00:00Z",
}

后续步骤