Instanzlabels erstellen und verwalten

Mit Cloud Bigtable können Sie Ihren Instanzen Labels hinzufügen. Labels sind Schlüssel/Wert-Paare, mit denen Sie verwandte Instanzen gruppieren und Metadaten zu einer Instanz speichern können.

Auf dieser Seite wird erläutert, wie Sie Labels für eine Bigtable-Instanz verwenden können. Außerdem wird beschrieben, wie Labels hinzugefügt, aktualisiert und entfernt werden.

Was sind Labels?

Ein Label ist ein Schlüsselwertpaar, mit dem Sie Ihre Google Cloud-Instanzen organisieren können. 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 Ihre in Rechnung gestellten Gebühren nach Labels aufschlüsseln können.

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 basierend darauf zulassen oder ablehnen, ob eine Ressource ein bestimmtes Tag hat. Weitere Informationen finden Sie in der Tag-Übersicht.

Labels und Tags

Tags sind ein separates Tool, das eine detaillierte Kontrolle über Richtlinien ermöglicht. Weitere Informationen zu Tags finden Sie in der Tag-Übersicht.

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 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 UTF-8-codiert sein. Internationale Zeichen sind zulässig.
  • 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.
  • Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.

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.

Labels einer Instanz hinzufügen oder aktualisieren

Nachdem Sie eine Bigtable-Instanz erstellt haben, können Sie mit der Google Cloud Console Labels zu der Instanz hinzufügen oder vorhandene Labels aktualisieren. Alternativ können Sie dafür auch die RPC Admin API oder die REST Admin API verwenden.

So fügen Sie Labels für eine Cloud Bigtable-Instanz mithilfe der Google Cloud Console hinzu oder aktualisieren sie:

  1. Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.

    Liste der Instanzen öffnen

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

  3. Falls das Feld Labels nicht sichtbar ist, klicken Sie in der rechten oberen Ecke auf Infofeld anzeigen, um es zu öffnen.

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

    Zum Hinzufügen eines neuen Labels klicken Sie auf Label hinzufügen und geben dann den Schlüssel und den Wert für das Label ein.

    Zum Ändern eines bestehenden Labels aktualisieren Sie seinen Wert. Den Schlüssel eines vorhandenen Labels können Sie nicht ändern.

  5. Klicken Sie auf Speichern, um die Änderungen zu speichern.

Label aus einer Instanz entfernen

So entfernen Sie ein Label mithilfe der Google Cloud Console aus einer Cloud Bigtable-Instanz:

  1. Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.

    Liste der Instanzen öffnen

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

  3. Falls das Feld Labels nicht sichtbar ist, klicken Sie in der oberen rechten Ecke auf Infofeld anzeigen, um es zu öffnen.

  4. Klicken Sie neben jedem Label, das Sie entfernen möchten, auf das X.

  5. Klicken Sie auf Speichern, um die Änderungen zu speichern.

Nächste Schritte

Mehr über die Bearbeitung weiterer Attribute einer Cloud Bigtable-Instanz erfahren