インスタンスを作成すると、Google Cloud Managed Lustre でインスタンスのリスト表示、取得、更新、削除を行うことができます。
マネージド Lustre インスタンスを更新する場合は、説明とラベルのみを変更できます。
インスタンスを確認する
プロジェクト内のすべてのインスタンスを一覧表示するには:
Google Cloud コンソール
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 コンソール
Google Cloud コンソールで、[Managed Lustre] ページに移動します。
インスタンス名をクリックして、特定のインスタンスの詳細を表示します。
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 コンソール
Google Cloud コンソールで、[Managed Lustre] ページに移動します。
更新するインスタンスの [インスタンス名] をクリックします。インスタンスの概要ページが表示されます。
[編集] をクリックします。
新しい値を入力します。
[送信] をクリックします。
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 コンソール
Google Cloud コンソールで、[Managed Lustre] ページに移動します。
削除するインスタンスの横にあるその他メニューを選択します。
[インスタンスを削除] を選択します。もう一度 [削除] をクリックして、削除を確定します。
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 を返します。詳しくは、operations.get リファレンスをご覧ください。