Taggen von Amazon DocumentDB DocumentDB-Ressourcen - Amazon DocumentDB

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 DocumentDB DocumentDB-Ressourcen

Sie können Amazon DocumentDB-Tags (mit MongoDB-Kompatibilität) verwenden, um Metadaten zu Ihren Amazon DocumentDB DocumentDB-Ressourcen hinzuzufügen. Diese Tags können mit AWS Identity and Access Management (IAM) -Richtlinien verwendet werden, um den Zugriff auf Amazon DocumentDB DocumentDB-Ressourcen zu verwalten und zu kontrollieren, welche Aktionen auf die 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 DocumentDB DocumentDB-Ressourcen taggen:

  • Cluster

  • Instances

  • Snapshots

  • Cluster-Snapshots

  • Parametergruppen

  • Cluster-Parametergruppen

  • Sicherheitsgruppen

  • Subnetzgruppen

Übersicht über Amazon DocumentDB DocumentDB-Ressourcen-Tags

Ein Amazon DocumentDB-Tag ist ein Name-Wert-Paar, das Sie definieren und mit einer Amazon DocumentDB DocumentDB-Ressource verknüpfen. Der Name wird als der Schlüssel bezeichnet. Die Angabe eines Wertes für den Schlüssel ist optional. Sie können Tags verwenden, um einer Amazon DocumentDB DocumentDB-Ressource beliebige Informationen zuzuweisen. Sie können einen Tag-Schlüssel z. B. dazu verwenden, um eine Kategorie zu definieren, und ein Tag-Wert könnte ein Element in dieser Kategorie sein. Sie könnten beispielsweise einen Tag-Schlüssel project und einen Tag-Wert von definierenSalix, was angibt, dass die Amazon DocumentDB DocumentDB-Ressource dem Salix-Projekt zugewiesen ist. Sie können Tags auch verwenden, um Amazon DocumentDB DocumentDB-Ressourcen so zu kennzeichnen, dass sie für Test- oder Produktionszwecke verwendet werden, indem Sie einen Schlüssel wie environment=test oder verwenden. environment=production Wir empfehlen Ihnen, einen konsistenten Satz von Tag-Schlüsseln zu verwenden, um die Nachverfolgung von Metadaten zu erleichtern, die Amazon DocumentDB DocumentDB-Ressourcen zugeordnet sind.

Sie können Tags verwenden, 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 im AWS Benutzerhandbuch für Fakturierung und Kostenmanagement.

Jede Amazon DocumentDB DocumentDB-Ressource hat einen Tagsatz, der alle Tags enthält, die dieser Ressource zugewiesen sind. Ein Tag-Satz kann bis zu zehn Tags enthalten oder leer sein. Wenn Sie einer Amazon DocumentDB DocumentDB-Ressource ein Tag hinzufügen, das denselben Schlüssel wie ein vorhandenes Tag auf einer Ressource hat, überschreibt der neue Wert den alten Wert.

AWS weist Ihren Tags keine semantische Bedeutung zu; Tags werden ausschließlich als Zeichenketten interpretiert. Amazon DocumentDB kann Tags für eine Instance oder andere Amazon DocumentDB DocumentDB-Ressourcen festlegen, abhängig von den Einstellungen, die Sie bei der Erstellung der Ressource verwenden. Amazon DocumentDB könnte beispielsweise ein Tag hinzufügen, das angibt, dass eine Instance für die Produktion oder zum Testen bestimmt ist.

Sie können ein Tag an einen Snapshot anfügen. Diese Gruppierung taucht jedoch nicht in Ihrer Rechnung auf.

Sie können das AWS Management Console oder das verwenden, um Tags AWS CLI zu Amazon DocumentDB DocumentDB-Ressourcen hinzuzufügen, aufzulisten und zu löschen. Wenn Sie den verwenden AWS CLI, müssen Sie den Amazon-Ressourcennamen (ARN) für die Ressource angeben, mit der Sie arbeiten möchten. Weitere Informationen zu Amazon DocumentDB finden Sie ARNs unterGrundlegendes zu Amazon DocumentDB Amazon Resource Names () ARNs.

Tag-Einschränkungen

Die folgenden Einschränkungen gelten für Amazon DocumentDB-Tags:

  • Maximale Anzahl von Tags pro Ressource: 10

  • Maximale Schlüssellänge – 128 Unicode-Zeichen

  • Maximale Wertlänge – 256 Unicode-Zeichen

  • Gültige Zeichen für Schlüssel und Wert — Groß- und Kleinbuchstaben im Zeichensatz UTF -8, Ziffern, Leerzeichen und die folgenden Zeichen: _ . : / = + - und @ (Java-Regex:) "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"

  • Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

  • Das Präfix aws: kann nicht für die Tag-Schlüssel oder Werte verwendet werden. Dieses Präfix ist für AWS reserviert.

Hinzufügen und Aktualisieren von Tags in einer Amazon DocumentDB DocumentDB-Ressource

Mit dem AWS Management Console oder dem können Sie einer Ressource bis zu 10 Tags hinzufügen. AWS CLI

Using the AWS Management Console

Der Prozess für das Hinzufügen eines Tags zu einer Ressource ist ähnlich, unabhängig davon, welcher Ressource Sie das Tag hinzufügen. In diesem Beispiel fügen Sie ein Tag zu einem Cluster hinzu.

