Condividi tramite


az tag

Gestione tag in una risorsa.

Comandi

Nome Descrizione Tipo Status
az tag add-value

Creare un valore di tag.

Memoria centrale Disponibilità generale
az tag create

Creare tag in una risorsa specifica.

Memoria centrale Disponibilità generale
az tag delete

Eliminare i tag in una risorsa specifica.

Memoria centrale Disponibilità generale
az tag list

Elencare l'intero set di tag in una risorsa specifica.

Memoria centrale Disponibilità generale
az tag remove-value

Elimina un valore di tag predefinito per un nome di tag predefinito.

Memoria centrale Disponibilità generale
az tag update

Aggiornare in modo selettivo il set di tag in una risorsa specifica.

Memoria centrale Disponibilità generale

az tag add-value

Creare un valore di tag.

az tag add-value --name
                 --value

Esempio

Creare un valore di tag.

az tag add-value --name MyTag --value MyValue

Parametri necessari

--name -n

Nome tag.

--value

Il valore del tag.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tag create

Creare tag in una risorsa specifica.

Il comando az tag create con un ID crea o aggiorna l'intero set di tag in una risorsa, un gruppo di risorse o una sottoscrizione. Questa operazione consente di aggiungere o sostituire l'intero set di tag nella risorsa, nel gruppo di risorse o nella sottoscrizione specificati. L'entità specificata può avere un massimo di 50 tag. Nota: "tag create" funge da "tag init", quindi i tag creati con questo comando sono gli unici presenti dopo l'esecuzione.

az tag create [--name]
              [--resource-id]
              [--tags]

Esempio

Creare un tag nella sottoscrizione.

az tag create --name MyTag

Creare o aggiornare l'intero set di tag in una sottoscrizione.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Creare o aggiornare l'intero set di tag in un gruppo di risorse.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Creare o aggiornare l'intero set di tag in una risorsa.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Parametri facoltativi

--name -n

Nome del tag da creare.

--resource-id

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

--tags

Tag da applicare alla risorsa.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tag delete

Eliminare i tag in una risorsa specifica.

Il comando az tag delete con un ID elimina l'intero set di tag in una risorsa, in un gruppo di risorse o in una sottoscrizione.

az tag delete [--name]
              [--resource-id]
              [--yes]

Esempio

Eliminare un tag predefinito dalla sottoscrizione non associato a una risorsa o senza valori di tag.

az tag delete --name MyTag

Eliminare l'intero set di tag in una sottoscrizione.

az tag delete --resource-id /subscriptions/{sub-id}

Eliminare l'intero set di tag in un gruppo di risorse.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Eliminare l'intero set di tag in una risorsa. (Anche usando --name insieme a --resource-id per specificare un singolo tag)

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parametri facoltativi

--name -n

Nome del tag da eliminare.

--resource-id

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tag list

Elencare l'intero set di tag in una risorsa specifica.

Il comando az tag list con un ID elenca l'intero set di tag in una risorsa, un gruppo di risorse o una sottoscrizione.

az tag list [--resource-id]

Esempio

Elencare l'intero set di tag in una sottoscrizione.

az tag list --resource-id /subscriptions/{sub-id}

Elencare l'intero set di tag in un gruppo di risorse.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Elencare l'intero set di tag in una risorsa.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parametri facoltativi

--resource-id

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tag remove-value

Elimina un valore di tag predefinito per un nome di tag predefinito.

Questa operazione consente di eliminare un valore dall'elenco di valori predefiniti per un nome di tag predefinito esistente. Il valore eliminato non deve essere in uso come valore di tag per il nome di tag specificato per qualsiasi risorsa.

az tag remove-value --name
                    --value

Parametri necessari

--name -n

Nome tag.

--value

Il valore del tag.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tag update

Aggiornare in modo selettivo il set di tag in una risorsa specifica.

Il comando az tag update con un ID aggiorna in modo selettivo il set di tag in una risorsa, un gruppo di risorse o una sottoscrizione. Questa operazione consente di sostituire, unire o eliminare in modo selettivo i tag nella risorsa, nel gruppo di risorse o nella sottoscrizione specificati. L'entità specificata può avere un massimo di 50 tag alla fine dell'operazione. L'opzione 'replace' sostituisce l'intero set di tag esistenti con un nuovo set. L'opzione 'merge' consente di aggiungere tag con nuovi nomi e aggiornare i valori dei tag con nomi esistenti. L'opzione 'delete' consente di eliminare in modo selettivo i tag in base a nomi o coppie nome/valore specificati.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Esempio

Aggiornare in modo selettivo il set di tag in una sottoscrizione con operazione di "merge".

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Aggiornare in modo selettivo il set di tag in un gruppo di risorse con l'operazione "replace".

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Aggiornare in modo selettivo il set di tag in una risorsa con operazione "delete".

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Parametri necessari

--operation

Operazione di aggiornamento. Le opzioni sono Merge, Sostituisci ed Elimina.

Valori accettati: Delete, Merge, Replace
--resource-id

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

--tags

Tag da aggiornare nella risorsa.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.