Gerenciando capturas instantâneas do Block Storage for VPC

Gerencie instantâneos d Block Storage for VPC s renomeando-os, atribuindo tags, ativando a restauração rápida, excluindo-os e verificando o acesso e o status.

Nomeando capturas instantâneas

Considere nomear a captura instantânea para indicar o volume que foi copiado. Por exemplo, my-volume seria my-volume-snapshot1. Também, para identificação rápida, considere nomear os volumes de inicialização incluindo boot como um prefixo, como boot_my-volume-snapshot1. À medida que a sua lista de capturas instantâneas aumenta, é possível identificar rapidamente o nome e o tipo de volume por meio do qual a captura instantânea foi criada.

Os nomes de capturas instantâneas atendem aos mesmos requisitos que os nomes de volumes. Os nomes válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a a z, 0 a 9) e o hífen (-), com até 63 caracteres. Os nomes de capturas instantâneas devem começar com uma letra minúscula e devem ser exclusivos em toda a VPC. A IU fornece a verificação de nome como uma conveniência. Por exemplo, se você terminar um nome de captura instantânea com um hífen (-), a IU irá notificá-lo do erro. Ela também verifica os nomes duplicados.

Quando você cria uma cópia regional cruzada de uma captura instantânea, a nova captura instantânea é denominada [copy]-[source-snapshot-name] Por exemplo, uma cópia regional cruzada do snapshot-my-volume-snapshot1_ é automaticamente denominada copy-my-volume-snapshot1 quando é colocada na região de destino. As cópias regionais cruzadas de capturas instantâneas são independentes da captura instantânea de origem e do volume de origem, e as cópias podem ser gerenciadas como qualquer outra captura instantânea normal

Renomeando um snapshot no console

Siga as etapas a seguir para renomear um snapshot no console.

Acesse a lista de capturas instantâneas. No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
Clique no nome de uma captura instantânea da lista.
Clique no ícone Editar .
Forneça um novo nome para a captura instantânea, salve e confirme suas mudanças.

Como renomear um snapshot pela CLI

Pré-requisitos para emitir comandos a partir da CLI

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.

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ê é solicitado a escolher a 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.

Como renomear um snapshot pela CLI

É possível renomear um snapshot pela CLI.

Para renomear uma captura instantânea, emita o comando ibmcloud is snapshot-update e forneça o ID da captura instantânea e o novo nome.

ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME

Consulte o exemplo a seguir.

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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-update

Alteração da propriedade Allowed Use de um snapshot na CLI

As propriedades do site Allowed Use são herdadas do volume principal. Você pode usar o comando ibmcloud is snapshot-update para alterar esses valores.

Você deve ter a função IAM is.volume.volume.manage-allowed-use para alterar essas propriedades de um snapshot.

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

As propriedades compreendem uma expressão booleana da Common Expression Language. Quando a expressão é avaliada como true, o provisionamento de uma instância de servidor virtual ou de um servidor bare metal é permitido com o instantâneo. Quando a expressão é avaliada como false, o provisionamento é bloqueado.

Renomeando um snapshot por meio da API

É possível renomear uma captura instantânea usando a API.

Execute a chamada PATCH /snapshots e especifique o ID do snapshot e o novo nome do snapshot.

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"
   }'

É possível usar a mesma chamada para renomear uma cópia entre regiões A cópia regional cruzada é independente da captura instantânea de origem e do volume de origem e pode ser gerenciada como qualquer outra.

Atualizando uma captura instantânea 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 terminal regional específico, que tem como destino o us-south por padrão Se sua VPC for criada em outra região, certifique-se de destinar a região apropriada no bloco do provedor no arquivo provider.tf.

Veja o exemplo a seguir de destinação de uma região diferente do us-south padrão:

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

Para atualizar uma captura instantânea, use o recurso ibm_is_snapshot.. É possível mudar o nome da captura instantânea, as zonas de restauração rápida e as tags No entanto, a alteração dos valores resource_group e source_volume força o Terraform a excluir o snapshot e criar um snapshot diferente.

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

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_snapshot.

Compartilhamento de um snapshot com outra conta no console

Você pode compartilhar um snapshot com outra conta no console.

Acesse a lista de capturas instantâneas. No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
No menu Actions , selecione Share snapshot.
Digite o ID da conta com a qual você deseja compartilhar o instantâneo.
Clique em Criar uma autorização IAM personalizada.

