Compartir a través de

az tag

  • Referencia

Administración de etiquetas en un recurso.

Comandos

Nombre Description Tipo Estado
az tag add-value

Cree un valor de etiqueta.

 Principal GA
az tag create

Cree etiquetas en un recurso específico.

 Principal GA
az tag delete

Elimine etiquetas en un recurso específico.

 Principal GA
az tag list

Enumere todo el conjunto de etiquetas de un recurso específico.

 Principal GA
az tag remove-value

Elimina un valor de etiqueta predefinido para un nombre de etiqueta predefinido.

 Principal GA
az tag update

Actualice selectivamente el conjunto de etiquetas en un recurso específico.

 Principal GA

az tag add-value

Editar

Cree un valor de etiqueta.

az tag add-value --name
                 --value

Ejemplos

Cree un valor de etiqueta.

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

Parámetros requeridos

--name -n

El nombre de la etiqueta.

--value

Valor de etiqueta.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az tag create

Editar

Cree etiquetas en un recurso específico.

El comando az tag create con un identificador crea o actualiza todo el conjunto de etiquetas en un recurso, un grupo de recursos o una suscripción. Esta operación permite agregar o reemplazar todo el conjunto de etiquetas en el recurso, el grupo de recursos o la suscripción especificados. La entidad especificada puede tener un máximo de 50 etiquetas. Tenga en cuenta que "tag create" actúa como "tag init", por lo que las etiquetas creadas con este comando son las únicas que están presentes después de la ejecución.

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

Ejemplos

Cree una etiqueta en la suscripción.

az tag create --name MyTag

Cree o actualice todo el conjunto de etiquetas de una suscripción.

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

Cree o actualice todo el conjunto de etiquetas en un grupo de recursos.

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

Cree o actualice todo el conjunto de etiquetas de un recurso.

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

Parámetros opcionales

--name -n

Nombre de la etiqueta que se va a crear.

--resource-id

Identificador de recurso de la entidad que se va a etiquetar. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

--tags

Etiquetas que se van a aplicar en el recurso.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az tag delete

Editar

Elimine etiquetas en un recurso específico.

El comando az tag delete con un identificador elimina todo el conjunto de etiquetas de un recurso, un grupo de recursos o una suscripción.

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

Ejemplos

Elimine una etiqueta predefinida de la suscripción no asociada a un recurso o que no tenga valores de etiqueta.

az tag delete --name MyTag

Elimine todo el conjunto de etiquetas de una suscripción.

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

Elimine todo el conjunto de etiquetas de un grupo de recursos.

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

Elimine todo el conjunto de etiquetas de un recurso. (Incluso con --name junto con --resource-id para especificar una sola etiqueta)

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

Parámetros opcionales

--name -n

Nombre de la etiqueta que se va a eliminar.

--resource-id

Identificador de recurso de la entidad que se va a etiquetar. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az tag list

Editar

Enumere todo el conjunto de etiquetas de un recurso específico.

El comando az tag list con un identificador enumera todo el conjunto de etiquetas de un recurso, un grupo de recursos o una suscripción.

az tag list [--resource-id]

Ejemplos

Enumere todo el conjunto de etiquetas de una suscripción.

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

Enumere todo el conjunto de etiquetas de un grupo de recursos.

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

Enumere todo el conjunto de etiquetas de un recurso.

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

Parámetros opcionales

--resource-id

Identificador de recurso de la entidad que se va a etiquetar. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az tag remove-value

Editar

Elimina un valor de etiqueta predefinido para un nombre de etiqueta predefinido.

Esta operación permite eliminar un valor de la lista de valores predefinidos para un nombre de etiqueta predefinido existente. El valor que se va a eliminar no debe estar en uso como valor de etiqueta para el nombre de etiqueta especificado para cualquier recurso.

az tag remove-value --name
                    --value

Parámetros requeridos

--name -n

El nombre de la etiqueta.

--value

Valor de etiqueta.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az tag update

Editar

Actualice selectivamente el conjunto de etiquetas en un recurso específico.

El comando az tag update con un identificador actualiza de forma selectiva el conjunto de etiquetas en un recurso, un grupo de recursos o una suscripción. Esta operación permite reemplazar, combinar o eliminar de forma selectiva etiquetas en el recurso, el grupo de recursos o la suscripción especificados. La entidad especificada puede tener un máximo de 50 etiquetas al final de la operación. La opción 'replace' reemplaza todo el conjunto de etiquetas existentes por un nuevo conjunto. La opción "merge" permite agregar etiquetas con nuevos nombres y actualizar los valores de las etiquetas con nombres existentes. La opción "eliminar" permite eliminar etiquetas de forma selectiva en función de nombres o pares de nombre/valor especificados.

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

Ejemplos

Actualice selectivamente el conjunto de etiquetas de una suscripción con la operación "merge".

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

Actualice selectivamente el conjunto de etiquetas de un grupo de recursos con la operación "replace".

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

Actualice selectivamente el conjunto de etiquetas de un recurso con la operación "eliminar".

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

Parámetros requeridos

--operation

Operación de actualización. Las opciones son Combinar, Reemplazar y Eliminar.

Valores aceptados: Delete, Merge, Replace
--resource-id

Identificador de recurso de la entidad que se va a etiquetar. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

--tags

Etiquetas que se van a actualizar en el recurso.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.