Para evitar que se borre de forma permanente una instantánea recuperable, es decir, una instantánea estándar borrada que se encuentra en la papelera de reciclaje, recupérala de la papelera de reciclaje antes de que venza su período de retención. Cuando recuperas una instantánea, se convierte en una instantánea estándar utilizable que puedes usar para crear un disco nuevo.
En este documento, se describe cómo enumerar, recuperar y borrar instantáneas recuperables.
Para obtener más información sobre la papelera de reciclaje, consulta Cómo conservar los recursos borrados en la papelera de reciclaje.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación verifica tu identidad para acceder a los servicios y las APIs de Cloud de Confiance by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña que corresponda a la forma en que 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 init
-
- Configura una región y una zona predeterminadas.
REST
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 y permisos requeridos
Para obtener los permisos que necesitas para administrar las instantáneas recuperables, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
- Administrador de instancias de Compute (
roles/compute.instanceAdmin) -
Para conectarte a una VM que puede ejecutarse como una cuenta de servicio:
Usuario de cuenta de servicio (v1) (
roles/iam.serviceAccountUser)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para administrar instantáneas recuperables. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para administrar instantáneas recuperables:
-
Para recuperar una instantánea recuperable, haz lo siguiente:
compute.recoverableSnapshots.recoveren la instantánea -
Para ver información sobre una instantánea recuperable, haz lo siguiente:
compute.recoverableSnapshots.geten la instantánea -
Para borrar de forma permanente una instantánea recuperable, haz lo siguiente:
compute.recoverableSnapshots.deleteen la instantánea -
Para enumerar las instantáneas recuperables en un proyecto, usa
compute.recoverableSnapshots.listen el proyecto.
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Limitaciones
- Recursos admitidos: Solo se admiten las instantáneas estándar. Las instantáneas de archivo, las instantáneas inmediatas, los discos y las imágenes se borran de forma permanente de inmediato cuando se borran.
- Conflictos de nombres: La recuperación de una instantánea fallará si ya existe una instantánea estándar con el mismo nombre y no proporcionas un nombre nuevo para la instantánea recuperada. Para recuperar una instantánea de este tipo, debes usar Google Cloud CLI o REST para especificar un nombre nuevo.
- Persistencia de etiquetas: Las etiquetas que se adjuntan a una instantánea antes de que se borre no se conservan si la instantánea se recupera de la papelera de reciclaje. Debes volver a agregar las etiquetas a la instantánea después de recuperarla de la papelera de reciclaje.
- Cambios en la política de retención: Los cambios en la política de retención de la papelera de reciclaje no se aplican a las instantáneas recuperables existentes, es decir, a las instantáneas estándar borradas existentes que se encuentran en la papelera de reciclaje.
- Instantáneas programadas: Si recuperas una instantánea que se creó originalmente según una programación, la instantánea ya no formará parte de la programación y no se borrará automáticamente después de la duración especificada por la programación. En su lugar, Compute Engine retiene la instantánea de forma indefinida hasta que la borres manualmente.
- Claves de encriptación administradas por el cliente (CMEK): Si revocas la CMEK que protege una instantánea recuperable y, luego, recuperas la instantánea, no podrás usarla para crear un disco hasta que restablezcas la clave. Si no recuperas la instantánea antes de que venza el período de retención, Compute Engine la borrará de forma permanente.
- Se requiere recuperación antes de usar: Las instantáneas recuperables son de solo lectura. Para usar una instantánea recuperable y crear un disco, primero debes recuperar la instantánea estándar de la papelera de reciclaje.
Enumera las instantáneas recuperables
Para ver las instantáneas recuperables que se encuentran en un proyecto, usa la Cloud de Confiance consola, gcloud CLI o REST.
Consola de Cloud de Confiance
En la consola de Cloud de Confiance , ve a la página Instantáneas.
Haz clic en Papelera de reciclaje.
Haz clic en la pestaña Instantáneas borradas. Aparecerá la lista de instantáneas recuperables.
Cada columna muestra detalles sobre las instantáneas recuperables, incluidos los siguientes:
- Name: Es el nombre de la instantánea recuperable.
- Nombre de la instantánea original: Es el nombre de la instantánea estándar original.
- Hora de eliminación de la instantánea: Es la hora en la que se borró la instantánea estándar original.
- Hora de eliminación permanente: Es la hora en el futuro en la que Compute Engine borrará de forma permanente la instantánea recuperable.
gcloud CLI
Para enumerar todas las instantáneas de la papelera de reciclaje de un proyecto, usa el comando gcloud beta compute recoverable-snapshots list.
Para incluir información adicional sobre cada instantánea recuperable, usa la marca --format.
Por ejemplo, el siguiente comando enumera cada instantánea recuperable de un proyecto y muestra detalles sobre cada una de ellas:
gcloud beta compute recoverable-snapshots list \ --project=PROJECT_ID \ --format="yaml(name, creationTimestamp, purgeTimestamp, originalResource)"
Reemplaza PROJECT_ID por el ID del proyecto.
El resultado es una lista de las instantáneas recuperables del proyecto, similar a la siguiente:
creationTimestamp: '2026-09-01T11:13:50.716-07:00'
name: data-disk-snapshot-20260805-qlb6lyqw
purgeTimestamp: '2026-09-06T11:13:50.609-07:00'
originalResource:
...
name: data-disk-snapshot-20260805
...
sourceDisk: projects/my-project/global/disks/data-disk
---
creationTimestamp: '2026-09-01T12:13:50.229-07:00'
name: disk-snapshot-20260901191347-s0c24h1m
purgeTimestamp: '2026-09-06T12:13:50.070-07:00'
originalResource:
...
name: disk-snapshot-20260901191347
...
sourceDisk: projects/my-project/global/disks/my-disk
---
El resultado muestra las siguientes propiedades clave de cada instantánea recuperable:
name: Es el nombre de la instantánea recuperable. Para recuperar la instantánea, debes especificar este nombre si usas gcloud CLI o REST.creationTimestamp: Es la fecha y hora en que se borró la instantánea estándar original.purgeTimestamp: Es la fecha y hora futuras en las que Compute Engine borrará de forma permanente la instantánea recuperable.originalResource: Es un objeto que contiene detalles sobre la instantánea original, incluidos su nombre y disco de origen.
REST
Realiza una solicitud GET al método recoverableSnapshots list.
GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/
Reemplaza PROJECT_ID por el ID del proyecto.
El cuerpo de la respuesta JSON contiene una lista de las instantáneas recuperables del proyecto, similar a la siguiente:
{
"kind": "compute#recoverableSnapshotList",
"id": "projects/PROJECT_ID/global/recoverableSnapshots/",
"items": [
{
"name": "prod-test-snapshot-20260905053732-uj731vz4",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"id": "3004584137782651782",
"creationTimestamp": "2025-10-05T22:36:41.868-07:00",
"name": "prod-test-snapshot"
...
}
},
{
"kind": "compute#recoverableSnapshot",
"id": "8914891425536994162",
"name": "my-test-snapshot-20260906053732-uj731vz5",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"id": "39904584137782651782",
"creationTimestamp": "2026-08-05T22:36:41.868-07:00",
"name": "my-test-snapshot"
...
}
}
]
}
El resultado muestra las siguientes propiedades clave de cada instantánea recuperable:
name: Es el nombre de la instantánea recuperable. Para recuperar la instantánea, debes especificar este nombre si usas gcloud CLI o REST.creationTimestamp: Es la fecha y hora en que se borró la instantánea estándar original.purgeTimestamp: Es la fecha y hora futuras en las que Compute Engine borrará de forma permanente la instantánea recuperable.originalResource: Es un objeto que contiene detalles sobre la instantánea original, incluidos su nombre y disco de origen.
Busca una instantánea recuperable por el nombre de la instantánea original
Para encontrar una instantánea recuperable y poder recuperarla, puedes usar el nombre de la instantánea original. Las instantáneas recuperables tienen un nombre único que Compute Engine genera cuando borras la instantánea original.
Para encontrar el nombre de la instantánea recuperable, enumera las instantáneas recuperables y filtra por el nombre de la instantánea original.
Puedes usar la Cloud de Confiance consola, gcloud CLI o REST.
Consola de Cloud de Confiance
En la consola de Cloud de Confiance , ve a la página Instantáneas.
Haz clic en Papelera de reciclaje.
Haz clic en la pestaña Instantáneas borradas. Aparecerá la lista de instantáneas recuperables.
En el campo filter_list Filtro, haz clic en Ingresa el nombre o el valor de la propiedad. Selecciona Nombre de la instantánea original en la lista de propiedades.
Ingresa el nombre original de la instantánea en el campo Valor y presiona Intro.
La consola de Cloud de Confiance muestra una lista de instantáneas recuperables que tienen una instantánea original con un nombre que coincide con el que ingresaste.
gcloud CLI
Para encontrar una instantánea recuperable por su nombre original, usa el comando gcloud beta compute recoverable-snapshots list. Para filtrar por el nombre de la instantánea original, usa la marca --filter para la propiedad originalResource.name.
gcloud beta compute recoverable-snapshots list \ --project=PROJECT_ID \ --filter="originalResource.name:ORIGINAL_SNAPSHOT_NAME" \ --format="yaml(name, creationTimestamp, purgeTimestamp)"
Reemplaza lo siguiente por los valores correspondientes:
PROJECT_ID: el ID del proyectoORIGINAL_SNAPSHOT_NAME: Es el nombre original de la instantánea.
El resultado es una lista de las instantáneas recuperables que tienen una instantánea original con un nombre que coincide con el nombre de la instantánea original que ingresaste, similar a la siguiente:
creationTimestamp: '2026-09-01T11:13:50.716-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901181348-qlb6lyqw
purgeTimestamp: '2026-09-06T11:13:50.609-07:00'
---
creationTimestamp: '2026-09-01T12:13:50.229-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901191347-s0c24h1m
purgeTimestamp: '2026-09-06T12:13:50.070-07:00'
---
creationTimestamp: '2026-09-01T13:13:51.060-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901201348-ogybudsu
purgeTimestamp: '2026-09-06T13:13:50.904-07:00'
Para filtrar por la hora de creación o eliminación de la instantánea original, extiende la expresión --filter:
- Para filtrar por la hora de creación de la instantánea original, agrega una condición para
originalResource.creationTimestampa la expresión--filter. Por ejemplo, para encontrar las instantáneas recuperables de una instantánea original que se creó en un momento específico o después de este, haz lo siguiente:
--filter="originalResource.creationTimestamp >= 'CREATION_FILTER_TIMESTAMP' AND originalResource.name:ORIGINAL_SNAPSHOT_NAME"
Reemplaza lo siguiente:
ORIGINAL_SNAPSHOT_NAME: el nombre de la instantánea original.CREATION_FILTER_TIMESTAMP: Es la marca de tiempo del filtro, por ejemplo,2026-09-01T10:00:00. La marca de tiempo está en hora local.Para filtrar por la fecha en que se borró la instantánea original, agrega una condición para
creationTimestampa la expresión--filter. Por ejemplo, para encontrar las instantáneas recuperables de una instantánea original específica que se borró en un momento específico o después de este, haz lo siguiente:
--filter="creationTimestamp >= 'DELETION_FILTER_TIMESTAMP' AND originalResource.name:ORIGINAL_SNAPSHOT_NAME"
Reemplaza lo siguiente:
ORIGINAL_SNAPSHOT_NAME: el nombre de la instantánea original.DELETION_FILTER_TIMESTAMP: Es la marca de tiempo del filtro, por ejemplo,2026-09-01T10:00:00. La marca de tiempo está en hora local.
REST
Crea una solicitud GET al método recoverableSnapshots.list con el parámetro de consulta filter.
GET 'https://compute.s3nsapis.fr/compute/beta/projects/ PROJECT_ID/global/recoverableSnapshots?filter=originalResource.name:ORIGINAL_SNAPSHOT_NAME'
Reemplaza lo siguiente por los valores correspondientes:
PROJECT_ID: el ID del proyectoORIGINAL_SNAPSHOT_NAME: Es el nombre original de la instantánea.
El cuerpo de respuesta es una lista de las instantáneas recuperables cuyo nombre original coincide con el que ingresaste, similar a la siguiente:
{
"kind": "compute#recoverableSnapshotList",
"id": "projects/PROJECT_ID/global/recoverableSnapshots/",
"items": [
{
"kind": "compute#recoverableSnapshot",
"id": "8914891425536994161",
"name": "prod-test-snapshot-20261006053732-uj731vz4",
"creationTimestamp": "2026-10-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-10-12T22:37:32.918-07:00",
...
"originalResource": {
"name": "prod-test-snapshot",
...
}
}
]
}
Cada objeto del array items representa una instantánea recuperable y tiene las siguientes propiedades:
name: Es el nombre de la instantánea recuperable. Para recuperar la instantánea, debes especificar este nombre si usas gcloud CLI o REST.creationTimestamp: Es la fecha y hora en que se borró la instantánea estándar original.purgeTimestamp: Es la fecha y hora futuras en las que Compute Engine borrará de forma permanente la instantánea recuperable.originalResource: Es un objeto que contiene detalles sobre la instantánea original, incluidos su nombre y disco de origen.
Visualiza información sobre una instantánea recuperable
Para recuperar información detallada sobre una instantánea recuperable, como su instantánea de origen o la hora de creación, usa la Cloud de Confiance consola, la gcloud CLI o REST.
Para encontrar el nombre de una instantánea recuperable si solo tienes el nombre de la instantánea original, consulta Cómo encontrar el nombre de una instantánea recuperable.
Consola de Cloud de Confiance
En la consola de Cloud de Confiance , ve a la página Instantáneas.
Haz clic en Papelera de reciclaje.
En la pestaña Deleted Snapshots, consulta la lista de instantáneas recuperables.
Cada columna muestra detalles sobre una instantánea recuperable, incluidos los siguientes:
- Nombre: Es el nombre de la instantánea recuperable.
- Nombre de la instantánea original: Es el nombre de la instantánea estándar original.
- Hora de eliminación de la instantánea: Es la hora en la que se borró la instantánea estándar original.
- Hora de eliminación permanente: Es la hora en el futuro en la que Compute Engine borrará de forma permanente la instantánea recuperable.
gcloud CLI
Para ver información sobre una instantánea recuperable, usa el comando gcloud beta compute recoverable-snapshots describe.
gcloud beta compute recoverable-snapshots describe RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Reemplaza lo siguiente por los valores correspondientes:
RECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.PROJECT_ID: el ID del proyecto
El resultado es una descripción de la instantánea recuperable, similar a la siguiente:
creationTimestamp: '2026-09-01T13:13:51.626-07:00'
id: '2573728532034916112'
kind: compute#recoverableSnapshot
name: prod-test-snapshot-uj731vz4
originalResource:
name: prod-test-snapshot
...
storageBytesStatus: UP_TO_DATE
storageLocations:
- us
purgeTimestamp: '2026-09-06T13:13:51.493-07:00'
selfLink: ..
status: READY
El resultado incluye las siguientes propiedades clave de la instantánea recuperable:
name: Es el nombre de la instantánea recuperable. Para recuperar la instantánea, debes especificar este nombre si usas gcloud CLI o REST.creationTimestamp: Es la fecha y hora en que se borró la instantánea estándar original.purgeTimestamp: Es la fecha y hora futuras en las que Compute Engine borrará de forma permanente la instantánea recuperable.originalResource: Es un objeto que contiene detalles sobre la instantánea original, incluidos su nombre y disco de origen.
REST
Para ver información sobre una instantánea recuperable, realiza una solicitud GET al método recoverableSnapshots.get.
GET 'https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME'
Reemplaza lo siguiente por los valores correspondientes:
PROJECT_ID: Es el ID del proyecto que contiene la instantánea recuperable.RECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.
La respuesta es similar a lo que se muestra a continuación:
{
"name": "prod-test-snapshot-uj731vz4",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"name": "prod-test-snapshot",
...
}
}
El cuerpo de la respuesta incluye las siguientes propiedades clave de la instantánea recuperable:
name: Es el nombre de la instantánea recuperable. Para recuperar la instantánea, debes especificar este nombre si usas gcloud CLI o REST.creationTimestamp: Es la fecha y hora en que se borró la instantánea estándar original.purgeTimestamp: Es la fecha y hora futuras en las que Compute Engine borrará de forma permanente la instantánea recuperable.originalResource: Es un objeto que contiene detalles sobre la instantánea original, incluidos su nombre y disco de origen.
Cómo recuperar instantáneas borradas
Antes de recuperar una instantánea, ten en cuenta lo siguiente:
- Persistencia de etiquetas: Las etiquetas adjuntas a una instantánea antes de que se borre no se conservan si la instantánea se recupera de la papelera de reciclaje. Debes volver a agregar las etiquetas a la instantánea después de recuperarla de la papelera de reciclaje.
- Instantáneas programadas: Si recuperas una instantánea que se creó originalmente según una programación, la instantánea ya no formará parte de la programación y no se borrará automáticamente después de la duración especificada por la programación. En su lugar, Compute Engine retiene la instantánea de forma indefinida hasta que la borres manualmente.
- Conflictos de nombres: La recuperación de una instantánea fallará si ya existe una instantánea estándar con el mismo nombre y no proporcionas un nombre nuevo para la instantánea recuperada. Para recuperar una instantánea de este tipo, debes usar Google Cloud CLI o REST para especificar un nombre nuevo.
- Las instantáneas recuperables persisten después de la recuperación: La recuperación de una instantánea no borra la instantánea recuperable de la papelera de reciclaje. La instantánea recuperable persiste en la papelera de reciclaje hasta que vence el período de retención.
- Nueva fecha y hora de creación de la instantánea recuperada: Cuando recuperas una instantánea, la fecha y hora de creación de la instantánea estándar son las del momento en que la recuperaste de la papelera de reciclaje, y no las del momento en que se creó originalmente.
Cómo recuperar una instantánea de la papelera de reciclaje
Para recuperar una instantánea borrada y poder usarla para crear un disco nuevo, primero debes encontrar el nombre de la instantánea recuperable. Para ello, sigue las instrucciones que se indican en Cómo encontrar el nombre de una instantánea recuperable.
Cuando conozcas el nombre de la instantánea recuperable, usa la Cloud de Confiance consola, gcloud CLI o REST para recuperarla.
Consola de Cloud de Confiance
En la consola de Cloud de Confiance , ve a la página Instantáneas.
Haz clic en Papelera de reciclaje.
Haz clic en la pestaña Instantáneas borradas. Aparecerá la lista de instantáneas recuperables.
Selecciona la instantánea que deseas recuperar.
Haz clic en restore_from_trash Recuperar.
gcloud CLI
Para recuperar una instantánea, usa el comando gcloud beta compute recoverable-snapshots recover.
Para recuperar una instantánea y conservar su nombre original, haz lo siguiente:
gcloud beta compute recoverable-snapshots recover \ RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Reemplaza lo siguiente por los valores correspondientes:
RECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.PROJECT_ID: el ID del proyecto
Para recuperar una instantánea y especificar un nombre nuevo para la instantánea recuperada, especifica el nombre nuevo con la marca
--snapshot-name.gcloud beta compute recoverable-snapshots recover \ RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID \ --snapshot-name=NEW_SNAPSHOT_NAME
Reemplaza lo siguiente por los valores correspondientes:
RECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.PROJECT_ID: el ID del proyectoNEW_SNAPSHOT_NAME: Es el nombre nuevo de la instantánea recuperada.
REST
Para recuperar una instantánea, realiza una solicitud POST al método recoverableSnapshots.recover.
POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME/recover
Reemplaza lo siguiente por los valores correspondientes:
PROJECT_ID: el ID del proyectoRECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.
Para recuperar una instantánea y especificar un nombre nuevo para la instantánea recuperada, especifica el nombre nuevo con el campo snapshotName en el cuerpo de la solicitud:
{
"snapshotName": "NEW_SNAPSHOT_NAME"
}
Reemplaza NEW_SNAPSHOT_NAME por el nuevo nombre de la instantánea recuperada.
Para crear un disco a partir de la instantánea recuperada, consulta Crea un disco a partir de una instantánea.
Para agregar etiquetas que se adjuntaron a la instantánea estándar original, consulta Cómo agregar etiquetas a un recurso.
Borra una instantánea recuperable
Puedes borrar de forma permanente una instantánea de la papelera de reciclaje antes de que venza su período de retención con la Cloud de Confiance consola, la gcloud CLI o REST.
Consola de Cloud de Confiance
En la consola de Cloud de Confiance , ve a la página Instantáneas.
Haz clic en Papelera de reciclaje.
En la pestaña Instantáneas borradas, selecciona la instantánea que quieras borrar de forma permanente.
Haz clic en BorrarBorrar definitivamente.
gcloud CLI
Para borrar de forma permanente una instantánea recuperable, usa el comando gcloud beta compute recoverable-snapshots delete.
gcloud beta compute recoverable-snapshots delete RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Reemplaza lo siguiente por los valores correspondientes:
RECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.PROJECT_ID: el ID del proyecto
REST
Para borrar de forma permanente una instantánea recuperable, realiza una solicitud DELETE al método recoverableSnapshots.delete.
DELETE https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME
Reemplaza lo siguiente por los valores correspondientes:
PROJECT_ID: el ID del proyectoRECOVERABLE_SNAPSHOT_NAME: Es el nombre de la instantánea recuperable.