Como alternativa, você pode criar uma autorização de serviço para serviço por meio do menu Gerenciar > Acesso (IAM) > Autorizações. Para obter mais informações, consulte Criando autorização de serviço a serviço para restauração entre contas no console.

Gerenciamento de permissões de compartilhamento para um instantâneo no console.

Acesse a lista de capturas instantâneas. No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
No menu Actions , selecione Manage share permission.
O painel lateral exibe a lista de contas com as quais você compartilhou o snapshot.

A lista mostra todas as autorizações que foram configuradas para o snapshot. Por exemplo, se uma conta tiver uma autorização para esse instantâneo específico e uma autorização para todos os instantâneos em sua conta, essa conta será listada duas vezes.
Clique em Manage IAM Authorization para acessar a página Authorization (Autorização) e modificar ou revogar a autorização.

Como alternativa, você pode gerenciar uma política de autorização de serviço para serviço diretamente por meio do menu Gerenciar > Acesso (IAM) > Autorizações. Para obter mais informações, consulte Usando autorizações para conceder acesso entre os serviços.

Compartilhamento de um snapshot com outra conta a partir da CLI

Você pode criar uma autorização de serviço a serviço para um instantâneo específico na CLI usando o comando ibmcloud iam authorization-policy-create. Para obter mais informações, consulte Criando autorização de serviço a serviço para restauração entre contas a partir da CLI.

Gerenciamento de permissões de compartilhamento para um instantâneo a partir da CLI

Você pode remover uma autorização de serviço a serviço para um instantâneo específico da CLI usando o comando authorization-policy-delete. Para obter mais informações, consulte Removendo uma autorização usando a CLI.

Compartilhamento de um instantâneo com outra conta com a API

Você pode criar programaticamente uma autorização de serviço a serviço para um instantâneo específico chamando o método policies na API de gerenciamento de políticas do IAM. Para obter mais informações, consulte Criando autorização de serviço a serviço para restauração entre contas com a API.

Gerenciamento de permissões de compartilhamento para um instantâneo com a API

Você pode revogar programaticamente uma autorização de serviço a serviço para um instantâneo específico chamando o método policies na API de gerenciamento de políticas do IAM. Para obter mais informações, consulte Removendo uma autorização usando a API.

Adicionando tags a um snapshot no console

É possível incluir tags de usuário e tags de gerenciamento de acesso em suas capturas instantâneas do Block Storage for VPC. Você pode adicionar tags de usuário a um snapshot existente ou ao criar um snapshot. As tags podem ser utilizadas por uma política de backup para criar backups do snapshot.

Incluindo tags do usuário a partir da tela da lista de capturas instantâneas

Use as etapas a seguir para incluir tags de usuário na tela da lista de capturas instantâneas.

Acesse lista de capturas instantâneas.
Localize um disponível instantâneo criado pelo do utilizador. (Os instantâneos criados por uma política de backup são identificados como criados pela política de backup.)
Na coluna Tags, as capturas instantâneas com tags mostram um número que indica as tags que já foram aplicadas. As capturas instantâneas sem tags têm um link Incluir tags. Clique em Incluir tags.
Na nova janela, digite uma tag na caixa de texto “Tags do usuário”.
Clique em Salvar.

Incluindo tags da página de detalhes da captura instantânea

Use as etapas a seguir para incluir tags da página de detalhes da captura instantânea.

Acesse lista de capturas instantâneas.
Clique no nome de um instantâneo na lista.
Na página de detalhes da captura de tela, clique no link Incluir tags
Na nova janela, insira uma tag de usuário ou uma tag de gerenciamento de acesso nos campos respectivos
Clique em Salvar.

Quando as tags do usuário correspondem a uma política de backup, um backup é acionado de acordo com a programação do plano de backup. Para obter mais informações, consulte Criando uma política de backup.

Adicionando tags a um snapshot pela CLI

É possível incluir tags em uma captura instantânea da CLI.

Especifique um comando snapshot-update com a opção --tags para adicionar tags de usuário a um volume.

Use a mesma opção para incluir tags em um volume quando você criar uma captura instantânea usando ibmcloud is snapshot-create

O exemplo a seguir inclui tags de usuário env:test e env:prod em um volume identificado por seu 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

Adicionando tags de usuário a um snapshot por meio da API

É possível incluir tags de usuário em uma snapshot usando a API.

Faça uma chamada PATCH /snapshots e especifique o ID de captura instantânea e as tags de usuário. O exemplo a seguir inclui tags de usuário env:test e env:prod na captura 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"
       ]
    }'

