管理 Hyperdisk 存储池

本文档介绍如何列出、描述、修改和删除存储池。

准备工作

• 设置身份验证（如果尚未设置）。身份验证是通过其进行身份验证以访问 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

所需的角色和权限

如需获得管理存储池所需的权限，请让管理员向您授予项目的以下 IAM 角色：

• Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
• 若要连接到能够以服务账号的身份运行的虚拟机实例：Service Account User (v1)（roles/iam.serviceAccountUser 角色）

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含管理存储池所需的权限。如需查看所需的确切权限，请展开所需权限部分：

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

限制

管理 Hyperdisk 存储池时，请注意以下限制：

• 在 24 小时内，您最多可以更改两次存储池的预配容量或性能。
• 您无法更改池的预配模型；您无法将标准容量存储池更改为高级容量存储池，也无法将高级性能存储池更改为标准性能存储池。
• 不允许将磁盘移入或移出存储池。如需将磁盘移入或移出存储池，您必须通过快照重新创建磁盘。如需了解详情，请参阅更改磁盘类型。
• 您无法对存储池中的磁盘进行克隆、创建即时快照或配置永久性磁盘异步复制等操作。
• 您每小时最多可以删除 5 个存储池。
• 存储池管理命令要么成功，要么立即失败，但最长可能需要 5 分钟才能完成操作，更改最长可能需要 30 分钟才会显示。

如需查看 Hyperdisk 存储池限制的完整列表，请参阅存储池的限制。

修改存储池时的值范围

创建存储池时，容量、IOPS 和吞吐量的新值必须在您要修改的存储池类型的限制范围内。此外，您只能使用支持的增量值指定新值。

如需了解详细的性能预配限制，请参阅存储池的限制。

列出项目的存储池

如需查看在项目中创建的存储池，请使用 Google Cloud 控制台、Google Cloud CLI 或 REST。

gcloud compute storage-pools list

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

列出存储池中的磁盘

如需获取存储池中创建的磁盘列表，请使用 Google Cloud 控制台、Google Cloud CLI 或 REST。

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

描述存储池

如需查看存储空间池的详细信息，您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST。

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

更新存储池的预配容量、IOPS 或吞吐量

您可以增加或减少存储池的预配容量、IOPS 或吞吐量。如需增加存储池的容量、IOPS 或吞吐量，您必须拥有项目和区域的可用配额。

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

删除存储池

如需删除或移除存储池，您必须先删除存储池中的所有磁盘。然后，您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST 删除存储池。

删除存储池的操作不可逆转。但是，删除存储池不会删除根据存储池中创建的磁盘截取的任何快照。您必须单独删除这些快照。

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

后续步骤

• 详细了解存储池。