Compartilhar via


az tag

Gerenciamento de tags em um recurso.

Comandos

Nome Description Tipo Status
az tag add-value

Crie um valor de tag.

Núcleo GA
az tag create

Crie tags em um recurso específico.

Núcleo GA
az tag delete

Excluir marcas em um recurso específico.

Núcleo GA
az tag list

Listar todo o conjunto de tags em um recurso específico.

Núcleo GA
az tag remove-value

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

Núcleo GA
az tag update

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

Núcleo GA

az tag add-value

Crie um valor de tag.

az tag add-value --name
                 --value

Exemplos

Crie um valor de tag.

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.

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

Crie tags em um recurso específico.

O comando az tag create com um id cria ou atualiza todo o conjunto de tags 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 tags. Observação: 'tag create' funciona como um 'tag init', portanto, as tags criadas com este comando são as únicas presentes após a execução.

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

Exemplos

Crie uma tag na assinatura.

az tag create --name MyTag

Crie ou atualize todo o conjunto de tags 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 tags 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 tag 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 tags 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.

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

Excluir marcas em um recurso específico.

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

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

Exemplos

Exclua uma marca predefinida da assinatura não associada a um recurso ou que não tenha valores de marca.

az tag delete --name MyTag

Exclua todo o conjunto de tags 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. (Mesmo usando --name junto com --resource-id para especificar uma única tag)

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

Parâmetros Opcionais

--name -n

O nome da tag 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.

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.

az tag list

Listar todo o conjunto de tags em um recurso específico.

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

az tag list [--resource-id]

Exemplos

Listar todo o conjunto de tags em uma assinatura.

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

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

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

Listar todo o conjunto de tags 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.

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

Exclui um valor de tag predefinido para um nome de tag 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 de 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.

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

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

O comando az tag update com um id atualiza seletivamente o conjunto de tags 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 especificados. A entidade especificada pode ter um máximo de 50 tags no final da operação. A opção 'substituir' substitui todo o conjunto de tags existentes por um novo conjunto. A opção 'mesclar' permite adicionar tags com novos nomes e atualizar os valores das tags com nomes existentes. A opção 'excluir' permite excluir seletivamente tags com base em nomes próprios ou pares nome/valor.

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

Exemplos

Atualize seletivamente o conjunto de tags em uma assinatura com a Operação "mesclar".

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

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

Atualize seletivamente o conjunto de tags em um recurso com a Operação "excluir".

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 Mesclar, Substituir e Excluir.

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

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.