Listado de todas las instantáneas en la consola

En la consola, puede ver una lista de todas las instantáneas que ha creado, con la más reciente al principio de la lista. Puede filtrar la lista para ver instantáneas específicas.

1. En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Almacenamiento > Block Storage instantáneas para VPC. La página tiene dos pestañas principales: grupo de consistencia de instantáneas e instantáneas.

2. Selecciona la pestaña Snapshots. Las instantáneas se listan para una región específica. Si desea ver instantáneas en otra región, pulse la flecha para expandir la lista y seleccionar una región diferente. Por defecto, las instantáneas más recientes se muestran al principio de la lista.

3. A medida que crece la lista de instantáneas, utilice el filtro para indicar el número de instantáneas que se mostrarán por página. Utilice las flechas de navegación de la página para avanzar y retroceder en la lista.

La tabla 1 describe la información de todas las instantáneas que aparece en la lista de instantáneas.

Pulse el icono de valores para visualizar los campos opcionales que puede añadir a la tabla.

Al pulsar el icono Acciones , puede visualizar un menú de acciones específicas del contexto.

• Renombrar
• Copiar UUID.
• Copiar CRN.
• Crear volumen.
• Crear copia instantánea.
• Comparte una instantánea.
• Gestionar los permisos de uso compartido.
• Editar restauración rápida.
• Suprimir.
• Suprimir todas las instantáneas de un volumen.

También puede ver una lista de todas las instantáneas creadas a partir de un volumen de Block Storage for VPC desde la página de detalles del volumen. Para obtener más información, consulte Ver todas las instantáneas que se crearon a partir del Block Storage for VPC volumen.

Visualización de los detalles de la instantánea en la consola

Para ver información detallada sobre una instantánea, localice la instantánea en la lista de instantáneas de Block Storage para VPC. A continuación, haz clic en el nombre de una instantánea. La página de detalles muestra el nombre de la instantánea, su estado y los códigos de usuario adjuntos en el título.

El panel de detalles de instantánea muestra la información que se describe en la tabla siguiente.

Detalles de instantánea

Campo	Descripción
Nombre	El nombre de la instantánea, que puede cambiar pulsando el icono Editar . Para obtener más información, consulte Denominación de instantáneas.
ID de instantánea	GUID de la instantánea que se puede copiar.
De arranque	Sí o No.
CRN	CRN de la instantánea que se puede copiar.
Grupo de recursos	Grupo de recursos definido al configurar la VPC.
Fecha de creación	Fecha y hora de inicio del proceso de creación de recursos de la instantánea.
Fecha de obtención	Fecha y hora en que se capturó esta instantánea.
Creado por	Este campo muestra User o Backup policy. Si la instantánea se crea mediante una política de copia de seguridad, la interfaz de usuario también muestra el nombre del plan de copia de seguridad que ha creado la instantánea de copia de seguridad.
Tamaño	Tamaño en GB de la instantánea, heredado del volumen de origen.
Volumen de origen	Volumen de origen del que se tomó la primera instantánea. Pulse el enlace para obtener detalles de volumen. Si el volumen se ha suprimido, el nombre aparece sin un enlace.
Cifrado	Cifrado gestionado por el proveedor o gestionado por el cliente. Para el cifrado gestionado por el cliente, se muestran la instancia de KMS, el nombre de clave raíz y el ID de clave raíz.
Generación	Este valor es Gen 1 o Gen 2 en función del perfil de volumen del volumen de origen.
Expresión de servidor virtual	La expresión de uso permitido define y restringe con qué perfiles de servidor virtual es compatible la instantánea de arranque. Cuando se aprovisiona una instancia de servidor virtual utilizando la instantánea, la expresión se compara con las propiedades de instancia solicitadas. Para obtener más información, consulte Adición de expresiones de uso permitido a imágenes personalizadas.
Panel de restauración rápida	Utilice restauración rápida para crear un volumen a partir de esta instantánea que se haya suministrado completamente. Pulse Editar para habilitar o inhabilitar la restauración rápida en una zona.
Panel Grupo de consistencia	Muestra información sobre el grupo de consistencia del que es miembro la instantánea. Pulse Crear servidor virtual para restaurar volúmenes del grupo de consistencia.

Al pulsar el icono Acciones , puede visualizar un menú de acciones específicas del contexto.

• Crear un volumen a partir de la instantánea
• Editar restauración rápida o suprimir una instantánea.

Listado de todos los grupos de coherencia de instantáneas en la consola

En la consola, puede ver una lista de todos los grupos de consistencia que ha creado, con el más reciente al principio de la lista. Puedes filtrar la lista para ver grupos de coherencia específicos.

