Partilhar via

az tag

Gerenciamento de tags em um recurso.

Comandos

Name Description Tipo Status
az tag add-value

Crie um valor de tag.

 Core disponibilidade geral
az tag create

Crie tags em um recurso específico.

 Core disponibilidade geral
az tag delete

Excluir tags em um recurso específico.

 Core disponibilidade geral
az tag list

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

 Core disponibilidade geral
az tag remove-value

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

 Core disponibilidade geral
az tag update

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

 Core disponibilidade geral

az tag add-value

Editar

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 Obrigatórios

--name -n

O nome da etiqueta.

--value

O valor da tag.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az tag create

Editar

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. Esta operação permite adicionar ou substituir todo o conjunto de tags no recurso especificado, grupo de recursos ou assinatura. A entidade especificada pode ter um máximo de 50 tags. Por favor, note: 'tag create' age como um 'tag init', portanto, as tags criadas com este comando são as únicas que estão 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 tags 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Pode configurar a subscrição predefinida ao utilizar az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az tag delete

Editar

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

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 tags em um grupo de recursos.

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az tag list

Editar

Liste 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

Liste todo o conjunto de tags em uma assinatura.

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

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

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

Liste 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az tag remove-value

Editar

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

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

az tag remove-value --name
                    --value

Parâmetros Obrigatórios

--name -n

O nome da etiqueta.

--value

O valor da tag.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az tag update

Editar

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. Esta operação permite substituir, mesclar ou excluir seletivamente tags no recurso especificado, grupo de recursos ou assinatura. 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 «eliminar» permite eliminar seletivamente etiquetas 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 tags 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 Obrigatórios

--operation

A operação de atualização. As opções são Mesclar, Substituir e Excluir.

Propriedade Valor
Valores aceites: 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False