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 diSalix, 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 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 AWS Management Console 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 DocumentDBARNs, consulta. Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs

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 Chiave e Valore: lettere maiuscole e minuscole nel set di UTF -8 caratteri, cifre, spazio e i seguenti caratteri: _ . : / = + - e @ (espressione regolare 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 AWS Management Console o il AWS CLI.

Using the AWS Management Console

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 AWS Management Console la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com/docdb.

2. Nel riquadro di navigazione scegli clusters (cluster).

3. Seleziona il nome del cluster a cui aggiungere i tag.

4. Scorri verso il basso fino alla sezione Tags (Tag) e scegli Edit (Modifica).

5. 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).

   2. Per assegnare al tag un valore nuovo o aggiornato, inserisci un valore per il tag nella casella Value (Valore).

   3. 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—La ARN 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

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.

Elenco di tag su una risorsa Amazon DocumentDB

Puoi usare AWS Management Console o the AWS CLI per ottenere un elenco dei tag per una risorsa Amazon DocumentDB.

Using the AWS Management Console

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 all'indirizzo https://console.aws.amazon.com/docdb.

2. Nel riquadro di navigazione scegli clusters (cluster).

3. Seleziona il nome del cluster di cui desideri elencare i tag.

4. 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. La ARN risorsa Amazon DocumentDB per cui desideri elencare i tag.

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'output di questa operazione è simile al seguente (JSONformato).

{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": ""
        },
        {
            "Key": "key3",
            "Value": "value3"
        }
    ]
}

Rimozione di tag da una risorsa Amazon DocumentDB

Puoi usare AWS Management Console o AWS CLI per rimuovere i tag dalle risorse di Amazon DocumentDB.

Using the AWS Management Console

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 all'indirizzo https://console.aws.amazon.com/docdb.

2. Nel riquadro di navigazione scegli clusters (cluster).

3. Seleziona il nome del cluster da cui desideri rimuovere i tag.

4. Scorri verso il basso fino alla sezione Tags (Tag) e scegli Edit (Modifica).

5. 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).

   2. Scegli Remove (Rimuovi) sulla stessa riga della chiave del tag.

   3. 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. La ARN risorsa Amazon DocumentDB da cui desideri rimuovere i tag.

• --tag-keys: obbligatorio. Un elenco di chiavi dei tag che desideri rimuovere da questa risorsa.

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.