1. En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Almacenamiento > Block Storage instantáneas para VPC. La página tiene dos pestañas principales: grupo de consistencia de instantáneas e instantáneas.

2. Seleccione el separador Grupo de consistencia de instantáneas. Los grupos se listan para una región específica. Si desea ver grupos de consistencia en otra región, pulse la flecha para expandir la lista y seleccionar una región diferente. De forma predeterminada, los grupos de instantáneas más recientes se muestran al principio de la lista.

3. A medida que aumente tu lista de grupos de coherencia, utiliza el filtro para indicar el número de elementos que deseas mostrar por página. Utilice las flechas de navegación de la página para avanzar y retroceder en la lista.

La tabla siguiente describe la información de todos los grupos de consistencia de la lista.

Pulse el icono de valores para visualizar los campos opcionales que puede añadir a la tabla.

Al pulsar el icono Acciones , puede visualizar un menú de acciones específicas del contexto.

• Renombrar
• Copiar UUID
• Copia el nombre del recurso en la nube (CRN).
• Crear servidor virtual
• Suprimir

Visualización de los detalles de un grupo de coherencia en la consola

Para ver información detallada sobre un grupo de consistencia, localice el grupo en la lista de instantáneas de Block Storage para VPC. A continuación, pulse el nombre de un grupo de consistencia.

La sección de visión general proporciona detalles sobre el grupo de consistencia y la instancia de servidor virtual de la que se han tomado las instantáneas del grupo de consistencia. El primer panel contiene información sobre el grupo de consistencia.

Visión general del grupo de coherencia.

Campo	Descripción
Nombre	El nombre único del grupo de consistencia. Si desea actualizarlo, pulse el icono Editar .
ID de grupo de consistencia	Este campo muestra la serie de ID del grupo de consistencia.
CRN	Nombre de recurso de nube del grupo de consistencia.
Creado por	El campo muestra user para una instantánea creada manualmente o una política de copia de seguridad para instantáneas automatizadas.
Grupo de recursos	El grupo de recursos al que pertenece el grupo de coherencia.
Fecha de creación	Muestra la fecha en la que se creó el grupo de consistencia.
Suprimir miembros de instantánea	Muestra si las instantáneas se suprimen o se conservan cuando se suprime el grupo de consistencia. Pulse el conmutador para cambiar el estado.
Región	La región de VPC en la que se ha creado el grupo de consistencia.

Para obtener más información, consulte Gestión de grupos de consistencia de instantáneas.

El segundo panel contiene información sobre la instancia de servidor virtual a la que están conectados los volúmenes de origen del conjunto de instantáneas.

La lista Instantáneas muestra las instantáneas dentro del grupo de consistencia y proporciona la misma información y acciones tal como se describe en la Tabla 1.

Antes de empezar

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

Inicia sesión en IBM Cloud®.

ibmcloud login --sso -a cloud.ibm.com

Este mandato devuelve un URL y solicita un código de acceso. Vaya a ese URL en el navegador e inicie la sesión. Si se ejecuta correctamente, recibe un código de acceso de un solo uso. Copie este código de acceso y péguelo como respuesta en la solicitud. Después de una autenticación correcta, se le solicitará que elija su cuenta. Si tiene acceso a varias cuentas, seleccione la cuenta con la que desea iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Visualización de todas las instantáneas de una cuenta en una región desde la CLI

Ejecute el mandato snapshots para listar todas las instantáneas. El siguiente ejemplo proporciona una lista de todas las instantáneas de todos los grupos de recursos de la región us-south.

ibmcloud is snapshots [--json]

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name             Status   Source volume                               Bootable   Resource group   Created                     Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-22db5609-69a1-4fe2-bd02-f64fb11230b3   my-test-snapshot stable   r006-ccbc5bc6-cd88-48e0-9a1d-de0f4d024324   true       defaults         2025-07-31T00:04:24+00:00   -                          -                       1
r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   my-test-snap-1   stable   r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   true       defaults         2025-08-06T22:38:01+00:00   -                          -                       1

Para obtener más información sobre las opciones de mandato de instantánea disponibles, consulte ibmcloud is snapshots.

Visualización de todas las instantáneas de un volumen desde la CLI

Ejecute el comando snapshots y especifique el ID de volumen.

ibmcloud is snapshots --volume VOLUME-ID [--json]

El ejemplo siguiente muestra las tres instantáneas que se han tomado del volumen r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa.

ibmcloud is snapshots --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa

Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                             Status   Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant   stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146   cli-snapshot-test                stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      defaults         2023-02-17T20:15:43+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                 stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshots.

