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à. # Etichettatura delle risorse di Amazon DocumentDB Puoi utilizzare i tag Amazon DocumentDB (con compatibilità con MongoDB) per aggiungere metadati alle tue risorse Amazon DocumentDB. Questi tag possono essere utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse. Puoi utilizzare questi tag anche per tenere traccia dei costi raggruppando le spese per risorse con tag simili. Puoi taggare le seguenti risorse Amazon DocumentDB: + Cluster + Istanze + Snapshot + Snapshot cluster + Gruppi di parametri + Gruppi di parametri di cluster + Gruppi di sicurezza + Gruppi di sottoreti ## Panoramica dei tag di risorsa di Amazon DocumentDB Un tag Amazon DocumentDB è una coppia nome-valore che definisci e associ a una risorsa Amazon DocumentDB. Il nome viene definito *chiave*. L'indicazione di un valore per la chiave è un'operazione facoltativa. Puoi utilizzare i tag per assegnare informazioni arbitrarie a una risorsa Amazon DocumentDB. Una chiave tag potrebbe essere impiegata, ad esempio, per definire una categoria e il valore di tag potrebbe essere un elemento di tale categoria. Ad esempio, è possibile definire una chiave di tag `project` e un valore di tag di`Salix`, a indicare che la risorsa Amazon DocumentDB è assegnata al progetto Salix. Puoi anche utilizzare i tag per designare le risorse di Amazon DocumentDB da utilizzare per test o produzione utilizzando una chiave come `environment=test` o. `environment=production` Ti consigliamo di utilizzare un set coerente di chiavi di tag per semplificare il monitoraggio dei metadati associati alle risorse di Amazon DocumentDB. Puoi utilizzare i tag per organizzare la AWS fattura in modo da rispecchiare la tua struttura di costi. A tale scopo, registrati per ricevere la Account AWS fattura con i valori chiave dell'etichetta inclusi. 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. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione per visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni, consulta [Utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *AWS Guida per l'utente di Billing and Cost Management*. Ogni risorsa Amazon DocumentDB ha un set di tag che contiene tutti i tag assegnati a quella risorsa. Un set di tag può contenere fino a 10 tag ma può anche essere vuoto. Se aggiungi un tag a una risorsa Amazon DocumentDB che ha la stessa chiave di un tag esistente sulla risorsa, il nuovo valore sovrascrive il vecchio valore. AWS non applica alcun significato semantico ai tag; i tag vengono interpretati rigorosamente come stringhe di caratteri. Amazon DocumentDB può impostare tag su un'istanza o altre risorse Amazon DocumentDB, a seconda delle impostazioni utilizzate al momento della creazione della risorsa. Ad esempio, Amazon DocumentDB potrebbe aggiungere un tag che indica che un'istanza è destinata alla produzione o al test. Puoi aggiungere un tag a una snapshot, tuttavia questo raggruppamento non sarà indicato riportato nella fattura. Puoi usare Console di gestione AWS o AWS CLI per aggiungere, elencare ed eliminare tag sulle risorse di Amazon DocumentDB. Quando utilizzi AWS CLI, devi fornire l'Amazon Resource Name (ARN) per la risorsa con cui desideri lavorare. Per ulteriori informazioni su Amazon DocumentDB ARNs, consulta. [Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs](documentdb-arns.md) ## Vincoli relativi ai tag I seguenti vincoli si applicano ai tag Amazon DocumentDB: + Numero massimo di tag per risorsa: 10 + Lunghezza massima della **chiave**: 128 caratteri Unicode + Lunghezza massima del **valore**: 256 caratteri Unicode + Caratteri validi per la **chiave** e il **valore**: lettere maiuscole e minuscole nel set di caratteri UTF-8, numeri, spazio e i seguenti caratteri: `_ . : / = + -` e `@` (espressioni regolari Java: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) + I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole. + Il prefisso `aws:` non può essere utilizzato per chiavi o valori dei tag, ma è riservato per AWS. ## Aggiungere e aggiornare tag su una risorsa Amazon DocumentDB Puoi aggiungere fino a 10 tag a una risorsa utilizzando Console di gestione AWS o il AWS CLI. ------ #### [ Using the Console di gestione AWS ] Il processo di aggiunta di un tag a una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, il tag viene aggiunto a un cluster. **Per aggiungere o aggiornare i tag in un cluster con la console** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster a cui aggiungere i tag. 1. Scorri verso il basso fino alla sezione **Tags (Tag)** e scegli **Edit (Modifica)**. 1. Per ogni tag da aggiungere alla risorsa, procedi nel seguente modo: 1. Per aggiungere un nuovo tag, immetti il nome del tag nella casella **Key (Chiave)**. Per modificare il valore di un tag, individua il nome del tag nella colonna **Key (Chiave)**. 1. Per assegnare al tag un valore nuovo o aggiornato, inserisci un valore per il tag nella casella **Value (Valore)**. 1. Se desideri aggiungere altri tag, scegli **Add (Aggiungi)**. Altrimenti, al termine, scegli **Save (Salva)**. ------ #### [ Using the AWS CLI ] Il processo di aggiunta di un tag a una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, vengono aggiunti tre tag a un cluster. Il secondo tag `key2` non contiene valori. Usa l' AWS CLI operazione `add-tags-to-resource` con questi parametri. **Parametri** + **--resource-name**—L'ARN della risorsa Amazon DocumentDB a cui desideri aggiungere i tag. + **--tags**—Un elenco dei tag (coppia chiave-valore) che desideri aggiungere a questa risorsa nel formato. `Key=key-name,Value=tag-value` **Example** Per Linux, macOS o 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 ``` Per 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 ``` L'operazione `add-tags-to-resource` non produce alcun output. Per visualizzare i risultati, utilizza l'operazione `list-tags-for-resource`. ------ ## Elencare i tag su una risorsa Amazon DocumentDB Puoi usare Console di gestione AWS o the AWS CLI per ottenere un elenco dei tag per una risorsa Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] Il processo per elencare i tag in una risorsa è quasi identico, indipendentemente dal tipo di risorsa a cui si aggiunge il tag. In questo esempio, vengono elencati i tag per un cluster. **Per elencare i tag in un cluster con la console** 1. [Apri la console Amazon DocumentDB in https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster di cui desideri elencare i tag. 1. Per visualizzare un elenco dei tag in questa risorsa, scorri la sezione **Tags (Tag)**. ------ #### [ Using the AWS CLI ] Il processo per elencare i tag in una risorsa è quasi identico, indipendentemente dal tipo di risorsa di cui si elencano i tag. In questo esempio, vengono elencati i tag in un cluster. Usa l' AWS CLI operazione `list-tags-for-resource` con questi parametri. **Parametri** + **--resource-name**: obbligatorio. L'ARN della risorsa Amazon DocumentDB per cui desideri elencare i tag. **Example** Per Linux, macOS o Unix: ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Per Windows: ``` aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] } ``` ------ ## Rimozione di tag da una risorsa Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per rimuovere i tag dalle risorse di Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] Il processo di rimozione dei tag da una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, vengono rimossi i tag da un cluster. **Per rimuovere tag da un cluster mediante la console** 1. [Apri la console Amazon DocumentDB in https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster da cui desideri rimuovere i tag. 1. Scorri verso il basso fino alla sezione **Tags (Tag)** e scegli **Edit (Modifica)**. 1. Se desideri rimuovere tutti i tag da questa risorsa, scegli **Remove all (Rimuovi tutti)**. Altrimenti, per ogni tag da rimuovere dalla risorsa, procedi nel seguente modo: 1. Individua il nome del tag nella colonna **Key (Chiave)**. 1. Scegli **Remove (Rimuovi)** sulla stessa riga della chiave del tag. 1. Al termine, scegli **Save** (Salva). ------ #### [ Using the AWS CLI ] Il processo di rimozione di un tag da una risorsa è quasi identico, indipendentemente dal tipo di risorsa da cui viene rimosso il tag. In questo esempio, viene rimosso un tag da un cluster. Usa l' AWS CLI operazione `remove-tags-from-resource` con questi parametri. + **--resource-name**: obbligatorio. L'ARN della risorsa Amazon DocumentDB da cui desideri rimuovere i tag. + **--tag-keys**: obbligatorio. Un elenco di chiavi dei tag che desideri rimuovere da questa risorsa. **Example** Per Linux, macOS o Unix: ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Per Windows: ``` aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` L'operazione `removed-tags-from-resource` non produce alcun output. Per visualizzare i risultati, utilizza l'operazione `list-tags-for-resource`. ------