创建共享预留

本文档介绍如何创建共享预留（在多个项目中共享的预留），以及如何管理组织中哪些项目可以使用共享预留。

托管预留的项目（所有者项目）和共享预留的项目（使用方项目）可以使用共享预留。如果您的组织有多个项目需要使用预留了相同属性的虚拟机 (VM) 实例，请使用共享预留。通过使用共享预留，您可以提高预留利用率，并减少需要创建和管理的预留数量。如需详细了解预留，请参阅 Compute Engine 可用区级资源的预留。

如需了解创建预留的其他方法，请参阅以下页面：

  • 如果您在当前项目中具有任何 1 年期或 3 年期承诺，则您的预留资源会自动获得任何适用的承诺使用折扣 (CUD)。您还可以在购买承诺时创建预留并将其附加到该承诺。如需了解详情，请参阅将预留附加到承诺。

  • 如需创建只能由单个项目使用的预留，请参阅为单个项目创建预留。

准备工作

  • 查看预留的要求和限制。
  • 查看共享预留的要求和限制。
  • 确保您用于创建共享预留的项目已被组织策略管理员添加到共享预留所有者项目 (compute.sharedReservationsOwnerProjects) 组织政策限制条件的许可名单中。默认情况下，此许可名单为空，因此在您的组织向一个或多个项目授予此权限之前，您不能创建共享预留。如需详细了解如何查看和修改组织政策限制条件，请参阅本文档中的允许和限制项目创建和修改共享预留。
  • 如果您尚未设置身份验证，请进行设置。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以按如下方式向 Compute Engine 进行身份验证。

    选择标签页以了解您打算如何使用本页面上的示例：

    控制台

    当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时，无需设置身份验证。

    gcloud

    1. 安装 Google Cloud CLI，然后通过运行以下命令初始化 Google Cloud CLI： 

      gcloud init
    2. 设置默认区域和可用区。

    Terraform

    如需从本地开发环境使用本页面上的 Terraform 示例，请安装并初始化 gcloud CLI，然后使用用户凭据设置应用默认凭据。

    1. 安装 Google Cloud CLI。

    2. 如需初始化 gcloud CLI，请运行以下命令： 

      gcloud init

    3. 为您的 Google 账号创建本地身份验证凭据：

      gcloud auth application-default login

    如需了解详情，请参阅 为本地开发环境设置身份验证。

    REST

    如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

      安装 Google Cloud CLI，然后通过运行以下命令初始化 Google Cloud CLI： 

      gcloud init

所需的角色

如需获得创建共享预留所需的权限，请让您的管理员为您授予以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理访问权限。

这些预定义角色可提供创建共享预留所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

必须拥有以下权限才能创建共享预留：

  • 项目的 compute.reservations.create 权限
  • 查看组织政策：针对组织的 orgpolicy.policy.get 权限
  • 修改组织政策：针对组织的 orgpolicy.policy.set 权限
  • 如需指定实例模板：实例模板的 compute.instanceTemplates.useReadOnly 权限

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

最佳做法