Visualización de todas las instantáneas en un grupo de consistencia desde la CLI

Ejecute el mandato snapshots y especifique el ID, nombre o CRN del grupo de consistencia.

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

El ejemplo siguiente utiliza el ID del grupo de consistencia para listar las instantáneas que son miembros del conjunto.

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshots.

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshots.

Cómo consultar los detalles de una instantánea desde la CLI

Ejecute el comando snapshot y especifique el ID de la instantánea.

ibmcloud is snapshot SNAPSHOTS_ID [--json]

El ejemplo siguiente muestra los detalles de una instantánea arrancable en la región us-south.

ibmcloud is snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6

Getting snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6 under account Test Account as user test.user@ibm.com...
ID                              r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Name                            my-test-snap-1
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Status                          stable
Clones                          Zone   Available   Created
Source volume                   ID                                          Name               Remote Region   CRN                                                                                                                        Resource type
                                r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   test-volume-fast   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   volume
Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        10
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-cec640a3-615e-4364-bae7-d3642d9f9e34   ibm-ubuntu-22-04-5-minimal-amd64-4   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-cec640a3-615e-4364-bae7-d3642d9f9e34   image
Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)
Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                         2025-08-06T22:38:01+00:00
Captured at                     2025-08-06T22:38:02+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-07-17
Allowed Use Bare Metal Server   true
Allowed Use Instance            true

Las propiedades de allowed-used se heredan del volumen de origen o instantánea en el momento de la creación. Puede cambiar su valor en el momento de la creación o más tarde si está autorizado al rol IAM is.snapshot.snapshot.manage-allowed-use. Las propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión de instancia se evalúa como true, se permite el aprovisionamiento de una instancia de servidor virtual con la instantánea. Cuando la expresión se evalúa como false, la provisión se bloquea. Si no se especifica el valor en el momento de la creación, las expresiones de restricción se toman del recurso fuente.

El ejemplo siguiente muestra los detalles de una instantánea no arrancable en la región eu-de, que también tiene un clon de restauración rápida en la zona eu-de-1.

ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
ID                         r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name                       cli-snapshot-test
CRN                        crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status                     stable
Clones                     Zone      Available   Created
                           eu-de-1   true        2023-02-17T20:15:46+00:00
Source volume              ID                                          Name
                           r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   block-test1
Bootable                   false
Encryption                 provider_managed
Encryption key             -
Minimum capacity(GB)       20
Size(GB)                   1
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group
Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshots.

Visualización de todos los clones de instantánea de restauración rápida desde la CLI

Puede listar todos los clones de restauración rápida disponibles de una instantánea emitiendo el mandato ibmcloud is snapshot-clones. El ejemplo siguiente lista los clones de instantánea de restauración rápida disponibles de la instantánea que tiene el ID de r138-4463eb2c-4913-43b1-b9bf-62a94f74c146.

ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Listing zonal clones of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone      Available   Created
eu-de-1   true        2023-02-17T20:15:46+00:00
eu-de-3   true        2023-02-17T20:29:21+00:00

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshot-clones.

Visualización de detalles de un clon de instantánea de restauración rápida desde la CLI

Puede ejecutar el mandato ibmcloud is snapshot-clone para listar los detalles de un clon de instantánea de restauración rápida específico. El siguiente ejemplo muestra cómo enumerar los detalles del clon de instantánea de restauración rápida de la instantánea r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 que se encuentra en la zona de eu-de-3.

ibmcloud is snapshot-clone r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3

Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone        eu-de-3
Available   true
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshot-clone.

Visualización de detalles de una copia de instantánea de región remota desde la CLI

Puede ejecutar el comando ibmcloud is snapshot para obtener una lista de los detalles de una copia de instantánea de región remota específica. El siguiente ejemplo muestra cómo listar los detalles de la instantánea de la región remota (my-cli-snapshot-crc) que se encuentra en la región us-south. La respuesta proporciona información sobre la instantánea padre (cli-snap-crc-test), el volumen padre y también la política de copia de seguridad que creó la instantánea.

ibmcloud is snapshot my-cli-snapshot-crc

Getting snapshot my-cli-snapshot-crc-target under account Test Account as user test.user@ibm.com...
ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created
Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume
Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan
Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot
Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

Visualización de todos los grupos de consistencia de instantánea desde la CLI

Ejecute el mandato snapshot-consistency-groups para listar todos los grupos de consistencia de una región.

ibmcloud is snapshot-consistency-groups