Editando zonas de restauração rápida no console

Use as etapas a seguir para editar as zonas onde os clones de restauração rápida são armazenados no console. É possível incluir ou remover zonas, conforme necessário

Selecione uma captura instantânea na lista de capturas instantâneas.
No menu Ações , selecione Editar restauração rápida.
No painel lateral, selecione ou desmarque as zonas para uma restauração rápida em sua região. Revise a atualização de faturamento com base em sua seleção
Clique em Salvar. Você retornou à página de detalhes de capturas instantâneas. A seção Restauração Rápida mostra a nova zona inicialmente com um status pendente

As informações de restauração rápida são atualizadas ao atualizar. As informações de zona são atualizadas para mostrar ativado ou desativado, dependendo de suas alterações.

Criando um clone de captura instantânea para restauração rápida por meio da CLI

Para criar uma cópia zonal de uma captura instantânea, emita o comando ibmcloud is snapshot-clone-create com o ID da captura instantânea e a zona ou zonas nas quais você deseja criar cópias. O exemplo de comando a seguir cria o clone de restauração rápida de r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 na 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

O clone de captura instantânea parece estar indisponível enquanto o clone de captura instantânea é criado. Leva apenas alguns segundos. Emita o comando ibmcloud is snapshot-cl com o ID de captura instantânea e a zona de destino de clone para ver o novo clone de captura instantânea conforme disponível.

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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-clone-create

Excluindo um clone de captura instantânea por meio da CLI

Para excluir um clone de captura instantânea, emita o comando ibmcloud is snapshot-clone-delete com o ID de captura instantânea e a zona na qual você deseja que a cópia de captura instantânea seja removida. O exemplo de comando a seguir exclui a cópia de restauração rápida da captura instantânea r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 na 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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-clone-delete

Criando um clone de captura instantânea para restauração rápida com a API

Para criar capturas instantâneas de restauração rápida, crie um clone da captura instantânea em uma zona diferente. Em seguida, você restaura um volume desse clone.

Na API, você cria um clone para uma captura instantânea existente fazendo uma chamada PUT /snapshots/{id}/clones/{zone_name} para clonar a captura instantânea para a zona especificada. Consulte o exemplo a seguir.

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}"

Uma resposta bem-sucedida se parece com o exemplo a seguir.

{
  "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,
}

Também é possível especificar a propriedade clone ao criar uma snapshot de um volume. Consulte o exemplo a seguir.

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"]
   }'

Uma resposta bem-sucedida se parece com o exemplo a seguir.

{
  "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
}

Excluindo um clone de captura instantânea com a API

Faça uma chamada DELETE /v1/snapshots/{id}/clones/{zone-name} para excluir um clone de captura instantânea na zona especificada.. Não é possível desfazer a exclusão quando o clone de captura instantânea é excluído

Consulte o exemplo a seguir.

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}"

Criando uma cópia remota no console

Use as etapas a seguir para criar cópias regionais cruzadas de capturas instantâneas da lista de capturas instantâneas para VPC ou da página de detalhes da captura instantânea.

No console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage snapshots.
Na lista de capturas instantâneas, localize a captura instantânea que deseja duplicar em outra região. Certifique-se de que o snapshot esteja no status Estável.
Clique no menu Actions (Ações), ) e selecione Copy snapshot (Copiar instantâneo ).
Selecione a região onde deseja criar a cópia.

Você pode ter apenas uma cópia por região. Se nenhuma região estiver disponível para cópias, a opção Copiar Captura Instantânea será desativada.
Clique em Criar.

Como alternativa, clique no nome do snapshot para visualizar seus detalhes. Você pode acessar a opção Copiar instantâneo no menu Ações ou pode rolar até o cartão de cópias remotas e clicar em Criar cópia. O mesmo painel de fornecimento é aberto onde é possível fazer a seleção de região.

Excluindo cópia da região remota no console

Cópias de captura instantânea em uma região remota são independentes da captura instantânea pai e do volume pai. É possível excluí-los a qualquer momento usando a lista de Capturas instantâneas para VPC

Use as etapas a seguir para excluir uma cópia de região remota no console.

No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
Clique no ícone Ações na linha da captura instantânea que você deseja excluir
Selecione ** Excluir **.
Confirme a exclusão e clique em Excluir.

Criando uma cópia de região remota a partir da CLI..

