Condividi tramite


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

--properties -p

Stringa in formato JSON contenente le proprietà delle risorse.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--id

ID risorsa.

--is-full-object

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

Proprietà Valore
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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

--action

Azione che verrà richiamata sulla risorsa specificata.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--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>.

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

Location. Usare i valori ottenuti con 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').

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
--tag

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

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

--destination-group

Nome del gruppo di risorse di destinazione.

--ids

ID risorsa separati da spazi da spostare.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--destination-subscription-id

Identificatore della sottoscrizione di destinazione.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

--properties -p

Stringa in formato JSON contenente le proprietà delle risorse.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--is-full-object

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

Proprietà Valore
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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--include-response-body

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

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

--tags

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

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà Valore
Parameter group: Generic Update Arguments
Valore predefinito: []
--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--force-string

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

Proprietà Valore
Parameter group: Generic Update Arguments
Valore predefinito: False
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--include-response-body

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

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Valore predefinito: False
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--remove

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

Proprietà Valore
Parameter group: Generic Update Arguments
Valore predefinito: []
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
--set

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

Proprietà Valore
Parameter group: Generic Update Arguments
Valore predefinito: []
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Proprietà Valore
Parameter group: Resource Id Arguments
--created

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

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--custom

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

Proprietà Valore
Parameter group: Wait Condition Arguments
--deleted

Attendere l'eliminazione.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--exists

Attendere che la risorsa esista.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--include-response-body

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

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--interval

Intervallo di polling in secondi.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: 30
--name -n

Nome della risorsa. (ad esempio: myC).

Proprietà Valore
Parameter group: Resource Id Arguments
--namespace

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

Proprietà Valore
Parameter group: Resource Id Arguments
--parent

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--resource-type

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

Proprietà Valore
Parameter group: Resource Id Arguments
--timeout

Attesa massima in secondi.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: 3600
--updated

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

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False