Restauração de dados de um snapshot de compartilhamento de arquivos

Recupere os dados do compartilhamento de arquivos criando novos compartilhamentos a partir de instantâneos. As ações restauradas utilizam o mesmo perfil e a mesma localização do instantâneo. Oferece suporte à recuperação completa e de arquivos individuais.

Os compartilhamentos podem ser criados somente no mesmo local que o compartilhamento de origem do instantâneo. Quando o novo compartilhamento é criado, ele contém apenas ponteiros para o compartilhamento original, e o processo de cópia de dados é iniciado. Enquanto os dados estão sendo copiados, o compartilhamento está em um estado pendente. Embora o novo compartilhamento possa ser montado para leitura/gravação em estado pendente, algumas operações, como a criação de uma réplica ou instantâneos, não são permitidas. Após a conclusão da operação de cópia de dados, o novo compartilhamento é dividido do compartilhamento pai para se tornar independente, concluindo o processo de inicialização. Após a conclusão do processo de inicialização, o compartilhamento passa para o estado estável e pode ser usado como qualquer outro compartilhamento.

É possível alterar a chave de criptografia gerenciada pelo cliente quando o novo compartilhamento de arquivos da zona é criado. Esse processo registra o novo compartilhamento no serviço de gerenciamento de chaves com uma nova chave. A nova chave é usada para criptografar o novo compartilhamento.

Selecione a disponibilidade Nesta versão de compartilhamentos de arquivos regionais, não é possível alterar a chave de criptografia gerenciada pelo cliente quando o novo compartilhamento de arquivos regional é criado.

Limitações

As seguintes limitações se aplicam ao restaurar um recurso compartilhado a partir de um instantâneo.

  • Para restaurar um compartilhamento, o snapshot deve estar em um estado estável e disponível.
  • Não é possível excluir o snapshot do qual o compartilhamento foi restaurado, a menos que a inicialização esteja concluída.
  • Se o snapshot estiver protegido com criptografia gerenciada pelo cliente e você não especificar um CRN de chave raiz diferente, o compartilhamento restaurado será criptografado com a chave de criptografia do snapshot. A criptografia não pode ser alterada posteriormente. Se a chave de criptografia do compartilhamento pai for excluída enquanto o novo compartilhamento estiver sendo inicializado, isso interromperá o processo de inicialização e causará falhas.

Restauração de compartilhamentos a partir de instantâneos no console

Você pode criar compartilhamentos a partir de várias páginas no console IBM Cloud.

Criação de um compartilhamento a partir de um snapshot no console

Na lista de snapshots File Storage for VPC, você pode criar um compartilhamento File Storage for VPC. Os novos compartilhamentos são adicionados à lista de compartilhamentos File Storage for VPC.

  1. Acesse a lista de instantâneos do File Storage for VPC. No site IBM Cloud console, clique no ícone Menu de navegação ícone do menu > Infraestrutura Ícone de VPC > Armazenamento > Compartilhamentos de armazenamento de arquivos.

  2. Selecione o compartilhamento que contém os dados que você deseja usar para criar outro compartilhamento.

  3. Na guia Instantâneos da página Detalhes do compartilhamento, localize o instantâneo que deseja usar. Ela deve estar em um estado stable.

  4. No menu Actions (Ações), ícone Actions(Ações) ), selecione Restore (Restaurar ).

  5. Na página de provisionamento, são mostrados os detalhes do instantâneo. Algumas configurações de compartilhamento de arquivos, como zona e tipo de criptografia, são herdadas do instantâneo e não podem ser alteradas.

  6. Forneça os detalhes de compartilhamento necessários.

    Crie opções de compartilhamento.
    Campo Descrição
    Compartilhar detalhes Defina o novo compartilhamento.
    Nome Digite um nome para o novo recurso compartilhado.
    Grupo de recursos Use os padrões ou selecione na lista.
    Tags de usuário Especifique tags de usuário para organizar seus recursos e para uso por políticas de backup
    Tags de gerenciamento de acesso Especifique as tags de gerenciamento de acesso que foram criadas no IAM para ajudá-lo a gerenciar o acesso aos seus compartilhamentos.
    Perfil O padrão é dp2 para compartilhamentos zonais e rfs para compartilhamentos regionais. O perfil e o valor de geração de armazenamento do novo compartilhamento devem corresponder ao perfil e ao valor de geração de armazenamento do snapshot.
    Tamanho Insira um tamanho de compartilhamento permitido pelo perfil. Ele deve ser maior ou igual ao tamanho do snapshot.
    IOPS Selecione o IOPS que está dentro do intervalo permitido pelo perfil de compartilhamento.
    Destinos de montagem A criação de um destino de montagem é opcional, mas você precisa ter um destino de montagem se quiser se conectar ao seu compartilhamento de arquivos a partir de uma instância de servidor virtual.
    Criptografia Herdado da captura instantânea.

  7. Quando terminar, clique em Criar. A nova ação foi criada.

Restauração de um compartilhamento a partir de um snapshot na CLI

Você pode criar um compartilhamento File Storage for VPC a partir de um snapshot na CLI. Quando o compartilhamento é criado, você pode criar um destino de montagem e montar o compartilhamento em uma instância posteriormente.

