为单个项目创建未来预留请求

本文档介绍了如何创建单项目未来预留请求。

如果 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
1. 安装 Google Cloud CLI，然后通过运行以下命令初始化 Google Cloud CLI：
```
gcloud init
```
  注意：如果您之前安装了 gcloud CLI，请确保通过运行 gcloud components update 获得最新版本。
2. Set a default region and zone.

所需的角色

如需获得创建单项目未来预留请求所需的权限，请让您的管理员为您授予项目的 Compute Future Reservation User (roles/compute.futureReservationUser) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

此预定义角色包含创建单项目未来预留请求所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

创建单项目未来预留请求需要具备以下权限：

创建未来预留请求：针对项目的 compute.futureReservations.create 权限
让 Compute Engine 自动创建预留：针对项目的 compute.reservations.create 权限
如需指定实例模板：实例模板的 compute.instanceTemplates.useReadOnly 权限

您也可以使用自定义角色或其他预定义角色来获取这些权限。

创建单项目未来预留请求

本部分介绍了如何创建单项目未来预留请求。

如需使用未来预留的自动创建预留，虚拟机必须具有完全匹配该预留的属性。如需通过创建未来预留请求来指定要请求预留的虚拟机的属性，请选择以下方法之一：

推荐：指定实例模板

本部分介绍如何使用现有实例模板来定义未来预留请求的属性。使用实例模板，您可以定义未来预留的属性，以及可以使用同一位置的自动创建预留的虚拟机。
直接指定属性

本部分介绍了如何直接定义未来预留请求的属性。此方法要求您手动确保虚拟机属性和自动创建预留完全匹配 - 任何不匹配的属性都会阻止使用。

任何具有匹配属性的虚拟机都会自动使用未来预留的自动创建预留。如果要避免虚拟机使用任何此类自动创建预留，请参阅如何创建不使用预留的虚拟机。

指定实例模板

您可以使用 Google Cloud 控制台、gcloud CLI 和 REST 指定现有实例模板，以创建单项目未来预留。

注意：在使用实例模板创建未来预留请求之前，请确保满足以下条件：

您必须在与实例模板中的资源相同的区域和可用区中创建未来预留请求。在实例模板中指定的任何区域级资源或可用区级资源（例如机器类型或磁盘）会将模板的使用范围限制为这些资源所在的位置。例如，如果您的实例模板指定了 us-central1-a 可用区中的现有磁盘，则必须在同一可用区中创建未来预留。否则，创建未来预留请求会失败。

如需检查现有模板是否指定了任何将模板绑定到特定区域或可用区的资源，请查看模板详细信息并查找对其中的区域级资源或可用区级资源的引用。
创建未来预留请求后，您将无法修改该未来预留请求来替换该模板的虚拟机属性，也无法指定其他模板。但是，您必须使用所需的更新创建新的未来预留请求。

控制台

如需通过指定实例模板来创建单项目未来预留请求，请按照以下步骤操作：

在 Google Cloud 控制台中，转到预留页面。

转到“预留”
点击未来预留标签页。
点击 创建未来预留。

创建未来预留页面会打开。
在名称字段中，为未来预留请求输入名称。
在前缀字段中，输入名称前缀。此未来预留请求中每个自动创建预留的名称以此前缀开头。

为了帮助您识别此未来预留请求的自动创建预留，建议指定唯一的名称前缀。
可选：在说明字段中，输入未来预留请求的说明。
在区域字段中，选择要预留哪个区域的资源。
在可用区字段中，选择要预留哪个可用区的资源。
在开始时间字段中，输入预留期的开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。

请务必指定开始时间的建议值，以确保在未来预留进入锁定时间之前有足够的时间。
在结束时间字段中，输入预留期的结束时间。预留期必须至少持续 24 小时。

在时长摘要部分中，您可以查看预留期时长。为了提高 Google Cloud 在提交未来预留请求以供审核后对其进行批准的可能性，请确保指定预留期的推荐值。
在共享类型部分中，选择本地（默认）。
在虚拟机实例数量字段中，输入您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。

