Labels verwalten

Auf dieser Seite erfahren Sie, wie Sie Labels mit Ihren Filestore-Instanzen verwenden. Außerdem wird beschrieben, wie Labels für eine Instanz hinzugefügt, aktualisiert und gelöscht werden. Mit Labels können Sie verwandte Instanzen gruppieren und Metadaten zu einer Instanz speichern.

Was sind Labels?

Ein Label ist ein Schlüsselwertpaar, mit dem Sie Ihre Google Cloud Filestore-Instanzen organisieren können. Sie können jeder Ressource ein Label zuweisen und dann die Ressourcen nach Labels filtern. Informationen über Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die in Rechnung gestellten Kosten nach Labels aufschlüsseln können.

Einsatzmöglichkeiten von Labels

Es wird empfohlen, nicht zu viele eindeutige Labels zu erstellen, etwa für Zeitstempel oder einzelne Werte für jeden API-Aufruf. Labels kommen u. a. in folgenden Situationen zum Einsatz:

  • Labels für Teams oder Kostenstellen: Fügen Sie Labels basierend auf einem Team oder einer Kostenstelle hinzu, um zwischen den Firestore-Instanzen verschiedener Teams zu unterscheiden (z. B. team:research und team:analytics). Sie können diese Art von Label für die Kostenabrechnung oder Budgetplanung nutzen.

  • Labels für Komponenten: z. B. component:redis, component:frontend, component:ingest und component:dashboard.

  • Labels für Umgebungen oder Phasen: z. B. environment:production und environment:test.

  • Labels für Status: z. B. state:active, state:readytodelete und state:archive.

Anforderungen an Labels

Die Labels, die auf eine Ressource angewendet werden, müssen die folgenden Anforderungen erfüllen:

  • Jede Ressource kann bis zu 64 Labels haben.
  • Jedes Label muss ein Schlüssel/Wert-Paar sein.
  • Schlüssel haben eine Mindestlänge von 1 Zeichen und eine maximale Länge von 63 Zeichen und dürfen nicht leer sein. Werte dürfen leer sein und haben eine maximale Länge von 63 Zeichen.
  • Schlüssel und Werte dürfen nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Alle Zeichen müssen die UTF-8-Codierung verwenden. Internationale Zeichen sind zulässig.
  • Der Schlüsselabschnitt eines Labels darf nur einmal vorkommen. Sie können jedoch denselben Schlüssel für mehrere Ressourcen verwenden.
  • Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.

Labels einer Instanz hinzufügen oder aktualisieren

Nachdem Sie eine Filestore-Instanz erstellt haben, können Sie der Instanz Labels hinzufügen und vorhandene Labels aktualisieren oder löschen.

Console

  1. Wechseln Sie in der Cloud Console zur Seite Filestore-Instanzen.

    Zur Seite mit den Filestore-Instanzen

  2. Klicken Sie auf das Kästchen neben den Instanzen, deren Labels Sie ändern möchten.

  3. Klicken Sie rechts oben auf Infofeld anzeigen, um es zu öffnen.

  4. Fügen Sie nach Bedarf Labels hinzu und aktualisieren Sie sie.

    Aktion Anleitung
    Label hinzufügen Klicken Sie auf Label hinzufügen und geben Sie den Schlüssel und den Wert für das Label ein.
    Aktualisieren Sie ein Label Aktualisieren Sie das Feld Wert. Sie können den Key eines vorhandenen Labels nicht aktualisieren.
    Labels löschen: Klicken Sie neben dem Label auf Element löschen .
  5. Klicken Sie zum Speichern der Änderungen auf Speichern.

gcloud

Mit dem Befehl instances update können Sie die Labels einer Filestore-Instanz bearbeiten. Verwenden Sie zum Hinzufügen neuer Labels oder der Werte vorhandener Labels das Flag --update-labels. Verwenden Sie zum Löschen eines oder mehrerer Labels das Flag --remove-labels. Das Flag --clear-labels entfernt alle Labels aus einer Instanz.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

wobei

  • instance-id ist die Instanz-ID der Instanz, die Sie bearbeiten möchten.
  • project-id ist die Projekt-ID des Cloudprojekts, das die Filestore-Instanz enthält. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz im Standardprojekt gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:

     gcloud config set project project-id
    
  • zone ist die Zone, in der sich die Filestore-Instanz befindet. Führen Sie den Befehl gcloud filestore zones list aus, um eine Liste der unterstützten Zonen abzurufen. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz in der Standardzone gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:

     gcloud config set filestore/zone zone
    
  • key ist ein neues Label oder ein vorhandenes Label, das Sie ändern oder entfernen möchten.

  • value ist der Wert für ein Label.

Beispiel

Im folgenden Beispiel wird die Instanz "nfs-server" aktualisiert. Hierzu wird das Label status hinzugefügt, der Wert für das Label dept aktualisiert und das Label admin entfernt.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

Nächste Schritte

Informationen zur Bearbeitung weiterer Eigenschaften einer Filestore-Instanz