创建共享预留时，建议遵循以下最佳实践。通过遵循这些最佳实践，您可以帮助优化组织中共享预留的可管理性和利用率。

  • 让所有者项目创建共享预留但不使用它。
    • 如需在各项目之间分配支出，建议仅允许使用方项目使用共享预留。所有者项目应仅用于创建共享预留。
    • 所有者项目必须具有足够的配额，才能预留两倍的资源。如需了解详情，请参阅共享预留的其他要求。
  • 尽量减少组织中允许创建共享预留的项目数量。您可以通过共享预留所有者项目 (compute.sharedReservationsOwnerProjects) 组织政策限制条件来控制这种情况。
    • 您只能列出每个项目创建的预留。这意味着共享预留仅在所有者项目中列出，您无法列出与每个项目共享的预留，也无法列出每个组织中的所有共享预留，因此仅拥有少量所有者项目可让您更轻松地监控和管理您的共享预订。
    • 将共享预留的共享限制给几个项目，以便更轻松地管理预留资源的配额。
    • 如需了解详情，请参阅允许和限制项目创建和修改共享预留。
  • 最大限度地减少具有相同虚拟机属性的单独共享预留的数量。
    • 对于每个虚拟机属性的唯一组合，组织最多可以有 100 个共享预留。因此，最大限度地减少您创建的具有相同虚拟机属性的共享预留数量有助于缓解此限制。
    • 减少共享预留可提高可管理性。
  • 仅在使用相同 Cloud Billing 账号的项目之间共享预留。
    • 将每个共享预留限制为仅与所有者项目具有相同 Cloud Billing 账号的使用方项目共享。这样，您就可以更轻松地查看预留是否已被使用，并了解其结算方式。
    • 如果您启用了 CUD 共享，并且有资格在 Cloud Billing 账号级层接收 CUD，那么为了最大限度地提高为已使用的预留获得的 CUD，请将共享预留限制为该承诺的 Cloud Billing 账号。这样，您就可以在创建和使用共享预留的项目之间保持一致的结算方式。
  • 对于未来预留请求，请仔细查看您所请求的虚拟机总数。
    • 如果您要创建未来预留请求，请确保请求以下所有数量的虚拟机：
      • 将在未来的日期存在的所有匹配的预留虚拟机。
      • 将在未来的日期存在的所有匹配的未预留虚拟机。
      • 将在未来的日期存在的任何匹配且未使用的按需预留。
      • 您希望在未来的日期额外预留的用量。

      例如，假设您需要在未来的日期额外增加 10 个虚拟机，并且那时已有以下资源：

      • 40 个匹配的预留虚拟机
      • 50 个匹配的未预留虚拟机

      或

      • 40 个匹配的预留虚拟机
      • 50 个匹配且未使用的按需预留

      由于未来日期的现有用量已总共添加了 90 个匹配的虚拟机和预留，并且还需要 10 个额外的虚拟机，因此您必须在未来预留请求中指定总数 100。

      如需了解详情，请参阅计算和预配预留资源。

允许和限制项目创建和修改共享预留

默认情况下，不允许任何项目在组织中创建或修改共享预留。将项目添加到共享预留所有者项目 (compute.sharedReservationsOwnerProjects) 组织政策限制条件，以允许它们创建和修改共享预留。如需详细了解组织政策限制条件，请参阅组织政策服务简介。

按照以下步骤查看和修改共享预留所有者项目 (compute.sharedReservationsOwnerProjects) 组织政策限制条件。

查看共享预留组织政策限制条件

如需查看允许哪些项目创建和修改共享预留，请使用 Google Cloud 控制台或 gcloud CLI。

控制台

按照使用共享预留所有者项目限制条件查看组织政策的步骤进行操作。

gcloud

如要查看 compute.sharedReservationsOwnerProjects 限制条件允许哪些项目创建和修改共享预留，请执行以下操作：

  1. 使用 gcloud resource-manager org-policies describe 命令下载组织的政策，并命名为 policy.yaml 文件：

    gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml

    将 ORGANIZATION_ID 替换为您的组织的 ID。

  2. 使用文本编辑器打开 policy.yaml 文件并查看 compute.sharedReservationsOwnerProjects 限制条件。允许创建和修改共享预留的项目列在其 allowedValues 下：

    ...
constraint: constraints/compute.sharedReservationsOwnerProjects
listPolicy:
  allowedValues:
  - projects/PROJECT_NUMBER_1
  - projects/PROJECT_NUMBER_2
  - projects/PROJECT_NUMBER_3
...

    其中，PROJECT_NUMBER_1、PROJECT_NUMBER_2 和 PROJECT_NUMBER_3 是您组织中唯一允许创建共享预留的项目的项目编号。

  3. 可选：删除 policy.yaml 文件。

    • 如果您使用的是 Linux 或 macOS 终端，请使用以下命令：

      rm policy.yaml

    • 如果您使用的是 Windows 终端，请使用以下命令：

      del policy.yaml

修改共享预留组织政策限制条件

如需修改允许哪些项目创建和修改共享预留，请使用 Google Cloud 控制台或 gcloud CLI。

控制台

使用共享预留所有者项目限制条件，按照自定义列表限制条件政策的步骤操作。

gcloud