在临近开始时间之前计算要为批准的未来预留请求创建的新预留数量时，Compute Engine 会从此总数中减去与该请求匹配的所有现有预留数。如需了解详情，请参阅 Compute Engine 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
在机器配置部分中，执行以下操作：
1. 如需使用现有实例模板指定虚拟机的属性，请选择使用实例模板。
2. 在实例模板字段中，选择所需的实例模板。如果选择区域级实例模板，则只能在该实例模板所在的区域内预留资源。
在自动生成的预留自动删除时间部分，执行以下操作之一：
- 如需使 Compute Engine 能够自动删除未来预留请求的自动创建预留，请执行以下操作：
  
  注意：如果启用了自动删除选项，则所有自动创建预留都会在指定删除时间删除，无论它们是否已被使用。
  1. 点击启用自动删除切换开关，以切换到开启的位置（默认）。
  2. 可选：在自动删除时间字段中，输入删除自动创建预留的新日期和时间。该日期和时间必须晚于预留期的结束时间。如果您将此字段留空，则自动创建预留将在预留期结束时间后的 2 小时内删除。
- 否则，请点击启用自动删除切换开关，以切换到关闭位置。
执行下列其中一项操作：
- 如需创建未来预留请求并将其提交给 Google Cloud 进行审核，请点击提交。
  
  注意：请先确保未来预留请求已准备好接受审核，然后再提交。提交后，您无法恢复还原为草稿。
- 如需创建未来预留请求草稿，请点击保存草稿。
- 要退出但不保存，请点击取消。

此时会打开预留页面。创建未来预留请求最多可能需要一分钟才能完成。

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

替换以下内容：

FUTURE_RESERVATION_NAME：要创建的未来预留请求的名称。

DESCRIPTION：可选。未来预留请求的说明。

NAME_PREFIX：未来预留请求的名称前缀。此未来预留请求的每个自动创建预留的名称都以名称前缀开头。为了帮助您识别此未来预留请求的自动创建预留，建议指定唯一的名称前缀。
PLANNING_STATUS：可选。未来预留请求的规划状态，必须是以下其中一项：
- 如需创建未来预留请求的草稿，请指定 DRAFT。
- 如需创建未来预留请求并将其提交给 Google Cloud 进行批准，请指定 SUBMITTED。
  
  注意：将未来预留请求提交审核后，您便无法将其规划状态更改回 DRAFT。
如果省略 --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 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
ZONE：要在其中预留资源的可用区。

当您指定 --auto-delete-auto-created-reservations 标志时，Compute Engine 会自动删除您未来预留请求的自动创建预留。默认情况下，删除时间为预留期结束时间后的 2 小时内。（可选）您可以通过执行以下操作之一来更改此设置：

如需在预留期结束时间后删除自动创建预留，请选择以下方法之一：

注意：如果启用自动删除选项，则所有自动创建预留都会在指定删除时间删除，无论它们是否完全使用。
- 如需在预留期结束时间后的特定时间删除自动创建预留，请指定 --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 \
    ...
