Compartilhar via

az tag

Gerenciamento de tags em um recurso.

Comandos

Nome Description Tipo Status
az tag add-value

Crie um valor de marca.

 Core GA
az tag create

Crie marcas em um recurso específico.

 Core GA
az tag delete

Excluir marcas em um recurso específico.

 Core GA
az tag list

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

 Core GA
az tag remove-value

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

 Core GA
az tag update

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

 Core GA

az tag add-value

Editar

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

--value

O valor da marca.

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

Editar

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

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

--name -n

O nome da marca a ser criada.

--resource-id

O identificador de recurso da 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 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 tag delete

Editar

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 predefinida da assinatura não associada a um recurso ou sem valores de marca.

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. (Mesmo usando --name junto com --resource-id para especificar uma única marca)

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

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.

--name -n

O nome da marca a ser excluída.

--resource-id

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

--yes -y

Não solicite confirmação.

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

az tag list

Editar

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

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

--resource-id

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

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

Editar

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 de marca fornecido para qualquer recurso.

az tag remove-value --name
                    --value

Parâmetros Exigidos

--name -n

O nome da etiqueta.

--value

O valor da marca.

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

Editar

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

Propriedade Valor
Valores aceitos: Delete, Merge, Replace
--resource-id

O identificador de recurso da 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 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