

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
<a name="managedomains-awsresourcetagging"></a>

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 | Description | Richiesto | 
| --- | --- | --- | 
| Chiave tag |  La chiave di tag corrisponde al nome del tag. La chiave deve essere univoca per il dominio del OpenSearch servizio a cui è associata. 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html).  | Sì | 
| Valore di 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, puoi avere una coppia chiave-valore in un set di tag di. project/Trinity and 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html).  | No | 

Ogni dominio OpenSearch di servizio ha un set di tag, che contiene tutti i tag assegnati a quel dominio di OpenSearch 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
<a name="managedomains-awsresourcetagging-examples"></a>

È 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 di`Salix`, 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 in modo da 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella documentazione relativa a *gestione di costi e fatturazione AWS *.

**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.

# Etichettatura dei domini (console)
<a name="managedomains-awsresourcetagging-console"></a>

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

****Per creare un tag (console)****

1. Vai sul sito [https://aws.amazon.com](https://aws.amazon.com/ ) e scegli **Sign In to the Console (Accedi alla console)**.

1. In **Analytics**, scegli **Amazon OpenSearch Service**.

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

1. Scegli **Gestisci**, quindi seleziona **Aggiungi nuovo tag**.

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

1. Scegli **Save** (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](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) nella *Guida alle operazioni di base della Console di gestione AWS *.

# Taggare i domini ()AWS CLI
<a name="managedomains-awsresourcetagging-cli"></a>

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 | Description | 
| --- | --- | 
| --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 | Description | 
| --- | --- | 
| --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 | Description | 
| --- | --- | 
| --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
```

# Etichettatura dei domini ()AWS SDKs
<a name="managedomains-awsresourcetagging-sdk"></a>

 AWS SDKs (eccetto Android e iOS SDKs) supportano tutte le azioni definite nell'[Amazon OpenSearch Service API Reference](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html), tra cui `AddTags``ListTags`, e `RemoveTags` le operazioni. Per ulteriori informazioni sull'installazione e l'utilizzo di AWS SDKs, consulta [AWS Software Development Kits](https://aws.amazon.com/code). 

## **Python**
<a name="pythonsample"></a>

Questo esempio utilizza il client Python di [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)basso livello AWS dell'SDK for 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
```