Crea y administra etiquetas

En esta página, se ofrece una breve descripción general de las etiquetas y se explica cómo crear y administrar etiquetas con la API de Resource Manager y Google Cloud Console.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que te ayuda a organizar tus instancias de Google Cloud. Puedes adjuntar una etiqueta a cada recurso y, luego, usarlas para filtrarlos. La información sobre las etiquetas se reenvía al sistema de facturación a fin de que puedas desglosar tus cargos de facturación según las etiquetas.

Usos comunes de las etiquetas

No recomendamos crear grandes cantidades de etiquetas únicas, como marcas de tiempo o valores individuales para cada llamada a la API. Estos son algunos casos prácticos comunes de las etiquetas:

  • Etiquetas de equipo o del centro de costos: Agrega etiquetas por equipo o centro de costos para distinguir las instancias que pertenecen a distintos equipos (por ejemplo, team:research y team:analytics). Puedes usar este tipo de etiquetas para la contabilidad de costos o la creación de presupuestos.

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

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

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

  • Etiquetas de máquina virtual: se puede adjuntar una etiqueta a una máquina virtual. Las etiquetas de máquina virtual que definiste con anterioridad aparecerán como una etiqueta sin un valor.

Requisitos para las etiquetas

Las etiquetas que se aplican a un recurso deben cumplir los siguientes requisitos:

  • Cada recurso puede tener varias etiquetas, hasta 64.
  • Cada etiqueta debe ser un par clave-valor.
  • La longitud de las claves debe ser de entre 1 y 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y su longitud máxima es de 63 caracteres.
  • Las claves y los valores pueden contener solo letras en minúscula, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8, además, se permiten los caracteres internacionales.
  • La porción de clave de una etiqueta debe ser única. Sin embargo, puedes usar la misma clave en varios recursos.
  • Las claves deben comenzar con una letra en minúscula o un carácter internacional.

Crea y administra etiquetas con la API de Resource Manager

Para crear un nuevo proyecto con una etiqueta, establece el campo labels cuando crees el proyecto.

REST

Solicitud:

POST https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}
Respuesta:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


Para agregar etiquetas a los proyectos existentes, haz lo siguiente:

  • Obtén el proyecto mediante el método get().
  • Modifica el campo labels.
  • Actualiza el proyecto con el método update().

Para obtener detalles sobre cómo actualizar las etiquetas de un proyecto, consulta la sección sobre cómo actualizar un proyecto.

Si quieres obtener detalles sobre el uso de etiquetas para filtrar proyectos, consulta la sección sobre cómo enumerar proyectos.

Permisos

Para agregar o modificar una etiqueta, llama al método projects.update(). Esto requiere el permiso resourcemanager.projects.update.

Para ver la etiqueta de un proyecto, llama al método projects.get(). Esto requiere el permiso resourcemanager.projects.get.

Crea y administra etiquetas con Cloud Console

Para agregar etiquetas a un solo proyecto, sigue estos pasos:

  1. Abre la página Etiquetas en Cloud Console.
    Abrir la página Etiquetas
  2. Selecciona tu proyecto del menú desplegable Seleccionar un proyecto.
  3. Para agregar una nueva entrada de etiqueta, haz clic en + Agregar etiqueta y, luego, ingresa una clave y valor de etiqueta para cada etiqueta que desees agregar.
  4. Cuando termines de agregar etiquetas, haz clic en Guardar.

Para agregar etiquetas a más de un proyecto al mismo tiempo, sigue estos pasos:

  1. Abre la página Administrar recursos en Cloud Console.
    Abrir la página Administrar recursos
  2. En la página Administrar recursos, selecciona la organización y los proyectos a los que deseas agregar etiquetas.
  3. En el panel lateral derecho, en la pestaña Etiquetas, haz clic en + Agregar etiqueta y, luego, ingresa una clave y valor de etiqueta para cada etiqueta que desees agregar.
  4. Cuando termines de agregar etiquetas, haz clic en Guardar.

Luego de agregar las etiquetas, puedes escribir una clave o valor de etiqueta en el cuadro de filtro sobre la lista de proyectos para filtrar proyectos. El cuadro de filtro sugerirá claves y valores para que puedas obtener una vista previa de los resultados.

Servicios que admiten etiquetas en la actualidad

Por el momento, los siguientes servicios de Google Cloud admiten etiquetas:

  • BigQuery
  • Cloud Bigtable
  • Dataflow
  • Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • Cloud Run (completamente administrado)
  • Herramientas de redes
  • Resource Manager
  • App Engine (entornos flexible y estándar)