Markieren von Amazon- OpenSearch Service-Domains - OpenSearch Amazon-Dienst

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.

Markieren von Amazon- OpenSearch Service-Domains

Mit Tags können Sie einer Amazon- OpenSearch Service-Domäne beliebige Informationen zuweisen, damit Sie diese Informationen kategorisieren und filtern können. Ein Tag ist ein Schlüssel-Wert-Paar, das Sie definieren und einer - OpenSearch Service-Domain zuordnen. Sie können diese Tags verwenden, um Kosten zu verfolgen, indem Sie Ausgaben für ähnlich markierte Ressourcen gruppieren. AWS wendet keine semantische Bedeutung auf Ihre Tags an. Tags werden streng als Zeichenfolgen interpretiert. Alle Tags haben die folgenden Elemente:

Tag-Element Beschreibung Erforderlich
Tag-Schlüssel

Der Tag-Schlüssel ist der Name des Markierungen. Der Schlüssel muss für die OpenSearch Service-Domain, an die er angefügt ist, eindeutig sein. Eine Liste der grundlegenden Einschränkungen auf Tag-Schlüsseln und -Werten finden Sie unter Einschränkungen benutzerdefinierter Tags.

Ja
Tag-Wert

Der Tag-Wert ist der Zeichenfolgenwert des Tags. Tag-Werte können null sein und müssen in einem Tag-Satz nicht einzigartig sein. Sie können beispielsweise über ein Schlüssel-Wert-Paar in einem Tag-Satz "Projekt/Trinity" und "Kostenstelle/Trinity" verfügen. Eine Liste der grundlegenden Einschränkungen auf Tag-Schlüsseln und -Werten finden Sie unter Einschränkungen benutzerdefinierter Tags.

Nein

Jede OpenSearch Service-Domain hat einen Tag-Satz, der alle Tags enthält, die dieser OpenSearch Service-Domain zugewiesen sind. weist OpenSearch Service- AWS Domains nicht automatisch Tags zu. Ein Tag-Satz kann zwischen 0 und 50 Tags enthalten. Wenn Sie einer Domäne einen Tag mit demselben Schlüssel wie ein vorhandenes Tag hinzufügen, wird der alte Wert vom neuen Wert überschrieben.

Tag-Beispiel

Sie können einen Schlüssel verwenden, um eine Kategorie zu definieren, und der Wert könnte ein Element in dieser Kategorie sein. Sie könnten beispielsweise einen Tag-Schlüssel von project und einen Tag-Wert von definierenSalix, was darauf hinweist, dass die OpenSearch Service-Domain dem Salix-Projekt zugewiesen ist. Sie können auch Tags verwenden, um OpenSearch Service-Domains so zu kennzeichnen, dass sie für Tests oder Produktion verwendet werden, indem Sie einen Schlüssel wie environment=test oder verwendenenvironment=production. Versuchen Sie, einen konsistenten Satz von Tag-Schlüsseln zu verwenden, um die Nachverfolgung von Metadaten zu erleichtern, die mit OpenSearch Service-Domains verknüpft sind.

Sie können auch 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 Tag-Schlüsselwerten zu erhalten. Um dann die Kosten kombinierter Ressourcen anzuzeigen, organisieren Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag-Schlüsselwerten. Sie können beispielsweise mehrere OpenSearch Service-Domains mit Schlüssel-Wert-Paaren markieren und dann Ihre Abrechnungsinformationen so organisieren, dass die Gesamtkosten für jede Domain über mehrere Services hinweg angezeigt werden. Weitere Informationen finden Sie unter Verwendung von Kostenzuordnungs-Tags in der AWS -Fakturierungs- und Kostenverwaltungs-Dokumentation.

Anmerkung

Tags werden für Autorisierungszwecke im Cache gespeichert. Aus diesem Grund können Ergänzungen und Aktualisierungen von Tags in OpenSearch Service-Domains einige Minuten dauern, bis sie verfügbar sind.

Arbeiten mit Tags (Konsole)

Die Konsole ist die einfachste Möglichkeit, eine Domäne zu markieren.

