Taggare i domini Amazon OpenSearch Service - OpenSearch Servizio Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Taggare i domini Amazon OpenSearch Service

I tag ti consentono di assegnare informazioni arbitrarie a un dominio Amazon OpenSearch Service in modo da poterle classificare e filtrare in base a tali informazioni. Un tag è una coppia chiave-valore che definisci e associ a un dominio di servizio. OpenSearch Puoi utilizzare questi tag per tenere traccia dei costi raggruppando le spese per risorse con tag simili. AWS non applica alcun significato semantico ai tag. I tag sono interpretati prettamente come stringhe di caratteri. Tutti i tag includono gli elementi seguenti:

Elemento del tag Descrizione Richiesto
Chiave tag

La chiave di tag corrisponde al nome del tag. La chiave deve essere unica per il dominio del OpenSearch servizio a cui è collegata. Per un elenco di restrizioni di base su chiavi e valori dei tag, consulta la sezione relativa alle restrizioni per i tag definiti dall'utente.

Valore tag

Il valore di tag è un valore di stringa del tag. I valori dei tag possono essere null e non devono necessariamente essere univoci in un set di tag. Ad esempio, può esserci una coppia chiave-valore in un set di tag project/Trinity e in cost-center/Trinity. Per un elenco di restrizioni di base su chiavi e valori dei tag, consulta la sezione relativa alle restrizioni per i tag definiti dall'utente.

No

Ogni dominio OpenSearch di servizio ha un set di tag, che contiene tutti i tag assegnati a quel dominio OpenSearch di servizio. AWS non assegna automaticamente alcun tag ai domini di OpenSearch servizio. Un set di tag può contenere tra 0 e 50 tag. Se si aggiunge un tag a un dominio con la stessa chiave di un tag esistente, il nuovo valore sovrascrive il vecchio valore.

Esempi di assegnazione di tag

È possibile utilizzare una chiave di tag per definire una categoria e il valore del tag potrebbe essere un elemento di tale categoria. Ad esempio, è possibile definire una chiave di tag project e un valore di tag diSalix, che indicano che il dominio OpenSearch Service è assegnato al progetto Salix. È inoltre possibile utilizzare i tag per designare i domini di OpenSearch servizio da utilizzare per il test o la produzione utilizzando una chiave come o. environment=test environment=production Prova a utilizzare un set coerente di chiavi di tag per semplificare il monitoraggio dei metadati associati OpenSearch ai domini di servizio.

Puoi anche utilizzare i tag per organizzare la AWS fattura in modo che rifletta la tua struttura dei costi. A tale scopo, registrati per ricevere la Account AWS fattura con i valori chiave dell'etichetta inclusi. Quindi, per visualizzare il costo delle risorse combinate, puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Ad esempio, puoi taggare diversi domini di OpenSearch servizio con coppie chiave-valore e quindi organizzare i dati di fatturazione per visualizzare il costo totale di ogni dominio per diversi servizi. Per ulteriori informazioni, consultare la sezione relativa all'utilizzo dei tag per l'allocazione dei costi nella documentazione relativa a gestione di costi e fatturazioneAWS .

Nota

I tag sono memorizzati nella cache a fini di autorizzazione. Per questo motivo, le aggiunte e gli aggiornamenti ai tag sui domini di OpenSearch servizio potrebbero richiedere alcuni minuti prima che siano disponibili.

Utilizzo dei tag (console)

La console è il modo più semplice per assegnare un tag a un dominio.

Per creare un tag (console)
  1. Andare all'indirizzo https://aws.amazon.com e quindi scegliere Sign In to the Console (Accedi alla console).

  2. In Analytics, scegli Amazon OpenSearch Service.

  3. Seleziona il dominio a cui aggiungere i tag e passa alla scheda Tag.

  4. Scegli Gestisci, quindi seleziona Aggiungi nuovo tag.

  5. Inserire una chiave di tag e un valore facoltativo.

  6. Selezionare Salva.

Per eliminare un tag, esegui la stessa procedura e scegli Rimuovi nella pagina Gestisci tag.

Per ulteriori informazioni sull'utilizzo della console per il funzionamento con i tag, consulta Editor di tag nella Guida alle operazioni di base della Console di gestioneAWS .

Utilizzo dei tag (AWS CLI)

Puoi creare tag di risorse usando il --add-tags comando AWS CLI with the.

Sintassi

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

Parametro Descrizione
--arn Nome della risorsa Amazon per il dominio di OpenSearch servizio a cui è associato il tag.
--tag-list Insieme di coppie chiave-valore separate da spazi nel seguente formato: Key=<key>,Value=<value>

Esempio

Nell'esempio seguente vengono creati due tag per il dominio logs:

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

Puoi rimuovere i tag da un dominio OpenSearch di servizio utilizzando il --remove-tags comando.

Sintassi

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

Parametro Descrizione
--arn Amazon Resource Name (ARN) per il dominio OpenSearch di servizio a cui è associato il tag.
--tag-keys Set di coppie chiave-valore separate da spazi che desideri rimuovere dal dominio del servizio. OpenSearch

Esempio

Nell'esempio seguente, i due tag creati nell'esempio precedente vengono rimossi dal dominio logs:

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

È possibile visualizzare i tag esistenti per un dominio di OpenSearch servizio con il comando: --list-tags

Sintassi

list-tags --arn=<domain_arn>

Parametro Descrizione
--arn Amazon Resource Name (ARN) per il dominio di OpenSearch servizio a cui sono allegati i tag.

Esempio

Nell'esempio seguente vengono elencati tutti i tag di risorsa per il dominio logs:

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

Lavorare con i tag (AWS SDK)

Gli AWS SDK (ad eccezione degli SDK per Android e iOS) supportano tutte le azioni definite nell'Amazon OpenSearch Service API Reference, tra cui AddTagsListTags, e RemoveTags le operazioni. Per ulteriori informazioni sull'installazione e l'utilizzo degli AWS SDK, consulta AWS Software Development Kits.

Python

Questo esempio utilizza il client Python di OpenSearchServicebasso livello dell'SDK AWS per Python (Boto) per aggiungere un tag a un dominio, elencare il tag associato al dominio e rimuovere un tag dal dominio. È necessario fornire valori per DOMAIN_ARN, TAG_KEY e TAG_VALUE.

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