Descripción general de las etiquetas

Las etiquetas son pares clave-valor que puedes adjuntar a tus recursos deGoogle Cloud para anotarlos y aplicar políticas de forma condicional. Esta aplicación condicional te brinda un control detallado sobre los recursos en toda tu jerarquía de recursos de Google Cloud .

La jerarquía de recursos de Google Cloud organiza los recursos en una estructura de árbol para ayudarte a administrarlos a gran escala. Sin embargo, esta jerarquía modela solo algunas dimensiones empresariales, como la estructura organizativa, las regiones, los tipos de cargas de trabajo y los centros de costos. Las etiquetas proporcionan la flexibilidad de agrupar varias dimensiones empresariales en toda tu jerarquía.

Etiquetas de instancia y etiquetas de recurso

Las etiquetas son una forma independiente de crear anotaciones para los recursos. En la siguiente tabla, se enumeran algunas de las diferencias entre las etiquetas de instancia y las etiquetas de recurso:

Etiquetas Etiquetas
Estructura de recursos Las claves, los valores y las vinculaciones de etiquetas de instancia son recursos independientes No son recursos en sí mismas, sino metadatos para recursos
Definición Se definen a nivel de la organización o del proyecto Se definen por cada recurso
Control de acceso La administración y la vinculación de etiquetas requieren roles de Identity and Access Management (IAM). Para adjuntar etiquetas, se requieren roles de IAM, que varían según el recurso de servicio.
Requisito previo para el archivo adjunto La clave y el valor de la etiqueta deben definirse antes de que se pueda adjuntar una etiqueta a un recurso. No hay requisitos previos para adjuntar
Herencia Los elementos secundarios del recurso heredan las vinculaciones de etiquetas en la jerarquía de Google Cloud No son heredadas por los elementos secundarios del recurso
Requisitos de eliminación Las etiquetas no se pueden borrar, a menos que no existan vinculaciones para esa etiqueta Se puede quitar de un recurso en cualquier momento.
Requisitos de nombres Requisitos para los valores de etiqueta y las claves de etiqueta Requisitos para las etiquetas
Longitud del nombre del par clave-valor 256 caracteres como máximo 63 caracteres como máximo
Compatibilidad con políticas de permiso y denegación Las etiquetas se pueden referenciar con condiciones de políticas de permiso y condiciones de políticas de denegación No se admiten las políticas de permisos y denegación
Compatibilidad con las políticas de la organización Las etiquetas de algunos recursos se pueden referenciar con restricciones condicionales de la política de la organización. No se admite la política de la organización
Integración de la Facturación de Cloud Realizar devoluciones de cargos, auditorías y otros análisis de asignación de costos, y exportar datos de costos de Facturación de Cloud a BigQuery Filtrar recursos por etiqueta en la Facturación de Cloud, exportar datos de la Facturación de Cloud a BigQuery

Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

Etiquetas semánticas

Una etiqueta semántica es un par clave-valor que proporciona metadatos significativos para tus recursos con una semántica sólida y estandarizada respaldada por las convenciones de OpenTelemetry (OTel).

Puedes usar etiquetas semánticas con los recursos de App Hub. Cuando configuras atributos en los servicios y las cargas de trabajo en App Hub, este los replica automáticamente como etiquetas semánticas del sistema de solo lectura en los recursos subyacentes directos.

Las etiquetas semánticas del sistema son de solo lectura. No puedes editar ni quitar estas etiquetas del sistema directamente con la API de etiquetas o la consola de Google Cloud . La administración de etiquetas se realiza en App Hub.

Etiquetas semánticas replicadas de App Hub

Si usas App Hub, los atributos Entorno y Importancia que se establecen en tus servicios o cargas de trabajo se replican automáticamente como etiquetas semánticas del sistema de solo lectura en el espacio de nombres dedicado google:AppHub.

Entre las etiquetas de sistema compatibles, se incluyen las siguientes:

  • google:AppHub/environment: valores derivados de App Hub, por ejemplo, PRODUCTION o STAGING.
  • google:AppHub/criticality: valores derivados de App Hub, por ejemplo, MISSION_CRITICAL o HIGH.

Mostrar el contexto de App Hub como etiquetas del sistema garantiza que los servicios descendentes, como la consola de Google Cloud , consuman metadatos autorizados para aplicar políticas de administración y seguridad sin los riesgos asociados con la configuración manual.

Para obtener más información sobre cómo administrar etiquetas semánticas, consulta Visualiza y administra etiquetas semánticas.

El catálogo semántico

El catálogo semántico proporciona una lista de las semánticas disponibles y su asignación a los atributos respaldados por OpenTelemetry (OTel). Puedes explorar este catálogo en la consola de Google Cloud o ver los detalles con las APIs.

