Añadir etiquetas a secretos

En esta página se ofrece una descripción general de las etiquetas, se explica cómo añadir etiquetas a un secreto y cómo ver y actualizar las etiquetas asociadas a un secreto.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que puede asignar a los secretos de Secret Manager. Google Cloud 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 centro de costes: añade etiquetas basadas en el equipo o el centro de costes para distinguir los secretos de Secret Manager que sean propiedad de diferentes equipos (por ejemplo, team:research y team:analytics). Puedes usar este tipo de etiqueta 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.

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 enfoque 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.

Crear un secreto con etiquetas

Para añadir una etiqueta al crear el secreto, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Secret Manager.

    Ir a Secret Manager

  2. En la página Secret Manager, haz clic en Crear secreto.

  3. En la página Crear secreto, introduce un nombre para el secreto en el campo Nombre.

  4. Introduce un valor para el secreto (por ejemplo, abcd1234). También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. Esta acción crea automáticamente la versión del secreto.

  5. Ve a la sección Etiquetas y haz clic en Añadir etiqueta.

  6. Introduce la clave y el valor correspondiente para crear una etiqueta.

  7. Haz clic en Crear secreto.

Ver etiquetas de un secreto

Para ver las etiquetas asignadas, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Secret Manager.

    Ir a Secret Manager

  2. En la página Secret Manager, selecciona el secreto cuyas etiquetas quieras ver.

  3. Si el panel de información está cerrado, haz clic en Mostrar panel de información para que se muestre.

  4. En el panel, haz clic en la pestaña Etiquetas. Se muestran todas las etiquetas añadidas al secreto.

Actualizar etiquetas

Para actualizar las etiquetas, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Secret Manager.

    Ir a Secret Manager

  2. Selecciona el secreto que quieras editar.

  3. Abre el panel de información y, a continuación, haz clic en la pestaña Etiquetas.

  4. Actualiza el valor de una etiqueta y haz clic en Guardar.

    También puedes eliminar una etiqueta o añadir una nueva. Para editar la clave de una etiqueta, añade una nueva etiqueta con el mismo nombre de clave y, a continuación, elimina la etiqueta antigua.

Eliminar etiquetas

Para quitar etiquetas, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Secret Manager.

    Ir a Secret Manager

  2. Selecciona el secreto que quieras editar.

  3. Abre el panel de información y, a continuación, haz clic en la pestaña Etiquetas.

  4. Haz clic en Eliminar para quitar las etiquetas que ya no necesites.

  5. Haz clic en Guardar.

Siguientes pasos