本文档介绍了如何创建单项目未来预留请求。
如果 Google Cloud 批准了您的单项目未来预留请求,那么,在请求中指定的开始时间,Compute Engine 会自动创建只能由同一项目中创建的虚拟机 (VM) 实例使用的预留。
准备工作
- 如果您尚未这样做,请查看未来预留的工作原理。
-
如果您尚未设置身份验证,请进行设置。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例,您可以按如下方式向 Compute Engine 进行身份验证。
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
创建未来预留请求:针对项目的
compute.futureReservations.create
权限 -
让 Compute Engine 自动创建预留:针对项目的
compute.reservations.create
权限 -
如需指定实例模板:实例模板的
compute.instanceTemplates.useReadOnly
权限 推荐:指定实例模板
本部分介绍如何使用现有实例模板来定义未来预留请求的属性。使用实例模板,您可以定义未来预留的属性,以及可以使用同一位置的自动创建预留的虚拟机。
-
本部分介绍了如何直接定义未来预留请求的属性。此方法要求您手动确保虚拟机属性和自动创建预留完全匹配 - 任何不匹配的属性都会阻止使用。
在 Google Cloud 控制台中,转到预留页面。
点击未来预留标签页。
点击
创建未来预留。创建未来预留页面会打开。
在名称字段中,为未来预留请求输入名称。
在前缀字段中,输入名称前缀。此未来预留请求中每个自动创建预留的名称以此前缀开头。
为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。
可选:在说明字段中,输入未来预留请求的说明。
在区域字段中,选择要预留哪个区域的资源。
在可用区字段中,选择要预留哪个可用区的资源。
在开始时间字段中,输入预留期的开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。
请务必指定开始时间的建议值,以确保在未来预留进入锁定时间之前有足够的时间。
在结束时间字段中,输入预留期的结束时间。预留期必须至少持续 24 小时。
在时长摘要部分中,您可以查看预留期时长。为了提高 Google Cloud 在提交未来预留请求以供审核后对其进行批准的可能性,请确保指定预留期的推荐值。
在共享类型部分中,选择本地(默认)。
在虚拟机实例数量字段中,输入您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。
在临近开始时间之前计算要为批准的未来预留请求创建的新预留数量时,Compute Engine 会从此总数中减去与该请求匹配的所有现有预留数。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
在机器配置部分中,执行以下操作:
如需使用现有实例模板指定虚拟机的属性,请选择使用实例模板。
在实例模板字段中,选择所需的实例模板。如果选择区域级实例模板,则只能在该实例模板所在的区域内预留资源。
在自动生成的预留自动删除时间部分,执行以下操作之一:
如需使 Compute Engine 能够自动删除未来预留请求的自动创建预留,请执行以下操作:
点击启用自动删除切换开关,以切换到开启的位置(默认)。
可选:在自动删除时间字段中,输入删除自动创建预留的新日期和时间。该日期和时间必须晚于预留期的结束时间。如果您将此字段留空,则自动创建预留将在预留期结束时间后的 2 小时内删除。
否则,请点击启用自动删除切换开关,以切换到关闭位置。
执行下列其中一项操作:
如需创建未来预留请求并将其提交给 Google Cloud 进行审核,请点击提交。
如需创建未来预留请求草稿,请点击保存草稿。
要退出但不保存,请点击取消。
FUTURE_RESERVATION_NAME
:要创建的未来预留请求的名称。DESCRIPTION
:可选。未来预留请求的说明。NAME_PREFIX
:未来预留请求的名称前缀。此未来预留请求的每个自动创建预留的名称都以名称前缀开头。为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。PLANNING_STATUS
:可选。未来预留请求的规划状态,必须是以下其中一项:如需创建未来预留请求的草稿,请指定
DRAFT
。如需创建未来预留请求并将其提交给 Google Cloud 进行批准,请指定
SUBMITTED
。
如果省略
--planning-status
标志,则其值设置为DRAFT
。PROJECT_ID
:您要预留资源的项目的 ID 和实例模板所在的项目。LOCATION
:实例模板的位置。请指定以下某个值:对于全球实例模板:
global
。对于区域级实例模板:
regions/REGION
。将REGION
替换为实例模板所在的区域。如果您指定了区域级实例模板,则只能在该实例模板所在的区域内预留虚拟机。
INSTANCE_TEMPLATE_NAME
:现有实例模板的名称。如果您指定了实例模板,则在创建未来预留请求时,您无法替换其属性。否则,您会遇到错误。START_TIME
:采用 RFC 3339 时间戳格式的预留期开始时间,必须如下所示:YYYY-MM-DDTHH:MM:SSOFFSET
替换以下内容:
YYYY-MM-DD
:格式为 4 位数年份、2 位数月份和 2 位数日期而且相互之间以连字符 (-
) 分隔的日期。HH:MM:SS
:格式为 2 位数小时、2 位数分钟和 2 位数秒而且相互之间以冒号 (:
) 分隔的采用 24 小时制的时间。OFFSET
:采用世界协调时间 (UTC) 的偏移量格式的时区。 例如,要使用太平洋标准时间 (PST),请指定-08:00
。或者,如果不使用时差,请指定Z
。
开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。为了在批准之后或者进入锁定时间之前有足够的时间选择性地取消、删除或修改未来预留请求,请务必指定开始时间的建议值。
END_TIME
:采用 RFC 3339 时间戳格式的预留期结束时间。预留期必须至少持续 24 小时。或者,您可以将--end-time
标志替换为--duration=END_DURATION
标志,其中END_DURATION
是预留期的时长,以秒表示。例如,指定1209600
表示 1,209,600 秒(14 天)。为了提高 Google Cloud 在您提交未来预留请求以供审核后批准该请求的可能性,请务必指定其中一个预留期建议值。
TOTAL_COUNT
:您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。计算要为已获批准的未来预留创建的预留数量时,Compute Engine 会首先检查现有预留。如果现有预留与已获批准的未来预留匹配,则系统会从该请求中所请求的预留总数减去现有预留数量,以确定 Compute Engine 创建的新预留的数量。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
ZONE
:要在其中预留资源的可用区。如需在预留期结束时间后删除自动创建预留,请选择以下方法之一:
如需在预留期结束时间后的特定时间删除自动创建预留,请指定
--auto-delete-auto-created-reservations
和--auto-created-reservations-delete-time
标志。gcloud beta compute future-reservations create example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \ ...
将
AUTO_CREATED_RESERVATIONS_DELETE_TIME
替换为采用 RFC 3339 时间戳格式的日期和时间。如需在预留期结束时间后的特定时长之后删除自动创建的预留,请指定
--auto-delete-auto-created-reservations
和--auto-created-reservations-duration
标志。gcloud beta compute future-reservations create example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE \ ...
将
DURATION_BEFORE_DELETE
替换为以天、小时、分钟或秒为单位的时长。例如,指定30m
表示 30 分钟,或指定1d2h3m4s
表示 1 天 2 小时 3 分钟 4 秒。
如需停用 Compute Engine,使其无法自动删除自动创建的预留,请指定
--no-auto-delete-auto-created-reservations
标志。 如果要将自动创建的预留附加到承诺,则必须停用自动删除选项。gcloud beta compute future-reservations create example-future-reservation \ --no-auto-delete-auto-created-reservations \ ...
PROJECT_ID
:您要预留资源的项目的 ID 和实例模板所在的项目。ZONE
:您要在其中预留资源的可用区。AUTO_DELETE_AUTO_CREATED_RESERVATIONS
:如果将此字段设置为true
,则 Compute Engine 会自动删除此未来预留请求的自动创建预留,无论这些预留是否已被使用。如果要将自动创建的预留附加到承诺,请将此字段设置为false
。默认情况下,删除时间为预留期结束时间后的 2 小时内。如需更改此设置,请执行以下操作之一:
如需在预留期结束时间后的特定时间删除自动创建的预留,请将
autoDeleteAutoCreatedReservations
设置为true
并指定autoCreatedReservationsDeleteTime
字段。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME", ... }
将
DELETE_TIME
替换为 Compute Engine 删除自动创建预留的日期和时间。日期和时间必须采用 RFC 3339 时间戳格式,并且必须如下所示:YYYY-MM-DDTHH:MM:SSOFFSET
替换以下内容:
YYYY-MM-DD
:格式为 4 位数年份、2 位数月份和 2 位数日期而且相互之间以连字符 (-
) 分隔的日期。HH:MM:SS
:格式为 2 位数小时、2 位数分钟和 2 位数秒而且相互之间以冒号 (:
) 分隔的采用 24 小时制的时间。OFFSET
:采用世界协调时间 (UTC) 时差格式的时区。例如,如需使用太平洋标准时间 (PST) 时区,请指定-08:00
。或者,如果不使用时差,请指定Z
。
如需在预留期开始时间起的特定时长后删除自动创建的预留,请将
autoDeleteAutoCreatedReservations
设置为true
并指定autoCreatedReservationsDuration
字段。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" }, ... }
将
DURATION_BEFORE_DELETE
替换为持续时间,以秒为单位。例如,指定604800
表示 604,800 秒(7 天)。
DESCRIPTION
:可选。未来预留请求的说明。FUTURE_RESERVATION_NAME
:要创建的未来预留请求的名称。NAME_PREFIX
:未来预留请求的名称前缀。此未来预留请求的每个自动创建预留的名称都以名称前缀开头。为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。PLANNING_STATUS
:可选。未来预留请求的规划状态,必须是以下其中一项:如需创建未来预留请求的草稿,请指定
DRAFT
。如需创建未来预留请求并将其提交给 Google Cloud 进行批准,请指定
SUBMITTED
。
如果省略
planningStatus
字段,则其值设置为DRAFT
。LOCATION
:实例模板的位置。请指定以下某个值:对于全球实例模板:
global
。对于区域级实例模板:
regions/REGION
。将REGION
替换为实例模板所在的区域。如果您指定了区域级实例模板,则只能在该实例模板所在的区域内预留虚拟机。
INSTANCE_TEMPLATE_NAME
:现有实例模板的名称。如果您指定了实例模板,则在创建未来预留请求时,您无法替换其属性。否则,您会遇到错误。TOTAL_COUNT
:您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。计算要为已获批准的未来预留创建的预留数量时,Compute Engine 会首先检查现有预留。如果现有预留与已获批准的未来预留匹配,则系统会从该请求中所请求的预留总数减去现有预留数量,以确定 Compute Engine 创建的新预留的数量。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
START_TIME
:采用 RFC 3339 时间戳格式的预留期开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。此外,请务必指定开始时间的建议值,以确保在未来预留进入锁定时间之前有足够的时间。END_TIME
:采用 RFC 3339 时间戳格式的预留期结束时间。预留期必须至少持续 24 小时。或者,您可以将endTime
字段替换为duration
字段,以指定从预留期开始时间起的具体时长:"duration": { "seconds": "END_DURATION" }
将
END_DURATION
替换为持续时间,以秒为单位。例如,指定1209600
表示 1,209,600 秒(14 天)。为了提高 Google Cloud 在您提交未来预留请求以供审核后批准该请求的可能性,请务必指定其中一个预留期建议值。
在 Google Cloud 控制台中,转到预留页面。
点击未来预留标签页。
点击
创建未来预留。创建未来预留页面会打开。
在名称字段中,为未来预留请求输入名称。
在前缀字段中,输入名称前缀。此未来预留请求中每个自动创建预留的名称以此前缀开头。
为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。
可选:在说明字段中,输入未来预留请求的说明。
在区域字段中,选择要预留哪个区域的资源。
在可用区字段中,选择要预留哪个可用区的资源。
在开始时间字段中,输入预留期的开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。
请务必指定开始时间的建议值,以确保在未来预留进入锁定时间之前有足够的时间。
在结束时间字段中,输入预留期的结束时间。预留期必须至少持续 24 小时。
在时长摘要部分中,您可以查看预留期时长。为了提高 Google Cloud 在提交未来预留请求以供审核后对其进行批准的可能性,请确保指定预留期的推荐值。
在共享类型部分中,选择本地(默认)。
在虚拟机实例数量字段中,输入您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。
在临近开始时间之前计算要为批准的未来预留请求创建的新预留数量时,Compute Engine 会从此总数中减去与该请求匹配的所有现有预留数。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
在机器配置部分中,执行以下操作:
选择指定机器类型(默认)。
从下列选项中选择一项:
对于常见工作负载,请点击通用标签页(默认)。
对于需要高性能的工作负载,请点击计算优化标签页。
对于内存与 vCPU 比率较高的工作负载,请点击内存优化标签页。
对于使用图形处理单元 (GPU) 的工作负载,请点击 GPU 标签页。
执行下列其中一项操作:
如果您在上一步中指定了通用、计算优化或内存优化,请执行以下操作:
在系列列表中,选择一个机器系列。
在机器类型列表中,选择一种机器类型。
可选:如需进一步自定义要请求预留的虚拟机,请展开高级配置并按照提示进行操作。
如果您在上一步中指定了 GPU,请执行以下操作:
在 GPU 类型菜单中,选择 GPU 的类型。
在 GPU 数量菜单中,选择 GPU 的数量。
可选:如果 GPU 类型允许,并且您希望使用预留资源运行图形密集型工作负载,请选中启用虚拟工作站 (NVIDIA GRID) 复选框。
在机器类型列表中,选择一种机器类型。
在 CPU 平台列表中,为您请求预留的虚拟机选择一个 CPU 平台。
可选:如果机器类型允许,并且您想要添加本地 SSD,请执行以下操作:
在磁盘数量字段中,选择本地 SSD 的磁盘数量。
在接口类型部分,选择以下接口之一:
SCSI(默认)
NVMe
在自动生成的预留自动删除时间部分,执行以下操作之一:
如需使 Compute Engine 能够自动删除未来预留请求的自动创建预留,请执行以下操作:
点击启用自动删除切换开关,以切换到开启的位置(默认)。
可选:在自动删除时间字段中,输入删除自动创建预留的新日期和时间。该日期和时间必须晚于预留期的结束时间。如果您将此字段留空,则自动创建预留将在预留期结束时间后的 2 小时内删除。
否则,请点击启用自动删除切换开关,以切换到关闭位置。
执行下列其中一项操作:
如需创建未来预留请求并将其提交给 Google Cloud 进行审核,请点击提交。
如需创建未来预留请求草稿,请点击保存草稿。
要退出但不保存,请点击取消。
FUTURE_RESERVATION_NAME
:要创建的未来预留请求的名称。可选:如需向每个预留的虚拟机添加图形处理单元 (GPU),请指定以下内容:
NUMBER_OF_ACCELERATORS
:要为每个预留虚拟机添加的 GPU 数量。ACCELERATOR_TYPE
:要添加到已预留虚拟机的 GPU 的类型。
确保您在未来预留请求中指定的机器类型支持您指定的 GPU 类型,并且该 GPU 在您要预留资源的可用区中可用。否则,您会遇到错误。
DESCRIPTION
:可选。未来预留请求的说明。INTERFACE_1
和INTERFACE_2
:可选。 您希望每个虚拟机的本地 SSD 使用的接口类型。该值必须为以下项之一:如果您的启动磁盘映像具有优化的 NVMe 驱动程序,请指定
nvme
。否则,请指定
scsi
。
每个本地 SSD 为 375 GB。对您要添加的每个本地 SSD 重复使用
--local-ssd
标志。您最多可以指定 24 个本地 SSD。MACHINE_TYPE
:要用于每个虚拟机的机器类型。 请指定以下某个值:对于预定义机器类型:
MACHINE_FAMILY-standard-CPUS
。对于自定义机器类型:
MACHINE_FAMILY-custom-CPUS-MEMORY
。在指定自定义机器类型之前,请查看自定义机器类型的虚拟机的限制。
替换以下内容:
MACHINE_FAMILY
:机器系列。CPUS
:vCPU 的数量。MEMORY
:预留虚拟机的总内存。 内存必须是 256 MB 的整数倍,且必须以 MB 为单位提供。
例如,如需指定配备 4 个 vCPU 和 5 GB(即 5,120 MB)内存的 N2 自定义机器类型,请指定
n2-custom-4-5120
。MINIMUM_CPU_PLATFORM
:可选。用于每个虚拟机的满足最低要求的 CPU 平台。如果您省略--min-cpu-platform
标志,则其值设置为可用区的默认 CPU 平台。NAME_PREFIX
:未来预留请求的名称前缀。此未来预留请求的每个自动创建预留的名称都以名称前缀开头。为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。PLANNING_STATUS
:可选。未来预留请求的规划状态,必须是以下其中一项:如需创建未来预留请求的草稿,请指定
DRAFT
。如需创建未来预留请求并将其提交给 Google Cloud 进行批准,请指定
SUBMITTED
。
如果省略
--planning-status
标志,则其值设置为DRAFT
。PROJECT_ID
:您要在其中预留资源的项目的 ID。START_TIME
:采用 RFC 3339 时间戳格式的预留期开始时间,必须如下所示:YYYY-MM-DDTHH:MM:SSOFFSET
替换以下内容:
YYYY-MM-DD
:格式为 4 位数年份、2 位数月份和 2 位数日期而且相互之间以连字符 (-
) 分隔的日期。HH:MM:SS
:格式为 2 位数小时、2 位数分钟和 2 位数秒而且相互之间以冒号 (:
) 分隔的采用 24 小时制的时间。OFFSET
:采用世界协调时间 (UTC) 的偏移量格式的时区。 例如,要使用太平洋标准时间 (PST),请指定-08:00
。或者,如果不使用时差,请指定Z
。
开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。为了在批准之后或者进入锁定时间之前有足够的时间选择性地取消、删除或修改未来预留请求,请务必指定开始时间的建议值。
END_TIME
:采用 RFC 3339 时间戳格式的预留期结束时间。预留期必须至少持续 24 小时。或者,您可以将--end-time
标志替换为--duration=END_DURATION
标志,其中END_DURATION
是预留期的时长,以秒表示。例如,指定1209600
表示 1,209,600 秒(14 天)。为了提高 Google Cloud 在您提交未来预留请求以供审核后批准该请求的可能性,请务必指定其中一个预留期建议值。
TOTAL_COUNT
:您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。计算要为已获批准的未来预留创建的预留数量时,Compute Engine 会首先检查现有预留。如果现有预留与已获批准的未来预留匹配,则系统会从该请求中所请求的预留总数减去现有预留数量,以确定 Compute Engine 创建的新预留的数量。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
ZONE
:要在其中预留资源的可用区。如需在预留期结束时间后删除自动创建预留,请选择以下方法之一:
如需在预留期结束时间后的特定时间删除自动创建预留,请指定
--auto-delete-auto-created-reservations
和--auto-created-reservations-delete-time
标志。gcloud beta compute future-reservations create example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \ ...
将
AUTO_CREATED_RESERVATIONS_DELETE_TIME
替换为采用 RFC 3339 时间戳格式的日期和时间。如需在预留期结束时间后的特定时长之后删除自动创建的预留,请指定
--auto-delete-auto-created-reservations
和--auto-created-reservations-duration
标志。gcloud beta compute future-reservations create example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE \ ...
将
DURATION_BEFORE_DELETE
替换为以天、小时、分钟或秒为单位的时长。例如,指定30m
表示 30 分钟,或指定1d2h3m4s
表示 1 天 2 小时 3 分钟 4 秒。
如需停用 Compute Engine,使其无法自动删除自动创建的预留,请指定
--no-auto-delete-auto-created-reservations
标志。 如果要将自动创建的预留附加到承诺,则必须停用自动删除选项。gcloud beta compute future-reservations create example-future-reservation \ --no-auto-delete-auto-created-reservations \ ...
PROJECT_ID
:您要在其中预留资源的项目的 ID。ZONE
:您要在其中预留资源的可用区。AUTO_DELETE_AUTO_CREATED_RESERVATIONS
:如果将此字段设置为true
,则 Compute Engine 会自动删除此未来预留请求的自动创建预留,无论这些预留是否已被使用。如果要将自动创建的预留附加到承诺,请将此字段设置为false
。默认情况下,删除时间为预留期结束时间后的 2 小时内。如需更改此设置,请执行以下操作之一:
如需在预留期结束时间后的特定时间删除自动创建的预留,请将
autoDeleteAutoCreatedReservations
设置为true
并指定autoCreatedReservationsDeleteTime
字段。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME", ... }
将
DELETE_TIME
替换为 Compute Engine 删除自动创建预留的日期和时间。日期和时间必须采用 RFC 3339 时间戳格式,并且必须如下所示:YYYY-MM-DDTHH:MM:SSOFFSET
替换以下内容:
YYYY-MM-DD
:格式为 4 位数年份、2 位数月份和 2 位数日期而且相互之间以连字符 (-
) 分隔的日期。HH:MM:SS
:格式为 2 位数小时、2 位数分钟和 2 位数秒而且相互之间以冒号 (:
) 分隔的采用 24 小时制的时间。OFFSET
:采用世界协调时间 (UTC) 时差格式的时区。例如,如需使用太平洋标准时间 (PST) 时区,请指定-08:00
。或者,如果不使用时差,请指定Z
。
如需在预留期开始时间起的特定时长后删除自动创建的预留,请将
autoDeleteAutoCreatedReservations
设置为true
并指定autoCreatedReservationsDuration
字段。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" }, ... }
将
DURATION_BEFORE_DELETE
替换为持续时间,以秒为单位。例如,指定604800
表示 604,800 秒(7 天)。
DESCRIPTION
:可选。未来预留请求的说明。FUTURE_RESERVATION_NAME
:要创建的未来预留请求的名称。NAME_PREFIX
:未来预留请求的名称前缀。此未来预留请求的每个自动创建预留的名称都以名称前缀开头。为了帮助您识别此未来预留请求的自动创建预留,建议指定唯一的名称前缀。PLANNING_STATUS
:可选。未来预留请求的规划状态,必须是以下其中一项:如需创建未来预留请求的草稿,请指定
DRAFT
。如需创建未来预留请求并将其提交给 Google Cloud 进行批准,请指定
SUBMITTED
。
如果省略
planningStatus
字段,则其值设置为DRAFT
。可选:如需向每个预留的虚拟机添加图形处理单元 (GPU),请指定以下内容:
NUMBER_OF_ACCELERATORS
:要为每个预留虚拟机添加的 GPU 数量。ACCELERATOR_TYPE
:要添加到已预留虚拟机的 GPU 的类型。
确保您在未来预留请求中指定的机器类型支持您指定的 GPU 类型,并且该 GPU 在您要预留资源的可用区中可用。否则,您会遇到错误。
INTERFACE_1
和INTERFACE_2
:可选。 您希望每个虚拟机的本地 SSD 使用的接口类型。该值必须为以下项之一:如果您的启动磁盘映像具有优化的 NVMe 驱动程序,请指定
NVME
。否则,请指定
SCSI
。
每个本地 SSD 为 375 GB。对您要添加的每个本地 SSD 重复使用
--local-ssd
标志。您最多可以指定 24 个本地 SSD。MACHINE_TYPE
:要用于每个虚拟机的机器类型。 请指定以下某个值:对于预定义机器类型:
MACHINE_FAMILY-standard-CPUS
。对于自定义机器类型:
MACHINE_FAMILY-custom-CPUS-MEMORY
。在指定自定义机器类型之前,请查看自定义机器类型的虚拟机的限制。
替换以下内容:
MACHINE_FAMILY
:机器系列。CPUS
:vCPU 的数量。MEMORY
:预留虚拟机的总内存。 内存必须是 256 MB 的整数倍,且必须以 MB 为单位提供。
例如,如需指定配备 4 个 vCPU 和 5 GB(即 5,120 MB)内存的 N2 自定义机器类型,请指定
n2-custom-4-5120
。MINIMUM_CPU_PLATFORM
:可选。用于每个虚拟机的满足最低要求的 CPU 平台。如果您省略--min-cpu-platform
标志,则其值设置为可用区的默认 CPU 平台。TOTAL_COUNT
:您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。计算要为已获批准的未来预留创建的预留数量时,Compute Engine 会首先检查现有预留。如果现有预留与已获批准的未来预留匹配,则系统会从该请求中所请求的预留总数减去现有预留数量,以确定 Compute Engine 创建的新预留的数量。如需了解详情,请参阅 Compute Engine 如何计算和预配预留资源。
START_TIME
:采用 RFC 3339 时间戳格式的预留期开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。此外,请务必指定开始时间的建议值,以确保在未来预留进入锁定时间之前有足够的时间。END_TIME
:采用 RFC 3339 时间戳格式的预留期结束时间。预留期必须至少持续 24 小时。或者,您可以将endTime
字段替换为duration
字段,以指定从预留期开始时间起的具体时长:"duration": { "seconds": "END_DURATION" }
将
END_DURATION
替换为持续时间,以秒为单位。例如,指定1209600
表示 1,209,600 秒(14 天)。为了提高 Google Cloud 在您提交未来预留请求以供审核后批准该请求的可能性,请务必指定其中一个预留期建议值。
在 Google Cloud 控制台中,转到预留页面。
点击未来预留标签页。
在名称列中,点击采购状态为正在草拟的未来预留请求的名称。
系统会打开未来预留页面,其中包含未来预留请求的详细信息。
点击
修改草稿。系统会打开未来预留请求草稿的详情页面。
如需将未来预留请求草稿提交给 Google Cloud 审核,请点击提交。
FUTURE_RESERVATION_NAME
:现有未来预留请求草稿的名称。PROJECT_ID
:未来预留请求所在项目的 ID。ZONE
:未来预留请求所在的可用区。PROJECT_ID
:未来预留请求所在项目的 ID。ZONE
:未来预留请求所在的可用区。FUTURE_RESERVATION_NAME
:现有未来预留请求草稿的名称。如需监控请求的采购状态并查看 Google Cloud 是批准还是拒绝您的请求,请查看未来预留请求的详细信息。
如需阻止 Google Cloud 审核您的请求并阻止 Compute Engine 预配请求的容量,请取消或删除未来预留请求。
了解如何查看未来预留请求。
了解如何修改、取消或删除未来预留请求。
到预留期的开始时间后,您就可以了解如何使用自动创建预留。
REST
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭据。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。
所需的角色
如需获得创建单项目未来预留请求所需的权限,请让您的管理员为您授予项目的 Compute Future Reservation User (
roles/compute.futureReservationUser
) IAM 角色。如需详细了解如何授予角色,请参阅管理访问权限。此预定义角色包含创建单项目未来预留请求所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
创建单项目未来预留请求需要具备以下权限:
创建单项目未来预留请求
本部分介绍了如何创建单项目未来预留请求。
如需使用未来预留的自动创建预留,虚拟机必须具有完全匹配该预留的属性。如需通过创建未来预留请求来指定要请求预留的虚拟机的属性,请选择以下方法之一:
任何具有匹配属性的虚拟机都会自动使用未来预留的自动创建预留。如果要避免虚拟机使用任何此类自动创建预留,请参阅如何创建不使用预留的虚拟机。
指定实例模板
您可以使用 Google Cloud 控制台、gcloud CLI 和 REST 指定现有实例模板,以创建单项目未来预留。
控制台
如需通过指定实例模板来创建单项目未来预留请求,请按照以下步骤操作:
此时会打开预留页面。创建未来预留请求最多可能需要一分钟才能完成。
gcloud
如需通过指定实例模板创建单项目未来预留请求,请在
gcloud beta compute future-reservations create
命令中使用--source-instance-template
标志。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --description="DESCRIPTION" \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
替换以下内容:
当您指定
--auto-delete-auto-created-reservations
标志时,Compute Engine 会自动删除您未来预留请求的自动创建预留。默认情况下,删除时间为预留期结束时间后的 2 小时内。(可选)您可以通过执行以下操作之一来更改此设置:例如,以下命令可使用
example-template
全球实例模板为 80 个虚拟机创建未来预留请求的草稿。 预留期从 UTC 2023 年 11 月 10 日半夜 12 点开始,到 2023 年 12 月 10 日半夜 12 点结束。 未来预留的自动创建预留在可用区us-central1-a
中创建,名称以fr-01-reservation
开头,并于世界协调时间 (UTC) 2023 年 12 月 13 日半夜 12 点自动删除。gcloud beta compute future-reservations create fr-01 \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \ --name-prefix=fr-01-reservation \ --planning-status=DRAFT \ --project=example-project \ --source-instance-template=projects/example-project/global/instanceTemplates/example-template \ --start-time=2023-11-10T00:00:00Z \ --end-time=2023-12-10T00:00:00Z \ --total-count=80 \ --zone=us-central1-a
REST
要通过指定实例模板创建单项目未来预留请求,请向
beta.futureReservations.insert
方法发出POST
请求。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "specificSkuProperties": { "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME", "totalCount": "TOTAL_COUNT" }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
替换以下内容:
例如,以下命令可使用
example-template
全球实例模板为 80 个虚拟机创建未来预留请求的草稿。 预留期从 UTC 2023 年 11 月 10 日半夜 12 点开始,到 2023 年 12 月 10 日半夜 12 点结束。 未来预留的自动创建预留在可用区us-central1-a
中创建,名称以fr-01-reservation
开头,并于世界协调时间 (UTC) 2023 年 12 月 13 日半夜 12 点自动删除。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z", "name": "fr-01", "namePrefix": "fr-01-reservation", "specificSkuProperties": { "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template", "totalCount": "80" }, "planningStatus": "DRAFT", "timeWindow": { "startTime": "2023-11-10T00:00:00Z", "endTime": "2023-12-10T00:00:00Z" } }
直接指定虚拟机属性
您可以使用 Google Cloud 控制台、gcloud CLI 和 REST 直接指定属性,以创建单项目未来预留。
控制台
如需通过直接指定属性创建单项目未来预留请求,请按以下步骤操作:
此时会打开预留页面。创建未来预留请求最多可能需要一分钟才能完成。
gcloud
如需通过直接指定属性来创建单项目未来预留请求,请使用
gcloud beta compute future-reservations create
命令。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --auto-delete-auto-created-reservations \ --description="DESCRIPTION" \ --local-ssd=size=375,interface=INTERFACE_1 \ --local-ssd=size=375,interface=INTERFACE_2 \ --machine-type=MACHINE_TYPE \ --min-cpu-platform=MIN_CPU_PLATFORM \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
替换以下内容:
当您指定
--auto-delete-auto-created-reservations
标志时,Compute Engine 会自动删除您未来预留请求的自动创建预留。默认情况下,删除时间为预留期结束时间后的 2 小时内。(可选)您可以通过执行以下操作之一来更改此设置:例如,以下命令会为 80 个虚拟机创建未来预留请求草稿。预留期从 UTC 2023 年 11 月 10 日半夜 12 点开始,到 2023 年 12 月 10 日半夜 12 点结束。 预留虚拟机指定了机器类型
n2-standard-4
、满足最低要求的 CPU 平台skylake
和 1 个具有scsi
接口和 375 GB 的本地 SSD。未来预留的自动创建预留在可用区us-central1-a
中创建,名称以fr-01-reservation
开头,并于世界协调时间 (UTC) 2023 年 12 月 13 日半夜 12 点自动删除。gcloud beta compute future-reservations create fr-01 \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \ --local-ssd=size=375,interface=scsi \ --machine-type=n2-standard-4 \ --min-cpu-platform=skylake \ --name-prefix=fr-01-reservation \ --planning-status=DRAFT \ --project=example-project \ --start-time=2023-11-10T00:00:00Z \ --end-time=2023-12-10T00:00:00Z \ --total-count=80 \ --zone=us-central1-a
REST
如需通过直接指定属性创建单项目未来预留请求,请向
beta.futureReservations.insert
方法发出POST
请求。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "specificSkuProperties": { "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" }, "totalCount": "TOTAL_COUNT" }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
替换以下内容:
例如,以下命令会为 80 个虚拟机创建未来预留请求草稿。预留期从 UTC 2023 年 11 月 10 日半夜 12 点开始,到 2023 年 12 月 10 日半夜 12 点结束。 预留虚拟机指定了机器类型
n2-standard-4
、满足最低要求的 CPU 平台skylake
和 1 个具有SCSI
接口和 375 GB 的本地 SSD。未来预留的自动创建预留在可用区us-central1-a
中创建,名称以fr-01-reservation
开头,并于世界协调时间 (UTC) 2023 年 12 月 13 日半夜 12 点自动删除。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z", "name": "fr-01", "namePrefix": "fr-01-reservation", "specificSkuProperties": { "instanceProperties": { "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ], "machineType": "n2-standard-4", "minCpuPlatform": "Skylake" }, "totalCount": "80" }, "planningStatus": "DRAFT", "timeWindow": { "startTime": "2023-11-10T00:00:00Z", "endTime": "2023-12-10T00:00:00Z" } }
提交未来预留请求草稿以供审核
您可以使用 Google Cloud 控制台、gcloud CLI 和 REST 向 Google Cloud 提交未来预留请求草稿以供审核。如果您还想在提交未来预留请求草稿以供审核时修改一个或多个属性,请参阅修改草稿或被拒绝的未来预留请求。
控制台
要提交未来预留请求草稿以供审核,请按以下步骤操作:
此时会打开预留页面。在您刚刚提交的未来预留请求的状态列中,采购状态设置为待审批。
gcloud
如需提交未来预留请求草稿以供审核,请使用
gcloud beta compute future-reservations update
命令,并将--planning-status
标志设置为SUBMITTED
。gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --planning-status=SUBMITTED \ --project=PROJECT_ID \ --zone=ZONE
替换以下内容:
REST
如需提交未来预留请求草稿以供审核,请向
beta.futureReservations.update
方法发出PATCH
请求,并将planningStatus
字段设置为SUBMITTED
。PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus { "name": "FUTURE_RESERVATION_NAME", "planningStatus": "SUBMITTED" }
替换以下内容:
提交未来预留请求草稿以供审核后,您可以执行以下操作:
问题排查
如果您在创建未来预留请求时遇到错误,请参阅如何排查未来预留请求问题。
如果您在排查问题后仍遇到问题,请与您的技术支持客户经理或销售团队联系。
后续步骤
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-05。
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"翻译问题" },{ "type": "thumb-down", "id": "otherDown", "label":"其他" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"易于理解" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"解决了我的问题" },{ "type": "thumb-up", "id": "otherUp", "label":"其他" }] -