Nuevo: si lo deseas, puedes filtrar los resultados de la consulta por el ID de una tarea de copia de seguridad. Filtrar por ID de tarea de copia de seguridad puede resultar útil cuando se desea restaurar una instancia recuperando volúmenes de dos grupos de consistencia de instantáneas de copia de seguridad que se crearon porque la instancia original tenía conectados volúmenes de primera y segunda generación.

ibmcloud is snapshot-consistency-groups --backup-policy-job BACKUP_POLICY_JOB_ID

Véase el siguiente ejemplo de resultado:

Listing snapshot consistency groups in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                      Name                           Backup policy job                      Backup policy plan                 Snapshots count   Lifecycle State   Service Tags                                               Resource group
r006-687c49cb-13ad-4dd8-9d04-0e264baa99a1  test-cli-2-4a3286e405b-4d3b  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  1                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc  test-cli-2-f4690eb88143-441a  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  2                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is snapshot-consistency-groups.

Visualización de detalles de un grupo de consistencia de instantáneas desde la CLI

Ejecute el mandato snapshot-consistency-group para listar los detalles de un grupo de consistencia específico en una región.

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

[Nuevo] :{: tag-green} Ejemplo de salida que muestra información sobre la tarea y el plan de la política de copias de seguridad:

Getting snapshot consistency group r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc under account Test Account as user test.user@ibm.com...
ID
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Name
test-cli-2-f4690eb88143-441a
CRN
crn:v1:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Href
https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Status
stable
Backup policy job
ID                                   Resource type
r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36   backup_policy_job
Backup policy plan
ID                                   Name        Resource type
r006-ee0bddb-17b9-4279-8d1a-802afe9104da   test-cli-2   backup_policy_plan
Delete snapshot on delete
true
Source Snapshot
ID                                   Name                          Remote Region   CRN                                                                                                           Resource type
r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   test-cli-2-c01a2ef47cd3-4202              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   snapshot
r006-388f4bb7-cdd2-4e60-b57e-690066412d45   test-cli-2-12524f129f23-4fbc              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-388f4bb7-cdd2-4e60-b57e-690066412d45   snapshot
Resource group
ID                                   Name
11caaa983d9c4beb82690daadb08717e9     Default
Created
2026-05-05T21:42:30+05:30
Service Tags
is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d

Para obtener más información sobre las opciones de comando disponibles, consulte ibmcloud is snapshot-consistency-group.

Listado de todas las instantáneas mediante la API

Puede listar mediante programación todas las instantáneas de los volúmenes llamando al método /snapshots en la API de VPC tal como se muestra en la siguiente solicitud de ejemplo. De forma predeterminada, la lista muestra primero las instantáneas más recientes, seguidas de las instantáneas más antiguas en orden descendente.

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: Bearer $iam_token"

Puede filtrar la lista utilizando el ID del grupo de recursos, el ID del volumen de origen o el CRN del volumen de origen, y filtrar aún más los resultados utilizando las siguientes opciones:

• Limit: controlar el número de instantáneas visualizadas en una página.
• Start: especificar qué instantánea (por ID) para iniciar la lista.
• Ordenar: para controlar el orden en el que ordena la página; por ejemplo, por fecha de creación o alfabéticamente por nombre de instantánea.

Por ejemplo, la siguiente llamada filtra la lista para mostrar las instantáneas creadas para un único volumen y limita los resultados a cinco por página.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

Detalles de una instantánea mediante la API

Puede recuperar mediante programación los detalles de una única instantánea llamando al método /snapshots en la API de VPC y especificando el ID de instantánea tal como se muestra en la siguiente solicitud de ejemplo.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

• Las propiedades de allowed-used se heredan del volumen de origen o instantánea en el momento de la creación. Puede cambiar su valor en el momento de la creación o más tarde si está autorizado al rol IAM is.snapshot.snapshot.manage-allowed-use. Las propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión de instancia se evalúa como true, se permite el aprovisionamiento de una instancia de servidor virtual con la instantánea. Cuando la expresión se evalúa como false, la provisión se bloquea. Si no se especifica el valor en el momento de la creación, las expresiones de restricción se toman del recurso fuente.

Visualización de todos los clones de instantánea de restauración rápida con la API

Puede listar mediante programación todos los clones de restauración rápida llamando al método /snapshots/clones en la API de VPC y especificando el ID de instantánea tal como se muestra en la siguiente solicitud de ejemplo.

Realice una solicitud GET /v1/snapshots/{id}/clones para listar todos los clones de instantánea de restauración rápida.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una respuesta satisfactoria proporciona información sobre los clones de instantánea de restauración rápida.

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

Visualización de detalles de un clon de instantánea de restauración rápida con la API