如需修改 compute.sharedReservationsOwnerProjects 限制条件允许创建和修改共享预留的项目，请使用以下某一方法：

  • 如需向单个项目授予权限以创建和修改共享预留，请使用 gcloud resource-manager org-policies allow 命令。您可以为要授予此权限的每个项目重复此命令。

    gcloud resource-manager org-policies allow compute.sharedReservationsOwnerProjects projects/PROJECT_NUMBER \
    --organization=ORGANIZATION_ID

    替换以下内容：

    • PROJECT_NUMBER：组织中您要允许其创建和修改共享预留的项目的编号（而非项目 ID）。
    • ORGANIZATION_ID：您的组织的 ID。

  • 如需授予或撤消多个项目的权限以创建和修改共享预留，请替换组织政策限制条件：

    1. 如需将组织的政策下载为名为 policy.yaml 的文件，请使用 gcloud resource-manager org-policies describe 命令：

      gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml

      将 ORGANIZATION_ID 替换为您的组织的 ID。

    2. 使用文本编辑器修改 policy.yaml 文件，以使 compute.sharedReservationsOwnerProjects 限制条件将您要允许其创建和修改共享预留的所有项目列在 allowedValues 下。

      • 对于要授予其创建和修改共享预留权限的每个项目，请在 allowedValues 下的新行中添加该项目。
      • 对于要撤消创建和修改共享预留权限的每个项目，请删除该项目的行。

      完成后，请确保 policy.yaml 文件类似于以下内容：

      ...
constraint: constraints/compute.sharedReservationsOwnerProjects
listPolicy:
  allowedValues:
  - projects/PROJECT_NUMBER_1
  - projects/PROJECT_NUMBER_2
  - projects/PROJECT_NUMBER_3
...

      其中，PROJECT_NUMBER_1、PROJECT_NUMBER_2 和 PROJECT_NUMBER_3 是组织中您要允许其创建和修改共享预留的所有项目的编号（而非项目 ID）。

    3. 保存 policy.yaml 文件并关闭文本编辑器。

    4. 如要使用您的更改更新组织的政策，请使用 gcloud resource-manager org-policies set-policy 命令：

      gcloud resource-manager org-policies set-policy --organization=ORGANIZATION_ID policy.yaml

      将 ORGANIZATION_ID 替换为您的组织的 ID。

    5. 可选：删除 policy.yaml 文件。

      • 如果您使用的是 Linux 或 macOS 终端，请使用以下命令：

        rm policy.yaml

      • 如果您使用的是 Windows 终端，请使用以下命令：

        del policy.yaml

您可能需要等待几分钟修改才能生效。

创建共享预留

本部分介绍如何创建共享预留。创建共享预留后，它只能由所有者项目修改，但共享预留的资源可以由所有者项目或任何使用方项目使用。

如需使用预留，虚拟机必须具有与该预留完全匹配的属性。如需指定要预留的虚拟机的属性，请选择本文档中的以下部分之一：

  • 推荐：指定实例模板

    本部分介绍如何使用实例模板定义共享预留的属性。通过使用实例模板，您可以在同一位置定义预留的属性和可以使用预留的虚拟机。但是，由于模板是特定于项目的，因此您无法使用同一模板创建可以在创建预留的项目之外使用预留的虚拟机。对于共享预留的项目，您必须在这些项目中创建类似的模板，或通过直接指定属性来创建虚拟机。

  • 直接指定属性

    本部分介绍如何直接定义共享预留的属性。此方法要求您手动确保虚拟机和预留的属性完全匹配，任何不匹配的属性都会阻止使用。

默认情况下，具有与预留相匹配的属性的虚拟机可以自动使用该预留。如果您想要控制预留的使用，请执行以下一项或多项操作：

指定实例模板

如需通过指定实例模板创建共享预留，您可以使用 Google Cloud 控制台、gcloud CLI 或 REST。

控制台

