En esta página se describe cómo editar los metadatos de un secreto. Puede actualizar muchas propiedades de un secreto, como el tipo de cifrado, la política de rotación, la fecha de vencimiento, las etiquetas y las notificaciones de eventos. También puedes añadir anotaciones y configurar alias para las versiones de secretos. No puedes editar el nombre ni el valor del secreto, ni la política de réplica. Para añadir un valor a tu secreto, debes crear una nueva versión del secreto.
Roles obligatorios
Para obtener los permisos que necesitas para actualizar los metadatos de un secreto,
pide a tu administrador que te conceda el rol de gestión de identidades y accesos
Administrador de Secret Manager (roles/secretmanager.admin
)
en el secreto o en el proyecto.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Editar un secreto
Para editar un secreto, utilice uno de los siguientes métodos:
Consola
-
En la Google Cloud consola, ve a la página Secret Manager.
-
Para editar un secreto, usa una de las siguientes opciones:
-
Busca el secreto en la lista y haz clic en el menú
Acciones asociado a ese secreto. En el menú Acciones, haz clic en Editar. -
Haz clic en el nombre del secreto para ir a la página de detalles. En la página de detalles del secreto, haz clic en
Editar secreto.
-
-
En la página Editar secreto, actualiza las propiedades del secreto según sea necesario y, a continuación, haz clic en Actualizar secreto.
gcloud
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- SECRET_ID: el ID del secreto
- KEY: la clave de la etiqueta
- VALUE: el valor correspondiente de la etiqueta
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets update SECRET_ID \ --update-labels=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID ` --update-labels=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID ^ --update-labels=KEY=VALUE
La respuesta devuelve el secreto actualizado.
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID del proyecto Google Cloud
- SECRET_ID: el ID del secreto
- KEY: la clave de la etiqueta
- VALUE: el valor correspondiente de la etiqueta
Método HTTP y URL:
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels
Cuerpo JSON de la solicitud:
{'labels': {'KEY': 'VAL'}}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la siguiente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID", "createTime": "2024-09-02T07:14:00.281541Z", "labels": { "key": "value" }, "etag": "\"16211dc7d040b1\"" }
C#
Para ejecutar este código, primero debes configurar un entorno de desarrollo de C# e instalar el SDK de C# de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Go
Para ejecutar este código, primero debes configurar un entorno de desarrollo de Go e instalar el SDK de Go de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Java
Para ejecutar este código, primero debes configurar un entorno de desarrollo de Java e instalar el SDK de Java de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Node.js
Para ejecutar este código, primero debes configurar un entorno de desarrollo de Node.js e instalar el SDK de Node.js de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
PHP
Para ejecutar este código, primero debes consultar información sobre cómo usar PHP en Google Cloud e instalar el SDK de PHP de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Python
Para ejecutar este código, primero debes configurar un entorno de desarrollo de Python e instalar el SDK de Python de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Ruby
Para ejecutar este código, primero debes configurar un entorno de desarrollo de Ruby e instalar el SDK de Ruby de Secret Manager. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Editar permisos y etiquetas de varios secretos
Puedes editar los permisos y las etiquetas de varios secretos mediante la Google Cloud consola.
-
En la Google Cloud consola, ve a la página Secret Manager.
-
En la página Secret Manager, selecciona los secretos cuyos permisos y etiquetas quieras editar.
-
Si el panel de información está cerrado, haz clic en Mostrar panel de información para que se muestre.
-
Los permisos y las etiquetas configurados para todos los secretos se muestran en el panel de información en las pestañas correspondientes. Ve a las pestañas correspondientes y actualiza los valores según sea necesario.
-
Cuando termine, haga clic en Guardar.
Siguientes pasos
- Consulta cómo gestionar el acceso a los secretos.
- Consulta cómo configurar las rotaciones de secretos.
- Consulta cómo configurar notificaciones en un secreto.
- Consulta cómo habilitar las claves de encriptado gestionadas por el cliente (CMEK) en Secret Manager.