Para obtener más información sobre cómo acceder al catálogo, consulta Visualiza el catálogo semántico.

Clave de semántica Clave de atributo de OTel Valor de la semántica Valor de atributo de OTel
ENVIRONMENT deployment.environment.name PRODUCTION production
STAGING staging
TEST test
DEVELOPMENT development
CRITICALITY service.criticality MISSION_CRITICAL critical
HIGH high
MEDIUM medium
LOW low

Limitaciones de las etiquetas semánticas

Las etiquetas semánticas tienen las siguientes limitaciones:

  • Vinculaciones personalizadas: No puedes vincular directamente las etiquetas semánticas ENVIRONMENT o CRITICALITY a recursos o nodos de Resource Manager (proyectos, carpetas u organizaciones) a través de la API de etiquetas.
  • Semántica definida por el usuario: No se admite la promoción de tus etiquetas existentes a etiquetas semánticas.
  • Solo recursos directos: La sincronización se aplica solo a los recursos directos registrados en App Hub. No se propaga a recursos anidados o indirectos dentro de un servicio o una carga de trabajo (por ejemplo, VMs individuales en un MIG).

Crea etiquetas

La estructura de las etiquetas es un par clave-valor. Se puede crear un recurso de clave de etiqueta en los recursos de tu organización o proyecto, y los valores de etiqueta son recursos que se adjuntan a una clave, por ejemplo, una clave de etiqueta environment con valores production y development.

Administración de etiquetas

Los administradores pueden controlar el uso de las etiquetas restringiendo quién puede crearlas, actualizarlas, borrarlas y adjuntarlas a los recursos. Pueden seleccionar una etiqueta individual para realizar modificaciones, como agregar o quitar valores, y actualizar la descripción. Esto permite un control detallado de tus etiquetas.

De manera opcional, las etiquetas tienen una descripción que se muestra cuando se recupera información sobre la etiqueta. La descripción ayuda a los usuarios que adjuntan la etiqueta al recurso a comprender el propósito de la etiqueta.

En un proyecto o una organización superior, cada clave de etiqueta debe ser única. Esto garantiza que cada valor de etiqueta, cuando se vincula a un recurso, cree una vinculación única con su clave de etiqueta.

Políticas y etiquetas

Puedes usar etiquetas y condiciones de IAM juntas para lo siguiente:

Después de crear un valor de etiqueta, puedes vincularlo a los recursos. Luego, puedes crear políticas de IAM con condiciones que identifiquen los recursos en función de si se vinculó una clave de etiqueta al recurso. Para obtener información sobre el uso de etiquetas y condiciones de IAM, consulta Etiquetas y acceso condicional.

Impacto de los cambios en las etiquetas

Si usas etiquetas para otorgar o denegar el acceso de forma condicional o para definir el alcance de las políticas de la organización, vincular o desvincular una etiqueta de un recurso puede cambiar el impacto de estas políticas.

Por ejemplo, supongamos que tienes un grupo de desarrolladores que necesitan administrar instancias de Compute Engine, pero solo las que se usan para el desarrollo:

  1. Definiciones de etiquetas: Tienes una clave de etiqueta 123456789012/env con los valores dev y prod.
  2. Acceso condicional: Otorgas el rol de Administrador de instancias de Compute (roles/compute.instanceAdmin) al grupo de desarrolladores. Agregas una condición a la vinculación de rol que permite el acceso solo si el recurso tiene la etiqueta env: dev.
  3. Efectos de los cambios:
    • Vinculación de etiquetas: Adjuntas la etiqueta env: dev a una instancia. La vinculación de rol condicional ahora otorga a los desarrolladores acceso para administrar la instancia.
    • Desvinculación de etiquetas: Más adelante, la misma instancia se asciende a producción. Desvinculas la etiqueta env: dev y vinculas la etiqueta env: prod. La vinculación de rol condicional ya no otorga acceso a los desarrolladores para administrar esta instancia.

En general, los cambios en las etiquetas entran en vigor en un plazo de 2 minutos. Sin embargo, los cambios pueden tardar hasta 7 minutos en propagarse por completo en todo el sistema. Este retraso de propagación se aplica a la rapidez con la que se otorga o revoca el acceso, o a la rapidez con la que se aplica una política de la organización después de vincular o desvincular una etiqueta.

Aplicación de etiquetas obligatorias con políticas de la organización