如需通过指定实例模板创建共享预留，请执行以下操作：

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

    转到“预留”

    随即会出现预留页面。

  2. 点击 创建预留。

    此时会显示创建预留页面。

  3. 在名称字段中，为预留输入名称。

  4. 选择您要预留资源的区域和可用区。

  5. 在共享类型部分，执行以下操作：

    1. 如需指定共享预留，请点击共享。

    2. 点击 添加项目，然后从当前项目的组织中选择要共享预留的项目。

  6. 在搭配虚拟机实例使用部分中，选择以下选项之一：

    • 如需允许匹配的虚拟机实例自动使用此预留，请点击自动使用预留（默认）。

    • 如需在创建通过名称明确指向此预留的匹配虚拟机时使用此预留的资源，请点击选择特定预留。

  7. 在虚拟机实例数量字段中，输入要预留的虚拟机数量。

  8. 在机器配置部分中，执行以下操作：

    1. 如需根据现有实例模板指定虚拟机的属性，请选择使用实例模板。

    2. 在实例模板字段中，选择所需的实例模板。 如果选择区域级实例模板，则只能在实例模板的区域内预留资源。

  9. 在自动删除部分中，您可以启用自动删除选项，以让 Compute Engine 在特定日期和时间自动删除预留。自动删除预留有助于避免在停止使用预留时产生不必要的费用。

  10. 要创建预留，请点击创建。

    创建共享预留可能需要一段时间才能完成。此操作会将您重定向到预留页面。

gcloud

如需通过指定实例模板创建共享预留，请使用 gcloud compute reservations create 命令。

如需通过指定不带任何可选标志的实例模板来创建共享预留，请运行以下命令：

gcloud compute reservations create RESERVATION_NAME \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

替换以下内容：

  • RESERVATION_NAME：要创建的预留的名称。

  • PROJECT_ID：要在其中预留资源以及实例模板所在的项目的 ID。

  • CONSUMER_PROJECT_IDS：可以使用此预留的项目 ID 的英文逗号分隔列表，例如 project-1,project-2。您最多可以添加 100 个使用方项目。 这些项目必须与所有者项目位于同一组织中。请勿包含所有者项目。默认情况下，已允许它使用该预留。

  • LOCATION：实例模板的位置。 请指定以下某个值：

    • 对于全球实例模板：global。

    • 对于区域级实例模板：regions/REGION。 将 REGION 替换为实例模板所在的区域。如果您指定了区域级实例模板，则只能在该实例模板的区域内预留虚拟机。

  • INSTANCE_TEMPLATE_NAME：现有实例模板的名称。如果您指定了实例模板，则在创建预留时，您无法覆盖其任何属性。否则，您会遇到错误。

  • NUMBER_OF_VMS：要预留的虚拟机数量。

  • ZONE：预留资源的可用区。

例如，如需通过在可用区 us-central1-a 中指定全局实例模板来创建预留，请与项目 project-1 和 project-2 共享预留，并预留 10 个虚拟机，每个虚拟机使用一个 N2 具有 4 个 vCPU 的预定义机器类型，请运行以下命令：

gcloud compute reservations create my-reservation \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/global/example-instance-template \
    --vm-count=10 \
    --zone=us-central1-a

（可选）您可以执行以下一项或多项操作：

  • 如需指定只有明确指向此预留的虚拟机才能使用该虚拟机，请添加 --require-specific-reservation 标志。

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • 如需让 Compute Engine 自动删除该预留，请选择以下方法之一：

    • 如需在特定日期和时间删除预留，请使用 gcloud beta compute reservations create 命令并添加 --delete-at-time 标志。

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      将 DELETE_AT_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。

    • 如需在特定时间段后删除预留，请使用 gcloud beta compute reservations create 命令并添加 --delete-after-duration 标志。

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      将 DELETE_AFTER_DURATION 替换为以天、小时、分钟或秒为单位的时长。例如，指定 30m 表示 30 分钟，或指定 1d2h3m4s 表示 1 天 2 小时 3 分钟 4 秒。

REST

如需通过指定实例模板创建共享预留，请向 reservations.insert 方法发出 POST 请求。

例如，如需通过指定没有任何可选字段的实例模板来创建共享预留，并与两个使用方项目共享预留，请发出以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  },
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}

