インスタンスを作成すると、Google Cloud Managed Lustre でインスタンスの 一覧表示、取得、更新、削除を行うことができます。
Managed Lustre インスタンスを更新する場合、変更できるのは説明とラベルのみです。
インスタンスの一覧取得
プロジェクト内のすべてのインスタンスを一覧表示するには:
Google Cloud コンソール
コンソールで、[Managed Lustre] ページに移動します。 Google Cloud
プロジェクトのインスタンスが一覧表示されます。
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 コンソール
コンソールで、[Managed Lustre] ページに移動します。 Google Cloud
インスタンス名をクリックして、特定のインスタンスの詳細を表示します。
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 コンソール
コンソールで、[Managed Lustre] ページに移動します。 Google Cloud
更新するインスタンスの [インスタンス名] をクリックします。インスタンスの概要ページが表示されます。
[編集] をクリックします。
新しい値を入力します。
[送信] をクリックします。
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 は、更新する Managed Lustre インスタンスの名前です。
- UPDATE_MASK は、更新するフィールドのカンマ区切りのリストです。フィールドは、マスクに含まれている場合にのみ上書きされます。
リクエストの本文には、次のフィールドのいずれか 1 つ以上を含める必要があります。
capacityGiBは、このインスタンスの新しいストレージ容量（ギビバイト（GiB）単位）です。値は、許容される最大容量を超えないようにし、ステップサイズの倍数にする必要があります。詳細については、 インスタンスの容量を増やすをご覧ください。descriptionは、このインスタンスの新しい説明です。labelsは、このインスタンスの新しいラベルセットです。labelsの値は、1 つ以上の key:value ペアを含む JSON オブジェクトです。
詳細については、instances.patch API リファレンスをご覧ください。
インスタンスの削除
インスタンスを削除するには:
Google Cloud コンソール
コンソールで、[Managed Lustre] ページに移動します。 Google Cloud
削除するインスタンスの横にあるその他アイコンを選択します。
[インスタンスを削除] を選択します。[削除] をもう一度クリックして、削除を確定します。
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 リファレンスをご覧ください。