

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 le tue risorse AWS Cloud Map
<a name="using-tags"></a>

Un tag è un'etichetta che si assegna a una risorsa. AWS Ogni tag è composto da una *chiave* e da un *valore* opzionale, entrambi personalizzabili.

I tag consentono di classificare le AWS risorse in base, ad esempio, allo scopo, al proprietario o all'ambiente. Se disponi di un numero elevato di risorse, puoi individuare rapidamente una risorsa specifica in base ai tag assegnati. Ad esempio, puoi definire un set di tag per AWS Cloud Map i tuoi servizi per aiutarti a tenere traccia del proprietario e del livello di stack di ciascun servizio. Consigliamo di definire un set coerente di chiavi di tag per ciascun tipo di risorsa.

I tag non vengono assegnati in automatico alle risorse. Dopo aver aggiunto un tag, puoi modificarne le chiavi e i valori oppure rimuovere i tag da una risorsa in qualsiasi momento. Se elimini una risorsa, verranno eliminati anche tutti i tag a essa associati.

I tag non hanno alcun significato semantico AWS Cloud Map e vengono interpretati rigorosamente come una stringa di caratteri. Puoi impostare il valore di un tag su una stringa vuota, ma non su null. Se aggiungi un tag con la stessa chiave di un tag esistente a una risorsa specifica, il nuovo valore sovrascrive quello precedente.

Puoi lavorare con i tag utilizzando l' Console di gestione AWS AWS CLI, la e l' AWS Cloud Map API.

Se utilizzi AWS Identity and Access Management (IAM), puoi controllare quali utenti del tuo AWS account sono autorizzati a creare, modificare o eliminare i tag.

## Assegnazione di tag alle risorse
<a name="tag-resources"></a>

Puoi taggare AWS Cloud Map namespace e servizi nuovi o esistenti.

Se utilizzi la AWS Cloud Map console, puoi applicare i tag alle nuove risorse al momento della creazione o alle risorse esistenti in qualsiasi momento utilizzando la scheda **Tag** nella pagina delle risorse pertinente.

Se utilizzi l' AWS Cloud Map API, l' AWS CLI o un AWS SDK, puoi applicare i tag a nuove risorse utilizzando il `tags` parametro sull'azione API pertinente o alle risorse esistenti utilizzando l'azione [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)API. Per ulteriori informazioni, consulta [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html).

Alcune operazioni per la creazione di risorse ti consentono di specificare tag per una risorsa durante la sua creazione. Se i tag non possono essere applicati durante la creazione della risorsa, il processo di creazione della risorsa avrà esito negativo. In questo modo, le risorse a cui desideri applicare tag al momento della creazione vengono create con tag specifici o non vengono create affatto. Se aggiungi tag alle risorse al momento della creazione, non devi eseguire script di tagging personalizzati dopo la creazione delle risorse.

La tabella seguente descrive le AWS Cloud Map risorse che possono essere taggate e le risorse che possono essere taggate al momento della creazione.


**Supporto per AWS Cloud Map l'etichettatura delle risorse**  

| Risorsa | Supporta tag | Supporta la propagazione di tag | Supporta l'etichettatura alla creazione (AWS Cloud Map API AWS CLI, AWS SDK) | 
| --- | --- | --- | --- | 
|  AWS Cloud Map namespace  |  Sì  | No. I tag dello spazio dei nomi non si propagano a nessun'altra risorsa associata allo spazio dei nomi. |  Sì  | 
|  AWS Cloud Map servizi  |  Sì  | No. I tag di servizio non si propagano ad altre risorse associate al servizio. |  Sì  | 

## Restrizioni
<a name="tag-restrictions"></a>

Ai tag si applicano le seguenti limitazioni di base:
+ Numero massimo di tag per ogni risorsa: 50
+ Per ciascuna risorsa, ogni chiave del tag deve essere univoca e ogni chiave del tag può avere un solo valore.
+ Lunghezza massima della chiave: 128 caratteri Unicode in formato UTF-8
+ Lunghezza massima del valore: 256 caratteri Unicode in formato UTF-8
+ Se il tuo schema di etichettatura viene utilizzato su più AWS servizi e risorse, ricorda che altri servizi potrebbero avere restrizioni sui caratteri consentiti. I caratteri generalmente consentiti sono: lettere, numeri, spazi rappresentabili in formato UTF-8 e i seguenti caratteri speciali: \$1 - = . \$1 : / @.
+ I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
+ Non utilizzare alcuna combinazione maiuscola o minuscola `aws:``AWS:`, ad esempio un prefisso per chiavi o valori, poiché è riservata all'uso. AWS Non è possibile modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non rientrano nel tuo limite. tags-per-resource

# Aggiornamento dei tag per le risorse AWS Cloud Map
<a name="tag-resources-api-sdk"></a>

Utilizza i seguenti AWS CLI comandi o operazioni AWS Cloud Map API per aggiungere, aggiornare, elencare ed eliminare i tag delle tue risorse.


**Supporto per AWS Cloud Map l'etichettatura delle risorse**  

| Attività | Azione API | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
|  Aggiungere sovrascrivere uno o più tag.  |  [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)  |  [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html)  |  [Aggiungi tag SDResource](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html)  | 
|  Eliminare uno o più tag.  |  [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html)  |  [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html)  |  [Rimuovi- SDResource Tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html)  | 
| Elencazione dei tag associati a una risorsa |  [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html)  |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html)  |  [Ottieni- SDResource Tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html)  | 

I seguenti esempi mostrano come aggiungere o rimuovere tag alle o dalle risorse utilizzando la AWS CLI.

**Esempio 1: tag a una risorsa esistente**  
Il comando seguente applica un tag a una risorsa esistente.

```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```

**Esempio 2: rimozione di un tag da una risorsa esistente**  
Il comando seguente elimina un tag da una risorsa esistente.

```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```

**Esempio 3: elencazione dei tag di una risorsa**  
Il comando seguente elenca i tag associati a una risorsa esistente.

```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```

Alcune operazioni per la creazione di risorse ti consentono di specificare tag quando crei le risorse. Le seguenti operazioni supportano il tagging in fase di creazione.


| Attività | Azione API | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
| Creare uno spazio dei nomi HTTP | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [Nuovo SDHttp spazio dei nomi](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) | 
| Creare uno spazio dei nomi privato basato su DNS | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [Nuovo- SDPrivate DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) | 
| Creare uno spazio dei nomi pubblico basato su DNS | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [Nuovo- SDPublic DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) | 
| Creazione di un servizio | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [Nuovo- SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) | 