替换以下内容：

  • PROJECT_ID：要在其中预留资源以及实例模板所在的项目的 ID。

  • ZONE：预留资源的可用区。

  • RESERVATION_NAME：要创建的预留的名称。

  • CONSUMER_PROJECT_ID_1 和 CONSUMER_PROJECT_ID_2：可以使用此预留的项目 ID。您最多可以添加 100 个使用方项目。这些项目必须与所有者项目位于同一组织中。请勿包含所有者项目。默认情况下，已允许它使用该预留。

  • NUMBER_OF_VMS：要预留的虚拟机数量。

  • LOCATION：实例模板的位置。 请指定以下某个值：

    • 对于全球实例模板：global。

    • 对于区域级实例模板：regions/REGION。 将 REGION 替换为实例模板所在的区域。如果您指定了区域级实例模板，则只能在该实例模板的区域内预留虚拟机。

  • INSTANCE_TEMPLATE_NAME：现有实例模板的名称。如果您指定了实例模板，则在创建预留时，您无法覆盖其任何属性。否则，您会遇到错误。

例如，如需通过指定全局实例模板为可用区 us-central1-a 中的 10 个虚拟机创建预留，并与项目 project-1 和 project-2 共享预留，请进行以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "project-1": {
        "projectId": "project-1"
      },
      "project-2": {
        "projectId": "project-2"
      }
    }
  },
  "specificReservation": {
    "count": "10",
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template"
  }
}

（可选）您可以执行以下一项或多项操作：

  • 如需指定只有明确针对此预留的虚拟机才能使用它，请在请求正文中添加 specificReservationRequired 字段并将其设置为 true。

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • 如需让 Compute Engine 自动删除该预留，请选择以下方法之一：

    • 如需在特定日期和时间删除预留，请向 beta.reservations.insert 方法发出 POST 请求。在请求正文中，包含 deleteAtTime 字段。

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      将 DELETE_AT_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。

    • 如需在特定时间段后删除预留，请向 beta.reservations.insert 方法发出 POST 请求。在请求正文中，包含 deleteAfterDuration 字段。

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      将 DELETE_AFTER_DURATION 替换为持续时间，以秒为单位。例如，指定 86400 标识 86400 秒（1 天）。

直接指定虚拟机属性

如需创建通过直接指定属性来创建共享预留，请使用 Google Cloud 控制台、gcloud CLI、Terraform 或 REST。

控制台

如需创建共享预留，请执行以下操作：

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

    转到“预留”

    随即会出现预留页面。

  2. 点击 创建预留。

    此时会显示创建预留页面。

  3. 在名称字段中，为预留输入名称。

  4. 选择您要预留资源的区域和可用区。

  5. 在共享类型部分，执行以下操作：

    1. 如需指定共享预留，请点击共享。

    2. 点击 添加项目，然后从当前项目的组织中选择要共享预留的项目。

  6. 在搭配虚拟机实例使用部分中，选择以下选项之一：

    • 如需允许匹配的虚拟机自动使用此预留，请点击自动使用预留（默认）。

    • 如需在创建通过名称明确指向此预留的匹配虚拟机时使用此预留的资源，请点击选择特定预留。

  7. 在虚拟机实例数量字段中，输入要预留的虚拟机数量。

  8. 在机器配置部分中，选择指定机器类型，然后指定以下内容：

    1. 在机器系列、系列和机器类型字段中，选择机器系列、系列和机器类型。

    2. 可选：如需指定满足最低要求的 CPU 平台和/或 GPU，请执行以下操作：

      1. 如需展开 CPU 平台和 GPU 部分，请点击 展开箭头。

      2. 可选：如需指定满足最低要求的 CPU 平台，请在 CPU 平台列表中选择一个选项。

      3. 可选：如需添加 GPU，请点击 添加 GPU。然后，在 GPU 类型和 GPU 数量字段中，选择每个虚拟机的 GPU 类型和数量。

    3. 可选：如需添加本地 SSD，请执行以下操作：

      1. 在磁盘数量字段中，选择每个虚拟机的本地 SSD 数量。

      2. 在接口类型字段中，选择本地 SSD 的接口。

  9. 在自动删除部分中，您可以启用自动删除选项，以让 Compute Engine 在特定日期和时间自动删除预留。自动删除预留有助于避免在停止使用预留时产生不必要的费用。

  10. 要创建预留，请点击创建。

    创建共享预留可能需要一段时间才能完成。此操作会将您重定向到预留页面。

