Restauración de datos a partir de una instantánea de un archivo compartido

Recupera los datos de los recursos compartidos creando nuevos recursos compartidos a partir de instantáneas. Las acciones restauradas utilizan el mismo perfil y la misma ubicación que la instantánea. Admite la recuperación completa y la recuperación de un solo archivo.

Los recursos compartidos sólo pueden crearse en la misma ubicación que el recurso compartido de origen de la instantánea. Cuando se crea el nuevo recurso compartido, sólo contiene punteros al recurso compartido original, y comienza el proceso de copia de datos. Mientras se copian los datos, la acción está en estado pendiente. Mientras que el nuevo recurso compartido se puede montar para lectura/escritura en estado pendiente, algunas operaciones como la creación de una réplica o instantáneas no están permitidas. Una vez completada la operación de copia de datos, el nuevo recurso compartido se separa del recurso padre para independizarse, completando así el proceso de inicialización. Una vez finalizado el proceso de inicialización, la acción pasa al estado estable y puede utilizarse como cualquier otra acción.

Es posible cambiar la clave de cifrado gestionada por el cliente cuando se crea el nuevo recurso compartido de archivos zonal. Este proceso registra la nueva acción en el servicio de gestión de claves con una nueva clave. La nueva clave se utiliza para cifrar el nuevo Share.

Seleccione disponibilidad En esta versión de recursos compartidos de archivos regionales, no es posible cambiar la clave de cifrado gestionada por el cliente cuando se crea el nuevo recurso compartido de archivos regionales.

Limitaciones

Al restaurar un recurso compartido a partir de una instantánea, se aplican las siguientes limitaciones.

  • Para restaurar un recurso compartido, la instantánea debe estar en un estado estable y disponible.
  • No se puede eliminar la instantánea desde la que se restaura el recurso compartido a menos que la inicialización se haya completado.
  • Si la instantánea está protegida con el cifrado gestionado por el cliente y no se especifica un CRN de clave raíz diferente, el recurso compartido restaurado se cifra con la clave de cifrado de la instantánea. El cifrado no puede modificarse posteriormente. Si se elimina la clave de cifrado del recurso compartido principal mientras se inicializa el nuevo recurso compartido, se interrumpe el proceso de inicialización y se produce un error.

Restauración de recursos compartidos a partir de instantáneas en la consola

Puede crear recursos compartidos desde varias páginas de la consola IBM Cloud.

Creación de un recurso compartido a partir de una instantánea en la consola

Desde la lista de instantáneas de File Storage for VPC, puede crear una compartición de File Storage for VPC. Las nuevas acciones se añaden a lista de acciones File Storage for VPC.

  1. Accede a la lista de instantáneas de « File Storage for VPC ». En IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú > Infraestructura Icono VPC > Almacenamiento > Archivos compartidos.

  2. Seleccione el recurso compartido que contiene los datos que desea utilizar para crear otro recurso compartido.

  3. En la pestaña de instantáneas de la página de detalles de Compartir, localiza la instantánea que quieras utilizar. Debe tener un estado stable.

  4. En el menú Acciones, icono Acciones, seleccione Restaurar.

  5. En la página de aprovisionamiento, se muestran los detalles de la instantánea. Algunas configuraciones de uso compartido de archivos, como la zona y el tipo de cifrado, se heredan de la instantánea y no pueden modificarse.

  6. Proporcione los datos de la acción requeridos.

    Crear opciones de acciones.
    Campo Descripción
    Detalles de compartición Define la nueva acción.
    Nombre Introduce un nombre para el nuevo recurso compartido.
    Grupo de recursos Utilice los valores predeterminados o seleccione de la lista.
    Etiquetas de usuario Especifique etiquetas de usuario para organizar sus recursos y para su uso por las políticas de copia de seguridad
    Etiquetas de gestión de acceso Especifique las etiquetas de gestión de acceso que se crearon en IAM para ayudarle a gestionar el acceso a sus recursos compartidos.
    Perfil Por defecto, dp2 para las cuotas zonales y rfs para las cuotas regionales. El perfil y el valor de generación de almacenamiento del nuevo recurso compartido deben coincidir con el perfil y el valor de generación de almacenamiento de la instantánea.
    Tamaño Introduzca un tamaño de cuota permitido por el perfil. Debe ser mayor o igual que el tamaño de la instantánea.
    IOPS Seleccione las IOPS que están dentro del rango que permite el perfil de compartición.
    Destinos de montaje La creación de un destino de montaje es opcional, pero es necesario tener un destino de montaje si desea conectarse a su recurso compartido de archivos desde una instancia de servidor virtual.
    Cifrado Heredado de la instantánea.

  7. Cuando hayas terminado, haz clic en « Crear ». Se ha creado la nueva acción.

Restauración de un recurso compartido a partir de una instantánea desde la CLI

Puede crear un recurso compartido File Storage for VPC a partir de una instantánea desde la CLI. Cuando se crea el recurso compartido, puede crear un destino de montaje y montar el recurso compartido en una instancia más tarde.

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.

  1. 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. Tras autenticarse correctamente, se le pedirá 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.

  2. Reúna información sobre la instantánea que desea utilizar para restaurar un recurso compartido.

    1. Puede utilizar la CLI para listar todas las instantáneas de un recurso compartido específico y elegir una de la salida.
    2. A continuación, utilice el comando ibmcloud is share-snapshot SHARE SNAPSHOT para listar los detalles de la instantánea elegida.

Creación de un recurso compartido a partir de una instantánea desde la CLI

Ejecute el comando ibmcloud is share-create y especifique el parámetro --snapshot y el ID o el CRN de la instantánea.

ibmcloud is share-create --name my-file-share-from-snapshot --snapshot r006-de41f19f-204c-4d4c-a630-1971ba85ed1d  --profile dp2 --size 100 --iops 2000  --user-tags env:test

Creating file share my-file-share-from-snapshot under account Test Account as user test.user@ibm.com...

ID                                 r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Name                               my-file-share-from-snapshot
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,user_managed
Zone                               us-south-2
Profile                            dp2
Size(GB)                           100
IOPS                               2000
User Tags                          env:test
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:35:03-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

El siguiente ejemplo crea un recurso compartido a partir de una instantánea utilizando el CRN de la instantánea. Si no le pones un nombre a tu nuevo recurso compartido, se generará uno automáticamente. Los valores de tamaño e IOPS se heredan de la instantánea, y puedes cambiarlos después de crear el recurso compartido.

ibmcloud is share-create --profile dp2 --snapshot crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-ed78dc15-048f-4077-b7a2-88c213d53463/r006-de41f19f-204c-4d4c-a630-1971ba85ed1d

Creating file share  under account Test Account as user test.user@ibm.com...

ID                                 r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Name                               giggling-maturing-remnant-unworldly
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           10
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:37:01-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Los perfiles de uso compartido de archivos de primera y segunda generación de la familia de perfiles de rendimiento definidos no son intercambiables. No puedes utilizar tu instantánea de segunda generación para crear un archivo compartido zonal. Del mismo modo, no se puede utilizar la instantánea del recurso compartido de archivos de primera generación para crear un recurso compartido con el perfil rfs.

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

Restaurar un recurso compartido a partir de una instantánea mediante la API

Puede restaurar un recurso compartido mediante programación llamando al método /shares de la API de VPC.

Antes de empezar, recopile información sobre la instantánea que desea utilizar para restaurar un recurso compartido.

Crear un recurso compartido a partir de una instantánea mediante la API

Para restaurar un recurso compartido a partir de una instantánea, realice una solicitud a POST /shares y especifique el ID o CRN de la instantánea en la propiedad source_snapshot. La capacidad restaurada del recurso compartido (en GB) debe ser, como mínimo, igual a la «minimum_capacity» de la instantánea.

La siguiente solicitud de ejemplo crea un recurso compartido de 100 GB basado en la instantánea de origen r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4.

curl -X POST \
"$vpc_api_endpoint/v1/shares/?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "my-share-from-snapshot",
     "capacity": 100,
     "iops": 2000,
     "source_snapshot:" {"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4"},
     "profile": {"name": "dp2"},
     "encryption_key":{"crn":"crn:[...]"},
     "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
     "allowed_transit_encryption_modes": ["none","user_managed"],
     "resource_group": {},
     "user_tags": ["env:test"]
   }`

Los perfiles de uso compartido de archivos de primera y segunda generación de la familia de perfiles de rendimiento definidos no son intercambiables. No puedes utilizar tu instantánea de segunda generación para crear un archivo compartido zonal. Del mismo modo, no se puede utilizar la instantánea del recurso compartido de archivos de primera generación para crear un recurso compartido con el perfil rfs.

Restauración de un recurso compartido a partir 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 Introducción a Terraform.

Los servicios de infraestructura VPC utilizan un punto final regional específico, que se dirige a us-south por defecto. Si su VPC se ha creado en otra región, asegúrese de indicar la región correspondiente en el bloque de proveedores del archivo provider.tf.

Véase el siguiente ejemplo de selección de una región distinta de la predeterminada us-south.

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

Creación de un recurso compartido a partir de una instantánea con Terraform

Para crear un recurso compartido a partir de una instantánea, utilice el recurso ibm_is_share. El siguiente ejemplo crea un recurso compartido a partir de una instantánea con el perfil dp2.

resource "ibm_is_share" "storage" {
  name            = "restore-share-new"
  profile         = "dp2"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.crn"
}

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

Recuperación de archivos a partir de una instantánea

Para realizar la restauración de un solo archivo, puedes utilizar las funciones nativas del sistema operativo. Puede navegar hasta el destino de montaje NFS del recurso compartido y abrir el directorio oculto de instantáneas (normalmente denominado /.snapshot o .snap, en función del tipo de recurso compartido). Dentro de este directorio, encontrará subdirectorios que representan cada instantánea de su recurso compartido. Puede abrirlos para localizarlos y, a continuación, copiar el archivo seleccionado en una ubicación diferente.

Aunque el directorio de instantáneas está oculto, es accesible cuando se aborda directamente utilizando comandos como cd .snapshot o ls .snapshot/. Cada instantánea aparece como un subdirectorio nombrado con su huella digital única, que coincide con lo que se ve en la consola, CLI o API.

[root@server .snapshot]# ls -lah
total 34K
drwxr-xr-x  3 root root  3 May 10 08:28 .
drwxr-xr-x 22 root root 56 May 10 08:28 ..
drwxr-xr-x  2 root root  2 May 10 08:28 c2c2439c-cbeb-4f12-8d9d-6059a3b85502

Estos subdirectorios representan el estado del recurso compartido en el momento en que se tomó la instantánea. Los subdirectorios son de sólo lectura. No es posible eliminar datos de estas instantáneas mediante métodos NFS. Del mismo modo, está prohibido crear nuevos subdirectorios. Esta vista sólo sirve para restaurar archivos individuales e inspeccionar los datos en un momento dado.

Próximos pasos

Puedes crear más instantáneas o gestionar las existentes.