In diesem Abschnitt erfahren Sie, wie Sie Tags an Datastream-Ressourcen wie Streams, Verbindungsprofile oder private Verbindungen anhängen, von ihnen lösen und auflisten. Eine Übersicht über Tags in Datastream finden Sie unter Zugriffssteuerung mit Tags.
Tags
Ein Tag ist ein Schlüssel/Wert-Paar, das an eine Ressource in Google Cloud angehängt werden kann. Mit Tags können Sie Richtlinien abhängig davon zulassen oder ablehnen, ob eine Ressource ein bestimmtes Tag hat. Beispielsweise können Sie IAM-Rollen (Identity and Access Management) bedingt zuweisen, je nachdem, ob eine Ressource ein bestimmtes Tag hat. Weitere Informationen finden Sie unter Tags – Übersicht.
Tags werden an Ressourcen angehängt, indem eine Tag-Bindungsressource erstellt wird, die den Wert mit der Google Cloud-Ressource verknüpft.
Wenn Sie Streams, Verbindungsprofile oder private Verbindungen in Datastream zu Automatisierungs- und Abrechnungszwecken gruppieren möchten, verwenden Sie Labels. Tags und Labels funktionieren unabhängig voneinander. Sie können beide auf Ressourcen anwenden.Erforderliche Berechtigungen
Welche Berechtigungen Sie benötigen, hängt von der auszuführenden Aktion ab.
Um diese Berechtigungen zu erhalten, bitten Sie Ihren Administrator, die vorgeschlagene Rolle auf der entsprechenden Ebene der Ressourcenhierarchie zu gewähren.
Tags aufrufen
Sie benötigen die Rolle Tag-Betrachter (roles/resourcemanager.tagViewer
) oder eine andere Rolle mit den folgenden Berechtigungen, um Tag-Definitionen und Tags aufzurufen, die an Ressourcen angehängt sind:
Erforderliche Berechtigungen
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings
für den entsprechenden Ressourcentyp. Beispiel:compute.instances.listTagBindings
zum Aufrufen von Tags, die an Compute Engine-Instanzen angehängt sind.listEffectiveTags
für den entsprechenden Ressourcentyp.
Beispiel:
compute.instances.listEffectiveTags
zum Aufrufen aller Tags, die an Compute Engine-Instanzen angehängt sind oder von diesen übernommen wurden.
Zum Aufrufen von Tags auf Organisationsebene benötigen Sie die Rolle Organisationsbetrachter (roles/resourcemanager.organizationViewer
) für die Organisationsressource.
Tags verwalten
Zum Erstellen, Aktualisieren und Löschen von Tag-Definitionen benötigen Sie die Rolle Tag-Administrator (roles/resourcemanager.tagAdmin
) oder eine andere Rolle mit den folgenden Berechtigungen:
Erforderliche Berechtigungen
resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy
Zum Verwalten von Tags auf Organisationsebene benötigen Sie die Rolle Organization Viewer (roles/resourcemanager.organizationViewer
) für die Organisationsressource.
Tags für Ressourcen verwalten
Zum Hinzufügen und Entfernen von Tags, die mit Ressourcen verknüpft sind, benötigen Sie die Rolle Tag-Nutzer (roles/resourcemanager.tagUser
) oder eine andere Rolle mit entsprechenden Berechtigungen für den Tag-Wert und die Ressourcen, an die Sie den Tag-Wert anhängen. Die Rolle Tag-Nutzer umfasst die folgenden Berechtigungen:
Erforderliche Berechtigungen
- Erforderliche Berechtigungen für die Ressource, an die Sie den Tag-Wert anhängen:
- Ressourcenspezifische
createTagBinding
-Berechtigung, z. B.compute.instances.createTagBinding
für Compute Engine-Instanzen. - Ressourcenspezifische
deleteTagBinding
-Berechtigung, z. B.compute.instances.deleteTagBinding
für Compute Engine-Instanzen. - Erforderliche Berechtigungen für den Tag-Wert:
resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete
- Berechtigungen, mit denen Sie Projekte und Tag-Definitionen aufrufen können:
resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get
Zum Anhängen von Tags an Datastream-Ressourcen benötigen Sie die Rolle Datastream-Administrator (roles/datastream.admin
) oder eine andere Rolle mit den folgenden Berechtigungen:
Erforderliche Berechtigungen
datastream.connectionProfiles.createTagBinding
datastream.connectionProfiles.deleteTagBinding
datastream.connectionProfiles.listTagBindings
datastream.connectionProfiles.listEffectiveTags
datastream.streams.createTagBinding
datastream.streams.deleteTagBinding
datastream.streams.listTagBindings
datastream.streams.listEffectiveTags
datastream.privateConnections.createTagBinding
datastream.privateConnections.deleteTagBinding
datastream.privateConnections.listTagBindings
datastream.privateConnections.listEffectiveTags
Tag-Schlüssel und -Werte erstellen
Bevor Sie ein Tag anhängen können, müssen Sie ein Tag erstellen und seinen Wert konfigurieren. Informationen zum Erstellen von Tag-Schlüsseln und Tag-Werten finden Sie unter Tag erstellen und Tag-Wert hinzufügen:
Tags an einen Stream, ein Verbindungsprofil oder eine private Verbindung anhängen
Nachdem das Tag erstellt wurde, müssen Sie es an ein Stream, ein Verbindungsprofil oder eine private Verbindung.
Console
- Rufen Sie in der Google Cloud Console die Seite Datastream auf.
- Wählen Sie die Seite der Ressource aus, an die Sie ein Tag anhängen möchten. Wenn Sie beispielsweise einem Verbindungsprofil ein Tag zuweisen möchten, rufen Sie die Seite Verbindungsprofile auf.
- Klicken Sie auf Tags.
- Wenn Ihre Organisation nicht im Bereich Tags angezeigt wird, klicken Sie auf Bereich auswählen. Wählen Sie Ihre Organisation aus und klicken Sie auf Öffnen.
- Klicken Sie auf Tag hinzufügen.
- Wählen Sie aus der Liste den Schlüssel für das Tag aus, das Sie anhängen möchten. Sie können die Liste filtern, indem Sie Suchbegriffe eingeben.
- Wählen Sie den Wert für das Tag, das Sie anhängen möchten, aus der Liste aus. Sie können die Liste filtern, indem Sie Suchbegriffe eingeben.
- Klicken Sie auf Speichern.
- Klicken Sie im Dialogfeld Bestätigen auf Bestätigen, um die Tag.
Mit einer Benachrichtigung wird bestätigt, dass Ihre Tags aktualisiert wurden.
gcloud
Wenn Sie ein Tag an einen Stream, ein Verbindungsprofil oder eine private Verbindung anhängen möchten, müssen Sie mit dem Befehl gcloud resource-manager tags bindings create
eine Tag-Bindungsressource erstellen:
gcloud resource-manager tags bindings create \ --tag-value=TAGVALUE_NAME \ --parent=RESOURCE_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
TAGVALUE_NAME
: die permanente ID oder der Namespace-Name des angehängten Tag-Werts. Beispiel:tagValues/567890123456
.-
RESOURCE_ID
ist die vollständige ID der Ressource. einschließlich des API-Domainnamens zur Identifizierung des Ressourcentyps (//datastream.googleapis.com/
). Um beispielsweise ein Tag an eineprojects/PROJECT_NAME/streams/STREAM_NAME
, lautet die vollständige ID://datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME
. LOCATION
: Der Standort Ihrer Ressource. Wenn Sie ein Tag an eine globale Ressource anhängen, z. B. einen Ordner oder ein Projekt, lassen Sie dieses Flag weg. Wenn Sie ein Tag an eine regionale oder zonale Ressource anhängen, müssen Sie den Standort angeben, z. B.us-central1
(Region) oderus-central1-a
(Zone).
Tags auflisten, die an einen Stream, ein Verbindungsprofil oder eine private Verbindung angehängt sind
Sie können eine Liste der Tag-Bindungen ansehen, die direkt mit dem -Stream, -Verbindungsprofil oder eine private Verbindung.
Console
- Rufen Sie in der Nest App die Seite Datastream auf. Google Cloud Console
Wählen Sie die Seite für die Ressource aus, für die Sie Tags ansehen möchten. Um beispielsweise Tags für das Verbindungsprofil anzusehen, rufen Sie die Seite Verbindungsprofile auf.
Tags werden in der Spalte Tags der den Stream, das Verbindungsprofil oder die private Verbindung.
gcloud
Verwenden Sie den Befehl gcloud resource-manager tags bindings list
, um eine Liste der Tag-Bindungen abzurufen, die an eine Ressource angehängt sind:
gcloud resource-manager tags bindings list \ --parent=RESOURCE_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
-
RESOURCE_ID
ist die vollständige ID der Ressource. einschließlich des API-Domainnamens zur Identifizierung des Ressourcentyps (//datastream.googleapis.com/
). Um beispielsweise ein Tag an eineprojects/PROJECT_NAME/streams/STREAM_NAME
, lautet die vollständige ID://datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME
. LOCATION
: Der Standort Ihrer Ressource. Wenn Sie ein Tag aufrufen, das an eine globale Ressource angehängt ist, z. B. einen Ordner oder ein Projekt, lassen Sie dieses Flag weg. Wenn Sie ein Tag aufrufen, das an eine regionale oder zonale Ressource angehängt ist, müssen Sie den Standort angeben, z. B.us-central1
(Region) oderus-central1-a
(Zone).
Sie sollten eine Antwort ähnlich der folgenden erhalten:
name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456 tagValue: tagValues/567890123456 resource: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<
Tags von einem Stream, Verbindungsprofil oder einer privaten Verbindung lösen
Sie können Tags, die direkt an einen Stream, ein Verbindungsprofil oder eine private Verbindung angehängt wurden, trennen. Übernommene Tags können durch Anhängen eines Tags mit demselben Schlüssel und einem anderen Wert überschrieben, aber nicht getrennt werden. Bevor Sie ein Tag löschen können, müssen Sie dessen Schlüssel und Werte von allen Ressourcen trennen, an die es angehängt ist.
Console
- Rufen Sie in der Google Cloud Console die Seite Datastream auf.
- Wählen Sie die Seite der Ressource aus, von der Sie ein Tag entfernen möchten. Wenn Sie beispielsweise ein Tag aus einem Verbindungsprofil entfernen möchten, rufen Sie die Seite Verbindungsprofile auf.
- Klicken Sie auf Tags.
- Klicken Sie im Bereich Tags neben dem Tag, das Sie trennen möchten, auf Element löschen.
- Klicken Sie auf Speichern.
- Klicken Sie im Dialogfeld Bestätigen auf Bestätigen, um das Tag zu trennen.
Mit einer Benachrichtigung wird bestätigt, dass Ihre Tags aktualisiert wurden.
gcloud
Verwenden Sie den Befehl gcloud resource-manager tags bindings delete
, um eine Tag-Bindung zu löschen:
gcloud resource-manager tags bindings delete \ --tag-value=TAGVALUE_NAME \ --parent=RESOURCE_ID \ --location=LOCATION
Ersetzen Sie dabei Folgendes:
TAGVALUE_NAME
: die permanente ID oder der Namespace-Name des angehängten Tag-Werts. Beispiel:tagValues/567890123456
.-
RESOURCE_ID
ist die vollständige ID der Ressource. einschließlich des API-Domainnamens zur Identifizierung des Ressourcentyps (//datastream.googleapis.com/
). Um beispielsweise ein Tag an eineprojects/PROJECT_NAME/streams/STREAM_NAME
, lautet die vollständige ID://datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME
. LOCATION
: Der Standort Ihrer Ressource. Wenn Sie ein Tag an eine globale Ressource anhängen, z. B. einen Ordner oder ein Projekt, lassen Sie dieses Flag weg. Wenn Sie ein Tag an eine regionale oder zonale Ressource anhängen, müssen Sie den Standort angeben, z. B.us-central1
(Region) oderus-central1-a
(Zone).
Tag-Schlüssel und -Werte löschen
Achten Sie beim Entfernen eines Tag-Schlüssels oder einer Wertedefinition darauf, dass das Tag vom Stream, Verbindungsprofil oder der privaten Verbindung getrennt ist. Sie müssen vorhandene Tag-Anhänge, die als Tag-Bindungen bezeichnet werden, löschen, bevor Sie die Tag-Definition selbst löschen. Informationen zum Löschen von Tag-Schlüsseln und Tag-Werten finden Sie unter Tags löschen.
Bedingungen und Tags für Identity and Access Management
Mit Tags und IAM-Bedingungen können Sie Nutzern in Ihrer Hierarchie bedingte Rollenbindungen zuweisen. Wenn Sie das an eine Ressource angehängte Tag ändern oder löschen, kann der Nutzerzugriff auf diese Ressource entfernt werden, nachdem eine IAM-Richtlinie mit bedingten Rollenbindungen angewendet wurde. Weitere Informationen finden Sie unter Bedingungen und Tags für Identity and Access Management.
Nächste Schritte
- Weitere Dienste ansehen, die Tags unterstützen.
- Unter Tags und Zugriffssteuerung erfahren Sie, wie Sie Tags mit IAM