Puede recuperar mediante programación los detalles de un único clon de restauración rápida llamando al método /snapshots/clones en la API de VPC y especificando el ID de instantánea y la zona tal como se muestra en la siguiente solicitud de ejemplo.

Realice una solicitud GET /v1/snapshots/{id}/clones/{zone-name} para recuperar un único clon de instantánea de restauración rápida especificado por ID y nombre de zona.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una respuesta satisfactoria muestra la siguiente información sobre el clon de instantánea de restauración rápida.

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Visualización de detalles de una copia de instantánea de región remota con la API

Puede recuperar mediante programación los detalles de una única instantánea llamando al método /snapshots en la API de VPC y especificando el ID de instantánea tal como se muestra en la siguiente solicitud de ejemplo.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una respuesta satisfactoria muestra información similar a la del ejemplo siguiente.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "gpu_supported": [],
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "region": "us-east",
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "name": "ibm-ubuntu-20-04-minimal-amd64-1"
  },
  "source_snapshot": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-snapshot-data"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

Visualización de todos los grupos de consistencia de instantánea con la API

Puede listar mediante programación todos los grupos de consistencia llamando al método /snapshot_consistency_groups en la API de VPC tal como se muestra en la siguiente solicitud de ejemplo.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

Nuevo: si lo deseas, puedes filtrar los resultados de la consulta por el ID de una tarea de copia de seguridad. Filtrar por ID de tarea de copia de seguridad puede resultar útil cuando se desea restaurar una instancia recuperando volúmenes de dos grupos de consistencia de instantáneas de copia de seguridad que se crearon porque la instancia original tenía conectados volúmenes de primera y segunda generación.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"\
-d '{
      "backup_policy_job_id":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Visualización de detalles de un grupo de consistencia de instantánea con la API

Puede recuperar mediante programación los detalles de un grupo de consistencia llamando al método /snapshot_consistency_groups en la API de VPC tal como se muestra en la siguiente solicitud de ejemplo.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

Listado de todas las instantáneas con Terraform

Importar los detalles de una colección de instantáneas como un origen de datos de sólo lectura. Puede filtrar la colección de instantáneas por source_volume, resource_group, name, etc.

data "ibm_is_snapshots" "example" {
}

Para obtener más información, consulte ibm_is_snapshots.

Listado de detalles de una instantánea con Terraform

Importar los detalles de una instantánea como un origen de datos de sólo lectura. Puede especificar el ID de instantánea o el nombre de instantánea.

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}

• Las propiedades de allowed-used se heredan del volumen de origen o instantánea en el momento de la creación. Puede cambiar su valor en el momento de la creación o más tarde si está autorizado al rol IAM is.snapshot.snapshot.manage-allowed-use. Las propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión de instancia se evalúa como true, se permite el aprovisionamiento de una instancia de servidor virtual con la instantánea. Cuando la expresión se evalúa como false, la provisión se bloquea. Si no se especifica el valor en el momento de la creación, las expresiones de restricción se toman del recurso fuente.

Para obtener más información, consulte ibm_is_snapshot.

Listado de todos los clones de instantánea de restauración rápida

Importar los detalles de todos los clones de restauración rápida de una instantánea como un origen de datos de sólo lectura.

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

Para obtener más información, consulte ibm_is_snapshot_clones.

Listado de detalles de un clon de restauración rápida con Terraform

Importar los detalles del clon de restauración rápida de una instantánea en una zona como un origen de datos de sólo lectura.

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

Para obtener más información, consulte ibm_is_snapshot_clone.

Listado de todos los grupos de consistencia con Terraform

Importar los detalles de una colección de grupos de consistencia como un origen de datos de sólo lectura.

data "ibm_is_snapshot_consistency_groups" "example" {
}

Para obtener más información, consulte ibm_is_consistency_groups.

Listado de detalles de un grupo de consistencia con Terraform

Importar los detalles de un grupo de consistencia de instantánea como un origen de datos de sólo lectura. Puede especificar el grupo de consistencia mediante el ID o el nombre del grupo de consistencia.

data "ibm_is_snapshot_consistency_group" "example 1" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}

data "ibm_is_snapshot_consistency_group" "example 2" {
  name = "my-data-consistency-group"
}

[Nuevo] :{: tag-green}. También puedes filtrar la colección por grupos de consistencia de instantáneas mediante la propiedad backup_policy_job.id. Vea el ejemplo siguiente.

data "ibm_is_snapshot_consistency_groups" "example 3" {
    backup_policy_job = "r006-fc4b7fbc-38af-45d9-9fb6-bf0533acbfc4"
}

Para obtener más información, consulte ibm_is_consistency_group.