```

例如，以下命令可使用 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"
  }
}

替换以下内容：

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。
  
  注意：将未来预留请求提交审核后，您便无法将其规划状态更改回 DRAFT。
如果省略 planningStatus 字段，则其值设置为 DRAFT。

LOCATION：实例模板的位置。请指定以下某个值：
- 对于全球实例模板：global。
- 对于区域级实例模板：regions/REGION。将 REGION 替换为实例模板所在的区域。如果您指定了区域级实例模板，则只能在该实例模板所在的区域内预留虚拟机。
INSTANCE_TEMPLATE_NAME：现有实例模板的名称。如果您指定了实例模板，则在创建未来预留请求时，您无法替换其属性。否则，您会遇到错误。

TOTAL_COUNT：您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。

计算要为已获批准的未来预留创建的预留数量时，Compute Engine 会首先检查现有预留。如果现有预留与已获批准的未来预留匹配，则系统会从该请求中所请求的预留总数减去现有预留数量，以确定 Compute Engine 创建的新预留的数量。如需了解详情，请参阅 Compute Engine 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
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 在您提交未来预留请求以供审核后批准该请求的可能性，请务必指定其中一个预留期建议值。

重要提示：请确保预留期不与另一个具有匹配的虚拟机属性和可用区并且是在当前项目中创建或与当前项目共享的现有未来预留请求的预留期重叠。否则，创建未来预留请求的操作会失败。

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 直接指定属性，以创建单项目未来预留。

控制台

如需通过直接指定属性创建单项目未来预留请求，请按以下步骤操作：

在 Google Cloud 控制台中，转到预留页面。

转到“预留”
点击未来预留标签页。
点击 创建未来预留。

创建未来预留页面会打开。
在名称字段中，为未来预留请求输入名称。
在前缀字段中，输入名称前缀。此未来预留请求中每个自动创建预留的名称以此前缀开头。

为了帮助您识别此未来预留请求的自动创建预留，建议指定唯一的名称前缀。
可选：在说明字段中，输入未来预留请求的说明。
在区域字段中，选择要预留哪个区域的资源。
在可用区字段中，选择要预留哪个可用区的资源。
在开始时间字段中，输入预留期的开始时间。开始时间不能比您提交未来预留申请以供审核的日期和时间晚 1 年。

请务必指定开始时间的建议值，以确保在未来预留进入锁定时间之前有足够的时间。
在结束时间字段中，输入预留期的结束时间。预留期必须至少持续 24 小时。

在时长摘要部分中，您可以查看预留期时长。为了提高 Google Cloud 在提交未来预留请求以供审核后对其进行批准的可能性，请确保指定预留期的推荐值。
在共享类型部分中，选择本地（默认）。
在虚拟机实例数量字段中，输入您要为此未来预留请求中指定的期限、虚拟机配置和项目预留的虚拟机总数。

在临近开始时间之前计算要为批准的未来预留请求创建的新预留数量时，Compute Engine 会从此总数中减去与该请求匹配的所有现有预留数。如需了解详情，请参阅 Compute Engine 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
在机器配置部分中，执行以下操作：
1. 选择指定机器类型（默认）。
2. 从下列选项中选择一项：
  - 对于常见工作负载，请点击通用标签页（默认）。
  - 对于需要高性能的工作负载，请点击计算优化标签页。
  - 对于内存与 vCPU 比率较高的工作负载，请点击内存优化标签页。
  - 对于使用图形处理单元 (GPU) 的工作负载，请点击 GPU 标签页。
3. 执行下列其中一项操作：
  - 如果您在上一步中指定了通用、计算优化或内存优化，请执行以下操作：
    1. 在系列列表中，选择一个机器系列。
    2. 在机器类型列表中，选择一种机器类型。
    3. 可选：如需进一步自定义要请求预留的虚拟机，请展开高级配置并按照提示进行操作。
  - 如果您在上一步中指定了 GPU，请执行以下操作：
    1. 在 GPU 类型菜单中，选择 GPU 的类型。
    2. 在 GPU 数量菜单中，选择 GPU 的数量。
    3. 可选：如果 GPU 类型允许，并且您希望使用预留资源运行图形密集型工作负载，请选中启用虚拟工作站 (NVIDIA GRID) 复选框。
    4. 在机器类型列表中，选择一种机器类型。
    5. 在 CPU 平台列表中，为您请求预留的虚拟机选择一个 CPU 平台。
4. 可选：如果机器类型允许，并且您想要添加本地 SSD，请执行以下操作：
  1. 在磁盘数量字段中，选择本地 SSD 的磁盘数量。
  2. 在接口类型部分，选择以下接口之一：
    - SCSI（默认）
    - NVMe
在自动生成的预留自动删除时间部分，执行以下操作之一：
- 如需使 Compute Engine 能够自动删除未来预留请求的自动创建预留，请执行以下操作：
  
  注意：如果启用了自动删除选项，则所有自动创建预留都会在指定删除时间删除，无论它们是否已被使用。
  1. 点击启用自动删除切换开关，以切换到开启的位置（默认）。
  2. 可选：在自动删除时间字段中，输入删除自动创建预留的新日期和时间。该日期和时间必须晚于预留期的结束时间。如果您将此字段留空，则自动创建预留将在预留期结束时间后的 2 小时内删除。
- 否则，请点击启用自动删除切换开关，以切换到关闭位置。
执行下列其中一项操作：
- 如需创建未来预留请求并将其提交给 Google Cloud 进行审核，请点击提交。
  
  注意：请先确保未来预留请求已准备好接受审核，然后再提交。提交后，您无法恢复还原为草稿。
- 如需创建未来预留请求草稿，请点击保存草稿。
- 要退出但不保存，请点击取消。

此时会打开预留页面。创建未来预留请求最多可能需要一分钟才能完成。

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

替换以下内容：

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。
  
  注意：将未来预留请求提交审核后，您便无法将其规划状态更改回 DRAFT。
如果省略 --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 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
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 \
    ...
```

