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 WorkSpaces delle applicazioni Amazon
AWS consente di assegnare metadati alle AWS risorse sotto forma di tag. È possibile utilizzare questi tag per gestire i generatori di immagini, le immagini, le flotte e gli stack delle WorkSpaces applicazioni e anche per organizzare i dati, inclusi i dati di fatturazione.
Puoi:
+ Raggruppare le risorse logicamente in diversi modi (ad esempio, in base a scopo, proprietario o ambiente).
Questa funzione è utile quando si dispone di numerose risorse dello stesso tipo.
+ Identificare velocemente una risorsa specifica in base ai tag a questa assegnati
+ Identifica e controlla i costi AWS
Ad esempio, è possibile identificare e raggruppare flotte di WorkSpaces applicazioni che si trovano in ambienti diversi (come sviluppo o produzione) o assegnate a diverse unità aziendali (come HR o Marketing). È quindi possibile tenere traccia dei AWS costi associati a queste flotte a livello dettagliato. Per fare ciò, registrati per far sì che la fattura dell'account Amazon Web Services includa i valori di chiave di tag. Per ulteriori informazioni sulla configurazione di un report di allocazione dei costi mediante i tag, consulta [Report mensile di allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) nella *Guida per l'utente di AWS Billing *.
**Topics**
+ [Nozioni di base sul tagging](tagging-introduction.md)
+ [Limitazioni applicate ai tag](tag-restrictions.md)
+ [Aggiungere tag durante la creazione di risorse](basic-tagging-resource-creation-console.md)
+ [Aggiungere, modificare ed eliminare tag](basic-tagging-console.md)
+ [Utilizzo dell'API, dell'SDK o della CLI](basic-tagging-API-SDK-CLI.md)
# Nozioni di base sull'etichettatura per le applicazioni Amazon WorkSpaces
I tag sono costituiti da una coppia chiave-valore, simile ai tag di altri servizi. AWS Per applicare tag a una risorsa, si specifica una *chiave* e un *valore* per ciascun tag. Una chiave può essere una categoria generale, ad esempio "progetto", "proprietario" o "ambiente", con specifici valori associati, ed è possibile condividere la stessa chiave e lo stesso valore tra più risorse. È possibile etichettare una risorsa WorkSpaces Applicazioni subito dopo averla creata o in un secondo momento. Se si elimina una risorsa, i tag vengono rimossi da quella risorsa per l'eliminazione. Tuttavia, WorkSpaces le altre applicazioni e AWS risorse che hanno la stessa chiave di tag non sono interessate.
Puoi modificare chiavi e valori di tag e rimuovere tag da una risorsa in qualsiasi momento. Puoi impostare il valore di un tag su una stringa vuota, ma non puoi impostare il nome di un tag su null. Se aggiungete un tag con la stessa chiave di un tag esistente su quella risorsa, il nuovo valore sovrascrive il vecchio valore. Se elimini una risorsa, verranno eliminati anche tutti i tag a essa associati.
**Nota**
Se prevedi di impostare un rapporto mensile sull'allocazione AWS dei costi per tenere traccia dei costi delle risorse delle WorkSpaces Applicazioni, tieni presente che i tag aggiunti alle risorse esistenti delle WorkSpaces Applicazioni vengono visualizzati nel rapporto sull'allocazione dei costi il primo giorno del mese successivo per le risorse che vengono rinnovate in quel mese.
# Restrizioni relative ai tag per WorkSpaces le applicazioni Amazon
+ Il numero massimo di tag per risorsa WorkSpaces Applications è 50.
+ La lunghezza massima delle chiavi è 128 caratteri Unicode in UTF-8.
+ Il valore massimo è 256 caratteri Unicode in UTF-8.
+ Per le chiavi e i valori dei tag viene fatta la distinzione tra maiuscole e minuscole.
+ Non utilizzate il prefisso «aws:» nei nomi o nei valori dei tag perché si tratta di un tag di sistema riservato AWS all'uso. Non puoi modificare né eliminare i nomi o i valori dei tag con tale prefisso. I tag con questo prefisso non vengono conteggiati per il limite del numero di tag per risorsa.
+ In generale, i caratteri consentiti sono lettere, numeri e spazi rappresentabili in formato UTF-8, più i caratteri speciali \$1 - = . \$1 : / @.
+ Anche se puoi condividere la stessa chiave e lo stesso valore tra più risorse, non puoi disporre di chiavi duplicate nella stessa risorsa.
+ Puoi aggiungere i tag delle risorse durante la creazione delle risorse. Puoi anche aggiungere, modificare ed eliminare i tag delle risorse che hai già creato.
# Aggiungere tag durante la creazione di risorse nella console Amazon WorkSpaces Applications
Quando crei una risorsa nella console WorkSpaces Applicazioni, puoi aggiungere uno o più tag per gestire la risorsa. Per ulteriori informazioni, consulta i seguenti argomenti:
+ Image builder: [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md), fase 4
+ Immagini: [Fase 6: terminare la creazione dell'immagine](tutorial-image-builder.md#tutorial-image-builder-finish-create-image), fase 1
+ Parchi istanze: [Crea una flotta nelle WorkSpaces applicazioni Amazon](set-up-stacks-fleets-create.md), fase 3
+ Stack: [Crea uno stack nelle applicazioni Amazon WorkSpaces](set-up-stacks-fleets-install.md), fase 2
# Aggiungere, modificare ed eliminare tag per risorse esistenti nella console Amazon WorkSpaces Applications
È possibile aggiungere, modificare ed eliminare tag per risorse esistenti utilizzando la console WorkSpaces Applicazioni.
**Per aggiungere, modificare o eliminare tag per una risorsa WorkSpaces Applications esistente**
1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Dalla barra di navigazione, selezionare la regione che contiene la risorsa per la quale si desidera aggiungere, modificare o eliminare i tag.
1. Nel riquadro di navigazione, selezionare il tipo di risorse. Il tipo di risorsa può essere un Image Builder, un'immagine, un parco istanze o uno stack.
1. Selezionare la risorsa dall'elenco di risorse.
1. Scegliere **Tags (Tag)**, **Add/Edit Tags (Aggiungi/modifica tag)** e quindi eseguire una o più delle operazioni seguenti:
+ Per aggiungere un tag, scegli **Aggiungi tag**, quindi digita la chiave e il valore per ciascun tag.
+ Per la modifica di un tag, modificare la chiave e il valore per il tag in base alle esigenze.
+ Per eliminare un tag, scegli l'icona ere l'icona **ELimina** (X) per il tag.
1. Scegli **Save** (Salva).
# Utilizzo dei tag utilizzando l'API di Amazon WorkSpaces Applications, un AWS SDK o AWS una CLI
Se utilizzi l'API WorkSpaces Applications, un AWS SDK o l'interfaccia a riga di AWS comando (AWS CLI), puoi utilizzare le WorkSpaces seguenti operazioni Applicazioni con `tags` il parametro per aggiungere tag quando crei nuove risorse.
**Nota**
È possibile utilizzare spazi in chiavi e valori di tag. Per indicare uno spazio quando usi la AWS CLI, usa «\$1 s» (senza virgolette).
| Operazione | AWS CLI | Operazione API |
| --- | --- | --- |
| Aggiungere uno o più tag per un nuovo parco istanze. | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html) | [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags) |
| Aggiungere uno o più tag per un nuovo sviluppatore di immagini | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) | [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags) |
| Aggiungere uno o più tag per un nuovo stack | [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html) | [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags) |
È possibile utilizzare le seguenti operazioni delle WorkSpaces Applicazioni per aggiungere, modificare, rimuovere o elencare i tag delle risorse esistenti:
| Operazione | AWS CLI | Operazione API |
| --- | --- | --- |
| Aggiungere o sovrascrivere uno o più tag per una risorsa | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html) |
| Rimuovere uno o più tag per una risorsa | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html) |
| Elencare uno o più tag per una risorsa | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html) |
Quando utilizzi l'API WorkSpaces Applications, un AWS SDK o le azioni AWS CLI per aggiungere, modificare, rimuovere o elencare tag per una risorsa Applications WorkSpaces esistente, specifica la risorsa utilizzando il relativo Amazon Resource Name (ARN). Un ARN identifica in modo univoco una AWS risorsa e utilizza la seguente sintassi generale.
```
arn:aws:appstream:region:account:resourceType/resourceName
```
***region***
La AWS regione in cui è stata creata la risorsa (ad esempio,). `us-east-1`
***account***
L' Account AWS ID, senza trattini (ad esempio,`123456789012`).
***resourceType***
Il tipo di risorsa. È possibile etichettare i seguenti tipi di risorse delle WorkSpaces applicazioni:`image-builder`, `image``fleet`, e. `stack`
***resourceName***
Il nome della risorsa.
[Ad esempio, è possibile ottenere l'ARN per una flotta di WorkSpaces applicazioni utilizzando il comando AWS CLI describe-fleets.](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) Copiare il seguente comando.
```
aws appstream describe-fleets
```
Per un ambiente che contiene un singolo parco istanze denominato `TestFleet`, l'ARN per questa risorsa viene visualizzato nell'output JSON simile al seguente.
```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```
Dopo aver ottenuto l'ARN per la risorsa, è possibile aggiungere due tag utilizzando il comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html):
```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```
Il primo tag, `Environment=Test`, indica che il parco istanze si trova in un ambiente di test. Il secondo tag `Department=IT`, indica che il parco istanze si trova nel reparto IT.
È possibile utilizzare il comando seguente per elencare i due tag aggiunti al parco istanze.
```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```
Per questo esempio, l'output JSON viene visualizzato come segue:
```
{
"Tags": {
"Environment" : "Test",
"Department" : "IT"
}
}
```