管理 Google Cloud Managed Lustre 实例

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

实例状态

Managed Lustre 实例可以处于以下任一状态：

状态 说明
CREATING 实例正在创建，尚未准备就绪，无法使用。
ACTIVE 实例可供使用。
REPAIRING 实例正在修复。
MAINTENANCE 或 UPGRADING 实例正在维护。 如需了解详情，请参阅 维护事件和政策。
SUSPENDED 实例已暂停，通常是由于客户管理的加密密钥 (CMEK) 存在问题。
DELETING 实例正在删除。

列出实例

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

Google Cloud 控制台

  1. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 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. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 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 必须是 Google Cloud Managed Lustre 支持的有效可用区。如需查看完整列表，请参阅 支持的位置。

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

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

更新实例

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

  • 说明
  • 标签
  • 存储空间容量
  • 维护政策

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

如需了解如何配置维护政策，请参阅 维护事件和政策。

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

Google Cloud 控制台

  1. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 Managed Lustre

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

  3. 点击修改 。

  4. 输入新值。

  5. 点击提交 。

gcloud CLI

使用 gcloud lustre instances update 命令：

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

其中：

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

  • NEW_DESCRIPTION 是说明字段的新值，它 会覆盖任何现有说明。

  • DAY：维护窗口的星期几（例如 TUESDAY）。

  • START_TIME：维护窗口的世界协调时间 (UTC) 开始时间，采用字典格式（例如 {hours=1,minutes=0}）。

如需更新标签，请参阅 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"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

您必须指定以下值：

  • PROJECT_ID 是您的 Google Cloud 项目 ID。
  • ZONE 是实例的 Google Cloud 可用区。
  • INSTANCE_NAME 是要更新的 Managed Lustre 实例的名称。
  • UPDATE_MASK 是要更新的字段的英文逗号分隔列表。只有当字段位于掩码中时，系统才会覆盖该字段。

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

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

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

无法将操作加入队列

如果您在尝试更新实例时看到类似以下内容的错误：

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

当您尝试启动操作时，如果同一实例上已在进行相同类型的其他操作，则会发生此错误。 Managed Lustre 允许每个实例一次进行一项活跃更新，并允许将其他更新操作加入队列。

如需解决此问题，请等待当前操作完成后再启动新操作。

删除实例

如需删除实例，请执行以下操作：

Google Cloud 控制台

  1. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 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 是要删除的 Managed Lustre 实例的名称。

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

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