az resource

Gestire le risorse di Azure.

Comandi

Nome	Descrizione	Tipo	Status
az resource create	Creare una risorsa.	Nucleo	GA
az resource delete	Eliminare una risorsa.	Nucleo	GA
az resource invoke-action	Richiamare un'azione sulla risorsa.	Nucleo	GA
az resource link	Gestire i collegamenti tra le risorse.	Nucleo	GA
az resource link create	Creare un nuovo collegamento tra le risorse.	Nucleo	GA
az resource link delete	Eliminare un collegamento tra le risorse.	Nucleo	GA
az resource link list	Elencare i collegamenti alle risorse.	Nucleo	GA
az resource link show	Ottiene un collegamento di risorsa con l'ID specificato.	Nucleo	GA
az resource link update	Aggiornare il collegamento tra le risorse.	Nucleo	GA
az resource list	Elencare le risorse.	Nucleo	GA
az resource lock	Gestire i blocchi a livello di risorsa di Azure.	Nucleo	GA
az resource lock create	Creare un blocco a livello di risorsa.	Nucleo	GA
az resource lock delete	Eliminare un blocco a livello di risorsa.	Nucleo	GA
az resource lock list	Elencare le informazioni di blocco a livello di risorsa.	Nucleo	GA
az resource lock show	Visualizzare i dettagli di un blocco a livello di risorsa.	Nucleo	GA
az resource lock update	Aggiornare un blocco a livello di risorsa.	Nucleo	GA
az resource move	Spostare le risorse da un gruppo di risorse a un'altra (può trovarsi in una sottoscrizione diversa).	Nucleo	GA
az resource patch	Aggiornare una risorsa per richiesta PATCH.	Nucleo	GA
az resource show	Ottenere i dettagli di una risorsa.	Nucleo	GA
az resource tag	Contrassegna una risorsa.	Nucleo	GA
az resource update	Aggiornare una risorsa tramite richiesta PUT.	Nucleo	GA
az resource wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di una risorsa.	Nucleo	GA

az resource create

Creare una risorsa.

az resource create --properties
                   [--api-version]
                   [--id]
                   [--is-full-object]
                   [--latest-include-preview]
                   [--location]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Esempio

Creare un'app per le API fornendo una configurazione JSON completa.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"location\": \
        \"West US\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Creare una risorsa caricando la configurazione JSON da un file.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile

Creare un'app Web con le informazioni di configurazione minime necessarie.

az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
    --properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
        {ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"

Creare una risorsa usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview

Creare un'estensione del sito a un'app Web

az resource create -g myRG --api-version "2018-02-01" \
    --name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"  \
        --resource-type Microsoft.Web/sites/siteextensions --is-full-object \
            --properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \
                \"location\": \"West US\", \"version\": \"1.9.0\" }"

Parametri necessari

--properties -p

Stringa in formato JSON contenente le proprietà delle risorse.

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--id

ID risorsa.

--is-full-object

Indicare che l'oggetto proprietà include altre opzioni, ad esempio posizione, tag, SKU e/o piano.

Valore predefinito: False

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--location -l

Ubicazione. Valori da: az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource delete

Eliminare una risorsa.

az resource delete [--api-version]
                   [--ids]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--no-wait]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Esempio

Eliminare una macchina virtuale denominata "MyVm".

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Eliminare un'app Web usando un identificatore di risorsa.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Eliminare una subnet usando un identificatore di risorsa.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Eliminare una macchina virtuale denominata "MyVm" usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource invoke-action

Richiamare un'azione sulla risorsa.

Un elenco delle possibili azioni corrispondenti a una risorsa è disponibile in https://learn.microsoft.com/rest/api/. Tutte le richieste POST sono azioni che possono essere richiamate e specificate alla fine del percorso URI. Ad esempio, per arrestare una macchina virtuale, l'URI della richiesta è https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} e l'azione corrispondente è powerOff. Questo è disponibile in https://learn.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop.

az resource invoke-action --action
                          [--api-version]
                          [--ids]
                          [--latest-include-preview]
                          [--name]
                          [--namespace]
                          [--no-wait]
                          [--parent]
                          [--request-body]
                          [--resource-group]
                          [--resource-type]

Esempio

Spegnere una macchina virtuale, specificata dall'ID.

az resource invoke-action --action powerOff \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}

Acquisire informazioni per una macchina virtuale arrestata.

az resource invoke-action --action capture \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
    Microsoft.Compute/virtualMachines/{VMName} \
  --request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
    \"myContainer\", \"overwriteVhds\": true }"

Richiamare un'azione sulla risorsa. (generato automaticamente)

az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites

Parametri necessari

--action

Azione che verrà richiamata sulla risorsa specificata.

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--request-body

Argomenti dei parametri con codifica JSON per l'azione che verrà passata nel corpo della richiesta post. Usare @{file} per caricare da un file.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource list

Elencare le risorse.

az resource list [--location]
                 [--name]
                 [--namespace]
                 [--resource-group]
                 [--resource-type]
                 [--tag]

Esempio

Elencare tutte le risorse nell'area Stati Uniti occidentali.

az resource list --location westus

Elencare tutte le risorse con il nome 'resourceName'.

az resource list --name 'resourceName'

Elencare tutte le risorse con il tag 'test'.

az resource list --tag test

Elencare tutte le risorse con un tag che inizia con "test".

az resource list --tag 'test*'

Elencare tutte le risorse con il tag 'test' con il valore 'example'.

az resource list --tag test=example

Parametri facoltativi

--location -l

