Assegnazione di tag alle risorse di Amazon AppStream 2.0

AWS consente di assegnare i metadati alle risorse AWS sotto forma di tag. Puoi utilizzare questi tag per semplificare la gestione di sviluppatori di Image Builder, immagini, parchi istanze e stack AppStream 2.0 e organizzare i dati, inclusi i dati di fatturazione.

È possibile:

• 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

• Identificare e controllare i costi di AWS

Ad esempio, puoi identificare e raggruppare i parchi istanze di AppStream 2.0 che si trovano in ambienti diversi (ad esempio, Sviluppo o Produzione) o che sono assegnati a diverse unità aziendali (ad esempio Risorse umane o Marketing). Puoi monitorare i costi associati ad AWS per questi parchi istanze in modo 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 nella Guida per l'utente di AWS Billing.

Nozioni di base sul tagging

I tag sono costituiti da una coppia chiave-valore, analogamente ad altri tag dei 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. Puoi assegnare tag a una risorsa AppStream 2.0 subito dopo la sua creazione o in un momento successivo. Se si elimina una risorsa, i tag vengono rimossi da quella risorsa per l'eliminazione. Tuttavia, altre risorse AppStream 2.0 e AWS con la stessa chiave tag non vengono influenzate.

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 aggiungi un tag con la stessa chiave di un tag esistente a una risorsa specifica, il nuovo valore sovrascrive quello precedente. Se elimini una risorsa, verranno eliminati anche tutti i tag associati alla risorsa.

Nota

Se prevedi di configurare un report di allocazione dei costi mensili per monitorare i costi AWS delle risorse AppStream 2.0, è necessario ricordare che i tag aggiunti alle risorse AppStream 2.0 esistenti vengono visualizzati nel report di allocazione dei costi il primo giorno del mese successivo per le risorse rinnovate in quel mese.

Limitazioni applicate ai tag

• Il numero massimo di tag per risorsa AppStream 2.0 è 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 utilizzare il prefisso "aws:" nei nomi o nei valori dei tag in quanto è un sistema di tag riservato per l'utilizzo di AWS. 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 + - = . _ : / @.

• 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.

Aggiunta di tag durante la creazione di risorse nella console AppStream 2.0

Quando crei una risorsa nella console AppStream 2.0, 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, fase 4

• Immagini - Fase 6: terminare la creazione dell'immagine, fase 1

• Parchi istanze - Creazione di un parco istanze, fase 3

• Stack - Creare uno stack, fase 2

Aggiunta, modifica ed eliminazione di tag per le risorse esistenti nella console AppStream 2.0

Puoi aggiungere, modificare ed eliminare i tag per le risorse esistenti utilizzando la console AppStream 2.0.

Aggiunta, modifica o eliminazione di tag per una risorsa AppStream 2.0 esistente

1. Apri la console AppStream 2.0 all'indirizzo https://console.aws.amazon.com/appstream2.

2. Dalla barra di navigazione, selezionare la regione che contiene la risorsa per la quale si desidera aggiungere, modificare o eliminare i tag.

3. 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.

4. Selezionare la risorsa dall'elenco di risorse.

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

6. Seleziona Salva.

Utilizzo dei tag tramite l'API AppStream 2.0, un AWS SDK o l'AWS CLI

Se stai utilizzando l'API AppStream 2.0, un AWS SDK oppure l'interfaccia della linea di comando AWS (AWS CLI), puoi utilizzare le seguenti operazioni AppStream 2.0 con il parametro tags per aggiungere i tag al momento della creazione di nuove risorse.

Nota

È possibile utilizzare spazi in chiavi e valori di tag. Per indicare uno spazio quando utilizzi l'AWS CLI, utilizza "\s" (senza virgolette).

Attività	AWS CLI	Operazione API
Aggiungere uno o più tag per un nuovo parco istanze.	create-fleet	CreateFleet
Aggiungere uno o più tag per un nuovo sviluppatore di immagini	create-imagebuilder	CreateImageBuilder
Aggiungere uno o più tag per un nuovo stack	create-stack	CreateStack

Puoi utilizzare le seguenti operazioni AppStream 2.0 per aggiungere, modificare, eliminare o elencare i tag per le risorse esistenti:

Attività	AWS CLI	Operazione API
Aggiungere o sovrascrivere uno o più tag per una risorsa	tag-resource	TagResource
Rimuovere uno o più tag per una risorsa	untag-resource	UntagResource
Elencare uno o più tag per una risorsa	list-tags-for-resource	ListTagsForResource

Quando utilizzi l'API AppStream 2.0, un AWS SDK o le operazioni dell'AWS CLI per aggiungere, modificare, rimuovere o elencare i tag per una risorsa AppStream 2.0 esistente, specifica la risorsa utilizzando il relativo nome della risorsa Amazon (ARN). Un ARN identifica in modo univoco una risorsa AWS e utilizza la seguente sintassi generale.

arn:aws:appstream:region:account:resourceType/resourceName

Regione

La regione AWS in cui è stata creata la risorsa (ad esempio, us-east-1).

account

L'ID dell'Account AWS senza trattini (ad esempio 123456789012).

resourceType

Il tipo di risorsa. Puoi assegnare tag ai seguenti tipi di risorse AppStream 2.0: image-builder, image, fleet e stack.

resourceName

Il nome della risorsa.

Ad esempio, puoi ottenere l'ARN per un parco istanze AppStream 2.0 utilizzando il comando dell'AWS CLI describe-fleets. 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:

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"
    }
}