So fügen Sie Tags einem Cluster über die Konsole hinzu oder aktualisieren sie
  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

  2. Wählen Sie im Navigationsbereich Cluster aus.

  3. Wählen Sie den Namen des Clusters aus, zu dem Sie Tags hinzufügen möchten.

  4. Scrollen Sie nach unten zum Abschnitt Tags und wählen Sie anschließend Bearbeiten aus.

  5. Für alle Tags, die Sie dieser Ressource hinzufügen möchten, gehen Sie wie folgt vor:

    1. Um ein neues Tag hinzuzufügen, geben Sie den Namen des Tags in das Feld Schlüssel ein. Um den Wert eines Tags zu ändern, suchen Sie den Namen des Tags in der Spalte Schlüssel.

    2. Um dem Tag einen neuen oder aktualisierten Wert zu geben, geben Sie einen Wert für das Tag in das Feld Wert ein.

    3. Wenn Sie mehrere Tags hinzufügen möchten, klicken Sie auf Hinzufügen. Andernfalls klicken Sie auf Speichern, sobald Sie fertig sind.

Using the AWS CLI

Der Prozess für das Hinzufügen eines Tags zu einer Ressource ist ähnlich, unabhängig davon, welcher Ressource Sie die Tags hinzufügen. In diesem Beispiel fügen Sie drei Tags zu einem Cluster hinzu. Das zweite Tag, key2, hat keinen Wert.

Verwenden Sie den AWS CLI Vorgang add-tags-to-resource mit diesen Parametern.

Parameter
  • --resource-name— ARN Die Amazon DocumentDB DocumentDB-Ressource, der Sie Tags hinzufügen möchten.

  • --tags—Eine Liste der Tags (Schlüssel-Wert-Paar), die Sie dieser Ressource hinzufügen möchten, im folgenden Format. Key=key-name,Value=tag-value

Für Linux, macOS oder Unix:

aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Für Windows:

aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Die add-tags-to-resource-Operation erzeugt keine Ausgabe. Um die Ergebnisse der Operation anzuzeigen, verwenden Sie die list-tags-for-resource-Operation.

Tags in einer Amazon DocumentDB DocumentDB-Ressource auflisten

Sie können das AWS Management Console oder das verwenden AWS CLI , um eine Liste der Tags für eine Amazon DocumentDB DocumentDB-Ressource zu erhalten.

Using the AWS Management Console

Der Prozess für das Auflisten von Tags in einer Ressource ist ähnlich, unabhängig davon, welcher Ressource Sie das Tag hinzufügen. In diesem Beispiel listen Sie die Tags für einen Cluster auf.

So listen Sie die Tags in einem Cluster mithilfe der Konsole auf
  1. Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

  2. Wählen Sie im Navigationsbereich Cluster aus.

  3. Wählen Sie den Namen des Clusters aus, für den Sie Tags auflisten möchten.

  4. Um eine Liste der Tags in dieser Ressource anzuzeigen, scrollen Sie nach unten zum Abschnitt Tags.

Using the AWS CLI

Der Prozess für das Auflisten der Tags in einer Ressource ist ähnlich, unabhängig davon, für welche Ressource Sie das Tag auflisten. In diesem Beispiel listen Sie die Tags in einem Cluster auf.

Verwenden Sie die AWS CLI Operation list-tags-for-resource mit diesen Parametern.

Parameter
  • --resource-name—Erforderlich. Die ARN Amazon DocumentDB DocumentDB-Ressource, für die Sie Tags auflisten möchten.

Für Linux, macOS oder Unix:

aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Für Windows:

aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSONFormat).

{ "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] }

Tags aus einer Amazon DocumentDB DocumentDB-Ressource entfernen

Sie können das AWS Management Console oder das verwenden, AWS CLI um Tags aus Amazon DocumentDB DocumentDB-Ressourcen zu entfernen.

Using the AWS Management Console

Der Prozess für das Entfernen von Tags aus einer Ressource ist ähnlich, unabhängig davon, welcher Ressource Sie das Tag hinzufügen. In diesem Beispiel entfernen Sie Tags aus einem Cluster.

So entfernen Sie Tags aus einem Cluster mithilfe der Konsole
  1. Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

  2. Wählen Sie im Navigationsbereich Cluster aus.

  3. Wählen Sie den Namen des Clusters aus, aus dem Sie Tags entfernen möchten.

  4. Scrollen Sie nach unten zum Abschnitt Tags und wählen Sie anschließend Bearbeiten aus.

  5. Wenn Sie alle Tags aus dieser Ressource entfernen möchten, wählen Sie Remove all (Alle entfernen) aus. Andernfalls gehen Sie für alle Tags, die Sie aus dieser Ressource entfernen möchten, wie folgt vor:

    1. Suchen Sie den Namen des Tags in der Spalte Schlüssel.

    2. Wählen Sie Entfernen auf derselben Zeile wie der Tag-Schlüssel aus.

    3. Wenn Sie fertig sind, wählen Sie Speichern aus.

Using the AWS CLI

Der Prozess für das Entfernen eines Tags aus einer Ressource ist ähnlich, unabhängig davon, aus welcher Ressource Sie das Tag entfernen. In diesem Beispiel entfernen Sie ein Tag aus einem Cluster.

Verwenden Sie die AWS CLI Operation remove-tags-from-resource mit diesen Parametern.

  • --resource-name—Erforderlich. Die ARN Amazon DocumentDB DocumentDB-Ressource, aus der Sie Tags entfernen möchten.

  • --tag-keys—Erforderlich. Eine Liste der Tag-Schlüssel, die von dieser Ressource entfernt werden sollen.

Für Linux, macOS oder Unix:

aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3

Für Windows:

aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3

Die removed-tags-from-resource-Operation erzeugt keine Ausgabe. Um die Ergebnisse der Operation anzuzeigen, verwenden Sie die list-tags-for-resource-Operation.