En esta página, se explica cómo configurar la destrucción demorada de las versiones de secretos, actualizar o quitar la duración de la demora en la destrucción y restablecer las versiones de secretos que están programadas para destruirse.
De forma predeterminada, cuando un usuario elige destruir una versión del secreto en Secret Manager, el material del secreto se destruye de inmediato y de forma permanente. Sin embargo, los usuarios con el rol de administrador de Secret Manager pueden configurar la destrucción retrasada de versiones del secreto, lo que garantiza que la versión del secreto no se destruya inmediatamente después de la solicitud y siga siendo recuperable durante un período configurable.
Cuando la destrucción retrasada está habilitada en el Secret y destruyes una versión de este, ocurre lo siguiente:
-
La versión está inhabilitada, lo que impide su uso.
-
El sistema programa la versión para su destrucción permanente al final del período de demora.
-
Una vez que vence el período de demora, la versión del secreto se destruye de forma permanente e irrevocable.
Beneficios
Esta función ofrece los siguientes beneficios:
-
Una capa adicional de protección contra la destrucción accidental o maliciosa de material secreto crítico. Cualquier usuario con el rol de Administrador de versiones de secretos de Secret Manager puede destruir una versión de un secreto. Esta acción es irreversible. Si configuras la destrucción retrasada, puedes evitar la destrucción inmediata de las versiones de Secrets. Puedes otorgar a los usuarios el acceso mínimo necesario para administrar el ciclo de vida de las versiones de los secretos, de modo que puedas supervisar y evitar cualquier destrucción accidental de datos sensibles.
-
Cuando se destruye una versión del secreto, se activa una notificación de
SECRET_VERSION_DESTROY_SCHEDULEDen los temas de Pub/Sub configurados en el secreto. Los usuarios con el rol de administrador de Secret Manager pueden cancelar la destrucción programada y restablecer la versión del Secret habilitando o inhabilitando la versión del Secret.
Antes de comenzar
-
Habilita la API de Secret Manager si aún no lo hiciste.
Roles necesarios para habilitar las APIs
Para habilitar APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles. -
Configura la autenticación.
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Cloud de Confiance para acceder a los servicios y las APIs de Cloud de Confiance by S3NS , no necesitas configurar la autenticación.
gcloud
Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:
gcloud initREST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Cloud de Confiance .
Roles obligatorios
Para obtener los permisos que
necesitas para configurar la destrucción retrasada de versiones de secretos,
pídele a tu administrador que te otorgue el
rol de IAM Administrador de Secret Manager (roles/secretmanager.admin) en un secreto.
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 a través de roles personalizados o cualquier otro rol predefinido.
Cómo configurar la destrucción demorada
Puedes habilitar la destrucción retrasada de una versión del secreto cuando creas el secreto o cuando lo actualizas. Para configurar la destrucción retrasada, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página Secret Manager, haz clic en la pestaña Secretos regionales y, luego, en Crear secreto regional.
-
En la página Crear secreto regional, ingresa un nombre para el secreto en el campo Nombre.
-
Ingresa 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. -
En la lista Región, elige la ubicación en la que deseas que se almacene tu Secret regional.
-
Ve a la sección Demorar la destrucción de la versión del secreto y, luego, selecciona la casilla de verificación Establecer la duración de la destrucción demorada.
-
En el campo Duración del retraso de la destrucción, ingresa la duración en días. El valor mínimo que puedes ingresar es 1 día, y el valor máximo es 1,000 días.
-
Haz clic en Crear secreto.
Para habilitar esta función en un secreto existente, ve a la página Editar secreto y, luego, configura la duración del retraso de destrucción.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_ID: Es el ID del secreto.
- LOCATION: Es la Cloud de Confiance by S3NS ubicación del secreto.
- TTL_DURATION: Es la duración de la demora en la destrucción de las versiones del secreto. Puedes ingresar la duración en cualquier formato, por ejemplo, días, horas o segundos. La duración mínima requerida es de 1 día, mientras que la duración máxima se puede establecer en 1,000 días.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
Windows (PowerShell)
gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
Windows (cmd.exe)
gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
La respuesta contiene el secreto recién creado.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación Cloud de Confiance by S3NS del Secret.
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: Es el ID del secreto.
- TTL_DURATION: Es la duración de la demora en la destrucción de las versiones del secreto. Ingresa la duración en segundos. Ten en cuenta que la duración mínima requerida es de 1 día, mientras que la duración máxima se puede establecer en 1,000 días.
Método HTTP y URL:
POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID
Cuerpo JSON de la solicitud:
{
"version_destroy_ttl":"TTL_DURATION"
}
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 POST \
-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?secretId=SECRET_ID"
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 POST `
-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?secretId=SECRET_ID" | 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-04T06:34:32.995517Z",
"etag": "\"1621455df3febd\"",
"versionDestroyTtl": "TTL_DURATION"
}
La destrucción retrasada no se aplica en las siguientes situaciones:
-
Cuando se borra un secreto, se borran de inmediato todo el material secreto y las versiones de secretos relacionadas.
-
Cuando se establece una fecha de vencimiento en el secreto y este vence, todas las versiones del secreto se destruyen de inmediato, incluso si la destrucción retrasada está habilitada en el secreto.
Actualiza la duración del retraso de la destrucción
Para actualizar la duración del retraso de destrucción, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página de Secret Manager, haz clic en la pestaña Secretos regionales.
-
Para editar un secreto, usa uno de los siguientes métodos:
-
Haz clic en Acciones para el secreto que deseas editar y, luego, 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, ve a la sección Retrasar la destrucción de la versión del secreto. Actualiza la duración del retraso según sea necesario y, luego, haz clic en Actualizar secreto.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_ID: Es el ID del secreto.
- LOCATION: la ubicación Cloud de Confiance by S3NS del secreto
- TTL_DURATION: Es la duración de la demora en la destrucción de las versiones del secreto.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
Windows (PowerShell)
gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
Windows (cmd.exe)
gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION
La respuesta contiene el secreto recién creado.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La Cloud de Confiance by S3NS ubicación del secreto
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: Es el ID del secreto.
- TTL_DURATION: Es la duración de la demora en la destrucción de las versiones del secreto.
Método HTTP y URL:
PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl
Cuerpo JSON de la solicitud:
{
"version_destroy_ttl":"TTL_DURATION"
}
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=version_destroy_ttl"
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=version_destroy_ttl" | 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-04T06:34:32.995517Z",
"etag": "\"16214561a80d09\"",
"versionDestroyTtl": "TTL_DURATION"
}
Las versiones del secreto que se ven afectadas por la duración de la demora en la destrucción dependen de lo siguiente:
-
Cuando se establece la destrucción retrasada por primera vez en el secreto, la duración del retraso en la destrucción afecta a todas las versiones activas (habilitadas y inhabilitadas) del secreto.
-
Cuando se actualiza o quita la duración de la demora de destrucción, los cambios se reflejan solo en las versiones nuevas del secreto en las que se intenta realizar la acción de destrucción. Las versiones del Secret que ya estén programadas para su destrucción seguirán destruyéndose en el momento programado.
Inhabilita la demora en la destrucción
Para inhabilitar la destrucción retrasada de versiones, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página de Secret Manager, haz clic en la pestaña Secrets regionales.
-
Para editar un secreto, usa uno de los siguientes métodos:
-
Haz clic en Acciones para el secreto que deseas editar y, luego, 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, ve a la sección Retrasar la destrucción de la versión del secreto. Desmarca la casilla de verificación Establecer la duración de la destrucción demorada y, luego, haz clic en Actualizar secreto.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_ID: Es el ID del secreto.
- LOCATION: La Cloud de Confiance by S3NS ubicación del secreto
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl
Windows (PowerShell)
gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl
Windows (cmd.exe)
gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La Cloud de Confiance by S3NS ubicación del secreto
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: Es el ID del secreto.
Método HTTP y URL:
PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl
Cuerpo JSON de la solicitud:
{}
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=version_destroy_ttl"
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=version_destroy_ttl" | 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-04T06:34:32.995517Z",
"etag": "\"16214564f18f19\""
}
Programa la destrucción demorada de las versiones del secreto
Para programar la destrucción demorada de una versión del secreto, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página Secret Manager, haz clic en la pestaña Secretos regionales y, luego, en un secreto para acceder a sus versiones. Se debe configurar la destrucción retrasada de las versiones en este secreto.
-
En la página de detalles del secreto, en la pestaña Versiones, selecciona la versión del secreto que deseas destruir.
-
Haz clic en Acciones y, luego, en Destruir.
-
En el cuadro de diálogo de confirmación que aparece, ingresa el ID del secreto para confirmar y, luego, haz clic en Programar la destrucción de las versiones seleccionadas.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
- SECRET_ID: el ID del secreto
- LOCATION: La Cloud de Confiance by S3NS ubicación del secreto
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (PowerShell)
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (cmd.exe)
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: la ubicación Cloud de Confiance by S3NS del secreto
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: Es el ID del secreto.
- VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
Método HTTP y URL:
POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:destroy
Cuerpo JSON de la solicitud:
{}
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 POST \
-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/versions/VERSION_ID:destroy"
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 POST `
-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/versions/VERSION_ID:destroy" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime": "2024-09-04T06:41:57.859674Z",
"state": "DISABLED",
"etag": "\"16214579184a2c\"",
"scheduledDestroyTime": "2024-09-05T13:15:28.357251843Z"
}
La versión del Secret se inhabilita de inmediato y se programa para su destrucción después de que venza la duración del retraso de la destrucción. Puedes ver la fecha y hora exactas en las que se destruirá la versión en la columna Programada para su destrucción el de la tabla Versiones.
Restablece versiones de secretos
Puedes restablecer una versión del secreto programada para su destrucción habilitando o inhabilitando la versión del secreto.
Habilita una versión del secreto programada para su destrucción
Para habilitar una versión de un secreto programada para su destrucción, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página Secret Manager, haz clic en la pestaña Secretos regionales y, luego, haz clic en un secreto para acceder a sus versiones.
-
En la página de detalles del secreto, en la pestaña Versiones, selecciona la versión del secreto programada para su destrucción.
-
Haz clic en Acciones y, luego, en Habilitar.
-
En el cuadro de diálogo de confirmación que aparece, haz clic en Habilitar las versiones seleccionadas.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
- SECRET_ID: el ID del secreto
- LOCATION: la ubicación Cloud de Confiance by S3NS del secreto
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (PowerShell)
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (cmd.exe)
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La Cloud de Confiance by S3NS ubicación del secreto
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: Es el ID del secreto.
- VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
Método HTTP y URL:
POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable
Cuerpo JSON de la solicitud:
{}
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 POST \
-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/versions/VERSION_ID:enable"
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 POST `
-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/versions/VERSION_ID:enable" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime": "2024-09-04T06:41:57.859674Z",
"state": "ENABLED",
"etag": "\"1621457b3c1459\""
}
Inhabilita una versión del secreto programada para su destrucción
Para inhabilitar una versión del secreto programada para su destrucción, usa uno de los siguientes métodos:
Console
-
En la consola de Cloud de Confiance , ve a la página Secret Manager.
-
En la página Secret Manager, haz clic en la pestaña Secretos regionales y, luego, haz clic en un secreto para acceder a sus versiones.
-
En la página de detalles del secreto, en la pestaña Versiones, selecciona la versión del secreto que está programada para destruirse.
-
Haz clic en Acciones y, luego, en Inhabilitar.
-
En el cuadro de diálogo de confirmación que aparece, haz clic en Inhabilitar las versiones seleccionadas.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SECRET_VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
- SECRET_ID: Es el ID del secreto.
- LOCATION: la ubicación Cloud de Confiance by S3NS del secreto
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (PowerShell)
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (cmd.exe)
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION
La respuesta contiene la versión inhabilitada del secreto.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: la ubicación Cloud de Confiance by S3NS del secreto
- PROJECT_ID: Es el ID del proyecto de Cloud de Confiance by S3NS .
- SECRET_ID: el ID del secreto
- VERSION_ID: Es el ID de la versión o el identificador completamente calificado de la versión.
Método HTTP y URL:
POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable
Cuerpo JSON de la solicitud:
{}
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 POST \
-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/versions/VERSION_ID:disable"
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 POST `
-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/versions/VERSION_ID:disable" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime": "2024-09-04T06:41:57.859674Z",
"state": "DISABLED",
"etag": "\"1621457b3c1459\""
}
¿Qué sigue?
- Obtén más información para garantizar la integridad de los datos.
- Obtén más información sobre las prácticas recomendadas.