So erstellen Sie ein Tag (Konsole)
  1. Rufen Sie die Webseite https://aws.amazon.com auf und klicken Sie dann auf Sign In to the Console (Bei der Konsole anmelden).

  2. Wählen Sie unter Analyse die Option Amazon OpenSearch Service aus.

  3. Wählen Sie die Domäne aus, zu der Sie Tags hinzufügen möchten und gehen Sie zur Registerkarte Tags.

  4. Wählen Sie Verwalten und neues Tag hinzufügen.

  5. Geben Sie einen Tag-Schlüssel und einen optionalen Wert ein.

  6. Wählen Sie Speichern.

Um ein Tag zu löschen, führen Sie die gleichen Schritte aus und wählen Sie Entfernen auf der Seite Tags verwalten.

Weitere Informationen zur Verwendung der Konsole für die Arbeit mit Tags finden Sie unter Tag Editor im AWS Handbuch „Erste Schritte“ der Managementkonsole.

Arbeiten mit Tags (AWS CLI)

Sie können Ressourcen-Tags mithilfe der AWS CLI mit dem --add-tags Befehl erstellen.

Syntax

add-tags --arn=<domain_arn> --tag-list Key=<key>,Value=<value>

Parameter Beschreibung
--arn Amazon-Ressourcenname für die OpenSearch Service-Domäne, an die das Tag angefügt ist.
--tag-list Satz an durch Leerzeichen getrennten Schlüssel-Wert-Paaren im folgendem Format: Key=<key>,Value=<value>

Beispiel

Im folgenden Beispiel werden zwei Tags für die logs-Domäne erstellt:

aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge

Sie können Tags aus einer - OpenSearch Service-Domain mit dem --remove-tags Befehl entfernen.

Syntax

remove-tags --arn=<domain_arn> --tag-keys Key=<key>,Value=<value>

Parameter Beschreibung
--arn Amazon-Ressourcenname (ARN) für die OpenSearch Service-Domäne, an die das Tag angefügt ist.
--tag-keys Satz von durch Leerzeichen getrennten Schlüssel-Wert-Paaren, die Sie aus der OpenSearch Service-Domain entfernen möchten.

Beispiel

Das folgende Beispiel entfernt zwei Tags aus der logs-Domäne, die im vorherigen Beispiel erstellt wurden:

aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances

Sie können die vorhandenen Tags für eine - OpenSearch Service-Domain mit dem --list-tags Befehl anzeigen:

Syntax

list-tags --arn=<domain_arn>

Parameter Beschreibung
--arn Amazon-Ressourcenname (ARN) für die OpenSearch Service-Domäne, an die die Tags angefügt sind.

Beispiel

Im folgenden Beispiel werden alle Ressourcen-Tags für die logs-Domäne aufgelistet:

aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs

Arbeiten mit Tags (AWS SDKs)

Die - AWS SDKs (außer den Android- und iOS-SDKs ) unterstützen alle in der Amazon- OpenSearch Service-API-Referenz definierten Aktionen, einschließlich der RemoveTags Operationen ListTags, und AddTags. Weitere Informationen zur Installation und Verwendung der AWS SDKs finden Sie unter AWS Software Development Kits.

Python

In diesem Beispiel wird der OpenSearchService Low-Level-Python-Client aus dem AWS SDK for Python (Boto) verwendet, um einer Domain ein Tag hinzuzufügen, das an die Domain angehängte Tag aufzulisten und ein Tag aus der Domain zu entfernen. Sie müssen Werte für DOMAIN_ARN, TAG_KEY und TAG_VALUE angeben.

import boto3 from botocore.config import Config # import configuration DOMAIN_ARN = '' # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain TAG_KEY = '' # The name of the tag key. i.e 'Smileyface' TAG_VALUE = '' # The value assigned to the tag. i.e 'Practicetag' # defines the configurations parameters such as region my_config = Config(region_name='us-east-1') client = boto3.client('opensearch', config=my_config) # defines the client variable def addTags(): """Adds tags to the domain""" response = client.add_tags(ARN=DOMAIN_ARN, TagList=[{'Key': TAG_KEY, 'Value': TAG_VALUE}]) print(response) def listTags(): """List tags that have been added to the domain""" response = client.list_tags(ARN=DOMAIN_ARN) print(response) def removeTags(): """Remove tags that have been added to the domain""" response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY]) print('Tag removed') return response