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üssel/Wert-Paar, das Sie Google Cloud Filestore-Instanzen zuweisen können. Clusterlabels helfen Ihnen dabei, diese Ressourcen zu organisieren und Ihre Kosten in großem Umfang mit der erforderlichen Detailgenauigkeit zu verwalten. Sie können jeder Ressource ein Label zuweisen und dann die Ressourcen basierend auf ihren Labels filtern. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die abgerechneten Gebühren nach Label aufschlüsseln können. Dank integrierter Abrechnungsberichte können Sie Kosten nach Ressourcenlabels filtern und gruppieren. Sie können Labels auch verwenden, um Abrechnungsdatenexporte abzufragen.

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 UTF-8-codiert sein. Internationale Zeichen sind zulässig. Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.
  • Der Schlüsselabschnitt eines Labels darf in einer einzelnen Ressource nur einmal vorkommen. Sie können jedoch denselben Schlüssel für mehrere Ressourcen verwenden.

Die Limits gelten für den Schlüssel und den Wert für jedes Label und für die einzelnen Google Cloud-Ressourcen, die Labels haben. Es gibt keine Beschränkung, wie viele Labels Sie auf alle Ressourcen in einem Projekt anwenden können.

Einsatzmöglichkeiten von Labels

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.

  • Labels für Eigentumsrechte: Wird verwendet, um die Teams zu identifizieren, die für den Betrieb verantwortlich sind, z. B. team:shopping-cart.

Es wird empfohlen, nicht zu viele eindeutige Labels zu erstellen, etwa für Zeitstempel oder einzelne Werte für einzelne API-Aufruf. Das Problem bei diesem Ansatz besteht darin, dass es schwierig ist, Ressourcen effektiv zu filtern und Berichte über sie zu erstellen, wenn sich die Werte häufig ändern oder wenn Schlüssel verwendet werden, die den Katalog überlasten.

Labels und Tags

Labels können als abfragbare Annotationen für Ressourcen verwendet werden, aber nicht zum Festlegen von Bedingungen für Richtlinien. Mit Tags können Sie Richtlinien auf Basis der Bedingung genehmigen oder ablehnen, ob eine Ressource ein bestimmtes Tag hat. Dazu müssen Sie eine detaillierte Richtlinienkontrolle ermöglichen. Weitere Informationen finden Sie in der Tag-Übersicht.

Labels einer Instanz hinzufügen oder aktualisieren

Sie können einer Filestore-Instanz beim Erstellen der Instanz Labels hinzufügen. Nachdem eine Instanz erstellt wurde, können Sie der Instanz weitere Labels hinzufügen und vorhandene Labels aktualisieren oder löschen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite „Filestore-Instanzen“ auf.

    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 auf Infofeld anzeigen.

  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. Um neue Labels hinzuzufügen oder die Werte vorhandener Labels zu ändern, verwenden Sie die 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

Dabei gilt:

  • instance-id ist die Instanz-ID der Instanz, die Sie bearbeiten möchten.

  • project-id ist die Projekt-ID des Google Cloud-Projekts, 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 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

Dienste, die aktuell Labels unterstützen

Labels werden derzeit von den folgenden Google Cloud-Diensten unterstützt:

  • AI Platform
  • App Engine (flexible und Standardumgebung)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Cloud Run-Funktionen
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Netzwerk
  • Pub/Sub
  • Resource Manager (nur Projekte)

Nächste Schritte

Informationen zur Bearbeitung weiterer Eigenschaften einer Filestore-Instanz