gcloud

如需创建共享预留，请使用 gcloud compute reservations create 命令。

如需创建没有任何可选标志的共享预留，请运行以下命令：

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

替换以下内容：

  • RESERVATION_NAME：要创建的预留的名称。

  • 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。

  • PROJECT_ID：您要在其中预留资源的项目的 ID。

  • CONSUMER_PROJECT_IDS：可以使用此预留的项目 ID 的英文逗号分隔列表，例如 project-1,project-2。您最多可以添加 100 个使用方项目。 这些项目必须与所有者项目位于同一组织中。请勿包含所有者项目。默认情况下，已允许它使用该预留。

  • NUMBER_OF_VMS：要预留的虚拟机数量。

  • ZONE：预留资源的可用区。

例如，如需通过指定全局实例模板为可用区 us-central1-a 中的 10 个虚拟机创建预留，并与项目 project-1 和 project-2 共享预留，请运行以下命令：

gcloud compute reservations create my-reservation \
    --machine-type=n2-standard-4 \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --vm-count=10 \
    --zone=us-central1-a

（可选）您可以执行以下一项或多项操作：

  • 如需向每个预留的虚拟机添加图形处理单元 (GPU)，请添加 --accelerator 标志。

    gcloud compute reservations create my-reservation \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE
    ...

    替换以下内容：

    • NUMBER_OF_ACCELERATORS：要为每个已预留虚拟机添加的 GPU 的数量。

    • ACCELERATOR_TYPE：要添加到已预留虚拟机的 GPU 的类型。

    确保您在预留中指定的机器类型支持您指定的 GPU 类型，并且 GPU 在您预留资源的可用区中可用。否则，创建预留将失败。

  • 如需向每个预留虚拟机添加一个或多个本地 SSD，请添加一个或多个 --local-ssd 标志。您最多可以指定 24 个本地 SSD。每个本地 SSD 为 375 GB。

    例如，如需在创建预留时指定两个本地 SSD，请添加两个 --local-ssd 标志。

    gcloud compute reservations create my-reservation \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    ...

    将 INTERFACE_1 和 INTERFACE_2 替换为您希望每个本地 SSD 使用的接口类型。请指定以下某个值：

    • 对于 NVME 磁盘接口：nvme。

    • 对于 SCSI 磁盘接口：scsi。

    请确保您为预留虚拟机指定的机器类型支持所选的磁盘接口。否则，创建预留将失败。 如需了解详情，请参阅如何选择磁盘接口。

  • 如需让预留的虚拟机使用特定的满足最低要求的 CPU 平台（而不是该可用区的默认 CPU 平台），请添加 --min-cpu-platform 标志。

    gcloud compute reservations create my-reservation \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    ...

    将 MIN_CPU_PLATFORM 替换为满足最低要求的 CPU 平台。 为确保 CPU 平台在要预留资源的可用区可用，请按可用区查看可用的 CPU 平台。

  • 如需指定只有明确指向此预留的虚拟机才能使用该虚拟机，请添加 --require-specific-reservation 标志。

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • 如需让 Compute Engine 自动删除该预留，请选择以下方法之一：

    • 如需在特定日期和时间删除预留，请使用 gcloud beta compute reservations create 命令并添加 --delete-at-time 标志。

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      将 DELETE_AT_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。

    • 如需在特定时间段后删除预留，请使用 gcloud beta compute reservations create 命令并添加 --delete-after-duration 标志。

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      将 DELETE_AFTER_DURATION 替换为以天、小时、分钟或秒为单位的时长。例如，指定 30m 表示 30 分钟，或指定 1d2h3m4s 表示 1 天 2 小时 3 分钟 4 秒。

Terraform

如需创建预留，请使用 google_compute_reservation Terraform 资源。如需指定共享预留，请定义 share_settings 块：

  • 将 share_type 字段设置为 SPECIFIC_PROJECTS。
  • 在 project_map 块中，指定您要与之共享此预留的项目的 ID。

