Google Cloud Managed Lustre-Instanzen verwalten

Nachdem Sie eine Instanz erstellt haben, können Sie mit Google Cloud Managed Lustre Instanzen auflisten, abrufen, aktualisieren und löschen.

Beim Aktualisieren verwalteter Lustre-Instanzen können nur die Beschreibung und die Labels geändert werden.

Instanzen auflisten

So listen Sie alle Instanzen in einem Projekt auf:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Verwaltetes Lustre auf.

    Zu Managed Lustre

    Die Instanzen Ihres Projekts werden aufgeführt.

gcloud-CLI

Führen Sie den Befehl gcloud lustre instances list aus:

gcloud lustre instances list --location=LOCATION

Ersetzen Sie LOCATION durch eine bestimmte Zone, um alle Instanzen an diesem Standort aufzulisten. Wenn Sie Projekte an allen Standorten aufrufen möchten, geben Sie - als Wert ein. Beispiel:

gcloud lustre instances list --location=-

REST

Wenn Sie Instanzen mit der REST API auflisten möchten, senden Sie eine Anfrage an den folgenden Endpunkt:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dabei müssen die folgenden Werte angegeben werden:

  • PROJECT_ID ist die Google Cloud Projekt-ID.

  • ZONE ist die Zone, für die alle Instanzen aufgelistet werden sollen. Verwenden Sie - als Wert, um Instanzen aus allen Zonen aufzulisten.

Weitere Informationen finden Sie in der API-Referenz zu instances.list.

Instanz abrufen

So rufen Sie die Details einer Instanz ab:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Verwaltetes Lustre auf.

    Zu Managed Lustre

  2. Klicken Sie auf den Instanznamen, um Details zu einer bestimmten Instanz aufzurufen.

gcloud-CLI

Führen Sie den Befehl gcloud lustre instances describe aus:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Wenn Sie Details zu einer bestimmten Instanz über die REST API abrufen möchten, senden Sie eine Anfrage an den folgenden Endpunkt:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dabei müssen die folgenden Werte angegeben werden:

  • PROJECT_ID ist die Google Cloud Projekt-ID.

  • ZONE muss eine gültige Google Cloud Zone sein, die von Managed Lustre unterstützt wird. Eine vollständige Liste finden Sie unter Unterstützte Standorte.

  • INSTANCE_NAME ist der Name der Managed Lustre-Instanz, die zurückgegeben werden soll.

Weitere Informationen finden Sie in der API-Referenz zu instances.get.

Instanz aktualisieren

Sie können die folgenden Attribute einer vorhandenen Instanz aktualisieren:

  • Beschreibung
  • Labels
  • Speicherkapazität

Informationen zum Erhöhen der Speicherkapazität einer Instanz finden Sie unter Kapazität einer Instanz erhöhen.

So aktualisieren Sie eine Instanz:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Verwaltetes Lustre auf.

    Zu Managed Lustre

  2. Klicken Sie auf den Instanznamen der Instanz, die Sie aktualisieren möchten. Die Seite „Instanzübersicht“ wird angezeigt.

  3. Klicken Sie auf Bearbeiten.

  4. Geben Sie die neuen Werte ein.

  5. Klicken Sie auf Senden.

Google Cloud CLI

Führen Sie den Befehl gcloud lustre instances update aus:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Wobei:

  • INSTANCE_NAME ist die Instanz, die aktualisiert werden soll.
  • LOCATION ist die Zone, in der sich die Instanz befindet.
  • NEW_CAPACITY ist die neue Speicherkapazität für diese Instanz in Gibibyte (GiB). Der Wert darf die maximal zulässige Kapazität nicht überschreiten und muss ein Vielfaches der Schrittweite sein. Weitere Informationen finden Sie unter Kapazität einer Instanz erhöhen.
  • NEW_DESCRIPTION ist ein neuer Wert für das Beschreibungsfeld, der alle vorhandenen Beschreibungen überschreibt.

Informationen zum Aktualisieren von Labels finden Sie in der Dokumentation zu gcloud lustre instances update.

REST

Wenn Sie eine Instanz mit der REST API aktualisieren möchten, senden Sie eine PATCH-Anfrage an den entsprechenden Endpunkt:

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"
  }
}

Dabei müssen die folgenden Werte angegeben werden:

  • PROJECT_ID ist die Google Cloud Projekt-ID.
  • ZONE ist die Google Cloud Zone der Instanz.
  • INSTANCE_NAME ist der Name der verwalteten Lustre-Instanz, die aktualisiert werden soll.
  • UPDATE_MASK ist eine durch Kommas getrennte Liste der zu aktualisierenden Felder. Ein Feld wird nur überschrieben, wenn es in der Maske enthalten ist.

Der Anfragetext muss eines oder mehrere der folgenden Felder enthalten:

  • capacityGiB ist die neue Speicherkapazität für diese Instanz in Gibibyte (GiB). Der Wert darf die maximal zulässige Kapazität nicht überschreiten und muss ein Vielfaches der Schrittweite sein. Weitere Informationen finden Sie unter Kapazität einer Instanz erhöhen.
  • description ist die neue Beschreibung für diese Instanz.
  • labels ist die neue Gruppe von Labels für diese Instanz. Der Wert von labels ist ein JSON-Objekt, das ein oder mehrere Schlüssel/Wert-Paare enthält.

Weitere Informationen finden Sie in der API-Referenz zu instances.patch.

Instanz löschen

So löschen Sie eine Instanz:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Verwaltetes Lustre auf.

    Zu Managed Lustre

  2. Wählen Sie das Dreipunkt-Menü neben der Instanz aus, die Sie löschen möchten.

  3. Wählen Sie Instanz löschen aus. Bestätigen Sie den Löschvorgang, indem Sie noch einmal auf Löschen klicken.

gcloud-CLI

Führen Sie den Befehl gcloud lustre instances delete aus:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Sie werden aufgefordert, das Löschen zu bestätigen. Geben Sie Y ein oder drücken Sie die Eingabetaste, um fortzufahren.

REST

Wenn Sie eine Instanz mit der REST API löschen möchten, senden Sie eine Anfrage an den folgenden Endpunkt:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dabei müssen die folgenden Werte angegeben werden:

  • PROJECT_ID ist die Google Cloud Projekt-ID.

  • ZONE ist die Google Cloud Zone, in der sich die Instanz befindet.

  • INSTANCE_NAME ist der Name der zu löschenden verwalteten Lustre-Instanz.

Weitere Informationen finden Sie in der API-Referenz zu instances.delete.

Löschanfragen sind Anfragen mit langer Ausführungszeit und geben eine Vorgangs-ID zurück, mit der der Vorgangsstatus abgefragt werden kann. Weitere Informationen finden Sie in der Referenz zu operations.get.