管理 Google Cloud Managed Lustre 執行個體

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

執行個體狀態

Managed Lustre 執行個體可能處於下列狀態：

狀態 說明
CREATING 執行個體正在建立中，尚未準備就緒。
ACTIVE 執行個體可供使用。
REPAIRING 正在修復執行個體。
MAINTENANCE或UPGRADING 執行個體正在維護中。詳情請參閱「維護事件和政策」。
SUSPENDED 執行個體已暫停，通常是因為客戶自行管理的加密金鑰 (CMEK) 有問題。
DELETING 正在刪除執行個體。

列出執行個體

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

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. 按一下「提交」。

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：維護期間的世界標準時間開始時間，格式為字典 (例如 {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. 前往 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 參考資料。