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,PRODUCTIONoSTAGING.google:AppHub/criticality: valores derivados de App Hub, por ejemplo,MISSION_CRITICALoHIGH.
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
ENVIRONMENToCRITICALITYa 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:
- Definiciones de etiquetas: Tienes una clave de etiqueta
123456789012/envcon los valoresdevyprod. - 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 etiquetaenv: dev. - Efectos de los cambios:
- Vinculación de etiquetas: Adjuntas la etiqueta
env: deva 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: devy vinculas la etiquetaenv: prod. La vinculación de rol condicional ya no otorga acceso a los desarrolladores para administrar esta instancia.
- Vinculación de etiquetas: Adjuntas la etiqueta
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:
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?
- Para obtener más información sobre cómo usar etiquetas, consulta la página Crea y administra etiquetas.
- Para obtener información sobre el uso de etiquetas con Compute Engine, consulta Administra etiquetas para recursos.
- Para obtener información sobre el uso de etiquetas para definir límites de administración entre proyectos, consulta Descripción general de los límites y las capacidades de administración.
- Para obtener información sobre el uso de etiquetas seguras para las políticas de firewall, consulta Crea y administra etiquetas seguras.