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 |
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)
-
Rufen Sie die Webseite https://aws.amazon.com
auf und klicken Sie dann auf Sign In to the Console (Bei der Konsole anmelden). -
Wählen Sie unter Analyse die Option Amazon OpenSearch Service aus.
-
Wählen Sie die Domäne aus, zu der Sie Tags hinzufügen möchten und gehen Sie zur Registerkarte Tags.
-
Wählen Sie Verwalten und neues Tag hinzufügen.
-
Geben Sie einen Tag-Schlüssel und einen optionalen Wert ein.
-
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 OpenSearchServiceDOMAIN_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