Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Crear y administrar etiquetas de instancia

Cloud Bigtable ofrece la opción de agregar etiquetas a tus instancias. Las etiquetas son pares clave-valor que puedes usar para agrupar las instancias relacionadas y almacenar metadatos de una instancia.

En esta página, se explica cómo puedes usar las etiquetas con tus instancias de Bigtable. También se describe cómo agregar, actualizar y quitar las etiquetas de una instancia.

¿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 envía al sistema de facturación a fin de que puedas desglosar tus cargos de facturación según las etiquetas.

Las etiquetas se pueden usar como anotaciones que se pueden consultar en los recursos, pero no se pueden usar para establecer condiciones en las políticas. Las etiquetas proporcionan una forma de permitir o rechazar políticas de manera condicional en función de si un recurso tiene una etiqueta específica. Para obtener más información, consulta la Descripción general de etiquetas.

Etiquetas

Las etiquetas son una herramienta independiente que se usa para proporcionar un control detallado sobre las políticas. Para obtener más información sobre las etiquetas, consulta la Descripción general de 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.

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 para un solo recurso. 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.

Estos límites se aplican a la clave y al valor de cada etiqueta de clúster, y a los recursos individuales de Google Cloud que tienen etiquetas de clúster. No hay límite para la cantidad de etiquetas de clúster que puedes aplicar en todos los recursos de un proyecto.

Agrega o actualiza las etiquetas de una instancia

Después de crear una instancia de Bigtable, puedes usar Google Cloud Console para agregar etiquetas a la instancia y actualizar las etiquetas existentes. También puedes usar la API de Administrador de RPC o la API de Administrador de REC a fin de agregar o actualizar etiquetas.

Para agregar o actualizar etiquetas para una instancia de Bigtable con la consola de Google Cloud, debes hacer lo siguiente:

  1. Abre la lista de instancias de Bigtable en Google Cloud Console.

    Abrir la lista de instancias

  2. Marca la casilla que aparece junto a cada instancia cuyas etiquetas deseas modificar.

  3. Si el panel Etiquetas no está visible, haz clic en Mostrar panel de información en la esquina superior derecha para abrirlo.

  4. Agrega y actualiza las etiquetas según sea necesario.

    Para agregar una etiqueta nueva, haz clic en Agregar etiqueta y, luego, escribe su clave y valor.

    Para modificar una etiqueta existente, actualiza su valor. La clave de una etiqueta existente no se puede modificar.

  5. Haz clic en Guardar para guardar los cambios.

Quita una etiqueta de una instancia

Para quitar una etiqueta de una instancia de Bigtable con la consola de Google Cloud, debes hacer lo siguiente:

  1. Abre la lista de instancias de Bigtable en Google Cloud Console.

    Abrir la lista de instancias

  2. Marca la casilla que aparece junto a cada instancia cuyas etiquetas desees quitar.

  3. Si el panel Etiquetas no es visible, haz clic en Mostrar panel de información en la esquina superior derecha para abrirlo.

  4. Haz clic en la X junto a cada etiqueta que desees quitar.

  5. Haz clic en Guardar para guardar los cambios.

¿Qué sigue?

Aprende cómo modificar otras propiedades de una instancia de Bigtable.