Puedes aplicar etiquetas obligatorias en los recursos con una política de la organización personalizada. Cuando aplicas etiquetas obligatorias, solo puedes crear recursos que cumplan con las políticas de etiquetado de tu organización, es decir, los recursos se vinculan con los valores de etiqueta para las claves de etiqueta obligatorias especificadas en la política. Para obtener más información, consulta Configura una restricción personalizada para aplicar etiquetas.

La aplicación de etiquetas obligatorias se admite para los siguientes tipos de recursos:

  • Proyectos y carpetas de Resource Manager
  • Instancias de Filestore
  • Recursos de clúster y copia de seguridad de AlloyDB para PostgreSQL
  • Flujo de trabajo de Workflows
  • Recursos de Compute Engine:
    • Instancias
    • Discos
    • Puertas de enlace de VPN externas
    • Puertas de enlace de VPN
    • Puertas de enlace de VPN de destino
    • Túneles VPN
    • Interconexiones
    • Adjuntos de interconexión
    • Servicios de backend
    • Servicios de backend regionales
    • Buckets de backend
  • Recursos de VPC:
    • Redes
    • Subredes
    • Reglas de firewall
    • Rutas

Herencia de etiquetas

Cuando se adjunta un valor de etiqueta a un recurso, de forma predeterminada, todos los descendientes del recurso heredan el mismo valor de etiqueta. Puedes anular un valor de etiqueta heredado en un recurso descendiente. Para anular un valor de etiqueta heredado, vincula un valor de etiqueta diferente al recurso descendiente. El valor de etiqueta diferente debe usar la misma clave de etiqueta que el valor de etiqueta heredado.

Por ejemplo, supongamos que aplicas la etiqueta environment: development a una carpeta y que esta tiene dos carpetas secundarias llamadas team-a y team-b. También puedes aplicar una etiqueta diferente, environment: test, a la carpeta team-b. Como resultado, los proyectos y otros recursos de la carpeta team-a heredan la etiqueta environment: development, y los proyectos y otros recursos de la carpeta team-b heredan la etiqueta environment: test:

Jerarquía de recursos con etiquetas

Jerarquía de recursos con etiquetas

Si quitas la etiqueta environment: test de la carpeta team-b, esa carpeta y sus recursos heredarán la etiqueta environment: development.

Todas las etiquetas adjuntas y heredadas de un recurso se denominan, en conjunto, etiquetas eficaces. Las etiquetas eficaces de un recurso son una combinación de las etiquetas adjuntas directamente a él y todas las etiquetas adjuntas a todos los principales del recurso en toda la jerarquía.

Cuando uses etiquetas con condiciones de IAM, te recomendamos que crees un valor de etiqueta predeterminado seguro para cada clave de etiqueta que usen tus condiciones de IAM. Aplica el valor de etiqueta predeterminado seguro vinculando ese valor de etiqueta a tu organización para que lo hereden todos los recursos dentro de la organización. Solo cambia el valor de la etiqueta anulando de forma explícita las vinculaciones heredadas en los recursos relevantes.

Por ejemplo, supongamos que tienes una condición de IAM que depende del valor de etiqueta on para la clave de etiqueta enforcement, y la clave de etiqueta también tiene un valor de etiqueta off. Vincula el valor de la etiqueta enforcement: off a la organización para crear un valor predeterminado seguro que hereden todos los recursos de la organización. Vincula solo el valor de la etiqueta enforcement: on a los recursos seleccionados dentro de la organización.

Luego, puedes escribir políticas que aborden la clave de etiqueta enforcement, con condiciones que afecten a un recurso si es enforcement: on o enforcement: off, y un caso seguro si es enforcement: default. Si alguna vez se quita la clave de etiqueta enforcement de un recurso, este puede heredar el valor de la etiqueta para enforcement de su recurso superior. Si ningún recurso superior tiene la clave de etiqueta enforcement, el recurso hereda enforcement: default del recurso de organización.

Usar una etiqueta predeterminada segura puede ayudar, pero para evitar comportamientos no deseados, te recomendamos que revises las etiquetas y las políticas con condiciones vigentes antes de mover tus recursos o quitar etiquetas.

Borra claves y valores de etiqueta

Antes de borrar un valor de etiqueta, debes borrar todas las vinculaciones de recursos que lo usen.

Protege los valores de etiqueta para que no se borren

Puedes crear una capa adicional de protección para tus valores de etiqueta adjuntando una conservación de etiqueta a un valor de etiqueta. Una conservación de etiqueta de instancia, al igual que una vinculación de etiqueta de instancia, impide que un usuario borre el valor de la etiqueta de instancia.

Algunos recursos crean automáticamente una retención de etiqueta en cada valor de etiqueta adjunto al recurso. Debes quitar esta conservación de etiqueta para poder borrar el valor de etiqueta.

¿Qué sigue?