例如，以下命令会为 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"
  }
}

替换以下内容：

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。
  
  注意：将未来预留请求提交审核后，您便无法将其规划状态更改回 DRAFT。
如果省略 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 如何计算和预配预留资源。

注意：请确保您有足够的配额用于请求预留的资源。否则，Google Cloud 会拒绝您的未来预留请求。
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 在您提交未来预留请求以供审核后批准该请求的可能性，请务必指定其中一个预留期建议值。

重要提示：请确保预留期不与另一个具有匹配的虚拟机属性和可用区并且是在当前项目中创建或与当前项目共享的现有未来预留请求的预留期重叠。否则，创建未来预留请求的操作会失败。

例如，以下命令会为 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 提交未来预留请求草稿以供审核。如果您还想在提交未来预留请求草稿以供审核时修改一个或多个属性，请参阅修改草稿或被拒绝的未来预留请求。

控制台

要提交未来预留请求草稿以供审核，请按以下步骤操作：

在 Google Cloud 控制台中，转到预留页面。

转到“预留”
点击未来预留标签页。
在名称列中，点击采购状态为正在草拟的未来预留请求的名称。

系统会打开未来预留页面，其中包含未来预留请求的详细信息。
点击 修改草稿。

系统会打开未来预留请求草稿的详情页面。
如需将未来预留请求草稿提交给 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

替换以下内容：

FUTURE_RESERVATION_NAME：现有未来预留请求草稿的名称。
PROJECT_ID：未来预留请求所在项目的 ID。
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"
}

替换以下内容：

PROJECT_ID：未来预留请求所在项目的 ID。
ZONE：未来预留请求所在的可用区。
FUTURE_RESERVATION_NAME：现有未来预留请求草稿的名称。

提交未来预留请求草稿以供审核后，您可以执行以下操作：

如需监控请求的采购状态并查看 Google Cloud 是批准还是拒绝您的请求，请查看未来预留请求的详细信息。
如需阻止 Google Cloud 审核您的请求并阻止 Compute Engine 预配请求的容量，请取消或删除未来预留请求。

问题排查

如果您在创建未来预留请求时遇到错误，请参阅如何排查未来预留请求问题。

如果您在排查问题后仍遇到问题，请与您的技术支持客户经理或销售团队联系。

后续步骤

了解如何查看未来预留请求。
了解如何修改、取消或删除未来预留请求。
到预留期的开始时间后，您就可以了解如何使用自动创建预留。

为单个项目创建未来预留请求

准备工作

Console

gcloud

REST

所需的角色

所需权限

创建单项目未来预留请求

指定实例模板

控制台

gcloud

REST

直接指定虚拟机属性

控制台

gcloud

REST

提交未来预留请求草稿以供审核

控制台

gcloud

REST

问题排查

后续步骤