管理 Google Cloud Managed Lustre 实例

创建实例后，您可以使用 Google Cloud Managed Lustre 列出、获取、更新和删除实例。

更新受管 Lustre 实例时，只能修改说明和标签。

列出实例

如需列出项目中的所有实例，请执行以下操作：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台中的托管式 Lustre 页面。

    前往 Managed Lustre

    系统会列出您项目中的实例。

gcloud CLI

使用 gcloud lustre instances list 命令：

gcloud lustre instances list --location=LOCATION

将 LOCATION 替换为特定可用区，以列出该位置中的所有实例。如需查看所有位置的项目，请输入 - 作为值。例如：

gcloud lustre instances list --location=-

REST

如需使用 REST API 列出实例，请向以下端点发送请求：

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

其中，必须指定以下值：

  • PROJECT_ID 是 Google Cloud 项目 ID。

  • ZONE 是要列出所有实例的可用区。如需列出所有可用区中的实例，请使用 - 作为值。

如需了解详情，请参阅 instances.list API 参考文档。

获取实例

如需获取实例的详细信息，请执行以下操作：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台中的托管式 Lustre 页面。

    前往 Managed Lustre

  2. 点击实例名称可查看特定实例的详细信息。

gcloud CLI

使用 gcloud lustre instances describe 命令：

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

如需使用 REST API 获取特定实例的详细信息，请向以下端点发送请求：

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

其中，必须指定以下值：

  • PROJECT_ID 是 Google Cloud 项目 ID。

  • ZONE 必须是受 Managed Lustre 支持的有效 Google Cloud 可用区。如需查看完整列表，请参阅支持的位置。

  • INSTANCE_NAME 是要返回的受管 Lustre 实例的名称。

如需了解详情，请参阅 instances.get API 参考文档。

更新实例

您可以更新现有实例的以下属性：

  • 说明
  • 标签
  • 存储空间容量

如需了解如何增加实例的存储容量，请参阅增加实例的容量。

如需更新实例，请执行以下操作：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台中的托管式 Lustre 页面。

    前往 Managed Lustre

  2. 点击要更新的实例的实例名称。系统会显示实例概览页面。

  3. 点击修改。

  4. 输入新值。

  5. 点击提交。

Google Cloud CLI

使用 gcloud lustre instances update 命令：

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

其中：

  • INSTANCE_NAME 是要更新的实例。
  • LOCATION 是实例所在的地区。
  • NEW_CAPACITY 是此实例的新存储空间容量，以吉比字节 (GiB) 为单位。该值不得超过允许的最大容量，并且必须是步长的倍数。如需了解详情，请参阅增加实例的容量。
  • NEW_DESCRIPTION 是说明字段的新值，会覆盖任何现有说明。

如需更新标签，请参阅 gcloud lustre instances update 文档中的可用命令。

REST

如需使用 REST API 更新实例，请向其特定端点发送 PATCH 请求：

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

其中，必须指定以下值：

  • PROJECT_ID 是 Google Cloud 项目 ID。
  • ZONE 是实例所在的 Google Cloud 地区。
  • INSTANCE_NAME 是要更新的受管 Lustre 实例的名称。
  • UPDATE_MASK 是要更新的字段的逗号分隔列表。只有当字段在掩码中时，该字段才会被覆盖。

请求正文必须包含以下一个或多个字段：

  • capacityGiB 是此实例的新存储空间容量，以吉比字节 (GiB) 为单位。该值不得超过允许的最大容量，并且必须是步长的倍数。如需了解详情，请参阅增加实例的容量。
  • description 是此实例的新说明。
  • labels 是此实例的新标签集。labels 的值是一个 JSON 对象，其中包含一个或多个“键：值”对。

如需了解详情，请参阅 instances.patch API 参考文档。

删除实例

要删除实例，请如下操作：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台中的托管式 Lustre 页面。

    前往 Managed Lustre

  2. 选择要删除的实例旁边的三点状菜单。

  3. 选择删除实例。再次点击删除以确认删除。

gcloud CLI

使用 gcloud lustre instances delete 命令：

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

系统会提示您确认是否要删除。输入 Y 或按 Enter 键继续。

REST

如需使用 REST API 删除实例，请向以下端点发送请求：

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

其中，必须指定以下值：

  • PROJECT_ID 是 Google Cloud 项目 ID。

  • ZONE 是实例所在的 Google Cloud 可用区。

  • INSTANCE_NAME 是要删除的受管 Lustre 实例的名称。

如需了解详情，请参阅 instances.delete API 参考文档。

删除请求是长时间运行的请求，会返回一个操作 ID，您可以通过该 ID 查询操作状态。如需了解详情，请参阅 operations.get 参考文档。