É possível criar uma cópia regional cruzada de uma captura instantânea usando o comando snapshot-create com a opção --source-snapshot-crn e o CRN de capturas instantâneas de origem, que cria uma captura instantânea na região de destino usando o CRN de uma captura instantânea da região de origem. A captura instantânea criada usa a chave de criptografia definida pelo cliente se o CRN de uma chave de criptografia também foi especificado. O snapshot de origem deve estar no status Estável para que a cópia seja criada com êxito.

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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-create

Excluindo uma cópia de região remota da CLI

É possível excluir uma cópia regional cruzada de uma captura instantânea usando o comando ibmcloud is snapshot-delete com o ID da captura 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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-delete

Criando uma cópia de região remota com a API

É possível criar uma cópia regional cruzada de uma captura instantânea fazendo uma chamada de API na região de origem. Especifique o CRN do snapshot de origem para criar uma cópia na região de destino. A captura instantânea criada usa a chave de criptografia definida pelo cliente se o CRN de uma chave de criptografia também foi especificado. O snapshot de origem deve estar no status Estável para que a cópia seja criada com êxito. Veja o exemplo a seguir, em que a região de destino é us-east e a captura instantânea original está em 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
}

Uma resposta bem-sucedida é semelhante ao exemplo a seguir:

{
  "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": []
}

Excluindo uma cópia de região remota de uma captura instantânea com a API

Crie um DELETE /snapshots/{id} na região de destino na qual a cópia remota está localizada

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

Criando uma cópia regional cruzada com o Terraform

Para criar uma cópia da captura instantânea em uma região remota, use o recurso ibm_is_snapshot.. O snapshot de origem deve estar no status Estável para que a cópia seja criada com êxito. A captura instantânea criada usa a chave de criptografia definida pelo cliente se o CRN de uma chave de criptografia também foi especificado. O exemplo a seguir cria uma cópia na região de destino usando o ID da captura instantânea de origem. A cópia será criptografada pela chave de criptografia especificada por seu 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 obter mais informações sobre argumentos e atributos, consulte ibm_is_snapshot.

Excluindo uma cópia de região remota com Terraform

Use o comando terraform destroy para excluir convenientemente um objeto remoto, como uma cópia inter-regional de um snapshot. O exemplo a seguir mostra a sintaxe para excluir uma captura instantânea. Substitua o ID real da captura instantânea em para ibm_is_snapshot.example.id.

terraform destroy --target ibm_is_snapshot.example.id

Para obter mais informações, consulte terraform destroy

Exclusão de instantâneos no console

É possível excluir qualquer captura instantânea para um volume ou todas as captura instantânea para um volume. Para poder excluir uma captura instantânea, ela deve atender aos pré-requisitos a seguir:

Estar em um estado stable ou pending.
Não estar restaurando ativamente um volume.

Uma maneira conveniente de determinar se é possível excluir um instantâneo é procurar no console a lista de instantâneos e verificar seu status. É possível excluir todas as capturas instantâneas para um volume. A exclusão de todos os instantâneos requer uma confirmação adicional no console.

Excluindo um único snapshot no console

É possível excluir uma captura instantânea da lista das capturas instantâneas usando as etapas a seguir.

Acesse a lista de todas as capturas instantâneas. No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
Clique no ícone Ações na linha da captura instantânea que você deseja excluir
Selecione ** Excluir **.
Confirme a exclusão e clique em Excluir.

Você também pode excluir um snapshot na página de detalhes de um volume do Block Storage for VPC.

Acesse a lista de todos os volumes de “ Block Storage for VPC ”. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage volumes.
Selecione um volume da lista e clique no nome do volume para acessar a página de detalhes do volume.
Clique em Capturas instantâneas. É exibida uma lista dos instantâneos criados para este volume, e você pode realizar as seguintes ações:
- Clique em Excluir todos para excluir todas as capturas instantâneas para este volume.
- Clique no ícone Ações para excluir uma captura instantânea específica.
Selecione ** Excluir **. Se o snapshot estiver restaurando um volume ativamente, a operação de exclusão não funcionará.
Confirme a exclusão.

Exclusão de todos os instantâneos de um volume no console

Para excluir todos os instantâneos de um volume no console, siga estas etapas.

Acesse a lista de todas as capturas instantâneas. No IBM Cloud console, acesse o menu Infraestrutura Armazenamento > Instantâneos.
Clique na linha para selecionar o instantâneo que você deseja excluir.
No menu Ações , selecione Excluir tudo para o volume
Confirme a exclusão digitando delete e, em seguida, clique em Excluir.

Excluindo instantâneos do Block Storage for VPC página de detalhes no console

É possível excluir o snapshot criado mais recentemente da lista de snapshots na página de detalhes do volume “ Block Storage for VPC ”. Opcionalmente, é possível excluir todas as capturas instantâneas dessa visualização.

Acesse a lista de todos os volumes de “ Block Storage for VPC ”. No IBM Cloud console, vá para o menu > Infraestrutura > Armazenamento > Block Storage.
Selecione um volume da lista e clique no nome desse volume para acessar a página de detalhes dele.
Clique em Capturas instantâneas para ver uma lista de capturas instantâneas obtidas desse volume.
Clique em Excluir todos para excluir todas as capturas instantâneas para este volume.
Como alternativa, selecione uma única captura instantânea na lista para exclusão e, em seguida:
1. Clique no ícone Ações .
2. Selecione ** Excluir **.
3. Confirme a exclusão.

Exclusão de instantâneos pela CLI

Estar em um estado stable ou pending.
Não estar restaurando ativamente um volume.

Exclusão de um único snapshot pela CLI

Use as etapas a seguir para excluir uma única captura instantânea usando a CLI.

Liste as capturas instantâneas que estão disponíveis para um volume para confirmar o ID da captura instantânea que você deseja excluir.

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

Execute o comando snapshot-delete e especifique o ID da captura instantânea. Para excluir várias capturas instantâneas, deve-se especificar todos os seus IDs no mesmo comando
```
ibmcloud is snapshot-delete SNAPSHOT_ID
```

Confirme a exclusão do snapshot. A mensagem de resposta indica que a captura instantânea foi excluída.

$ 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 obter mais informações sobre as opções de comando disponíveis, ibmcloud is snaphot-delete

Exclusão de todos os snapshots pela CLI

Use as etapas a seguir para excluir todas as capturas instantâneas usando a CLI..

Listar todas as capturas instantâneas

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

Digite o comando snapshots-delete e especifique o ID do volume.
```
ibmcloud is snapshots-delete --volume VOLUME_ID
```

Confirme a exclusão dos instantâneos. A mensagem de resposta indica quando a solicitação de exclusão de captura instantânea é aceita e as capturas instantâneas são excluídas.

$ 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 obter mais informações sobre as opções de comando disponíveis, ibmcloud is snaphot-delete

Exclusão de instantâneos por meio da API

Estar em um estado stable ou pending.
Não estar restaurando ativamente um volume.

Exclusão de um único snapshot por meio da API

Execute uma chamada DELETE /snapshots/{snapshot_ID} para excluir um snapshot específico pelo 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}"

Exclusão de todos os instantâneos de um volume por meio da API

Faça uma chamada DELETE/snapshots e especifique o ID do volume de origem para o parâmetro source_volume.id na solicitação.

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

Excluindo capturas instantâneas com o Terraform

Estar em um estado stable ou pending.
Não estar restaurando ativamente um volume.

Excluindo uma única captura instantânea com o Terraform

Use o comando terraform destroy para excluir convenientemente um objeto remoto, como um único snapshot. O exemplo a seguir exclui my-snapshot.

terraform destroy --target ibm_is_snapshot.my-snapshot

Para obter mais informações, consulte terraform destroy

Excluindo todas as capturas instantâneas para um volume com Terraform

Para excluir todas as capturas instantâneas de um volume com o Terraform, use o recurso ibm_is_volume

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

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_volume.

Monitorando estados do ciclo de vida do snapshot

A Tabela 2 descreve os estados do snapshot ao longo de seu ciclo de vida. Você pode ver esses estados no console, nas saídas de comando da CLI, nas respostas da API e nas fontes de dados do Terraform.

Estados do ciclo de vida da captura instantânea
Status da captura instantânea	Explicação
Estável	A captura instantânea está disponível para restaurar um volume.
Aguardando	As informações da captura instantânea estão sendo recuperadas.
Pendente	Enquanto a captura instantânea está sendo criada, é exibida a porcentagem concluída.
Com falha	Não foi possível criar o instantâneo; o volume não pode ser restaurado a partir de um instantâneo.
Suspenso	A captura instantânea está temporariamente indisponível.
Atualizando	Você mudou algo sobre a captura instantânea e ela está sendo atualizada.
Excluindo	O snapshot está sendo excluído.
Excluído	A captura instantânea foi excluída e não está disponível para restaurar volumes.

Próximas etapas

É possível Restaurar um volume a partir de uma snapshot.