En esta página, se describe cómo editar los metadatos de un secreto. Puedes actualizar muchas propiedades de un secreto, como el tipo de encriptación, la política de rotación, la fecha de vencimiento, las etiquetas y las notificaciones de eventos. También puedes agregar anotaciones y configurar alias para las versiones de los secretos. No puedes editar el nombre ni el valor del secreto. Para agregar un valor nuevo a tu secreto, debes crear una versión nueva del secreto.
Roles obligatorios
Para obtener los permisos que
necesitas para actualizar los metadatos de un secreto,
pídele a tu administrador que te otorgue el
rol de IAM Administrador de Secret Manager (roles/secretmanager.admin) en el secreto o el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Edita un secreto
Para editar un secreto, usa uno de los siguientes métodos:
Console
-
En la Cloud de Confiance consola, ve a la Secret Manager página.
-
En la página Secret Manager, haz clic en la pestaña Secretos regionales.
-
Para editar un secreto, usa una de las siguientes opciones:
-
Ubica el secreto en la lista y haz clic en el Acciones menú 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 del secreto. 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, luego, haz clic en Actualizar secreto.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- SECRET_ID: Es el ID del secreto.
- LOCATION: Es la Cloud de Confiance by S3NS ubicación del secreto.
- KEY: Es la clave de etiqueta.
- VALUE: Es el valor correspondiente de la etiqueta.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets update SECRET_ID --location=LOCATION \ --update-labels=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID --location=LOCATION ` --update-labels=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID --location=LOCATION ^ --update-labels=KEY=VALUE
La respuesta muestra el secreto actualizado.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la Cloud de Confiance by S3NS ubicación del secreto.
- PROJECT_ID: Es el Cloud de Confiance by S3NS ID del proyecto.
- SECRET_ID: Es el ID del secreto.
- KEY: Es la clave de etiqueta.
- VALUE: Es el valor correspondiente de la etiqueta.
Método HTTP y URL:
PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=labels" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
"createTime": "2024-09-02T07:14:00.281541Z",
"labels": {
"key": "value"
},
"etag": "\"16211dc7d040b1\""
}
Go
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Para ejecutar este código, primero configura un entorno de desarrollo de Go y instala el SDK de Go para Secret Manager. En Compute Engine o GKE, debes autenticarte con el permiso cloud-platform.
Java
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Para ejecutar este código, primero configura un entorno de desarrollo de Java y instala el SDK de Java para Secret Manager. En Compute Engine o GKE, debes autenticarte con el permiso cloud-platform.
Node.js
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Para ejecutar este código, primero configura un entorno de desarrollo de Node.js e instala el SDK de Node.js para Secret Manager. En Compute Engine o GKE, debes autenticarte con el permiso cloud-platform.
Python
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Para ejecutar este código, primero configura un entorno de desarrollo de Python y instala el SDK de Python para Secret Manager. En Compute Engine o GKE, debes autenticarte con el permiso cloud-platform.
Edita los permisos y las etiquetas de varios secretos
Puedes editar los permisos y las etiquetas de varios secretos con la Cloud de Confiance consola.
-
En la Cloud de Confiance consola, ve a la Secret Manager página.
-
En la página Secret Manager , haz clic en la pestaña Secretos regionales y, luego, selecciona los secretos para los que deseas editar los permisos y las etiquetas.
-
Si el Panel de información está cerrado, haz clic en Mostrar panel de información para mostrarlo.
-
Los permisos y las etiquetas configurados para todos los secretos se muestran en el Panel de información en sus pestañas correspondientes. Ve a las pestañas individuales y actualiza los valores según sea necesario.
-
Haz clic en Guardar cuando termines.