Administra etiquetas

En esta página, se muestra cómo usar etiquetas con tus instancias de Filestore. También se describe cómo agregar, actualizar y borrar las etiquetas de una instancia. Las etiquetas te permiten agrupar las instancias relacionadas y almacenar los metadatos de una instancia.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que puedes asignar a las instancias de Google Cloud Filestore. Te ayudan a organizar estos recursos y administrar los costos a gran escala, con el nivel de detalle que necesitas. 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 que te permite desglosar los cargos facturados por etiqueta. Con los informes de facturación integrados, puedes filtrar y agrupar costos por etiquetas de recurso. También puedes usar etiquetas para consultar las exportaciones de datos de facturación.

Requisitos para las etiquetas

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

  • Cada recurso puede tener hasta 64 etiquetas.
  • 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. Las claves deben comenzar con una letra en minúscula o un carácter internacional.
  • 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.

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.

Usos comunes de las etiquetas

Estos son algunos casos prácticos comunes de las etiquetas:

  • Etiquetas de equipo o centro de costo: agregue etiquetas basadas en el equipo o centro de costo para distinguir las instancias de Filestore que pertenecen a diferentes equipos (por ejemplo, team:research y team:analytics). Puede usar este tipo de etiqueta para la contabilidad de costos o el presupuesto.

  • 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 propiedad: Se usan para identificar a los equipos responsables de las operaciones, por ejemplo: team:shopping-cart.

No recomendamos crear grandes cantidades de etiquetas únicas, como marcas de tiempo o valores individuales para cada llamada a la API. El problema con este enfoque es que, cuando los valores cambian con frecuencia o con claves que sobrecargan el catálogo, esto dificulta el filtrado y la generación de informes eficaces para los recursos.

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, ya que proporciona un control detallado sobre las políticas. Para obtener más información, consulta la Descripción general de etiquetas.

Agrega o actualiza las etiquetas de una instancia

Puedes agregar etiquetas a una instancia de Filestore cuando creas la instancia. Después de crear una instancia, puedes agregarle más etiquetas y actualizar o borrar las existentes.

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Filestore.

    Vaya a la página de instancias de Filestore

  2. Selecciona la casilla de verificación junto a cada instancia cuyas etiquetas desees modificar.

  3. Haz clic en Mostrar panel de información.

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

    Operación Instrucciones
    Agregar una etiqueta Haz clic en Agregar etiqueta y escribe la clave y el valor de la etiqueta.
    Actualiza una etiqueta Actualiza el campo Valor. No puedes actualizar la Clave de una etiqueta existente.
    Borrar una etiqueta Haz clic en Borrar elemento junto a la etiqueta.

  5. Haz clic en Guardar para guardar los cambios una vez que termines con las actualizaciones.

gcloud

Puedes editar las etiquetas de una instancia de Filestore mediante la ejecución del comando instances update. Para agregar etiquetas nuevas o cambiar los valores de las existentes, usa la marca --update-labels. Para borrar una o más etiquetas, usa la marca --remove-labels. La marca --clear-labels quita todas las etiquetas de una instancia.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

Donde:

  • instance-ides el ID de la instancia que deseas editar.

  • project-id es el ID del proyecto de Google Cloud que contiene la instancia de Filestore. Puedes omitir esta marca si la instancia de Filestore está en el proyecto predeterminado gcloud. Para configurar el proyecto predeterminado, ejecuta el siguiente comando:

     gcloud config set project project-id

  • zone es la zona en la que se encuentra la instancia de Filestore. Ejecuta el comando gcloud filestore zones list para obtener una lista de las zonas compatibles. Puedes omitir esta marca si la instancia de Filestore se encuentra en la zona predeterminada gcloud. Para configurar la zona predeterminada, ejecuta el siguiente comando:

     gcloud config set filestore/zone zone

  • key es una etiqueta nueva o una etiqueta existente que quieres cambiar o quitar.

  • value es el valor de una etiqueta.

Ejemplo

En el ejemplo a continuación, se actualiza la instancia de nfs-server; para eso, se agrega la etiqueta estado, se actualiza el valor de la etiqueta departamento y se quita la etiqueta administrador.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

Servicios que admiten etiquetas en la actualidad

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

  • AI Platform
  • App Engine (entornos flexible y estándar)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Redes
  • Pub/Sub
  • Resource Manager (solo proyectos)

¿Qué sigue?

Aprenda cómo editar otras propiedades de una instancia de Filestore.