Aggiunta di tag personalizzati alle risorse

La pagina seguente illustra la procedura necessaria per utilizzare la propagazione dei tag personalizzati. La propagazione dei tag personalizzati richiede le fasi seguenti:

Quando attivi la propagazione dei tag personalizzati in un dominio esistente, la propagazione dei tag non viene eseguita per le applicazioni esistenti finché non vengono riavviate. Analogamente, i tag non vengono aggiornati su una risorsa esistente quando vengono aggiunti nuovi tag personalizzati. Ad esempio, supponiamo che un dominio abbia due tag e che un utente crei una risorsa nel dominio. La risorsa ha quindi due tag. Se viene aggiunto un nuovo tag al dominio, questo non viene aggiunto alla risorsa esistente. Tuttavia, il nuovo tag sarà collegato a ogni nuova risorsa creata.

Prerequisiti

Selezione dell’opzione di adesione alla propagazione dei tag personalizzati

Il processo di adesione alla propagazione dei tag personalizzati varia a seconda di dove viene eseguito, dalla console o dalla AWS CLI. Dalla console, puoi aderire alla propagazione dei tag personalizzati solo aggiornando un dominio esistente. Dalla AWS CLI, puoi aderire alla propagazione dei tag personalizzati quando crei un dominio o aggiorni un dominio esistente.

Selezione dell’opzione di adesione dalla console

Nelle istruzioni seguenti viene descritto come aderire alla propagazione dei tag personalizzati dalla console. È possibile aderire alla propagazione dei tag personalizzati dalla console solo aggiornando un dominio esistente.

Selezione dell’opzione di adesione dalla AWS CLI

Per aderire alla propagazione dei tag personalizzati dalla AWS CLI, utilizza l’attributo TagPropagation nelle API CreateDomain e UpdateDomain. Il valore predefinito del campo è DISABLED. Anche per un valore vuoto l’impostazione predefinita è DISABLED. L’esempio seguente mostra come attivare la propagazione dei tag personalizzati.

aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED

Aggiunta di tag personalizzati

Il processo di aggiunta dei tag personalizzati varia a seconda di dove viene eseguito, dalla console o dalla AWS CLI.

Aggiunta dalla console

Nelle istruzioni seguenti viene descritto come aggiungere tag personalizzati a un dominio dalla console.

Nelle istruzioni seguenti viene descritto come aggiungere tag personalizzati a un profilo utente dalla console.

Aggiunta dalla AWS CLI

Dopo aver attivato la propagazione dei tag personalizzati, puoi aggiungere tag personalizzati utilizzando la AWS CLI a livello di dominio, profilo utente o spazio durante la creazione o l’aggiornamento. Il metodo per aggiungere tag personalizzati quando si crea una nuova risorsa è diverso da quello utilizzato quando si aggiungono tag a una risorsa esistente.

Nell’esempio seguente viene mostrato come aggiungere tag personalizzati a livello di dominio durante la creazione.

aws sagemaker create-domain \
    --domain-name domain-id \
    --auth-mode IAM \
    --default-user-settings '{"ExecutionRole": "execution-role"}' \
    --subnet-ids subnet-id \
    --vpc-id vpc-id \
    --tags Key=key,Value=value \
    --tag-propagation ENABLED

È necessario utilizzare l’API AddTags per aggiungere tag personalizzati a un dominio, a un profilo utente e a spazi esistenti, come descritto di seguito.

aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value