az tag

Gerenciamento de marcas em um recurso.

Comandos

az tag add-value	Crie um valor de marca.
az tag create	Crie marcas em um recurso específico.
az tag delete	Excluir marcas em um recurso específico.
az tag list	Liste todo o conjunto de marcas em um recurso específico.
az tag remove-value	Exclui um valor de marca predefinido para um nome de marca predefinido.
az tag update	Atualize seletivamente o conjunto de marcas em um recurso específico.

az tag add-value

Crie um valor de marca.

az tag add-value --name
                 --value

Exemplos

Crie um valor de marca.

az tag add-value --name MyTag --value MyValue

Parâmetros Exigidos

--name -n

O nome da marcação.

--value

O valor da marcaçã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.

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

Crie marcas em um recurso específico.

O comando az tag create com uma ID cria ou atualiza todo o conjunto de marcas em um recurso, grupo de recursos ou assinatura. Essa operação permite adicionar ou substituir todo o conjunto de marcas no recurso, grupo de recursos ou assinatura especificado. A entidade especificada pode ter no máximo 50 marcas. Observe: 'tag create' atua como um 'tag init' portanto, as marcas criadas com esse comando são as únicas que estão presentes após a execução.

az tag create [--name]
              [--resource-id]
              [--tags]

Exemplos

Crie uma marca na assinatura.

az tag create --name MyTag

Crie ou atualize todo o conjunto de marcas em uma assinatura.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Crie ou atualize todo o conjunto de marcas em um grupo de recursos.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Crie ou atualize todo o conjunto de marcas em um recurso.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Parâmetros Opcionais

--name -n

O nome da marca a ser criada.

--resource-id

O identificador de recurso para a entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

--tags

As marcas a serem aplicadas no recurso.

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.

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

Excluir marcas em um recurso específico.

O comando az tag delete com uma ID exclui todo o conjunto de marcas em um recurso, grupo de recursos ou assinatura.

az tag delete [--name]
              [--resource-id]
              [--yes]

Exemplos

Exclua uma marca da assinatura.

az tag delete --name MyTag

Exclua todo o conjunto de marcas em uma assinatura.

az tag delete --resource-id /subscriptions/{sub-id}

Exclua todo o conjunto de marcas em um grupo de recursos.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Exclua todo o conjunto de marcas em um recurso.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parâmetros Opcionais

--name -n

O nome da marca a ser excluída.

--resource-id

O identificador de recurso para a entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

--yes -y

Não solicite confirmaçã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.

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

Liste todo o conjunto de marcas em um recurso específico.

O comando az tag list com uma ID lista todo o conjunto de marcas em um recurso, grupo de recursos ou assinatura.

az tag list [--resource-id]

Exemplos

Liste todo o conjunto de marcas em uma assinatura.

az tag list --resource-id /subscriptions/{sub-id}

Liste todo o conjunto de marcas em um grupo de recursos.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Liste todo o conjunto de marcas em um recurso.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parâmetros Opcionais

--resource-id

O identificador de recurso para a entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

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.

--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 tag remove-value

Exclui um valor de marca predefinido para um nome de marca predefinido.

Essa operação permite excluir um valor da lista de valores predefinidos para um nome de marca predefinido existente. O valor que está sendo excluído não deve estar em uso como um valor de marca para o nome da marca fornecido para qualquer recurso.

az tag remove-value --name
                    --value

Parâmetros Exigidos

--name -n

O nome da marcação.

--value

O valor da marcaçã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.

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

Atualize seletivamente o conjunto de marcas em um recurso específico.

O comando az tag update com uma ID atualiza seletivamente o conjunto de marcas em um recurso, grupo de recursos ou assinatura. Essa operação permite substituir, mesclar ou excluir seletivamente marcas no recurso, grupo de recursos ou assinatura especificado. A entidade especificada pode ter no máximo 50 marcas no final da operação. A opção 'replace' substitui todo o conjunto de marcas existentes por um novo conjunto. A opção 'merge' permite adicionar marcas com novos nomes e atualizar os valores de marcas com nomes existentes. A opção 'delete' permite excluir seletivamente marcas com base em determinados nomes ou pares nome/valor.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Exemplos

Atualize seletivamente o conjunto de marcas em uma assinatura com a Operação de "mesclagem".

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Atualize seletivamente o conjunto de marcas em um grupo de recursos com a Operação "replace".

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Atualize seletivamente o conjunto de marcas em um recurso com a Operação "delete".

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Parâmetros Exigidos

--operation

A operação de atualização. As opções são Mesclagem, Substituição e Exclusão.

valores aceitos: Delete, Merge, Replace

--resource-id

O identificador de recurso para a entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

--tags

As marcas a serem atualizadas no recurso.

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.

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