

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 Amazon RDS
<a name="USER_Tagging"></a><a name="tagging"></a>

Un tag Amazon RDS è una coppia nome-valore definita e associata a una risorsa Amazon RDS, ad esempio un’istanza database o uno snapshot database. Il nome viene definito chiave. Facoltativamente, è possibile fornire un valore per la chiave.

Puoi utilizzare l' Console di gestione AWS API Amazon RDS o Amazon RDS per aggiungere, elencare ed eliminare tag sulle risorse Amazon RDS. AWS CLI Quando usi l'interfaccia della linea di comando o l'API, devi fornire il nome della risorsa Amazon (ARN) della risorsa RDS che vuoi utilizzare. Per ulteriori informazioni sulla creazione di un ARN, consultare [Costruzione di un ARN per Amazon RDS](USER_Tagging.ARN.Constructing.md).

È possibile usare i tag per aggiungere metadati alle risorse Amazon RDS. Puoi utilizzare i tag per aggiungere notazioni personalizzate su istanze di database, snapshot, cluster Aurora e così via. In questo modo puoi documentare le risorse Amazon RDS. I tag possono inoltre essere utilizzati con procedure di manutenzione automatizzate. 

 In particolare, puoi usare questi tag con le policy IAM per gestire l’accesso alle risorse Amazon RDS e per controllare le azioni che è possibile applicare a tali risorse. Puoi utilizzare questi tag anche per tenere traccia dei costi raggruppando le spese per risorse con tag simili. 

Puoi applicare i tag alle seguenti risorse Amazon RDS:
+ Istanze DB
+ Cluster database
+ Cluster globali Aurora
+ Endpoint del cluster di database.
+ Repliche di lettura
+ Snapshot DB
+ Snapshot cluster database
+ Istanze database riservate
+ Abbonamenti a eventi
+ Gruppi di opzioni database
+ Gruppi di parametri database
+ Gruppi di parametri di cluster database
+ Gruppi di sottoreti database
+ Proxy RDS
+ Endpoint RDS Proxy
+ Implementazioni blu/verdi
+ Integrazioni Zero-ETL
+ Backup automatizzati
+ Backup automatici in cluster

**Nota**  
Quando tagghi un'istanza DB, Amazon RDS applica automaticamente tali tag alle risorse Performance Insights associate. Al momento, non è possibile etichettare proxy RDS e endpoint proxy RDS utilizzando il. Console di gestione AWS