Antes de Iniciar

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

  1. Efetue login no IBM Cloud®.

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

    Esse comando retorna uma URL e solicita uma senha. Acesse essa URL em seu navegador e efetue login. Se bem-sucedido, você receberá uma senha descartável. Copie essa senha e cole-a como uma resposta no prompt. Após a autenticação bem-sucedida, você será solicitado a escolher sua conta. Se você tiver acesso a várias contas, selecione a conta com a qual deseja fazer login. Responda a quaisquer prompts restantes para concluir o login.

  2. Reúna informações sobre o snapshot que você deseja usar para restaurar um compartilhamento.

    1. Você pode usar a CLI para listar todos os snapshots de um compartilhamento específico e escolher um na saída.
    2. Em seguida, use o comando ibmcloud is share-snapshot SHARE SNAPSHOT para listar os detalhes do snapshot escolhido.

Criação de um compartilhamento a partir de um snapshot na CLI

Execute o comando ibmcloud is share-create e especifique o parâmetro --snapshot e o ID ou o CRN do snapshot.

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

O exemplo a seguir cria um compartilhamento a partir de um snapshot usando o CRN do snapshot. Se você não fornecer um nome para o seu novo compartilhamento, um nome será gerado automaticamente para você. Os valores de tamanho e IOPS são herdados do snapshot e você pode alterá-los depois que o compartilhamento for criado.

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

Os perfis de compartilhamento de arquivos de primeira e segunda geração da família de perfis de desempenho definidos não são intercambiáveis. Não é possível usar o snapshot de segunda geração para criar um compartilhamento de arquivos por zona. Da mesma forma, não é possível usar o instantâneo do compartilhamento de arquivos de primeira geração para criar um compartilhamento com o perfil rfs.

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is share-create.

Restaurando um compartilhamento a partir de um instantâneo usando a API

Você pode restaurar um compartilhamento de forma programática chamando o método /shares na API do VPC.

Antes de começar, reúna informações sobre o snapshot que você deseja usar para restaurar um compartilhamento.

Criação de um compartilhamento a partir de um snapshot usando a API

Para restaurar um compartilhamento a partir de um instantâneo, faça uma solicitação POST /shares e especifique a ID ou o CRN do instantâneo na propriedade source_snapshot. A capacidade restaurada do compartilhamento (em GB) deve ser, no mínimo, igual à minimum_capacity do snapshot.

A solicitação de exemplo a seguir cria um compartilhamento de 100 GB com base no snapshot de origem 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"]
   }`

Os perfis de compartilhamento de arquivos de primeira e segunda geração da família de perfis de desempenho definidos não são intercambiáveis. Não é possível usar o snapshot de segunda geração para criar um compartilhamento de arquivos por zona. Da mesma forma, não é possível usar o instantâneo do compartilhamento de arquivos de primeira geração para criar um compartilhamento com o perfil rfs.

Restauração de um compartilhamento a partir de um snapshot com o Terraform

Para usar o Terraform, faça o download da CLI do Terraform e configure o plug-in do provedor IBM Cloud. Para obter mais informações, consulte Introdução ao Terraform.

Os serviços de infraestrutura de VPC usam um endpoint regional específico, que tem como destino o endereço us-south por padrão. Se a sua VPC for criada em outra região, certifique-se de direcionar a região apropriada no bloco do provedor no arquivo provider.tf.

Veja o seguinte exemplo de direcionamento para uma região diferente da padrão us-south.

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

Criação de um compartilhamento a partir de um snapshot com o Terraform

Para criar um compartilhamento a partir de um instantâneo, use o recurso ibm_is_share. O exemplo a seguir cria um compartilhamento a partir de um snapshot com o 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 obter mais informações sobre os argumentos e atributos, consulte ibm_is_share.

Restaurando arquivos a partir de um snapshot

Para executar a restauração de um único arquivo, você pode usar as funções nativas do sistema operacional. Você pode navegar até o destino de montagem NFS do compartilhamento e abrir o diretório oculto do snapshot (normalmente denominado /.snapshot ou .snap, dependendo do tipo de compartilhamento de arquivos). Dentro desse diretório, você encontrará subdiretórios que representam cada snapshot do seu compartilhamento. Você pode abri-los para localizar e, em seguida, copiar o arquivo selecionado para outro local.

Embora o diretório do snapshot esteja oculto, ele pode ser acessado quando abordado diretamente por meio de comandos como cd .snapshot ou ls .snapshot/. Cada snapshot aparece como um subdiretório nomeado com sua impressão digital exclusiva, que corresponde ao que você vê no console, na CLI ou na 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

Esses subdiretórios representam o estado do compartilhamento no momento em que o instantâneo foi tirado. Os subdiretórios são somente leitura. Não é possível excluir dados desses instantâneos por meio de métodos NFS. Da mesma forma, é proibido criar novos subdiretórios. Essa visualização é apenas para conveniência na execução de restauração de arquivo único e inspeção pontual dos dados.

Próximas etapas

Você pode criar mais instantâneos ou gerenciar os instantâneos existentes.