Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Taggen von Amazon RDS-Ressourcen Ein Amazon-RDS-Tag ist ein Name-Wert-Paar, das Sie definieren und mit einer Amazon-RDS-Ressource wie einer DB-Instance oder einem DB-Snapshot verknüpfen. Der Name wird als der Schlüssel bezeichnet. Optional können Sie einen Wert für den Schlüssel angeben. Sie können die AWS-Managementkonsole AWS CLI, oder die Amazon RDS-API verwenden, um Tags zu Amazon RDS-Ressourcen hinzuzufügen, aufzulisten und zu löschen. Wenn Sie die CLI oder API verwenden, müssen Sie den Amazon-Ressourcennamen (ARN) für die RDS-Ressource angeben, mit der Sie arbeiten möchten. Weitere Informationen zum Konstruieren eines ARN finden Sie unter [Erstellen eines ARN für Amazon RDS](USER_Tagging.ARN.Constructing.md). Mithilfe von Tags fügen Sie Metadaten zu Ihren Amazon-RDS-Ressourcen hinzu. Sie können die Tags verwenden, um Ihre eigenen Notationen unter anderem zu Datenbank-Instances, Snapshots und Aurora-Clustern hinzuzufügen. Dies kann Ihnen dabei helfen, Ihre Amazon-RDS-Ressourcen zu dokumentieren. Sie können die Tags auch mit automatisierten Wartungsvorgängen verwenden. Insbesondere können Sie diese Tags mit IAM-Richtlinien verwenden. Sie können sie verwenden, um den Zugriff auf Amazon-RDS-Ressourcen zu verwalten und zu steuern, welche Aktionen auf diese Ressourcen angewendet werden können. Sie können Tags auch verwenden, um Kosten zu verfolgen, indem Ausgaben für ähnlich markierte Ressourcen gruppiert werden. Sie können die folgenden Amazon-RDS-Ressourcen mit Tags versehen: + DB-Instances + DB-Cluster + Globale Aurora-Cluster + DB-Cluster-Endpunkte + Read Replicas + DB-Snapshots + DB-Cluster-Snapshots + Reservierte DB-Instances + Ereignisabonnements + DB-Optionsgruppen + DB-Parametergruppen + DB-Cluster-Parametergruppen + DB-Subnetzgruppen + RDS-Proxys + RDS-Proxy-Endpunkte + Blau/Grün-Bereitstellungen + Zero-ETL-Integrationen + Automatische Backups + Automatisierte Cluster-Backups **Anmerkung** Wenn Sie eine DB-Instance taggen, wendet Amazon RDS diese Tags automatisch auf die zugehörigen Performance Insights Insights-Ressourcen an. Derzeit können Sie RDS-Proxys und RDS-Proxy-Endpunkte nicht mit dem taggen. AWS-Managementkonsole **Topics** + [Warum Tags für Amazon-RDS-Ressourcen verwenden?](#Tagging.Purpose) + [So funktionieren Tags für Amazon-RDS-Ressourcen](#Overview.Tagging) + [Bewährte Methoden für das Taggen von Amazon-RDS-Ressourcen](#Tagging.best-practices) + [Kopieren von Tags in DB-Snapshots](#USER_Tagging.CopyTags) + [Verschlagwortung automatisierter Backup-Ressourcen](#USER_Tagging.AutomatedBackups) + [Hinzufügen und Löschen von Tags in Amazon RDS](#Tagging.HowTo) + [Tutorial: Verwenden von Tags, um anzugeben, welche DB-Instances angehalten werden sollen](Tagging.RDS.Autostop.md) ## Warum Tags für Amazon-RDS-Ressourcen verwenden? Mit Tags können Sie die folgenden Aktionen ausführen: + Kategorisieren Sie Ihre RDS-Ressourcen nach Anwendung, Projekt, Abteilung, Umgebung usw. Sie können einen Tag-Schlüssel z. B. dazu verwenden, eine Kategorie zu definieren, wobei ein Tag-Wert ein Element in dieser Kategorie ist. Sie könnten das Tag `environment=prod` erstellen. Alternativ könnten Sie beispielsweise den Tag-Schlüssel `project` und den Tag-Wert `Salix` definieren, was angibt, dass die Amazon-RDS-Ressource dem Projekt „Salix“ zugewiesen ist. + Automatisieren Sie Aufgaben im Ressourcenmanagement. Sie könnten beispielsweise ein Wartungsfenster für Instances mit dem Tag `environment=prod` erstellen, das sich vom Fenster für Instances mit dem Tag `environment=test` unterscheidet. Sie könnten auch automatische DB-Snapshots für markierte Instances mit dem Tag `environment=prod` konfigurieren. + Steuern Sie den Zugriff auf RDS-Ressourcen innerhalb einer IAM-Richtlinie. Hierzu können Sie den globalen Bedingungsschlüssel `aws:ResourceTag/tag-key` verwenden. Eine Richtlinie könnte es beispielsweise nur Benutzern in der Gruppe `DBAdmin` gestatten, DB-Instances mit dem Tag `environment=prod` zu ändern. Informationen zur Verwaltung des Zugriffs auf markierte Ressourcen mit IAM-Richtlinien finden Sie unter [Identity and Access Management für Amazon RDS](UsingWithRDS.IAM.md) [Steuern des Zugriffs auf AWS Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) im *AWS Identity and Access Management-Benutzerhandbuch*. + Überwachen Sie Ressourcen anhand eines Tags. Sie können beispielsweise ein CloudWatch Amazon-Dashboard für DB-Instances erstellen, die mit gekennzeichnet sind`environment=prod`. + Verfolgen Sie Kosten, indem Ausgaben für Ressourcen mit ähnlichen Tags gruppiert werden. Wenn Sie beispielsweise RDS-Ressourcen, die mit dem Projekt „Salix“ verknüpft sind, mit dem Tag `project=Salix` versehen, können Sie Kostenberichte für dieses Projekt erstellen und Ausgaben diesem Projekt zuordnen. Weitere Informationen finden Sie unter [So funktioniert die AWS Abrechnung mit Tags in Amazon RDS](#Tagging.Billing). ## So funktionieren Tags für Amazon-RDS-Ressourcen AWS wendet Ihren Tags keine semantische Bedeutung an. Tags werden streng als Zeichenfolgen interpretiert. **Topics** + [Tag-Sätze in Amazon RDS](#Overview.Tagging.Sets) + [Tag-Struktur in Amazon RDS](#Overview.Tagging.Structure) + [Für das Taggen infrage kommende Amazon-RDS-Ressourcen](#Overview.Tagging.Resources) + [So funktioniert die AWS Abrechnung mit Tags in Amazon RDS](#Tagging.Billing) ### Tag-Sätze in Amazon RDS Jede Amazon-RDS-Ressource hat einen Container, der als Tag-Satz bezeichnet wird. Der Container enthält alle Tags, die der Ressource zugewiesen sind. Eine Ressource hat genau einen Tag-Satz. Ein Tag-Satz enthält 0–50 Tags. Wenn Sie einer RDS-Ressource ein Tag mit demselben Schlüssel hinzufügen wie ein bereits vorhandenes Tag der Ressource, überschreibt der neue Wert den alten. ### Tag-Struktur in Amazon RDS Die Struktur eines RDS-Tags sieht wie folgt aus: **Tag-Schlüssel** Der Schlüssel ist der erforderliche Name des Tags. Der Zeichenfolgenwert muss aus 1 bis 128 Unicode-Zeichen bestehen. Ihm darf kein „`aws:`“ oder „`rds:`“ als Präfix vorangestellt werden. Die Zeichenfolge darf nur Unicode-Zeichen, Ziffern, Leerzeichen sowie `_`, `.`, `:`, `/`, `=`, `+`, `-` und `@` enthalten. Der Java-Regex ist `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. Bei Tag-Schlüsseln wird die Groß- und Kleinschreibung beachtet. Somit sind die Schlüssel `project` und `Project` unterschiedlich. Ein Schlüssel in einem Tag-Satz ist eindeutig. Sie können z. B. in einem Tag-Satz kein Schlüsselpaar mit gleichem Schlüssel, aber unterschiedlichen Werten verwenden, wie `project=Trinity` und `project=Xanadu`. **Tag-Wert** Der Tag-Wert ist ein optionaler Zeichenfolgenwert des Tags. Der Zeichenfolgenwert muss aus 1 bis 256 Unicode-Zeichen bestehen. Die Zeichenfolge darf nur Unicode-Zeichen, Ziffern, Leerzeichen sowie `_`, `.`, `:`, `/`, `=`, `+`, `-` und `@` enthalten. Der Java-Regex ist `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. Bei Tag-Werten muss die Groß- und Kleinschreibung beachtet werden. Somit sind die Werte `prod` und `Prod` unterschiedlich. Die Werte innerhalb eines Tag-Satzes müssen nicht eindeutig und können null sein. Es ist z. B. ein Schlüssel-Wert-Paar in einem Tag-Satz `project=Trinity` und `cost-center=Trinity` möglich. ### Für das Taggen infrage kommende Amazon-RDS-Ressourcen Sie können die folgenden Amazon-RDS-Ressourcen kennzeichnen: + DB-Instances + DB-Cluster + DB-Cluster-Endpunkte + Read Replicas + DB-Snapshots + DB-Cluster-Snapshots + Reservierte DB-Instances + Ereignisabonnements + DB-Optionsgruppen + DB-Parametergruppen + DB-Cluster-Parametergruppen + DB-Subnetzgruppen + RDS-Proxys + RDS-Proxy-Endpunkte **Anmerkung** Derzeit können Sie RDS-Proxys und RDS-Proxy-Endpunkte nicht per AWS-Managementkonsole markieren. + Blau/Grün-Bereitstellungen + Null-ETL-Integrationen (Vorschau) + Automatische Backups + Automatisierte Cluster-Backups ### So funktioniert die AWS Abrechnung mit Tags in Amazon RDS Verwenden Sie Tags, um Ihre AWS Rechnung so zu organisieren, dass sie Ihrer eigenen Kostenstruktur entspricht. Melden Sie sich dazu an, um Ihre AWS-Konto Rechnung mit den Tag-Schlüsselwerten zu erhalten. Um dann die Kosten kombinierter Ressourcen anzuzeigen, organisieren Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag-Schlüsselwerten. Beispielsweise können Sie mehrere Ressourcen mit einem bestimmten Anwendungsnamen markieren und dann Ihre Fakturierungsinformationen so organisieren, dass Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen können. Weitere Informationen finden Sie unter [Verwendung von Kostenzuordnungs-Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) im *AWS Billing -Benutzerhandbuch*. #### So funktionieren Kostenzuweisungs-Tags mit Sie können einem DB-Snapshot ein Tag hinzufügen. Diese Gruppierung erscheint jedoch nicht in Ihrer Rechnung. Für die Anwendung von Kostenzuordnung-Tags für DB-Snapshots müssen die folgenden Bedingungen erfüllt sein: + Die Tags müssen an die übergeordnete DB-Instance angehängt werden. + Die übergeordnete DB-Instance muss genauso vorhanden sein AWS-Konto wie der . + Die übergeordnete DB-Instance muss genauso vorhanden sein AWS-Region wie der . DB-Snapshots gelten als verwaist, wenn sie nicht in derselben Region wie die übergeordnete DB-Instance existieren oder wenn die übergeordnete DB-Instance gelöscht wurde. Verwaiste DB-Snapshots unterstützen keine Kostenzuordnung-Tags. Die Kosten für verwaiste Snapshots werden in einer einzigen Zeile ohne Tags zusammengefasst. Kontoübergreifende DB-Snapshots gelten nicht als verwaist, wenn die folgenden Bedingungen erfüllt sind: + Sie müssen sich in derselben Region wie die DB-Instance befinden. + Das Quellkonto ist Eigentümer der übergeordneten DB-Instance. **Anmerkung** Wenn ein anderes Konto Eigentümer der übergeordneten DB-Instance ist, gelten die Kostenzuordnungs-Tags nicht für kontenübergreifende Snapshots im Zielkonto. ## Bewährte Methoden für das Taggen von Amazon-RDS-Ressourcen Wir empfehlen Ihnen, bei der Verwendung von Tags folgende bewährte Methode befolgen: + Dokumentieren Sie Konventionen für die Verwendung von Tags, die von allen Teams in Ihrem Unternehmen befolgt werden. Achten Sie insbesondere darauf, dass die Namen sowohl beschreibend als auch einheitlich sind. Zum Beispiel sollte das Format `environment:prod` standardisiert werden, anstatt einige Ressourcen mit `env:production`zu kennzeichnen. **Wichtig** Speichern Sie keine personenbezogenen Daten (PII) oder andere vertrauliche Informationen in Tags. + Automatisieren Sie das Tagging, um Einheitlichkeit zu gewährleisten. Sie können die folgenden Techniken verwenden: + Fügen Sie Tags in eine CloudFormation Vorlage ein. Wenn Sie Ressourcen mit der Vorlage erstellen, werden die Ressourcen automatisch mit Tags versehen. + Definieren und wenden Sie Tags mithilfe von AWS Lambda Funktionen an. + Erstellen Sie ein SSM-Dokument, das Schritte zum Hinzufügen von Tags zu Ihren RDS-Ressourcen enthält. + Verwenden Sie Tags nur bei Bedarf Sie können bis zu 50 Tags für eine einzelne RDS-Ressource hinzufügen. Eine bewährte Methode besteht jedoch darin, unnötig viele und komplexe Tags zu vermeiden. + Überprüfen Sie die Tags regelmäßig auf Relevanz und Richtigkeit. Entfernen oder ändern Sie veraltete Tags nach Bedarf. + Erwägen Sie das Erstellen von Tags mit dem AWS Tag-Editor in der AWS-Managementkonsole. Sie können den Tag-Editor verwenden, um mehreren unterstützten AWS Ressourcen, einschließlich RDS-Ressourcen, gleichzeitig Tags hinzuzufügen. Weitere Informationen finden Sie unter [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) im *Benutzerhandbuch von AWS Resource Groups*. ## Kopieren von Tags in DB-Snapshots Wenn Sie eine DB-Instance erstellen oder wiederherstellen, können Sie festlegen, dass die Tags aus der DB-Instance in Snapshots der DB-Instance kopiert werden. Das Kopieren von Tags stellt sicher, dass die Metadaten für die DB-Snapshots mit denen der Quell-DB-Instance übereinstimmen. Es wird außerdem sichergestellt, dass alle Zugriffsrichtlinien für die DB-Snapshots auch mit denen der Quell-DB-Instance übereinstimmen. Sie können für die folgenden Aktionen festlegen, dass Tags in DB-Snapshots kopiert werden: + Erstellen einer DB-Instance + Wiederherstellen einer DB-Instance + Erstellen eines Lesereplikats + Kopieren eines DB-Snapshots Um Tags für die vorherigen Aktionen zu kopieren, wählen Sie in der die AWS-Managementkonsole Option **Tags in Snapshots kopieren** aus oder geben Sie sie `--copy-tags-to-snapshot` in an AWS CLI. Beim Kopieren eines DB-Snapshots können Sie die zugehörigen Tags nur kopieren, wenn Sie den DB-Snapshot in dasselbe Konto kopieren. Sie können keine Tags kopieren, wenn Sie einen DB-Snapshot zwischen Konten kopieren. In den meisten Fällen werden Tags nicht standardmäßig kopiert. Wenn Sie jedoch eine DB-Instance aus einem DB-Snapshot wiederherstellen, prüft RDS, ob Sie neue Tags angeben. Wenn ja, werden die neuen Tags zur wiederhergestellten DB-Instance hinzugefügt. Wenn es keine neuen Tags gibt und sich der DB-Snapshot im selben Konto befindet wie die Quell-DB-Instance, fügt RDS der wiederhergestellten DB-Instance die Tags aus der Quell-DB-Instance zum Zeitpunkt der Snapshot-Erstellung hinzu. RDS fügt keine Tags aus der Quell-DB-Instance hinzu, wenn der DB-Snapshot in ein anderes Konto kopiert und dort wiederhergestellt wird. Um zu verhindern, dass Tags von Quell-DB-Instances zu wiederhergestellten DB-Instances hinzugefügt werden, empfehlen wir Ihnen, beim Wiederherstellen einer DB-Instance neue Tags anzugeben. **Anmerkung** In einigen Fällen können Sie einen Wert für den `--tags` Parameter des [create-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-snapshot.html) AWS CLI Befehls angeben. Oder Sie können mindestens ein Tag für den Vorgang [Create DBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBSnapshot.html) API angeben. In diesen Fällen kopiert RDS keine Tags von der Quell-DB-Instance in den neuen DB-Snapshot. Diese Funktionalität gilt sogar, wenn in der Quell-DB-Instance die Option `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`) aktiviert ist. Wenn Sie diesen Ansatz verwenden, können Sie eine Kopie einer DB-Instance aus einem DB-Snapshot erstellen. Dieser Ansatz vermeidet das Hinzufügen von Tags, die nicht für die neue DB-Instance gelten. Sie erstellen Ihren DB-Snapshot mit dem AWS CLI `create-db-snapshot` Befehl (oder dem `CreateDBSnapshot` RDS-API-Vorgang). Nachdem Sie Ihren DB-Snapshot erstellt haben, können Sie Tags hinzufügen. Dieser Vorgang wird später in diesem Thema beschrieben. ## Verschlagwortung automatisierter Backup-Ressourcen Automatisierte Backup-Ressourcen werden erstellt, wenn Sie den Wert für die Aufbewahrungsdauer von Backups von 0 auf über 0 setzen. Mithilfe des `--tag-specifications` Parameters können Sie automatisierte Backup-Ressourcen für Instanzen oder Cluster während der Erstellung kennzeichnen. ### Parameter mit Tag-Spezifikationen APIs die den `--tag-specifications` Anforderungsparameter unterstützen (wie [create-db-instancerestore-db-instance-from](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)[-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) usw.) [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html), können automatische Backups (Ressourcentyp: `auto-backup` oder) während der Erstellung taggen. `cluster-auto-backup` #### Automatisierte Backups der Instanz kennzeichnen Verwenden Sie `--tag-specifications` mit`ResourceType=auto-backup`, wenn Sie DB-Instances erstellen oder ändern, für die automatische Backups aktiviert sind. #### Automatisierte Cluster-Backups kennzeichnen Verwenden Sie `--tag-specifications` mit`ResourceType=cluster-auto-backup`, wenn Sie DB-Cluster erstellen, für die automatische Backups aktiviert sind. #### Markieren automatisierter Backups beim Ändern der DB-Instance Sie können automatische Backups nur dann taggen, `--tag-specifications` wenn Sie die Aufbewahrungsdauer von Backups auf einen Wert von 0 auf einen Wert über 0 setzen. Wenn automatisierte Backups bereits existieren, verwenden Sie stattdessen die [AddTagsToResource](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html)API. **Anmerkung** Automatisierte Backup-Tags sind unabhängig von Quell-DB-Instance-Tags, DB-Cluster-Tags oder DB-Snapshot-Tags. ## Hinzufügen und Löschen von Tags in Amazon RDS Sie haben die folgenden Möglichkeiten: + Erstellen Sie Tags, wenn Sie eine Ressource erstellen, z. B. wenn Sie den AWS CLI Befehl ausführen`create-db-instance`. + Fügen Sie Tags über den Befehl `add-tags-to-resource` zu einer vorhandenen Ressource hinzu. + Listen Sie über den Befehl `list-tags-for-resource` Tags auf, die einer bestimmten Ressource zugeordnet sind. + Aktualisieren Sie die Tags über den Befehl `add-tags-to-resource`. + Entfernen Sie Tags über den Befehl `remove-tags-from-resource` aus einer Ressource. Die folgenden Verfahren zeigen, wie typische Tagging-Operationen für Ressourcen im Zusammenhang mit DB-Instances durchgeführt werden. Beachten Sie, dass Tags für Autorisierungszwecke zwischengespeichert werden. Aus diesem Grund können beim Hinzufügen oder Aktualisieren von Tags zu Amazon-RDS-Ressourcen mehrere Minuten vergehen, bis die Änderungen sichtbar sind. ### Konsole Amazon-RDS-Ressourcen werden auf die gleiche Weise wie andere Ressourcen getaggt. Die folgenden Schritte zeigen, wie Sie eine Amazon-RDS-DB-Instance taggen. **So fügen Sie ein Tag zu einer DB-Instance hinzu** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Wählen Sie im Navigationsbereich **Datenbanken** aus. **Anmerkung** Geben Sie unter **Filter databases (Datenbanken filtern)** eine Textzeichenfolge ein, um die Liste der DB-Instances im Bereich **Databases (Datenbanken)** zu filtern. Es werden nur DB-Instances angezeigt, welche die Zeichenfolge enthalten. 1. Wählen Sie den Namen der DB-Instance aus, die Sie mit einem Tag versehen möchten, um deren Details anzuzeigen. 1. Scrollen Sie im Detailbereich nach unten zum Bereich **Tags**. 1. Wählen Sie **Add** aus. Das Fenster **Add tags** (Tags hinzufügen) wird angezeigt. ![\[Fenster "Tags hinzufügen"\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging5.png) 1. Geben Sie einen Wert für **Tag key (Tag-Schlüssel)** und **Wert** ein. 1. Wenn Sie ein weiteres Tag hinzufügen möchten, wählen Sie **Add another Tag (Weiteres Tag hinzufügen)** aus und geben Sie unter **Tag key (Tag-Schlüssel)** und **Wert** einen Wert ein. Wiederholen Sie diesen Schritt, bis Sie alle Tags hinzugefügt haben. 1. Wählen Sie **Add** aus. **So löschen Sie ein Tag aus einer DB-Instance** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Wählen Sie im Navigationsbereich **Datenbanken** aus. **Anmerkung** Geben Sie im Feld **Databases (Datenbanken)** eine Textzeichenfolge ein, um die Liste der DB-Instances im Bereich **Databases (Datenbanken)** zu filtern. Es werden nur DB-Instances angezeigt, welche die Zeichenfolge enthalten. 1. Wählen Sie den Namen der entsprechenden DB-Instance aus, um deren Details anzuzeigen. 1. Scrollen Sie im Detailbereich nach unten zum Bereich **Tags**. 1. Wählen Sie das Tag aus, das Sie löschen möchten. ![\[Tag-Bereich\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging6.png) 1. Wählen Sie **Löschen** und dann im Fenster **Löschen von Tags** erneut **Löschen** aus. ### AWS CLI Mithilfe der können Sie Tags für eine DB-Instance hinzufügen, auflisten oder entferne AWS CLI. + Verwenden Sie den AWS CLI Befehl, um einer Amazon RDS-Ressource ein oder mehrere Tags hinzuzufügen [https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html). + Verwenden Sie den AWS CLI Befehl, um die Tags auf einer Amazon RDS-Ressource aufzulisten [https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html). + Verwenden Sie den AWS CLI Befehl, um ein oder mehrere Tags aus einer Amazon RDS-Ressource zu entfernen [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html). Weitere Informationen zum Erstellen des erforderlichen ARN finden Sie unter [Erstellen eines ARN für Amazon RDS](USER_Tagging.ARN.Constructing.md). ### RDS-API Mithilfe der Amazon-RDS-API können Sie Tags für eine DB-Instance hinzufügen, auflisten oder entfernen. + Verwenden Sie die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html), um ein Tag zu einer Amazon-RDS-Ressource hinzuzufügen. + Verwenden Sie die API-Operation , um die Tags für eine Amazon-RDS-Ressource aufzulisten [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html). + Verwenden Sie die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html), um Tags aus einer Amazon-RDS-Ressource zu entfernen. Weitere Informationen zum Erstellen des erforderlichen ARN finden Sie unter [Erstellen eines ARN für Amazon RDS](USER_Tagging.ARN.Constructing.md). Wenn Sie in der Amazon-RDS-API mit XML arbeiten, nutzen Sie das folgende Schema: ``` 1. 2. 3. 4. Project 5. Trinity 6. 7. 8. User 9. Jones 10. 11. 12. ``` Die folgende Tabelle enthält eine Liste der zulässigen XML-Tags und deren Eigenschaften. Bei Werten für `Key` und `Value` wird die Groß-/Kleinschreibung berücksichtigt. Beispiel: `project=Trinity` und `PROJECT=Trinity` sind verschiedene Tags. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/USER_Tagging.html) # Tutorial: Verwenden von Tags, um anzugeben, welche DB-Instances angehalten werden sollen In diesem Tutorial wird davon ausgegangen, dass Sie über mehrere DB-Instances in einer Entwicklungs- oder Testumgebung verfügen. Sie müssen diese DB-Instances mehrere Tage lang beibehalten. Einige DB-Instances führen Tests über Nacht aus, während andere über Nacht angehalten und am nächsten Tag wieder gestartet werden können. Das folgende Tutorial zeigt, wie Sie denjenigen DB-Instances ein Tag zuweisen, die sich dafür eignen, über Nacht angehalten zu werden. Das Tutorial zeigt, wie ein Skript erkennt, welche DB-Instances dieses Tag haben, und diese mit Tags versehenen DB-Instances anschließend anhält. In diesem Beispiel spielt der Wertanteil des Schlüssel-Wert-Paares keine Rolle. Das Vorhandensein des `stoppable`-Tags bedeutet, dass die DB-Instance diese benutzerdefinierte Eigenschaft besitzt. Im folgenden Tutorial werden die Befehle und APIs für das Tagging verwendet ARNs, sodass RDS nahtlos über AWS Regionen, AWS Konten und verschiedene Ressourcentypen hinweg arbeiten kann, die möglicherweise identische Kurznamen haben. Sie können in CLI-Befehlen, die mit DB-Instances arbeiten, den ARN anstelle der DB-Instance-ID angeben. **Angabe, welche DB-Instances angehalten werden sollen** 1. Bestimmen Sie den ARN einer DB-Instance, die Sie als anhaltbar kennzeichnen wollen. Ersetzen Sie im folgenden Beispiel den Namen Ihrer eigenen DB-Instances durch. *dev-test-db-instance* Ersetzen Sie in nachfolgenden Befehlen mit ARN-Parametern den ARN Ihrer eigenen DB-Instance. Der ARN enthält Ihre eigene AWS Konto-ID und den Namen der AWS Region, in der sich Ihre DB-Instance befindet. ``` $ aws rds describe-db-instances --db-instance-identifier dev-test-db-instance \ --query "*[].{DBInstance:DBInstanceArn}" --output text arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance ``` 1. Fügen Sie das Tag `stoppable` zu dieser DB-Instance hinzu. Der Name für dieses Tag wird von Ihnen ausgewählt. Da das Tag in diesem Beispiel als Attribut behandelt wird, das entweder vorhanden ist oder nicht, wird der `Value=`-Teil des `--tags`-Parameters weggelassen. Dieser Ansatz bedeutet, dass Sie vermeiden können, eine Namenskonvention zu entwickeln, die alle relevanten Informationen in Namen codiert. In einer solchen Konvention können Sie Informationen im DB-Instance-Namen oder Namen anderer Ressourcen codieren. ``` $ aws rds add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance \ --tags Key=stoppable ``` 1. Bestätigen Sie, dass das Tag in der DB-Instance vorhanden ist. Die folgenden Befehle rufen die Tag-Informationen für die DB-Instance im JSON-Format und in einfachem tabulatorgetrenntem Text ab. ``` $ aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance { "TagList": [ { "Key": "stoppable", "Value": "" } ] } aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance --output text TAGLIST stoppable ``` 1. Halten Sie alle DB-Instances an, die als `stoppable` ermittelt werden. Im folgenden Beispiel wird eine Textdatei erstellt, die alle Ihre DB-Instances auflistet. Der Shell-Befehl durchläuft die Liste und prüft, ob jede DB-Instance mit dem entsprechenden Attribut gekennzeichnet ist, und führt den Befehl `aws rds stop-db-instance` für jede DB-Instance aus. ``` $ aws rds describe-db-instances --query "*[].[DBInstanceArn]" --output text >/tmp/db_instance_arns.lst $ for arn in $(cat /tmp/db_instance_arns.lst) do match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep stoppable)" if [[ ! -z "$match" ]] then echo "DB instance $arn is tagged as stoppable. Stopping it now." # Note that you need to get the DB instance identifier from the ARN. dbid=$(echo $arn | sed -e 's/.*://') aws rds stop-db-instance --db-instance-identifier $dbid fi done DB instance arn:arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance is tagged as stoppable. Stopping it now. { "DBInstance": { "DBInstanceIdentifier": "dev-test-db-instance", "DBInstanceClass": "db.t3.medium", ... ``` Sie können ein Skript wie das vorherige am Ende eines jeden Tages ausführen, um sicherzustellen, dass nicht benötigte DB-Instances angehalten werden. Sie können einen Job auch mit einem Dienstprogramm wie `cron` planen, um jede Nacht eine solche Überprüfung durchzuführen. Sie könnten so beispielsweise vorgehen, wenn einige DB-Instances versehentlich weiter ausgeführt wurden. Hier könnten Sie eine Feinabstimmung des Befehls vornehmen, mit dem die Liste der zu prüfenden DB-Instances vorbereitet wird. Der folgende Befehl erzeugt eine Liste Ihrer DB-Instances mit dem Status `available`. Das Skript kann DB-Instances ignorieren, die bereits angehalten wurden, da sie unterschiedliche Statuswerte wie `stopped` oder `stopping` haben. ``` $ aws rds describe-db-instances \ --query '*[].{DBInstanceArn:DBInstanceArn,DBInstanceStatus:DBInstanceStatus}|[?DBInstanceStatus == `available`]|[].{DBInstanceArn:DBInstanceArn}' \ --output text arn:aws:rds:us-east-1:123456789102:db:db-instance-2447 arn:aws:rds:us-east-1:123456789102:db:db-instance-3395 arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance arn:aws:rds:us-east-1:123456789102:db:pg2-db-instance ``` **Tipp** Sie können die Tags zuweisen und DB-Instances mit Hilfe dieser Tags finden, um die Kosten auf andere Weise zu senken. Nehmen wir zum Beispiel dieses Szenario mit DB-Instances, die für Entwicklungs- und Testzwecke verwendet werden. In diesem Fall können Sie einige DB-Instances festlegen, die am Ende eines jeden Tages gelöscht werden sollen. Oder Sie können sie so festlegen, dass ihre DB-Instances in Zeiten erwarteter geringer Auslastung in kleine DB-Instance-Klassen geändert werden.