**Topics**
+ [

## Perché utilizzare i tag delle risorse Amazon RDS?
](#Tagging.Purpose)
+ [

## In che modo funzionano i tag delle risorse Amazon RDS
](#Overview.Tagging)
+ [

## Best practice per l’utilizzo dei tag delle risorse Amazon RDS
](#Tagging.best-practices)
+ [

## Copia di tag in snapshot database
](#USER_Tagging.CopyTags)
+ [

## Etichettatura delle risorse di backup automatizzate
](#USER_Tagging.AutomatedBackups)
+ [

## Aggiunta ed eliminazione di tag in Amazon RDS
](#Tagging.HowTo)
+ [

# Tutorial: specificare le istanze database da interrompere utilizzando i tag
](Tagging.RDS.Autostop.md)

## Perché utilizzare i tag delle risorse Amazon RDS?
<a name="Tagging.Purpose"></a>

È possibile utilizzare i tag per le seguenti operazioni:
+ Suddividere le risorse RDS in categorie in base all’applicazione, al progetto, al reparto, all’ambiente e così via. Ad esempio, è possibile utilizzare una chiave di tag per definire una categoria, in cui il valore del tag è un elemento della categoria. È possibile creare il tag `environment=prod`. Oppure è possibile definire una chiave di tag `project` e un valore del tag `Salix`, che indica che una risorsa Amazon RDS è assegnata al progetto Salix.
+ Automatizzare le attività di gestione delle risorse. Ad esempio, è possibile creare una finestra di manutenzione per le istanze con tag `environment=prod` diversa dalla finestra per le istanze con tag `environment=test`. È inoltre possibile configurare snapshot database automatici per le istanze con tag `environment=prod`.
+ Controllare l’accesso alle risorse RDS in una policy IAM. Per farlo, devi utilizzare la chiave di condizione globale `aws:ResourceTag/tag-key`. Ad esempio, una policy potrebbe consentire solo agli utenti del gruppo `DBAdmin` di modificare le istanze database con tag `environment=prod`. Per informazioni sulla gestione dell'accesso alle risorse con tag con le policy IAM, consulta [Gestione accessi e identità per Amazon RDS](UsingWithRDS.IAM.md) [Controlling access to AWS resources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) nella *AWS Identity and Access Management User Guide*. 
+ Monitorare le risorse in base a un tag. Ad esempio, puoi creare una CloudWatch dashboard Amazon per le istanze DB contrassegnate con`environment=prod`.
+ Puoi utilizzare questi tag anche per tenere traccia dei costi raggruppando le spese per risorse con tag simili. Ad esempio, se si applica il tag `project=Salix` alle risorse RDS associate al progetto Salix, è possibile generare report sui costi e allocare le spese per questo progetto. Per ulteriori informazioni, consulta [Come funziona la AWS fatturazione con i tag in Amazon RDS](#Tagging.Billing).

## In che modo funzionano i tag delle risorse Amazon RDS
<a name="Overview.Tagging"></a>

AWS non applica alcun significato semantico ai tag. I tag sono interpretati prettamente come stringhe di caratteri. 

**Topics**
+ [

### Set di tag in Amazon RDS
](#Overview.Tagging.Sets)
+ [

### Struttura di tag in Amazon RDS
](#Overview.Tagging.Structure)
+ [

### Risorse Amazon RDS idonee all’applicazione di tag
](#Overview.Tagging.Resources)
+ [

### Come funziona la AWS fatturazione con i tag in Amazon RDS
](#Tagging.Billing)

### Set di tag in Amazon RDS
<a name="Overview.Tagging.Sets"></a>

Ogni risorsa Amazon RDS dispone di un container chiamato set di tag. Il container include tutti i tag assegnati alla risorsa. Una risorsa ha esattamente un set di tag. 

Un set di tag contiene da 0 a 50 tag. Se aggiungi un tag a una risorsa RDS con la stessa chiave di un tag esistente per la risorsa, il nuovo valore sovrascrive quello precedente.

### Struttura di tag in Amazon RDS
<a name="Overview.Tagging.Structure"></a>

La struttura di un tag RDS è la seguente:

**Chiave tag**  
La chiave è il nome obbligatorio del tag. Il valore della stringa deve essere composto da 1 a 128 caratteri Unicode e non può avere il prefisso `aws:` o `rds:`. La stringa può contenere solo il set di lettere, cifre, spazi vuoti, `_`, `.`, `:`, `/`, `=`, `+`, `-` e `@` Unicode. L’espressione regolare Java è `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. Pertanto, `project` e `Project` sono chiavi distinte.  
La chiave è univoca per un set di tag. Ad esempio, non è possibile avere una coppia di chiavi in un set di tag con la chiave uguale e valori diversi, come `project=Trinity` e `project=Xanadu`.

**Valore di tag**  
Il valore è un valore di stringa facoltativo del tag. Il valore di stringa deve essere composto da 1 a 256 caratteri Unicode. La stringa può contenere solo il set di lettere, cifre, spazi vuoti, `_`, `.`, `:`, `/`, `=`, `+`, `-` e `@` Unicode. L’espressione regolare Java è `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. I valori di tag fanno distinzione tra maiuscole e minuscole. Pertanto, `prod` e `Prod` sono valori distinti.  
I valori non devono essere necessariamente univoci in un set di tag e possono essere null. Ad esempio, puoi avere una coppia chiave-valore in un set di tag `project=Trinity` e `cost-center=Trinity`. 

### Risorse Amazon RDS idonee all’applicazione di tag
<a name="Overview.Tagging.Resources"></a>

Puoi contrassegnare con i tag le seguenti risorse Amazon RDS:
+ Istanze DB
+ Cluster database
+ Endpoint del cluster di database.
+ Repliche di lettura
+ Snapshot DB
+ Snapshot cluster database
+ Istanze database riservate
+ Abbonamenti a eventi
+ Gruppi di opzioni database
+ Gruppi di parametri database
+ Gruppi di parametri di cluster database
+ Gruppi di sottoreti database
+ Proxy RDS
+ Endpoint RDS Proxy
**Nota**  
Al momento, non è possibile taggare i proxy RDS e gli endpoint RDS Proxy utilizzando la Console di gestione AWS.
+ Implementazioni blu/verdi
+ Integrazioni Zero-ETL (anteprima)
+ Backup automatizzati
+ Backup automatici in cluster

### Come funziona la AWS fatturazione con i tag in Amazon RDS
<a name="Tagging.Billing"></a>

Utilizza i tag per organizzare la AWS fattura in modo da rispecchiare la tua struttura dei 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 la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *Guida per l'utente di AWS Billing *.

#### Come funzionano i tag di allocazione dei costi con le istantanee dei DB
<a name="Tagging.Billing.Snapshots"></a>

È possibile aggiungere un tag a uno snapshot di di database. Tuttavia, l'addebito non rifletterà questo raggruppamento. Per applicare i tag di allocazione dei costi agli snapshot di di database, è necessario che siano soddisfatte le condizioni elencate di seguito:
+ I tag devono essere collegati all’istanza database principale.
+ L'istanza DB principale deve esistere nella Account AWS stessa istantanea del DB.
+ L'istanza DB principale deve esistere nella Regione AWS stessa istantanea del DB.

Gli snapshot di di database sono considerati orfani se non sono presenti nella stessa Regione dell’istanza database principale o se l’istanza database principale viene eliminata. Gli snapshot DB orfani non supportano i tag di allocazione dei costi. I costi degli snapshot orfani vengono aggregati in un’unica voce senza tag. Gli snapshot di di database multi-account non sono considerati orfani quando vengono soddisfatte le seguenti condizioni:
+ Esistono nella stessa Regione dell’istanza database principale.
+ L’istanza database principale è di proprietà dell’account di origine.
**Nota**  
Se l’istanza database principale è di proprietà di un account diverso, i tag di allocazione dei costi non si applicano agli snapshot multi-account nell’account di destinazione.

## Best practice per l’utilizzo dei tag delle risorse Amazon RDS
<a name="Tagging.best-practices"></a>

Quando si utilizzano i tag, è consigliabile attenersi alle seguenti best practice:
+ Documentare le convenzioni per l’utilizzo dei tag che devono essere seguite da tutti i team dell’organizzazione. In particolare, è necessario assicurarsi che i nomi siano descrittivi e coerenti. Ad esempio, standardizzare il formato `environment:prod` anziché utilizzare il tag `env:production` per alcune risorse.
**Importante**  
Non memorizzare informazioni personali identificabili o altre informazioni riservate o sensibili nei tag.
+ Automatizzare l’utilizzo dei tag per garantire la coerenza. Ad esempio, è possibile utilizzare le seguenti tecniche:
  + Includi tag in un CloudFormation modello. Quando le risorse vengono create con il modello, i tag vengono automaticamente applicati.
  + Definisci e applica i tag utilizzando AWS Lambda le funzioni.
  + Creare un documento SSM che includa i passaggi per aggiungere i tag alle risorse RDS.
+ Utilizzare i tag solo quando necessario. È possibile aggiungere fino a 50 tag per una singola risorsa RDS, ma è consigliabile evitare la proliferazione e la complessità non necessarie dei tag.
+ Controllare periodicamente i tag per verificarne la pertinenza e la precisione. Rimuovere o modificare i tag obsoleti secondo necessità.
+ Prendi in considerazione la possibilità di creare AWS tag con il Tag Editor in Console di gestione AWS. Puoi utilizzare Tag Editor per aggiungere tag a più AWS risorse supportate, incluse le risorse RDS, contemporaneamente. Per ulteriori informazioni, consulta [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) nella *Guida per l’utente di AWS Resource Groups*.

## Copia di tag in snapshot database
<a name="USER_Tagging.CopyTags"></a>

Quando si crea o si ripristina un'istanza database, è possibile specificare che i tag dell'istanza database vengano copiati nelle snapshot dell'istanza database. La copia dei tag garantisce che i metadati degli snapshot DB corrispondano a quelli dell'istanza database di origine. Garantisce anche che eventuali policy di accesso degli snapshot DB corrispondano a quelle dell'istanza database di origine.

È possibile specificare che i tag vengano copiati nelle snapshot DB per le seguenti azioni: 
+ Creazione di un'istanza database
+ Ripristino di un’istanza database.
+ Creazione di una replica di lettura
+ Copia di uno snapshot DB.

Per copiare i tag per le azioni precedenti, scegli **Copia i tag nelle istantanee** in Console di gestione AWS, oppure specifica `--copy-tags-to-snapshot` in. AWS CLI Durante la copia di uno snapshot di database, è possibile copiare i tag associati solo se si copia lo snapshot di database nello stesso account. Non è possibile copiare i tag quando si copia uno snapshot di database tra account diversi.

Nella maggior parte dei casi, i tag non vengono copiati per impostazione predefinita. Tuttavia, quando ripristini un'istanza database da uno snapshot DB, RDS verifica se vengono specificati nuovi tag. In caso affermativo, i nuovi tag vengono aggiunti all'istanza database ripristinata. Se non sono presenti nuovi tag e lo snapshot database si trova nello stesso account dell’istanza database di origine, RDS aggiunge i tag dall’istanza database di origine al momento della creazione dello snapshot nell’istanza database ripristinata. RDS non aggiunge i tag dall’istanza database di origine se lo snapshot database viene copiato e ripristinato in un altro account.

Per evitare che i tag delle istanze database di origine vengano aggiunti alle istanze database ripristinate, si consiglia di specificare nuovi tag durante il ripristino di un'istanza database.

**Nota**  
In alcuni casi, potreste includere un valore per il `--tags` parametro del [create-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-snapshot.html) AWS CLI comando. Oppure potresti fornire almeno un tag all'operazione [Create DBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBSnapshot.html) API. In questi casi, RDS non copia i tag dall'istanza database di origine nel nuovo snapshot DB. Questa funzionalità si applica anche se per l'istanza database di origine è stata attivata l'opzione `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`).  
Con questo approccio puoi creare la copia di un'istanza database da uno snapshot DB ed evitare di aggiungere tag che non si applicano alla nuova istanza database. È possibile creare lo snapshot DB utilizzando il AWS CLI `create-db-snapshot` comando (o l'operazione API `CreateDBSnapshot` RDS). Dopo aver creato uno snapshot DB, puoi aggiungere i tag come descritto più avanti in questo argomento.

## Etichettatura delle risorse di backup automatizzate
<a name="USER_Tagging.AutomatedBackups"></a>

Le risorse di backup automatizzate vengono create quando si imposta il valore del periodo di conservazione dei backup da 0 a un valore superiore a 0. È possibile etichettare le risorse di backup automatizzate dell'istanza o del cluster durante la creazione utilizzando il `--tag-specifications` parametro.

### Parametro Tag-Specifications
<a name="USER_Tagging.AutomatedBackups.TagSpecifications"></a>

APIs che supportano il parametro di `--tag-specifications` richiesta (come [restore-db-instance-from-db-snapshot [create-db-instance[create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html)](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html), ecc.) possono etichettare i backup automatici (Resource Type: or) durante la creazione. `auto-backup` `cluster-auto-backup`

#### Taggare i backup automatici delle istanze
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.Instance"></a>

Da utilizzare `--tag-specifications` con `ResourceType=auto-backup` per creare o modificare istanze DB con backup automatici abilitati.

#### Etichettatura dei backup automatici del cluster
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.Cluster"></a>

Da utilizzare `--tag-specifications` con `ResourceType=cluster-auto-backup` quando si creano cluster DB con backup automatici abilitati.

#### Assegnazione di tag ai backup automatici durante la modifica dell'istanza DB
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.ModifyBehavior"></a>

 È possibile contrassegnare i backup automatici solo `--tag-specifications` quando si imposta la conservazione dei backup da 0 a un valore superiore a 0. Se esistono già backup automatici, utilizza invece l'[AddTagsToResource](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html)API.

**Nota**  
I tag di backup automatici sono indipendenti dai tag dell'istanza DB di origine, dai tag del cluster DB o dai tag degli snapshot DB.

## Aggiunta ed eliminazione di tag in Amazon RDS
<a name="Tagging.HowTo"></a>

È possibile effettuare le seguenti operazioni:
+ Crea tag quando crei una risorsa, ad esempio quando esegui il AWS CLI comando`create-db-instance`.
+ Aggiungere tag a una risorsa esistente utilizzando il comando `add-tags-to-resource`.
+ Elencare i tag associati a una risorsa specifica utilizzando il comando `list-tags-for-resource`.
+ Aggiornare i tag utilizzando il comando `add-tags-to-resource`.
+ Rimuovere i tag da una risorsa utilizzando il comando `remove-tags-from-resource`.

Le procedure seguenti illustrano come eseguire operazioni di applicazione di tag tipiche sulle risorse correlate alle istanze database. Tieni presente che i tag sono memorizzati nella cache a fini di autorizzazione. Per questo motivo, quando si aggiungono o si aggiornano tag sulle risorse Amazon RDS, possono trascorrere diversi minuti prima che le modifiche siano disponibili. 

### Console
<a name="USER_Tagging.CON"></a>

Il processo di applicazione dei tag a una risorsa di Amazon RDS è simile per tutte le risorse. Di seguito viene mostrato come applicare i tag a un'istanza database Amazon RDS. 

**Aggiunta di un tag a un'istanza database**

1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nel pannello di navigazione, seleziona **Database**.
**Nota**  
Per filtrare l'elenco di istanze database nel riquadro **Databases (Database)**, inserire una stringa di testo per **Filter instances (Filtra istanze)**. Vengono visualizzate solo le istanze database che contengono la stringa.

1. Scegliere il nome dell'istanza database a cui si desidera aggiungere tag per visualizzarne i dettagli. 

1. Nella sezione dei dettagli, scorrere verso il basso fino alla sezione **Tags (Tag)**. 

1. Scegliere **Aggiungi**. Viene visualizzata la finestra **Add tags (Aggiungi tag)**.   
![\[Finestra per l'aggiunta di tag\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging5.png)

1. Inserire un valore per **Tag key (Chiave tag)** e **Value (Valore)**.

1. Per aggiungere un altro tag, scegliere **Add another Tag (Aggiungi un altro tag)** e inserire un valore per **Tag key (Chiave tag)** e **Value (Valore)**. 

   Ripetere questa operazione tutte le volte necessarie.

1. Scegliere **Aggiungi**. 

**Eliminazione di un tag da un'istanza database**

1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nel pannello di navigazione, seleziona **Database**.
**Nota**  
Per filtrare l'elenco di istanze database nel riquadro **Databases (Database)**, inserire una stringa di testo nella casella **Filter instances (Filtra istanze)**. Vengono visualizzate solo le istanze database che contengono la stringa.

1. Scegliere il nome dell'istanza database per visualizzarne i dettagli. 

1. Nella sezione dei dettagli, scorrere verso il basso fino alla sezione **Tags (Tag)**. 

1. Scegliere il tag da eliminare.  
![\[Sezione dei tag\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging6.png)

1. Scegliere **Delete (Elimina)** e quindi scegliere **Delete (Elimina)** nella finestra **Delete tags (Elimina tag)**. 

### AWS CLI
<a name="USER_Tagging.CLI"></a>

È possibile aggiungere, elencare o rimuovere i tag per un'istanza database utilizzando AWS CLI.
+ Per aggiungere uno o più tag a una risorsa Amazon RDS, usa il AWS CLI comando [https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html).
+ Per elencare i tag su una risorsa Amazon RDS, usa il AWS CLI comando [https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html).
+ Per rimuovere uno o più tag da una risorsa Amazon RDS, usa il AWS CLI comando [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html).

Per ulteriori informazioni su come creare l'ARN necessario, consultare [Costruzione di un ARN per Amazon RDS](USER_Tagging.ARN.Constructing.md).

### API RDS
<a name="USER_Tagging.API"></a>

È possibile aggiungere, elencare o rimuovere i tag per un'istanza database utilizzando l'API di Amazon RDS.
+ Per aggiungere un tag a una risorsa Amazon RDS, utilizza l'operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html).
+ Per elencare i tag assegnati a una risorsa Amazon RDS, utilizza [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html).
+ Per rimuovere i tag da una risorsa Amazon RDS, utilizza l'operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html).

Per ulteriori informazioni su come creare l'ARN necessario, consultare [Costruzione di un ARN per Amazon RDS](USER_Tagging.ARN.Constructing.md).

Quando utilizzi XML con l'API di Amazon RDS i tag seguono questo schema:

```
 1. <Tagging>
 2.       <TagSet>
 3.           <Tag>
 4.               <Key>Project</Key>
 5.               <Value>Trinity</Value>
 6.           </Tag>
 7.           <Tag>
 8.               <Key>User</Key>
 9.               <Value>Jones</Value>
10.           </Tag>
11.       </TagSet>
12.   </Tagging>
```

La tabella riportata di seguito fornisce un elenco dei tag XML consentiti e le relative caratteristiche. I valori per `Key` e `Value` rispettano la distinzione tra maiuscole e minuscole. Ad esempio, `project=Trinity` e `PROJECT=Trinity` sono tag distinti. 


****  
<a name="user-tag-reference"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_Tagging.html)

# Tutorial: specificare le istanze database da interrompere utilizzando i tag
<a name="Tagging.RDS.Autostop"></a>

In questo tutorial si presuppone di avere più istanze database in un ambiente di sviluppo o di test. Sarà necessario mantenere queste istanze database per diversi giorni. Altre istanze database possono essere arrestate durante la notte e riavviate il giorno successivo. 

Il tutorial seguente illustra come assegnare un tag alle istanze database che possono essere interrotte durante la notte. Il tutorial mostra come uno script può rilevare le istanze database che hanno il tag e quindi interromperle. In questo esempio, la parte del valore della coppia chiave-valore non ha importanza. La presenza del tag `stoppable` indica che l'istanza database ha questa proprietà definita dall'utente. 

Nel seguente tutorial, i comandi e APIs i tag funzionano con ARNs, che consentono a RDS di funzionare senza problemi tra AWS regioni, AWS account e diversi tipi di risorse che potrebbero avere nomi brevi identici. Puoi specificare l'ARN anziché l'ID istanza database nei comandi della CLI che operano su istanze database.

**Per specificare le istanze database da interrompere**

1. Innanzitutto, determina l'ARN di un'istanza database che desideri indicare come arrestabile.

   Nell'esempio seguente, sostituite il nome delle vostre istanze DB con. *dev-test-db-instance* Nei comandi successivi che utilizzano i parametri ARN, sostituisci l'ARN della tua istanza database. L'ARN include l'ID AWS dell'account e il nome della AWS regione in cui si trova l'istanza DB. 

   ```
   $ aws rds describe-db-instances --db-instance-identifier dev-test-db-instance \
     --query "*[].{DBInstance:DBInstanceArn}" --output text
   arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance
   ```

1. Quindi, aggiungi il tag `stoppable` a questa istanza database.

   Scegli il nome per il tag. Poiché questo esempio considera il tag come un attributo presente o assente, viene omessa la parte `Value=` del parametro `--tags`. Con questo approccio puoi evitare di definire una convenzione di denominazione che codifichi tutte le informazioni rilevanti nei nomi. Con la convenzione puoi codificare le informazioni nel nome dell'istanza database o nei nomi di altre risorse. 

   ```
   $ aws rds add-tags-to-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance \
     --tags Key=stoppable
   ```

1. Verifica che il tag sia presente nell'istanza database.

   I comandi seguenti recuperano le informazioni sul tag per l’istanza database in formato JSON e in testo semplice separato da tabulazioni. 

   ```
   $ aws rds list-tags-for-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance 
   {
       "TagList": [
           {
               "Key": "stoppable",
               "Value": ""
   
           }
       ]
   }
   aws rds list-tags-for-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance --output text
   TAGLIST stoppable
   ```

1. Interrompi tutte le istanze database designate come `stoppable`.

   L’esempio seguente crea un file di testo che elenca tutte le istanze database. Il comando shell scorre l’elenco, individua ogni istanza database contrassegnata con l’attributo pertinente ed esegue il comando `aws rds stop-db-instance` per ogni istanza database rilevata. 

   ```
   $ aws rds describe-db-instances --query "*[].[DBInstanceArn]" --output text >/tmp/db_instance_arns.lst
   $ for arn in $(cat /tmp/db_instance_arns.lst)
   do
     match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep stoppable)"
     if [[ ! -z "$match" ]]
     then
         echo "DB instance $arn is tagged as stoppable. Stopping it now."
   # Note that you need to get the DB instance identifier from the ARN.
         dbid=$(echo $arn | sed -e 's/.*://')
         aws rds stop-db-instance --db-instance-identifier $dbid
     fi
   done
   
   DB instance arn:arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance is tagged as stoppable. Stopping it now.
   {
       "DBInstance": {
           "DBInstanceIdentifier": "dev-test-db-instance",
           "DBInstanceClass": "db.t3.medium",
           ...
   ```

Puoi eseguire uno script come quello precedente alla fine di ogni giorno per assicurarti che le istanze database non essenziali vengano interrotte. Puoi inoltre pianificare un processo utilizzando un'utilità come `cron` per eseguire tale controllo ogni notte. Ad esempio, puoi eseguire questa operazione nel caso in cui alcune istanze database venissero lasciate in esecuzione per errore. Puoi quindi ottimizzare il comando che prepara l'elenco di istanze database da controllare. 

Il comando seguente produce un elenco delle istanze database nello stato `available`. Lo script può ignorare le istanze database già arrestate, poiché avranno valori di stato diversi, ad esempio `stopped` o `stopping`. 

```
$ aws rds describe-db-instances \
  --query '*[].{DBInstanceArn:DBInstanceArn,DBInstanceStatus:DBInstanceStatus}|[?DBInstanceStatus == `available`]|[].{DBInstanceArn:DBInstanceArn}' \
  --output text
arn:aws:rds:us-east-1:123456789102:db:db-instance-2447
arn:aws:rds:us-east-1:123456789102:db:db-instance-3395
arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance
arn:aws:rds:us-east-1:123456789102:db:pg2-db-instance
```

**Suggerimento**  
Puoi utilizzare l'assegnazione di tag e la ricerca di istanze database con i tag per ridurre i costi in altri modi. Supponi, ad esempio, questo scenario con le istanze database utilizzate per lo sviluppo e il test. In questo caso, potresti designare alcune istanze database da eliminare alla fine di ogni giornata. In alternativa, potresti designarle per modificare le istanze database in piccole classi di istanza database durante i periodi previsti di basso utilizzo. 