如需详细了解如何使用 Terraform，请参阅将 Terraform 与 Google Cloud 搭配使用。

REST

如需创建共享预留，请向 reservations.insert 方法发出 POST 请求。

例如，如需创建没有任何可选字段的共享预留并与两个使用方项目共享预留，请发出以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  },
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  }
}

替换以下内容：

  • PROJECT_ID：您要在其中预留资源的项目的 ID。

  • ZONE：预留资源的可用区。

  • RESERVATION_NAME：要创建的预留的名称。

  • CONSUMER_PROJECT_ID_1 和 CONSUMER_PROJECT_ID_2：可以使用此预留的项目 ID。您最多可以添加 100 个使用方项目。这些项目必须与所有者项目位于同一组织中。请勿包含所有者项目。默认情况下，已允许它使用该预留。

  • NUMBER_OF_VMS：要预留的虚拟机数量。

  • 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。

例如，如需通过在可用区 us-central1-a 中指定全局实例模板来创建预留，请与项目 project-1 和 project-2 共享预留，并预留 10 个虚拟机，每个虚拟机使用一个 N2 具有 4 个 vCPU 的预定义机器类型，请执行以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "project-1": {
        "projectId": "project-1"
      },
      "project-2": {
        "projectId": "project-2"
      }
    }
  },
  "specificReservation": {
    "count": "10",
    "instanceProperties": {
      "machineType": "n2-standard-4",
    }
  }
}

（可选）您可以执行以下一项或多项操作：

  • 如需向每个预留的虚拟机添加图形处理单元 (GPU)，请在请求正文中添加 guestAccelerators 字段。

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      ...
    },
    ...
  }
}

    替换以下内容：

    • NUMBER_OF_ACCELERATORS：要为每个已预留虚拟机添加的 GPU 的数量。

    • ACCELERATOR_TYPE：要添加到已预留虚拟机的 GPU 的类型。

    确保您在预留中指定的机器类型支持您指定的 GPU 类型，并且 GPU 在您预留资源的可用区中可用。否则，创建预留将失败。

  • 如需向每个预留的虚拟机添加一个或多个本地 SSD，请在请求正文中添加 localSsds 字段。您最多可以指定 24 个本地 SSD。每个本地 SSD 为 375 GB。

    例如，如需在创建预留时指定两个本地 SSD，请指定以下内容：

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      ...
    },
    ...
  }
}

    将 INTERFACE_1 和 INTERFACE_2 替换为您希望每个本地 SSD 使用的接口类型。请指定以下某个值：

    • 对于 NVME 磁盘接口：NVME。

    • 对于 SCSI 磁盘接口：SCSI。

    请确保您为预留虚拟机指定的机器类型支持所选的磁盘接口。否则，创建预留将失败。 如需了解详情，请参阅如何选择磁盘接口。

  • 如需让预留的虚拟机使用特定的满足最低要求的 CPU 平台（而不是可用区的默认 CPU 平台），请在请求正文中添加 minCpuPlatform 字段。

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "minCpuPlatform": "MIN_CPU_PLATFORM",
      ...
    },
    ...
  }
}

    将 MIN_CPU_PLATFORM 替换为满足最低要求的 CPU 平台。 为确保 CPU 平台在要预留资源的可用区可用，请按可用区查看可用的 CPU 平台。

  • 如需指定只有明确针对此预留的虚拟机才能使用它，请在请求正文中添加 specificReservationRequired 字段并将其设置为 true。

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • 如需让 Compute Engine 自动删除该预留，请选择以下方法之一：

    • 如需在特定日期和时间删除预留，请向 beta.reservations.insert 方法发出 POST 请求。在请求正文中，包含 deleteAtTime 字段。

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      将 DELETE_AT_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。

    • 如需在特定时间段后删除预留，请向 beta.reservations.insert 方法发出 POST 请求。在请求正文中，包含 deleteAfterDuration 字段。

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      将 DELETE_AFTER_DURATION 替换为持续时间，以秒为单位。例如，指定 86400 标识 86400 秒（1 天）。

问题排查

了解如何排查预留创建问题。

后续步骤