az resource
Gestire le risorse di Azure.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az resource create |
Creare una risorsa. |
Core | GA |
| az resource delete |
Eliminare una risorsa. |
Core | GA |
| az resource invoke-action |
Richiamare un'azione sulla risorsa. |
Core | GA |
| az resource link |
Gestire i collegamenti tra le risorse. |
Core | GA |
| az resource link create |
Creare un nuovo collegamento tra le risorse. |
Core | GA |
| az resource link delete |
Eliminare un collegamento tra le risorse. |
Core | GA |
| az resource link list |
Elencare i collegamenti alle risorse. |
Core | GA |
| az resource link show |
Ottiene un collegamento di risorsa con l'ID specificato. |
Core | GA |
| az resource link update |
Aggiornare il collegamento tra le risorse. |
Core | GA |
| az resource list |
Elencare le risorse. |
Core | GA |
| az resource lock |
Gestire i blocchi a livello di risorsa di Azure. |
Core | GA |
| az resource lock create |
Creare un blocco a livello di risorsa. |
Core | GA |
| az resource lock delete |
Eliminare un blocco a livello di risorsa. |
Core | GA |
| az resource lock list |
Elencare le informazioni di blocco a livello di risorsa. |
Core | GA |
| az resource lock show |
Visualizzare i dettagli di un blocco a livello di risorsa. |
Core | GA |
| az resource lock update |
Aggiornare un blocco a livello di risorsa. |
Core | GA |
| az resource move |
Spostare le risorse da un gruppo di risorse a un'altra (può trovarsi in una sottoscrizione diversa). |
Core | GA |
| az resource patch |
Aggiornare una risorsa per richiesta PATCH. |
Core | GA |
| az resource show |
Ottenere i dettagli di una risorsa. |
Core | GA |
| az resource tag |
Contrassegna una risorsa. |
Core | GA |
| az resource update |
Aggiornare una risorsa tramite richiesta PUT. |
Core | 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. |
Core | 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
Stringa in formato JSON contenente le proprietà delle risorse.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
ID risorsa.
Indicare che l'oggetto proprietà include altre opzioni, ad esempio posizione, tag, SKU e/o piano.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Non attendere il completamento dell'operazione a esecuzione prolungata.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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. (autogenerated)
az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites
Parametri necessari
Azione che verrà richiamata sulla risorsa specificata.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Non attendere il completamento dell'operazione a esecuzione prolungata.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Argomenti dei parametri con codifica JSON per l'azione che verrà passata nel corpo della richiesta post. Usare @{file} per caricare da un file.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.
Nome della risorsa. (ad esempio: myC).
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Un singolo tag in formato 'key[=value]'. Usare "" per cancellare i tag esistenti.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
Nome del gruppo di risorse di destinazione.
ID risorsa separati da spazi da spostare.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Identificatore della sottoscrizione di destinazione.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
Stringa in formato JSON contenente le proprietà delle risorse.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Indicare che l'oggetto proprietà include altre opzioni, ad esempio posizione, tag, SKU e/o piano.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
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.
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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. (autogenerated)
az resource update --ids $id --set properties.connectionType=Proxy
Aggiornare una risorsa. (autogenerated)
az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
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>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Generic Update Arguments |
| Valore predefinito: | [] |
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Generic Update Arguments |
| Valore predefinito: | False |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
| Valore predefinito: | False |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Generic Update Arguments |
| Valore predefinito: | [] |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Generic Update Arguments |
| Valore predefinito: | [] |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
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. (autogenerated)
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. (autogenerated)
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. (autogenerated)
az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api della risorsa (omessa per la versione stabile più recente).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
Attendere l'eliminazione.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Attendere che la risorsa esista.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Uno o più ID risorsa (delimitati da spazi). Se specificato, non è necessario specificare altri argomenti "ID risorsa".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Usare se l'output del comando predefinito non acquisisce tutti i dati della proprietà.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
Intervallo di polling in secondi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 30 |
Nome della risorsa. (ad esempio: myC).
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Spazio dei nomi provider (ad esempio: 'Microsoft.Provider').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Percorso padre (ad esempio: 'resA/myA/resB/myB').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Tipo di risorsa (ad esempio: 'resC'). Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Provider/resC').
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Resource Id Arguments |
Attesa massima in secondi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 3600 |
Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |