Gestión de instantáneas de Block Storage for VPC

Gestiona las instantáneas de « Block Storage for VPC » cambiando su nombre, asignándoles etiquetas, activando la restauración rápida, eliminándolas y comprobando su acceso y estado.

Denominación de instantáneas

Considere la posibilidad de nombrar la instantánea para indicar el volumen que se ha copiado. Por ejemplo, my-volume sería my-volume-snapshot1. Además, para una identificación rápida, considere la posibilidad de nombrar los volúmenes de arranque prefijándoles boot como, por ejemplo, boot_my-volume-snapshot1. A medida que crece la lista de instantáneas, puede identificar rápidamente el nombre y el tipo de volumen a partir del cual ha creado la instantánea.

Los nombres de instantánea se ajustan a los mismos requisitos que los nombres de volumen. Los nombres válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de instantánea deben empezar por una letra minúscula y deben ser exclusivos en la VPC. La interfaz de usuario proporciona la comprobación de nombres por comodidad. Por ejemplo, si finaliza un nombre de instantánea con un guión (-), la interfaz de usuario le notifica del error. También comprueba si hay nombres duplicados.

Cuando crea una copia entre regiones de una instantánea, la nueva instantánea se denomina [copy]-[source-snapshot-name]. Por ejemplo, una copia entre regiones de snapshot-my-volume-snapshot1_ se denomina automáticamente copy-my-volume-snapshot1 cuando se coloca en la región de destino. Las copias entre regiones de las instantáneas son independientes de la instantánea de origen y del volumen de origen, y las copias se pueden gestionar como cualquier otra instantánea normal.

Cambiar el nombre de una instantánea en la consola

Sigue estos pasos para cambiar el nombre de una instantánea en la consola.

Vaya a la lista de instantáneas. En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
Pulse el nombre de una instantánea de la lista.
Pulse el icono Editar .
Proporcione un nombre nuevo para la instantánea, guarde y confirme los cambios.

Cambiar el nombre de una instantánea desde la CLI

Requisitos previos para emitir mandatos desde la CLI

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 tienes acceso a varias cuentas, selecciona la cuenta con la que quieras iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Cambiar el nombre de una instantánea desde la CLI

Puedes cambiar el nombre de una instantánea desde la CLI.

Para cambiar el nombre de una instantánea, emita el mandato ibmcloud is snapshot-update y proporcione el ID de instantánea y el nuevo nombre.

ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME

Vea el ejemplo siguiente.

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   -

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

Cambio de la propiedad Allowed Use de una instantánea desde la CLI

Las propiedades de Allowed Use se heredan del volumen padre. Puede utilizar el comando ibmcloud is snapshot-update para cambiar estos valores.

Debe tener el rol IAM is.volume.volume.manage-allowed-use para cambiar estas propiedades de una instantánea.

ibmcloud is snapshot-update r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 --allowed-use-api-version "2025-03-03" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true

Updating snapshot r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 under account Test Account as user test.user@ibm.com...

ID                              r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Name                            my-bootable-snapshot
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Status                          stable
Clones                          Zone   Available   Created

Source volume                   ID                                          Name                         Remote Region   CRN                                                                                                                        Resource type
                                r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   fence-denture-mosaic-royal   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   volume

Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        1
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-d734b459-b5a0-4777-8600-9fa3254d2cea   ibm-ubuntu-24-04-6-minimal-amd64-2   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-d734b459-b5a0-4777-8600-9fa3254d2cea   image

Operating system                Name                 Vendor      Version                                  Family         Architecture   Display name
                                ubuntu-24-04-amd64   Canonical   24.04 LTS Noble Numbat Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 24.04 LTS Noble Numbat Minimal Install (amd64)

Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                         2025-02-17T17:08:15+00:00
Captured at                     2025-02-17T17:08:15+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-03-03
Allowed Use Bare Metal Server   enable_secure_boot==true
Allowed Use Instance            true

Las propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión se evalúa como true, se permite el aprovisionamiento de una instancia de servidor virtual o un servidor bare metal con la instantánea. Cuando la expresión se evalúa como false, se bloquea la provisión.

Cambiar el nombre de una instantánea mediante la API

Puede cambiar el nombre de una instantánea utilizando la API.

Realiza una llamada a PATCH /snapshots e indica el ID de la instantánea y el nuevo nombre de la misma.

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

Puede utilizar la misma llamada para cambiar el nombre de una copia entre regiones. La copia entre regiones es independiente de la instantánea de origen y del volumen de origen, y se puede gestionar como cualquier otra instantánea.

Actualización de una instantánea con Terraform

Para utilizar Terraform, descargue Terraform CLI y configure el complemento IBM Cloud Provider. Para obtener más información, consulte Cómo empezar con Terraform.

Los servicios de infraestructura de VPC utilizan un punto final regional específico, que se dirige a us-south de forma predeterminada. Si la VPC se crea en otra región, asegúrese de que el destino sea la región adecuada en el bloque de proveedor en el archivo provider.tf.

Consulte el ejemplo siguiente de destino de una región que no sea la predeterminada us-south.

provider "ibm" {
  region = "eu-de"
}

Para actualizar una instantánea, utilice el recurso ibm_is_snapshot. Puede cambiar el nombre de la instantánea, las zonas de restauración rápida y las etiquetas. Sin embargo, cambiar los valores resource_group y source_volume obliga a Terraform a eliminar la instantánea y crear una instantánea diferente.

resource "ibm_is_snapshot" "example" {
  name          = "my-snapshot"
  source_volume = ibm_is_volume.example.id
  }

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_snapshot.

Compartir una instantánea con otra cuenta en la consola

Puedes compartir una instantánea con otra cuenta de la consola.

Vaya a la lista de instantáneas. En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
En el menú Acciones , seleccione Compartir instantánea.
Introduzca el ID de la cuenta con la que desea compartir la instantánea.
Haga clic en Crear una autorización IAM personalizada.

Como alternativa, puede crear una autorización de servicio a servicio a través del menú Administrar > Acceso (IAM) > Autorizaciones. Para obtener más información, consulte Creación de autorización de servicio a servicio para la restauración entre cuentas en la consola.

Gestión de los permisos de compartición de una instantánea en la consola.

Vaya a la lista de instantáneas. En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
En el menú Acciones , seleccione Gestionar permiso para compartir.
El panel lateral muestra la lista de cuentas con las que has compartido tu instantánea.

La lista muestra todas las autorizaciones configuradas para la instantánea. Por ejemplo, si una cuenta tiene una autorización para esta instantánea específica y una autorización para todas las instantáneas de su cuenta, esa cuenta aparece dos veces en la lista.
Haga clic en Gestionar autorización de IAM para ir a la página Autorización y modificar o revocar la autorización.

Como alternativa, puede gestionar una política de autorización de servicio a servicio directamente a través del menú Gestión > Acceso (IAM) > Autorizaciones. Para obtener más información, consulte Uso de autorizaciones para otorgar acceso entre servicios.

Compartir una instantánea con otra cuenta desde la CLI

Puede crear una autorización de servicio a servicio para una instantánea específica desde la CLI utilizando el comando ibmcloud iam authorization-policy-create. Para obtener más información, consulte Creación de la autorización de servicio a servicio para la restauración entre cuentas desde la CLI.

Gestión de los permisos de uso compartido de una instantánea desde la CLI

Puede eliminar una autorización de servicio a servicio para una instantánea específica desde la CLI mediante el comando authorization-policy-delete. Para obtener más información, consulte Eliminación de una autorización mediante la CLI.

Compartir una instantánea con otra cuenta mediante la API

Puede crear mediante programación una autorización de servicio a servicio para una instantánea específica llamando al método policies de la API de gestión de directivas de IAM. Para obtener más información, consulte Creación de autorización de servicio a servicio para la restauración entre cuentas con la API.

Gestión de los permisos de uso compartido de una instantánea con la API

Puede revocar mediante programación una autorización de servicio a servicio para una instantánea específica llamando al método policies de la API de gestión de directivas de IAM. Para obtener más información, consulte Eliminación de una autorización mediante la API.

Agregar etiquetas a una instantánea en la consola

Puede añadir etiquetas de usuario y etiquetas de gestión de acceso a las instantáneas de Block Storage for VPC. Puedes añadir etiquetas de usuario a una instantánea ya existente o al crear una instantánea. Las etiquetas pueden utilizarse en una política de copias de seguridad para crear copias de seguridad de la instantánea.

Adición de etiquetas de usuario desde la pantalla de lista de instantáneas

Utilice los pasos siguientes para añadir etiquetas de usuario desde la pantalla de lista de instantáneas.

Vaya a la lista de instantáneas.
Localizar un disponible instantánea creada por el usuario. (Las instantáneas creadas mediante una política de copia de seguridad se identifican como creadas por dicha política.)
En la columna Etiquetas, las instantáneas con etiquetas muestran un número que indica las etiquetas que ya se han aplicado. Las instantáneas sin etiquetas tienen el enlace Añadir etiquetas. Pulse Añadir etiquetas.
En la nueva ventana, escribe una etiqueta en el cuadro de texto «Etiquetas de usuario».
Pulse Guardar.

Adición de etiquetas desde la página de detalles de instantánea

utilice los pasos siguientes para añadir etiquetas desde la página de detalles de instantánea.

Vaya a la lista de instantáneas.
Haz clic en el nombre de una instantánea de la lista.
En la página de detalles de instantánea, pulse el enlace Añadir etiquetas.
En la nueva ventana, especifique una etiqueta de usuario o una etiqueta de gestión de acceso en los campos respectivos.
Pulse Guardar.

Cuando las etiquetas del usuario coinciden con una política de copias de seguridad, se activa una copia de seguridad según la programación del plan de copias de seguridad. Puede obtener información adicional consultando Creación de una política de seguridad.

Añadir etiquetas a una instantánea desde la CLI

Puede añadir etiquetas a una instantánea desde la CLI.

Especifica un comando « snapshot-update » con la opción « --tags » para añadir etiquetas de usuario a un volumen.

Utilice la misma opción para añadir etiquetas a un volumen al crear una instantánea utilizando ibmcloud is snapshot-create.

El ejemplo siguiente añade las etiquetas de usuario env:test y env:prod a un volumen identificado por su ID.

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap --tags env:test,env:prod

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   env:test,env:prod

Añadir etiquetas de usuario a una instantánea mediante la API

Puede añadir etiquetas de usuario a una instantánea utilizando la API.

