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 von Managed 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 Managed Lustre auf.

    Zu Managed Lustre

    Die Instanzen Ihres Projekts werden aufgelistet.

gcloud CLI

Verwenden Sie den gcloud lustre instances list Befehl:

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 Ihre Google Cloud Projekt-ID.

  • ZONE ist die Zone, für die alle Instanzen aufgelistet werden sollen. Wenn Sie Instanzen aus allen Zonen auflisten möchten, verwenden Sie - als Wert.

Weitere Informationen finden Sie in der instances.list API-Referenz für weitere Details.

Instanz abrufen

So rufen Sie die Details einer Instanz ab:

Google Cloud Console

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

    Zu Managed Lustre

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

gcloud CLI

Verwenden Sie den gcloud lustre instances describe Befehl:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Wenn Sie Details zu einer bestimmten Instanz mit der 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 Ihre 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 instances.get API-Referenz für weitere Details.

Instanzstatus

Eine Managed Lustre-Instanz kann einen der folgenden Status haben:

Bundesland Beschreibung
CREATING Die Instanz wird erstellt und ist noch nicht einsatzbereit.
ACTIVE Die Instanz ist einsatzbereit.
UPGRADING Die Instanz wird aktualisiert.
REPAIRING Die Instanz wird repariert.
MAINTENANCE Für die Instanz wird eine geplante Hostwartung durchgeführt. Bei Instanzen mit großer Kapazität (über dem Schwellenwert für die Schrittgröße) kann es in diesem Status zu Ausfallzeiten von bis zu 4 Stunden kommen.
SUSPENDED Die Instanz wurde angehalten, in der Regel aufgrund eines Problems mit einem kundenverwalteten Verschlüsselungsschlüssel (CMEK).
DELETING Die Instanz wird gelöscht.

Weitere Informationen zur Wartung finden Sie unter Fehlerbehebung und bekannte Probleme.

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 Managed 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

Verwenden Sie den gcloud lustre instances update Befehl:

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 Schrittgröße sein. Weitere Informationen finden Sie unter Kapazität einer Instanz erhöhen.
  • NEW_DESCRIPTION ist ein neuer Wert für das Feld „Beschreibung“, der eine vorhandene Beschreibung überschreibt.

Informationen zum Aktualisieren von Labels finden Sie in der Dokumentation zu gcloud lustre instances update unter den verfügbaren Befehlen.

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 Ihre Google Cloud Projekt-ID.
  • ZONE ist die Google Cloud Zone der Instanz.
  • INSTANCE_NAME ist der Name der Managed 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 Schrittgröße 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 instances.patch API-Referenz für weitere Details.

Instanz löschen

So löschen Sie eine Instanz:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Managed 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 das Löschen noch einmal, indem Sie auf Löschen klicken.

gcloud CLI

Verwenden Sie den gcloud lustre instances delete Befehl:

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 Ihre Google Cloud Projekt-ID.

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

  • INSTANCE_NAME ist der Name der Managed Lustre Instanz, die gelöscht werden soll.

Weitere Informationen finden Sie in der instances.delete API-Referenz für weitere Details.

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 operations.get.