az resource
Gerencie recursos do Azure.
Comandos
| Name | Description | Tipo | Status |
|---|---|---|---|
| az resource create |
Criar um recurso. |
Core | disponibilidade geral |
| az resource delete |
Excluir um recurso. |
Core | disponibilidade geral |
| az resource invoke-action |
Invoque uma ação no recurso. |
Core | disponibilidade geral |
| az resource link |
Gerencie links entre recursos. |
Core | disponibilidade geral |
| az resource link create |
Crie um novo link entre recursos. |
Core | disponibilidade geral |
| az resource link delete |
Exclua um link entre recursos. |
Core | disponibilidade geral |
| az resource link list |
Listar links de recursos. |
Core | disponibilidade geral |
| az resource link show |
Obtém um link de recurso com a ID especificada. |
Core | disponibilidade geral |
| az resource link update |
Atualizar link entre recursos. |
Core | disponibilidade geral |
| az resource list |
Listar recursos. |
Core | disponibilidade geral |
| az resource lock |
Gerencie bloqueios de nível de recurso do Azure. |
Core | disponibilidade geral |
| az resource lock create |
Crie um bloqueio no nível do recurso. |
Core | disponibilidade geral |
| az resource lock delete |
Exclua um bloqueio no nível de recurso. |
Core | disponibilidade geral |
| az resource lock list |
Listar informações de bloqueio no nível de recurso. |
Core | disponibilidade geral |
| az resource lock show |
Mostrar os detalhes de um bloqueio de nível de recurso. |
Core | disponibilidade geral |
| az resource lock update |
Atualize um bloqueio no nível do recurso. |
Core | disponibilidade geral |
| az resource move |
Mova recursos de um grupo de recursos para outro (pode estar sob assinatura diferente). |
Core | disponibilidade geral |
| az resource patch |
Atualize um recurso por solicitação PATCH. |
Core | disponibilidade geral |
| az resource show |
Obtenha os detalhes de um recurso. |
Core | disponibilidade geral |
| az resource tag |
Marcar um recurso. |
Core | disponibilidade geral |
| az resource update |
Atualize um recurso por solicitação PUT. |
Core | disponibilidade geral |
| az resource wait |
Coloque a CLI em um estado de espera até que uma condição de um recurso seja atendida. |
Core | disponibilidade geral |
az resource create
Criar um recurso.
az resource create --properties
[--api-version]
[--id]
[--is-full-object]
[--latest-include-preview]
[--location]
[--name]
[--namespace]
[--parent]
[--resource-group]
[--resource-type]
Exemplos
Crie um aplicativo de API fornecendo uma configuração 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}\" } }"
Crie um recurso carregando a configuração JSON de um arquivo.
az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile
Crie um aplicativo Web com as informações mínimas de configuração necessárias.
az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
--properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
{ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"
Crie um recurso usando a versão mais recente da api se esta versão for uma versão de visualização.
az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview
Criar uma extensão de site para um aplicativo 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\" }"
Parâmetros Obrigatórios
Uma cadeia de caracteres formatada em JSON contendo propriedades de recurso.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
ID do recurso.
Indique que o objeto de propriedades inclui outras opções, como localização, tags, sku e/ou plano.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource delete
Excluir um recurso.
az resource delete [--api-version]
[--ids]
[--latest-include-preview]
[--name]
[--namespace]
[--no-wait]
[--parent]
[--resource-group]
[--resource-type]
Exemplos
Exclua uma máquina virtual chamada 'MyVm'.
az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"
Exclua um aplicativo Web usando um identificador de recurso.
az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp
Exclua uma sub-rede usando um identificador de recurso.
az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet
Exclua uma máquina virtual chamada 'MyVm' usando a versão api mais recente se esta versão for uma versão de visualização.
az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource invoke-action
Invoque uma ação no recurso.
Uma lista de possíveis ações correspondentes a um recurso pode ser encontrada em https://learn.microsoft.com/rest/api/. Todas as solicitações POST são ações que podem ser invocadas e são especificadas no final do caminho do URI. Por exemplo, para parar uma VM, o URI da solicitação é https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} e a ação correspondente é powerOff. Isso pode ser encontrado em 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]
Exemplos
Desligue uma vm, especificada por Id.
az resource invoke-action --action powerOff \
--ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}
Capture informações para uma vm interrompida.
az resource invoke-action --action capture \
--ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
Microsoft.Compute/virtualMachines/{VMName} \
--request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
\"myContainer\", \"overwriteVhds\": true }"
Invoque uma ação no recurso. (autogenerated)
az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites
Parâmetros Obrigatórios
A ação que será invocada no recurso especificado.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Argumentos de parâmetro codificados JSON para a ação que será passada no corpo da solicitação de postagem. Use @{file} para carregar a partir de um arquivo.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource list
Listar recursos.
az resource list [--location]
[--name]
[--namespace]
[--resource-group]
[--resource-type]
[--tag]
Exemplos
Liste todos os recursos na região Oeste dos EUA.
az resource list --location westus
Liste todos os recursos com o nome 'resourceName'.
az resource list --name 'resourceName'
Liste todos os recursos com a tag 'test'.
az resource list --tag test
Liste todos os recursos com uma tag que começa com 'test'.
az resource list --tag 'test*'
Liste todos os recursos com a tag 'test' que têm o valor 'example'.
az resource list --tag test=example
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
O nome do recurso. (Ex: myC).
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Uma única tag no formato 'key[=value]'. Use "" para limpar tags existentes.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource move
Mova recursos de um grupo de recursos para outro (pode estar sob assinatura diferente).
az resource move --destination-group
--ids
[--destination-subscription-id]
Exemplos
Mover vários recursos para o grupo de recursos de destino sob a assinatura de destino
az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"
Parâmetros Obrigatórios
O nome do grupo de recursos de destino.
As ids de recurso separadas por espaço a serem movidas.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
O identificador de assinatura de destino.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource patch
Atualize um recurso por solicitação PATCH.
Ele suporta a atualização de recursos com cadeia de caracteres formatada em JSON. Se a operação de patch falhar, tente executar 'az resource update' em vez disso.
az resource patch --properties
[--api-version]
[--ids]
[--is-full-object]
[--latest-include-preview]
[--name]
[--namespace]
[--parent]
[--resource-group]
[--resource-type]
Exemplos
Atualize um webapp usando a versão mais recente da api se esta versão for uma versão de visualização.
az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
--latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"
Atualize um recurso usando a configuração JSON de um arquivo.
az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
--is-full-object --properties @jsonConfigFile
Atualize um aplicativo de API fornecendo uma configuração 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}\" } }"
Parâmetros Obrigatórios
Uma cadeia de caracteres formatada em JSON contendo propriedades de recurso.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Indique que o objeto de propriedades inclui outras opções, como localização, tags, sku e/ou plano.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource show
Obtenha os detalhes de um recurso.
az resource show [--api-version]
[--ids]
[--include-response-body {false, true}]
[--latest-include-preview]
[--name]
[--namespace]
[--parent]
[--resource-group]
[--resource-type]
Exemplos
Mostrar um recurso de máquina virtual chamado 'MyVm'.
az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"
Mostrar um aplicativo Web usando um identificador de recurso.
az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp
Mostrar uma sub-rede.
az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets
Mostrar uma sub-rede usando um identificador de recurso.
az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet
Mostrar uma regra de caminho do gateway de aplicativo.
az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1
Mostrar um recurso de máquina virtual chamado 'MyVm' usando a versão api mais recente se esta versão é uma versão de visualização.
az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Use se a saída do comando padrão não capturar todos os dados da propriedade.
| Propriedade | Valor |
|---|---|
| Default value: | False |
| Valores aceites: | false, true |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource tag
Marcar um recurso.
az resource tag --tags
[--api-version]
[--ids]
[--is-incremental]
[--latest-include-preview]
[--name]
[--namespace]
[--parent]
[--resource-group]
[--resource-type]
Exemplos
Marque a máquina virtual 'MyVm' com a chave 'vmlist' e o valor 'vm1'.
az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"
Marque um aplicativo Web com a chave 'vmlist' e o valor 'vm1', usando um identificador de recurso.
az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}
Marque a máquina virtual 'MyVm' com a chave 'vmlist' e o valor 'vm1' incrementalmente. Ele não esvazia as tags existentes.
az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i
Marque a máquina virtual 'MyVm' com a chave 'vmlist' e o valor 'vm1' usando a versão api mais recente se esta versão for uma versão de visualização.
az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview
Parâmetros Obrigatórios
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
A opção de adicionar tags incrementalmente sem excluir as tags originais. Se a chave da nova tag e a tag original forem duplicadas, o valor original será substituído.
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource update
Atualize um recurso por solicitação PUT.
Ele suporta a atualização genérica (usando o caminho da propriedade) para atualizar recursos. Se a operação de atualização falhar, tente executar 'az resource patch' em vez disso.
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]
Exemplos
Atualize um webapp usando a versão mais recente da api se esta versão for uma versão de visualização.
az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview
Atualizar um recurso. (autogenerated)
az resource update --ids $id --set properties.connectionType=Proxy
Atualizar um recurso. (autogenerated)
az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | False |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Use se a saída do comando padrão não capturar todos os dados da propriedade.
| Propriedade | Valor |
|---|---|
| Default value: | False |
| Valores aceites: | false, true |
Indique que a versão mais recente da api será usada independentemente de ser a versão de visualização (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api suportada do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele levará a versão mais recente 2020-01-01-preview, caso contrário, levará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
| Default value: | False |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az resource wait
Coloque a CLI em um estado de espera até que uma condição de um recurso seja atendida.
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]
Exemplos
Coloque a CLI em um estado de espera até que uma condição de um recurso seja atendida. (autogenerated)
az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}
Coloque a CLI em um estado de espera até que uma condição de um recurso seja atendida. (autogenerated)
az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true
Coloque a CLI em um estado de espera até que uma condição de um recurso seja atendida. (autogenerated)
az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
A versão api do recurso (omitir para a versão estável mais recente).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Aguarde até ser excluído.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Um ou mais IDs de recurso (delimitados por espaço). Se fornecido, nenhum outro argumento "Resource Id" deve ser especificado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Use se a saída do comando padrão não capturar todos os dados da propriedade.
| Propriedade | Valor |
|---|---|
| Default value: | False |
| Valores aceites: | false, true |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | 30 |
O nome do recurso. (Ex: myC).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Namespace do provedor (Ex: 'Microsoft.Provider').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O caminho pai (Ex: 'resA/myA/resB/myB').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O tipo de recurso (Ex: 'resC'). Também pode aceitar o formato de namespace/tipo (Ex: 'Microsoft.Provider/resC').
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Espera máxima em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | 3600 |
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |