Introducción

En este documento se ofrece una breve descripción general de las etiquetas y sus funciones.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que puede asignar a los Google Cloud recursos. Te ayudan a organizar estos recursos y a gestionar tus costes a gran escala, con la granularidad que necesites. Puedes asignar una etiqueta a cada recurso y, después, filtrar los recursos en función de sus etiquetas. La información relacionada con las etiquetas se reenvía al sistema de facturación para que puedas desglosar los cargos facturados por etiquetas. Con los informes de facturación integrados, puedes filtrar y agrupar los costes por etiquetas de recursos. También puedes usar etiquetas para consultar exportaciones de datos de facturación.

Requisitos de las etiquetas

Las etiquetas aplicadas a un recurso deben cumplir los siguientes requisitos:

  • Cada recurso puede tener hasta 64 etiquetas.
  • Cada etiqueta debe ser un par clave-valor.
  • Las claves deben tener como mínimo 1 carácter y como máximo 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y pueden tener hasta 63 caracteres.
  • Las claves y los valores solo pueden contener letras minúsculas, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar codificación UTF-8, y se pueden usar caracteres internacionales. Las claves deben empezar por una letra minúscula o un carácter internacional.
  • La parte de la clave de una etiqueta debe ser única en un solo recurso. Sin embargo, puedes usar la misma clave con varios recursos.

Estos límites se aplican a la clave y al valor de cada etiqueta, así como a los recursos individuales Google Cloud que tienen etiquetas. No hay límite en el número de etiquetas que puedes aplicar a todos los recursos de un proyecto.

Usos habituales de las etiquetas

A continuación se indican algunos de los usos más habituales de las etiquetas:

  • Etiquetas de equipo o de centro de costes: añade etiquetas basadas en el equipo o el centro de costes para distinguir los recursos propiedad de diferentes equipos (por ejemplo, team:research y team:analytics). Puedes usar este tipo de etiquetas para la contabilidad de costes o la elaboración de presupuestos.

  • Etiquetas de componentes: por ejemplo, component:redis, component:frontend, component:ingest y component:dashboard.

  • Etiquetas de entorno o fase: por ejemplo, environment:production y environment:test.

  • Etiquetas de estado: por ejemplo, state:active, state:readytodelete y state:archive.

  • Etiquetas de propiedad: se usan para identificar los equipos responsables de las operaciones. Por ejemplo, team:shopping-cart.

  • Etiquetas de red: se pueden asociar etiquetas a una máquina virtual. Las etiquetas de red que haya definido anteriormente aparecerán como una etiqueta sin valor.

No recomendamos crear un gran número de etiquetas únicas, como las de marcas de tiempo o valores individuales para cada llamada a la API. El problema de este método es que, cuando los valores cambian con frecuencia o con claves que saturan el catálogo, resulta difícil filtrar y generar informes sobre los recursos de forma eficaz.

Etiquetas

Las etiquetas se pueden usar como anotaciones consultables para los recursos, pero no se pueden usar para definir condiciones en las políticas. Las etiquetas permiten aplicar o denegar políticas de forma condicional en función de si un recurso tiene una etiqueta específica, lo que proporciona un control pormenorizado de las políticas. Para obtener más información, consulta la descripción general de las etiquetas.

Permisos

Se necesitan los siguientes permisos para añadir, modificar y ver etiquetas de proyectos:

  • Para añadir o modificar una etiqueta, llama al método projects.patch(). Para ello, se necesita el permiso resourcemanager.projects.update.
  • Para ver la etiqueta de un proyecto, llama al método projects.get(). Para ello, se necesita el permiso resourcemanager.projects.get.

Consultar los costes mediante etiquetas

Puedes asignar una etiqueta a un recurso y, después, filtrar los recursos en función de sus etiquetas. La información relacionada con las etiquetas se reenvía al sistema de facturación, lo que te permite desglosar los cargos facturados por etiqueta.

A continuación, te indicamos algunas formas de usar las etiquetas para entender los costes:

  • Puedes añadir etiquetas como costcenter=cost_center_name, service=service_name y environment=environment_name a tus máquinas virtuales o segmentos de Cloud Storage. De esta forma, sabrás dónde se han desplegado tus recursos, con qué fin y a qué centro de costes se deben cargar.
  • Puede habilitar la exportación de datos de facturación a BigQuery. Las etiquetas se exportan a BigQuery con los recursos correspondientes Google Cloud y su uso. De esta forma, puede monitorizar aspectos como el coste de ejecutar el servicio de carrito de la compra en la aplicación o el coste de las máquinas de prueba de los desarrolladores.
  • Puedes usar BigQuery junto con etiquetas para saber el coste de todos los recursos del sistema de prueba en comparación con los recursos de producción o cuánto cuesta un servicio concreto.

Ejemplo

En este ejemplo, el coste de los servicios de playlist de un proyecto se determina exportando el uso y las etiquetas a BigQuery. Para ello, primero debes habilitar la exportación de facturación a BigQuery. labels-demo-prj es la fuente de tu uso de recursos y labels_demo_bqexport es el conjunto de datos de destino donde se almacenan los datos de uso. Después de exportar tu uso y tus etiquetas a BigQuery, puedes determinar cuánto cuestan tus playlistservicios.

A continuación, se muestran los detalles del uso de Compute Engine y su coste asociado en BigQuery.

.