az resource

  • Referência

Gerenciar recursos do Azure.

Comandos

Nome Description Tipo Status
az resource create

Crie um recurso.

 Núcleo GA
az resource delete

Excluir um recurso.

 Núcleo GA
az resource invoke-action

Invocar uma ação no recurso.

 Núcleo GA
az resource link

Gerenciar links entre recursos.

 Núcleo GA
az resource link create

Crie um novo link entre recursos.

 Núcleo GA
az resource link delete

Excluir um link entre recursos.

 Núcleo GA
az resource link list

Listar links de recursos.

 Núcleo GA
az resource link show

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

 Núcleo GA
az resource link update

Atualizar link entre recursos.

 Núcleo GA
az resource list

Liste os recursos.

 Núcleo GA
az resource lock

Gerenciar bloqueios de nível de recurso do Azure.

 Núcleo GA
az resource lock create

Crie um bloqueio no nível do recurso.

 Núcleo GA
az resource lock delete

Exclua um bloqueio no nível de recurso.

 Núcleo GA
az resource lock list

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

 Núcleo GA
az resource lock show

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

 Núcleo GA
az resource lock update

Atualize um bloqueio no nível de recurso.

 Núcleo GA
az resource move

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

 Núcleo GA
az resource patch

Atualizar um recurso por solicitação PATCH.

 Núcleo GA
az resource show

Obtenha os detalhes de um recurso.

 Núcleo GA
az resource tag

Marcar um recurso.

 Núcleo GA
az resource update

Atualizar um recurso por solicitação PUT.

 Núcleo GA
az resource wait

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

 Núcleo 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 de configuração mínimas 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, independentemente de esta versão ser 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 Exigidos

--properties -p

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

Parâmetros Opcionais

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--id

ID do recurso.

--is-full-object

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

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

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--location -l

Local. 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').

--parent

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

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--ids

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

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

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--no-wait

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

valor padrão: False
--parent

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

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource invoke-action

Editar

Invocar uma ação no recurso.

Uma lista de possíveis ações correspondentes a um recurso pode ser encontrada em https://docs.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 é e a ação correspondente é https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion}powerOff. Isso pode ser encontrado em https://docs.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 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 }"

Invocar uma ação no recurso. (gerado automaticamente)

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

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--ids

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

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

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--no-wait

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

valor padrão: False
--parent

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

--request-body

Argumentos de parâmetro codificados em JSON para a ação que será passada no corpo da solicitação post. Use @{file} para carregar a partir de um arquivo.

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource list

Editar

Liste os 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 tenham o valor 'example'.

az resource list --tag test=example

Parâmetros Opcionais

--location -l

Local. 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').

--resource-group -g

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

--resource-type

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

--tag

Uma única tag no formato 'key[=value]'. Use "" para limpar as tags existentes.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource move

Editar

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

Os ids de recurso separados por espaço a serem movidos.

Parâmetros Opcionais

--destination-subscription-id

O identificador de assinatura de destino.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource patch

Editar

Atualizar um recurso por solicitação PATCH.

Ele oferece suporte à atualização de recursos com cadeia de caracteres formatada em JSON. Se a operação de patch falhar, tente executar 'az resource update'.

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, independentemente de esta versão ser 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\" } }"

Atualizar 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

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--ids

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

--is-full-object

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

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

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 esta versão for uma versão de visualização.

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

Parâmetros Opcionais

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--ids

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

--include-response-body

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

valores aceitos: false, true
valor padrão: False
--latest-include-preview -v
Versão Prévia

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource tag

Editar

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 Exigidos

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

Parâmetros Opcionais

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--ids

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

--is-incremental -i

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.

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

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource update

Editar

Atualizar um recurso por solicitação PUT.

Ele oferece 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'.

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, independentemente de esta versão ser 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. (gerado automaticamente)

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

Atualizar um recurso. (gerado automaticamente)

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

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor padrão: []
--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--force-string

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

valor padrão: False
--ids

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

--include-response-body

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

valores aceitos: false, true
valor padrão: False
--latest-include-preview -v
Versão Prévia

Indique que a versão api mais recente será usada independentemente de ser uma 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 usará 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 por esse parâmetro.

valor padrão: False
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--parent

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

--remove

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

valor padrão: []
--resource-group -g

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

--resource-type

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

--set

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

valor padrão: []
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az resource wait

Editar

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. (gerado automaticamente)

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. (gerado automaticamente)

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. (gerado automaticamente)

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

Parâmetros Opcionais

--api-version

A versão api do recurso (omitir para a versão estável mais recente).

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

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

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--ids

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

--include-response-body

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

valores aceitos: false, true
valor padrão: False
--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--name -n

O nome do recurso. (Ex: myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

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

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.