Realice una llamada de PATCH /snapshots y especifique el ID de instantánea y las etiquetas de usuario. El ejemplo siguiente añade las etiquetas de usuario env:test y env:prod a la instantánea.

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -d `{
       "user_tags": [
         "env:test",
         "env:prod"
       ]
    }'

Editar zonas de restauración rápida en la consola

Utilice los siguientes pasos para editar las zonas donde se almacenan los clones de restauración rápida en la consola. Puede añadir o eliminar zonas según sea necesario.

Seleccione una instantánea en la lista de instantáneas.
En el menú Acciones , seleccione Editar restauración rápida.
En el panel lateral, seleccione o deseleccione las zonas para una restauración rápida en su región. Revise la actualización de facturación en función de su selección.
Pulse Guardar. Volverá a la página de detalles de instantáneas. La sección Restauración rápida muestra la nueva zona inicialmente con un estado pendiente .

La información de restauración rápida se actualiza cuando se renueva. La información de zona se actualiza para mostrar habilitada o inhabilitada, en función de los cambios realizados.

Creación de un clon de instantánea para una restauración rápida desde la CLI

Para crear una copia zonal de una instantánea, emita el mandato ibmcloud is snapshot-clone-create con el ID de instantánea y la zona o zonas donde desea crear copias. El siguiente ejemplo de mandato crea el clon de restauración rápida de r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 en la zona eu-de-3.

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

Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

Zone        eu-de-3
Available   false
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

El clon de instantánea parece no estar disponible mientras se crea el clon de instantánea. Sólo tarda unos segundos. Emita el mandato ibmcloud is snapshot-cl con el ID de instantánea y la zona de destino de clonación para ver el nuevo clon de instantánea como disponible.

ibmcloud is snapshot-cl 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

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

Supresión de un clon de instantánea desde la CLI

Para suprimir un clon de instantánea, emita el mandato ibmcloud is snapshot-clone-delete con el ID de instantánea y la zona donde desea eliminar la copia de instantánea. El siguiente ejemplo de mandato suprime la copia de restauración rápida de la instantánea r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 en la zona eu-de-3.

@$ ibmcloud is snapshot-clone-delete r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
This will delete zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 and cannot be undone. Continue [y/N] ?> y
Deleting zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
OK
Deletion request for zonal snapshot clone eu-de-3 has been accepted.

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

Creación de un clon de instantánea para una restauración rápida con la API

Para crear instantáneas de restauración rápida, cree un clon de la instantánea en una zona diferente. A continuación, restaure un volumen a partir de ese clon.

En la API, puede crear un clon para una instantánea existente realizando una llamada PUT /snapshots/{id}/clones/{zone_name} para clonar la instantánea en la zona especificada. Vea el ejemplo siguiente.

curl -X PUT \
"$vpc_api_endpoint/v1/snapshots/5e160469-0837-48a7-8973-e44c8d5fd85a/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

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

{
  "available": true,
  "created_at": "2025-02-18T20:35:38.600Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  },
  "storage_generation": 1,
}

También puede especificar la propiedad clone al crear una instantánea de un volumen. Vea el ejemplo siguiente.

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "clones": [{"zone": {"name": "us-south-1"}}],
    "name": "my-snapshot2",
    "resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
    "source_volume": {"id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"},
    "user_tags": ["env:test","env:prod"]
   }'

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

{
  "bootable": false,
  "clones": [
      "available": true,
      "created_at": "2025-02-18T20:18:38.600Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
     }
  ],
  "created_at": "2025-02-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "storage_generation": 1
}

Supresión de un clon de instantánea con la API

Realice una llamada DELETE /v1/snapshots/{id}/clones/{zone-name} para suprimir un clon de instantánea en la zona especificada. No puede deshacer la supresión cuando se suprime el clon de instantánea.

Vea el ejemplo siguiente.

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/fde0b8d5-2d75-4c28-af7d-12ffc3ae2a55/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

Creando una copia remota en la consola

Utilice los pasos siguientes para crear copias entre regiones de instantáneas desde la lista Instantáneas para VPC o desde la página de detalles de instantánea.

En la consola, haga clic en el icono Menú de navegación >Infraestructura >Almacenamiento > Block Storage instantáneas.
En la lista de instantáneas, busque la instantánea que desea duplicar en otra región. Asegúrese de que la instantánea tenga el estado Estable.
Haga clic en el menú Acciones y seleccione Copiar instantánea.
Selecciona la región en la que deseas crear la copia.

Solo puedes tener una copia por región. Si no hay regiones disponibles para copias, la opción Copiar instantánea está inhabilitada.
Pulse Crear.

De forma alternativa, pulse el nombre de la instantánea para ver sus detalles. Puede acceder a la opción Copiar instantánea desde el menú Acciones o puede desplazarse hasta la tarjeta de copias remotas y hacer clic en Crear copia. Se abre el mismo panel de suministro donde puede realizar la selección de región.

Eliminar copia de región remota en la consola

Las copias de instantánea en una región remota son independientes de la instantánea padre y del volumen padre. Puede suprimirlos en cualquier momento utilizando la lista Instantáneas para VPC.

Utilice los siguientes pasos para eliminar una copia de una región remota en la consola.

En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
Pulse el icono Acciones en la fila de la instantánea que desea suprimir.
Seleccione Suprimir.
Confirme la supresión y pulse Suprimir.

Creación de una copia de región remota desde la CLI

Puede crear una copia entre regiones de una instantánea utilizando el mandato snapshot-create con la opción --source-snapshot-crn y el CRN de la instantánea de origen, que crea una instantánea en la región de destino utilizando el CRN de una instantánea de la región de origen. La instantánea creada utiliza la clave de cifrado definida por el cliente si también se ha especificado el CRN de una clave de cifrado. La instantánea de origen debe estar en estado Estable para que la copia se cree correctamente.

ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8

Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...

ID                     r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Status                 pending
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region
                       r006-be21061a-4dc6-4c9f-b17d-421838fde399   -remote-421838fde399   us-south

Snapshot Copies        ID   Name   Remote Region   CRN   Resource type

Bootable               true
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                   Remote Region   CRN                                                                                                                        Resource type
                       r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   cli-snap-crc-test-sn   us-south        crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   snapshot

Minimum capacity(GB)   100
Size(GB)               1
Source Image           ID                                          Name                   Remote Region
                       r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   -remote-5a8a3766f0d6   us-south

Operating system       Name             Vendor   Version                 Family   Architecture   Display name
                       centos-7-amd64   CentOS   7.x - Minimal Install   CentOS   amd64          CentOS 7.x - Minimal Install (amd64)

Resource group         ID                                 Name
                       cdc21b72d4e647b195de988b175e3d82   Default

Created                2023-04-24T18:54:29+05:30
Captured at            2023-04-24T09:48:03+05:30
Tags                   -
Service Tags           -

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

Supresión de una copia de región remota desde la CLI

Puede suprimir una copia entre regiones de una instantánea utilizando el mandato ibmcloud is snapshot-delete con el ID de instantánea.

ibmcloud is snapshot-delete r142-bd4532c0-e73c-44f9-a017-89e5368c521a

This will delete snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a under account Test Account as user test.user@ibm.com...
    OK
Snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a is deleted.

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

Creación de una copia de región remota con la API

Puede crear una copia entre regiones de una instantánea realizando una llamada de API en la región de destino. Especifique el CRN de la instantánea de origen para crear una copia en la región de destino. La instantánea creada utiliza la clave de cifrado definida por el cliente si también se ha especificado el CRN de una clave de cifrado. La instantánea de origen debe estar en estado Estable para que la copia se cree correctamente. Consulte el ejemplo siguiente, donde la región de destino es us-east y la instantánea original está en us-south.

POST https://us-east.iaas.cloud.ibm.com/v1/snapshots
{
     "name": "my-snapshot",    // required
     "source_snapshot": {      // required
      	"crn": "crn:[...]"
     },
     "resource_group": {       // optional
       "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"
     },
     "encryption_key": "crn:[...]"     // optional
}

Una respuesta satisfactoria tendrá el aspecto siguiente:

{
  "created_at": "2023-05-18T20:18:18Z",
  "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": "pending",
  "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": [],
  "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",
    	   "hfef": "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"
  },
  "user_tags": []
}

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

Haga un DELETE /snapshots/{id} en la región de destino donde se encuentra la copia remota.

curl -X DELETE https://us-east.iaas.cloud.ibm.com/v1/snapshots/{id}

Creación de una copia entre regiones con Terraform

Para crear una copia de la instantánea en una región remota, utilice el recurso ibm_is_snapshot. La instantánea de origen debe estar en estado Estable para que la copia se cree correctamente. La instantánea creada utiliza la clave de cifrado definida por el cliente si también se ha especificado el CRN de una clave de cifrado. El ejemplo siguiente crea una copia en la región de destino utilizando el ID de la instantánea de origen. La copia se va a cifrar mediante la clave de cifrado especificada por su CRN.

resource "ibm_is_snapshot" "snapshot" {
  name 		        = "my-cross-regional-snapshot"
  source_snapshot = "r138-4463eb2c-4913-43b1-b9bf-62a94f74c146"
  encryption_key  = "crn:bluemix:public:kms:us-south:a/df0564dd126042ebb03e0224728ce939:4957299d-0ba0-487f-a1a0-c724a729b8b4:key:0cb88b98-9261-4d07-8329-8f594b6641b5"
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_snapshot.

Supresión de una copia de región remota con Terraform

Utilice el comando terraform destroy para eliminar cómodamente un objeto remoto, como una copia interregional de una instantánea. El ejemplo siguiente muestra la sintaxis para suprimir una instantánea. Sustituya el ID real de la instantánea por ibm_is_snapshot.example.id.

terraform destroy --target ibm_is_snapshot.example.id

Para obtener más información, consulte terraform destroy.

Eliminación de instantáneas en la consola

Puede suprimir cualquier instantánea de un volumen o todas las instantáneas de un volumen. Para poder suprimir una instantánea, debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No se está restaurando activamente un volumen.

Una forma cómoda de determinar si puedes eliminar una instantánea es buscar en la consola la lista de instantáneas y comprobar su estado. Puede suprimir todas las instantáneas para un volumen. Para eliminar todas las instantáneas es necesario realizar una confirmación adicional en la consola.

Eliminar una sola instantánea en la consola

Puede suprimir una instantánea de la lista de todas las instantáneas utilizando los pasos siguientes.

Vaya a la lista de todas las instantáneas. En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
Pulse el icono Acciones en la fila de la instantánea que desea suprimir.
Seleccione Suprimir.
Confirme la supresión y pulse Suprimir.

También puedes eliminar una instantánea desde la página de detalles de un volumen de « Block Storage for VPC ».

Accede a la lista de todos los volúmenes de « Block Storage for VPC ». En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Almacenamiento > Block Storage.
Selecciona un volumen de la lista y haz clic en el nombre del volumen para acceder a la página de detalles del mismo.
Pulse Instantáneas. Se muestra una lista de las instantáneas que se han tomado de este volumen, y puedes realizar las siguientes acciones:
- Pulse Suprimir todo para suprimir todas las instantáneas de este volumen.
- Pulse el icono Acciones para suprimir una instantánea específica.
Seleccione Suprimir. Si la instantánea está restaurando un volumen, la operación de eliminación no funciona.
Confirme la supresión.

Eliminar todas las instantáneas de un volumen en la consola

Para eliminar todas las instantáneas de un volumen en la consola, sigue estos pasos.

Vaya a la lista de todas las instantáneas. En la IBM Cloud consola, ve al menú > Infraestructura > Almacenamiento > Instantáneas.
Haz clic en la fila para seleccionar la instantánea que deseas eliminar.
En el menú Acciones , seleccione Suprimir todo para volumen.
Confirme la supresión escribiendo suprimir y pulse Suprimir.

Eliminar instantáneas del Block Storage for VPC página de detalles en la consola

Puedes eliminar la instantánea creada más recientemente de la lista de instantáneas desde la página de detalles del volumen « Block Storage for VPC ». Opcionalmente, puede suprimir todas las instantáneas de esta vista.

Accede a la lista de todos los volúmenes de « Block Storage for VPC ». En la IBM Cloud consola, vaya al menú >Infraestructura >Almacenamiento > Block Storage.
Seleccione un volumen de la lista y pulse el nombre del volumen para ir a la página de detalles del volumen.
Pulse Instantáneas para ver una lista de las instantáneas tomadas de este volumen.
Pulse Suprimir todo para suprimir todas las instantáneas de este volumen.
De forma alternativa, seleccione una única instantánea en la lista para su supresión y después:
1. Pulse el icono Acciones .
2. Seleccione Suprimir.
3. Confirme la supresión.

Eliminación de instantáneas desde la CLI

Puede suprimir cualquier instantánea de un volumen o todas las instantáneas de un volumen. Para poder suprimir una instantánea, debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No se está restaurando activamente un volumen.

Cómo eliminar una instantánea concreta desde la CLI

Utilice los pasos siguientes para suprimir una única instantánea utilizando la CLI.

Liste las instantáneas que están disponibles para un volumen para confirmar el ID de la instantánea que desea suprimir.

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]

$ 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

Ejecute el comando snapshot-delete y especifique el ID de la instantánea. Para suprimir varias instantáneas, debe especificar todos sus ID en el mismo mandato.
```
ibmcloud is snapshot-delete SNAPSHOT_ID
```

Confirma la eliminación de la instantánea. El mensaje de respuesta indica que se ha suprimido la instantánea.

$ ibmcloud is snapshot-delete r138-e6664842-b370-496a-9ae7-da3fb647707c
This will delete snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...
OK
Snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c is deleted.

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

Eliminar todas las instantáneas desde la CLI

Utilice los pasos siguientes para suprimir todas las instantáneas utilizando la CLI.

Listar todas las instantáneas.

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups]

Introduce el comando « snapshots-delete » y especifica el ID del volumen.
```
ibmcloud is snapshots-delete --volume VOLUME_ID
```

Confirma la eliminación de las instantáneas. El mensaje de respuesta indica cuándo se acepta la solicitud de supresión de instantánea y cuándo se suprimen las instantáneas.

$ ibmcloud is snapshots-delete --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
This will delete snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa and cannot be undone. Continue [y/N] ?> y
Deleting snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa under account Test Account as user test.user@ibm.com...
OK
Deletion request for snapshots by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa has been accepted.

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

Eliminación de instantáneas mediante la API

Puede suprimir cualquier instantánea de un volumen o todas las instantáneas de un volumen. Para poder suprimir una instantánea, debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No se está restaurando activamente un volumen.

Eliminar una instantánea concreta mediante la API

Realiza una llamada al método DELETE /snapshots/{snapshot_ID} para eliminar una instantánea concreta por su ID.

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

Eliminación de todas las instantáneas de un volumen mediante la API

Realice una llamada DELETE/snapshots y especifique el ID de volumen de origen para el parámetro source_volume.id en la solicitud.

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots?source_volume.id=_volume-id_&version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

Supresión de instantáneas con Terraform

Puede suprimir cualquier instantánea de un volumen o todas las instantáneas de un volumen. Para poder suprimir una instantánea, debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No se está restaurando activamente un volumen.

Supresión de una única instantánea con Terraform

Utilice el comando " terraform destroy " para eliminar cómodamente un objeto remoto, como una sola instantánea. El siguiente ejemplo elimina my-snapshot.

terraform destroy --target ibm_is_snapshot.my-snapshot

Para obtener más información, consulte terraform destroy.

Supresión de todas las instantáneas de un volumen con Terraform

Para suprimir todas las instantáneas de un volumen con terraform, utilice el recurso ibm_is_volume.

resource "ibm_is_volume" "storage" {
  name                 = "example-volume"
  profile              = "general-purpose"
  zone                 = "us-south-1"
  delete_all_snapshots = true
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_volume.

Monitoreo de los estados del ciclo de vida de las instantáneas

La tabla 2 describe los estados de las instantáneas a lo largo de su ciclo de vida. Puedes ver estos estados en la consola, en las salidas de comandos de la CLI, en las respuestas de la API y en las fuentes de datos de Terraform.

Estados de ciclo de vida
Estado de la instantánea	Explicación
Estable	La instantánea está disponible para restaurar un volumen.
En espera	Se está recuperando la información de instantánea.
Pendiente	Mientras se está creando la instantánea, se muestra el porcentaje completado.
Error	No se ha podido crear la instantánea; no es posible restaurar el volumen a partir de una instantánea.
Suspendido	La instantánea no está disponible temporalmente.
Actualizando	Ha cambiado algo sobre la instantánea y se está actualizando.
Suprimiendo	Se está eliminando la instantánea.
Suprimidos	La instantánea se ha suprimido y no está disponible para restaurar volúmenes.

Próximos pasos

Puede Restaurar un volumen a partir de una instantánea.