Compartilhar via

az resource

Gerenciar recursos do Azure.

Comandos

Nome Description Tipo Status
az resource create

Crie um recurso.

 Core GA
az resource delete

Excluir um recurso.

 Core GA
az resource invoke-action

Invoque uma ação no recurso.

 Core GA
az resource link

Gerenciar links entre recursos.

 Core GA
az resource link create

Crie um novo vínculo entre recursos.

 Core GA
az resource link delete

Exclua um link entre recursos.

 Core GA
az resource link list

Listar links de recursos.

 Core GA
az resource link show

Obtém um link de recurso com a ID especificada.

 Core GA
az resource link update

Atualizar o link entre os recursos.

 Core GA
az resource list

List resources.

 Core GA
az resource lock

Gerenciar bloqueios no nível de recurso do Azure.

 Core GA
az resource lock create

Crie um bloqueio no nível do recurso.

 Core GA
az resource lock delete

Exclua um bloqueio no nível do recurso.

 Core GA
az resource lock list

Listar informações de bloqueio no nível do recurso.

 Core GA
az resource lock show

Mostrar os detalhes de um bloqueio no nível do recurso.

 Core GA
az resource lock update

Atualize um bloqueio no nível do recurso.

 Core GA
az resource move

Mover recursos de um grupo de recursos para outro (pode estar em uma assinatura diferente).

 Core GA
az resource patch

Atualize um recurso por solicitação PATCH.

 Core GA
az resource show

Obtenha os detalhes de um recurso.

 Core GA
az resource tag

Marque um recurso.

 Core GA
az resource update

Atualize um recurso por solicitação PUT.

 Core GA
az resource wait

Coloque a CLI em um estado de espera até que uma condição de recursos seja atendida.

 Core GA

az resource create

Editar

Crie 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 de API mais recente se essa versão for uma versão prévia.

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 Exigidos

--properties -p

Uma cadeia de caracteres formatada em JSON que contém propriedades de recurso.

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--id

Resource ID.

--is-full-object

Indique que o objeto properties inclui outras opções, como localização, marcas, sku e/ou plano.

Propriedade Valor
Valor padrão: False
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource delete

Editar

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 de API mais recente se essa versão for uma versão prévia.

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

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource invoke-action

Editar

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 especificadas no final do caminho do URI. Por exemplo, para interromper 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

Desligar uma VM, especificada pela ID.

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

Capturar informações de uma VM parada.

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 Exigidos

--action

A ação que será invocada no recurso especificado.

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--request-body

Argumentos de parâmetro codificados em JSON para a ação que será transmitida no corpo da solicitação pós-solicitação. Use @{file} para carregar de um arquivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource list

Editar

List resources.

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 marca 'test'.

az resource list --tag test

Liste todos os recursos com uma marca que começa com 'test'.

az resource list --tag 'test*'

Liste todos os recursos com a marca 'test' que tem o valor 'example'.

az resource list --tag test=example

Parâmetros Opcionais

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. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

O nome do recurso. (Ex: myC).

--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
--tag

Uma única marca no formato 'key[=value]'. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource move

Editar

Mover recursos de um grupo de recursos para outro (pode estar em uma assinatura diferente).

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

Exemplos

Mover vários recursos para o grupo de recursos de destino na assinatura de destino

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

Parâmetros Exigidos

--destination-group

O nome do grupo de recursos de destino.

--ids

As IDs de recurso separadas por espaço a serem movidas.

Parâmetros Opcionais

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

O identificador de assinatura de destino.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource patch

Editar

Atualize um recurso por solicitação PATCH.

Ele dá suporte à 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 aplicativo Web usando a versão de API mais recente se essa versão for uma versão prévia.

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 Exigidos

--properties -p

Uma cadeia de caracteres formatada em JSON que contém propriedades de recurso.

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--is-full-object

Indique que o objeto properties inclui outras opções, como localização, marcas, sku e/ou plano.

Propriedade Valor
Valor padrão: False
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource show

Editar

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

Mostre um recurso de máquina virtual chamado 'MyVm' usando a versão mais recente da API se essa versão é uma versão prévia.

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

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--include-response-body

Use se a saída de comando padrão não capturar todos os dados de propriedade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource tag

Editar

Marque 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 marcas 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 de api mais recente se esta versão for uma versão prévia.

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

Parâmetros Exigidos

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--is-incremental -i

A opção de adicionar marcas incrementalmente sem excluir as marcas originais. Se a chave da nova marca e da marca original forem duplicadas, o valor original será substituído.

--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource update

Editar

Atualize um recurso por solicitação PUT.

Ele dá suporte à 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 aplicativo Web usando a versão de API mais recente se essa versão for uma versão prévia.

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

Atualize um recurso. (autogenerated)

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

Atualize um recurso. (autogenerated)

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

Parâmetros Opcionais

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

--add

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
Parameter group: Generic Update Arguments
Valor padrão: []
--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--include-response-body

Use se a saída de comando padrão não capturar todos os dados de propriedade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--latest-include-preview -v
Versão Prévia

Indique que a versão de api mais recente será usada independentemente de ser a versão prévia (como 2020-01-01-preview) ou não. Por exemplo, se a versão de api com suporte do provedor de recursos for 2020-01-01-preview e 2019-01-01: ao passar esse parâmetro, ele usará a versão mais recente 2020-01-01-preview, caso contrário, ele usará a versão estável mais recente 2019-01-01 sem passar esse parâmetro.

Propriedade Valor
Parameter group: Resource Id Arguments
Valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: []
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: []
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az resource wait

Editar

Coloque a CLI em um estado de espera até que uma condição de recursos 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 recursos 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 recursos 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 recursos seja atendida. (autogenerated)

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

Parâmetros Opcionais

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

--api-version

A versão da API do recurso (omita para a versão estável mais recente).

Propriedade Valor
Parameter group: Resource Id Arguments
--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade Valor
Parameter group: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Se fornecido, nenhum outro argumento "ID do recurso" deve ser especificado.

Propriedade Valor
Parameter group: Resource Id Arguments
--include-response-body

Use se a saída de comando padrão não capturar todos os dados de propriedade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: 30
--name -n

O nome do recurso. (Ex: myC).

Propriedade Valor
Parameter group: Resource Id Arguments
--namespace

Namespace do provedor (por exemplo: 'Microsoft.Provider').

Propriedade Valor
Parameter group: Resource Id Arguments
--parent

O caminho pai (Ex: 'resA/myA/resB/myB').

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-type

O tipo de recurso (Ex: 'resC'). Também é possível aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Provider/resC').

Propriedade Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Parameter group: Wait Condition Arguments
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False