Tagging delle risorse AWS Batch

Per semplificare la gestione delle risorse AWS Batch, è possibile assegnare metadati personalizzati a ciascuna risorsa sotto forma di tag. Questo argomento descrive i tag e mostra come crearli.

Nozioni di base sui tag

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

I tag consentono di categorizzare le risorse AWS per scopo, proprietario o ambiente. In presenza di un numero elevato di risorse, è possibile individuare rapidamente una risorsa specifica in base ai tag assegnati. Ad esempio, puoi definire un set di tag per i servizi AWS Batch per monitorare il proprietario di ogni servizio e il livello di stack. 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 per AWS Batch 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 la AWS Management Console, l'AWS CLI e l'API AWS Batch.

Se utilizzi AWS Identity and Access Management (IAM), puoi controllare quali utenti nel tuo account AWS dispongono dell'autorizzazione per creare, modificare o eliminare i tag.

Tagging delle risorse 

È possibile etichettare ambienti di AWS Batch calcolo, processi, definizioni di lavoro, code di lavoro e politiche di pianificazione nuovi o esistenti.

Se utilizzi la console AWS Batch, puoi applicare tag alle nuove risorse quando vengono create o alle risorse esistenti utilizzando la scheda Tags (Tag) nella pagina della risorsa interessata in qualsiasi momento.

Se utilizzi l'API AWS Batch, l'AWS CLI o un SDK AWS, puoi applicare i tag alle nuove risorse mediante il parametro tags nell'operazione API rilevante oppure alle risorse esistenti mediante l'operazione API TagResource. Per ulteriori informazioni, consulta. TagResource

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.

Nella seguente tabella sono descritte le risorse AWS Batch a cui puoi associare i tag, nonché le risorse che possono essere associate a tag in fase di creazione.

Supporto del tagging per le risorse AWS Batch
Risorsa	Supporta tag	Supporta la propagazione di tag	Supporto del tagging in fase di creazione (API AWS Batch, AWS CLI, SDK AWS)
AWS Batchambienti di calcolo	Sì	No. I tag dell'ambiente di calcolo non si propagano a nessun'altra risorsa. I tag per le risorse sono specificati nei tag membri dell'oggetto ComputeResources passato nell'operazione API. CreateComputeEnvironment	Sì
AWS Batch processi	Sì	Sì	Sì
AWS Batchdefinizioni delle mansioni	Sì	No	Sì
Code di processi AWS Batch	Sì	No	Sì
AWS Batchpolitiche di pianificazione	Sì	No	Sì

Limitazioni applicate ai tag

Si applicano le seguenti limitazioni di base ai tag:

• Numero massimo di tag per 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 lo schema di assegnazione dei tag viene utilizzato in più servizi e risorse AWS, tieni presente che altri servizi potrebbero prevedere limitazioni sui caratteri consentiti. I caratteri generalmente consentiti sono: lettere, numeri, spazi rappresentabili in formato UTF-8 e i seguenti caratteri speciali: + - = . _ : / @.

• I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.

• Non utilizzare aws:, AWS: o qualsiasi combinazione di maiuscole o minuscole di un tale prefisso per chiavi o valori poiché tali stringhe sono riservate per l'utilizzo esclusivo da parte di AWS. Non è possibile modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non vengono conteggiati ai fini del tags-per-resource limite.

Utilizzo di tag tramite la console

Utilizzando la AWS Batch console, puoi gestire i tag associati agli ambienti di calcolo, ai lavori, alle definizioni dei processi e alle code di lavoro nuovi o esistenti.

Aggiunta di tag a una singola risorsa alla creazione

È possibile aggiungere tag agli ambienti di AWS Batch calcolo, ai processi, alle definizioni dei processi, alle code di lavoro e alle politiche di pianificazione al momento della creazione.

Aggiunta ed eliminazione di tag in una singola risorsa

AWS Batch consente di aggiungere o eliminare i tag associati ai cluster direttamente dalla pagina della risorsa.

Per aggiungere o eliminare un tag su una singola risorsa

1. Apri la AWS Batch console all'indirizzo https://console.aws.amazon.com/batch/.

2. Dalla barra di navigazione, scegli la regione da usare.

3. Nel riquadro di navigazione, scegli un tipo di risorsa (ad esempio Job Queues).

4. Scegli una risorsa specifica, quindi scegli Modifica tag.

5. Aggiungi o elimina i tag secondo necessità.

   • Per aggiungere un tag, specifica la chiave e il valore nelle caselle di testo vuote alla fine dell'elenco.

   • Per eliminare un tag, scegli il pulsante accanto al tag.

6. Ripeti questa procedura per ogni tag che desideri aggiungere o eliminare, quindi scegli Modifica tag per terminare.

Utilizzo di tag tramite la CLI o l'API

Utilizza i seguenti comandi AWS CLI o operazioni API AWS Batch per aggiungere, aggiornare, elencare ed eliminare i tag per le risorse.

Supporto del tagging per le risorse AWS Batch
Attività	Azione API	AWS CLI	AWS Tools for Windows PowerShell
Aggiungere sovrascrivere uno o più tag.	TagResource	tag-resource	Aggiungi barra ResourceTag
Eliminare uno o più tag.	UntagResource	untag-resource	Rimuovi-bat ResourceTag
Elencazione dei tag associati a una risorsa	ListTagsForResource	list-tags-for-resource	Prendi pipistrello ResourceTag

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 batch 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 batch 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 batch 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
Crea un ambiente di calcolo	CreateComputeEnvironment	create-compute-environment	New-BAT ComputeEnvironment
Crea una coda di lavoro	CreateJobQueue	create-job-queue	Nuova BAT JobQueue
Crea una politica di pianificazione	CreateSchedulingPolicy	create-scheduling-policy	Nuova BAT SchedulingPolicy
Registra una definizione di lavoro	RegisterJobDefinition	register-job-definition	Registrati - BAT JobDefinition
Invio di un processo	SubmitJob	invia un lavoro	Invia - batjob