Ubicazione. Valori da: az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

--tag

Un singolo tag in formato 'key[=value]'. Usare "" per cancellare i tag esistenti.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource move

Spostare le risorse da un gruppo di risorse a un'altra (può trovarsi in una sottoscrizione diversa).

az resource move --destination-group
                 --ids
                 [--destination-subscription-id]

Esempio

Spostare più risorse nel gruppo di risorse di destinazione nella sottoscrizione di destinazione

az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"

Parametri necessari

--destination-group

Nome del gruppo di risorse di destinazione.

--ids

ID risorsa separati da spazi da spostare.

Parametri facoltativi

--destination-subscription-id

Identificatore della sottoscrizione di destinazione.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource patch

Aggiornare una risorsa per richiesta PATCH.

Supporta l'aggiornamento delle risorse con una stringa in formato JSON. Se l'operazione di patch non riesce, provare a eseguire invece 'az resource update'.

az resource patch --properties
                  [--api-version]
                  [--ids]
                  [--is-full-object]
                  [--latest-include-preview]
                  [--name]
                  [--namespace]
                  [--parent]
                  [--resource-group]
                  [--resource-type]

Esempio

Aggiornare un'app Web usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
  --latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"

Aggiornare una risorsa usando la configurazione JSON da un file.

az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
  --is-full-object --properties @jsonConfigFile

Aggiornare un'app per le API fornendo una configurazione JSON.

az resource patch --name MyApiApp --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Parametri necessari

--properties -p

Stringa in formato JSON contenente le proprietà delle risorse.

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--is-full-object

Indicare che l'oggetto proprietà include altre opzioni, ad esempio posizione, tag, SKU e/o piano.

Valore predefinito: False

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource show

Ottenere i dettagli di una risorsa.

az resource show [--api-version]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--latest-include-preview]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]

Esempio

Visualizzare una risorsa macchina virtuale denominata "MyVm".

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Visualizzare un'app Web usando un identificatore di risorsa.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Visualizzare una subnet.

az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets

Visualizzare una subnet usando un identificatore di risorsa.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Visualizzare una regola di percorso del gateway applicazione.

az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1

Visualizzare una risorsa macchina virtuale denominata "MyVm" usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--include-response-body

Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.

Valori accettati: false, true

Valore predefinito: False

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource tag

Contrassegna una risorsa.

az resource tag --tags
                [--api-version]
                [--ids]
                [--is-incremental]
                [--latest-include-preview]
                [--name]
                [--namespace]
                [--parent]
                [--resource-group]
                [--resource-type]

Esempio

Contrassegna la macchina virtuale 'MyVm' con la chiave 'vmlist' e il valore 'vm1'.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Contrassegna un'app Web con la chiave "vmlist" e il valore "vm1", usando un identificatore di risorsa.

az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Contrassegna la macchina virtuale 'MyVm' con la chiave 'vmlist' e il valore 'vm1' in modo incrementale. Non svuota i tag esistenti.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i

Contrassegna la macchina virtuale 'MyVm' con la chiave 'vmlist' e il valore 'vm1' usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parametri necessari

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--is-incremental -i

Opzione per aggiungere tag in modo incrementale senza eliminare i tag originali. Se la chiave del nuovo tag e del tag originale vengono duplicati, il valore originale verrà sovrascritto.

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource update

Aggiornare una risorsa tramite richiesta PUT.

Supporta l'aggiornamento generico (usando il percorso della proprietà) per aggiornare le risorse. Se l'operazione di aggiornamento non riesce, provare a eseguire invece 'az resource patch'.

az resource update [--add]
                   [--api-version]
                   [--force-string]
                   [--ids]
                   [--include-response-body {false, true}]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--remove]
                   [--resource-group]
                   [--resource-type]
                   [--set]

Esempio

Aggiornare un'app Web usando la versione api-version più recente se questa versione è una versione di anteprima.

az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview

Aggiornare una risorsa. (generato automaticamente)

az resource update --ids $id --set properties.connectionType=Proxy

Aggiornare una risorsa. (generato automaticamente)

az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--include-response-body

Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.

Valori accettati: false, true

Valore predefinito: False

--latest-include-preview -v

Anteprima

Indicare che verrà usata la versione api-version più recente indipendentemente dal fatto che si tratti di una versione di anteprima (ad esempio 2020-01-01-preview) o meno. Ad esempio, se la versione API del provider di risorse supportata è 2020-01-01-preview e 2019-01-01: quando si passa questo parametro, verrà accettata la versione 2020-01-01-preview più recente, altrimenti la versione stabile più recente 2019-01-01 senza passare questo parametro.

Valore predefinito: False

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az resource wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di una risorsa.

az resource wait [--api-version]
                 [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--interval]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]
                 [--timeout]
                 [--updated]

Esempio

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di una risorsa. (generato automaticamente)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di una risorsa. (generato automaticamente)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di una risorsa. (generato automaticamente)

az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets

Parametri facoltativi

--api-version

Versione api della risorsa (omessa per la versione stabile più recente).

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False

--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False

--exists

Attendere che la risorsa esista.

Valore predefinito: False

--ids

Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".

--include-response-body

Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.

Valori accettati: false, true

Valore predefinito: False

--interval

Intervallo di polling in secondi.

Valore predefinito: 30

--name -n

Nome della risorsa. (ad esempio: myC).

--namespace

Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').

--parent

Percorso padre (ad esempio: 'resA/myA/resB/myB').

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--resource-type

Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').

--timeout

Attesa massima in secondi.

Valore predefinito: 3600

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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