管理 Google Cloud Managed Lustre 執行個體

建立執行個體後，您可以使用 Google Cloud Managed Lustre 列出、取得、更新及刪除執行個體。

更新代管 Lustre 執行個體時，只能修改說明和標籤。

列出執行個體

如要列出專案中的所有執行個體：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Managed Lustre」(受管理 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 控制台的「Managed Lustre」(受管理 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 是要傳回的 Managed Lustre 執行個體名稱。

詳情請參閱 instances.get API 參考資料。

更新執行個體

您可以更新現有執行個體的下列屬性：

  • 說明
  • 標籤
  • 儲存空間容量

如要瞭解如何增加執行個體的儲存空間容量，請參閱「增加執行個體的容量」一文。

如要更新執行個體，請按照下列步驟操作：

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Managed Lustre」(受管理 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 控制台的「Managed Lustre」(受管理 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 是要刪除的 Managed Lustre 執行個體名稱。

詳情請參閱 instances.delete API 參考資料。

刪除要求是長時間執行的要求，會傳回作業 ID，可用於查詢作業狀態。詳情請參閱 operations.get 參考資料。