Copiar um instant snapshot para outro local

Em determinados cenários, convém copiar um snapshot instantâneo para uma zona ou região diferente do disco de origem. As possíveis ocasiões incluem:

  • Proteger o instant snapshot de uma interrupção temporária zonal ou regional armazenando-o em um local diferente.
  • Transferir um instant snapshot com dados de um marco de um evento ou projeto para um armazenamento de longo prazo.
  • Uso de um snapshot instantâneo em um local para criar um novo disco em outro local.

Não é possível executar essas tarefas com um instant snapshot. Em vez disso, crie um snapshot padrão ou de arquivo com base no instant snapshot e use esse snapshot recém-criado.

Nesta página, explicamos como criar um snapshot padrão ou de arquivo usando um instant snapshot.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Restrições

Se o disco de origem de um snapshot for criptografado com uma chave de criptografia fornecida pelo cliente (CSEK), o snapshot instantâneo também será criptografado com a mesma chave.

Portanto, para criar um snapshot padrão com base em um snapshot instantâneo criptografado por CSEK, é preciso fornecer a chave usada para criptografar o disco de origem.

Criar um snapshot padrão ou de arquivo com base em um instant snapshot

É possível criar um snapshot padrão ou de arquivo com base em um instant snapshot usando a CLI gcloud, o console do Google Cloud ou REST.

Console

  1. Encontre o instant snapshot:

    1. No console do Google Cloud, acesse a página Snapshots.

      Acesse Snapshots

    2. Clique na guia Instant Snapshots.

    3. Na coluna Nome, anote o nome do snapshot que você quer restaurar.

  2. Clique em Criar snapshot.

  3. No campo Nome, insira um nome exclusivo para identificar o snapshot.

  4. Opcional. Adicione mais detalhes sobre o snapshot no campo Descrição.

  5. Em Tipo de origem do snapshot, escolha instant snapshot.

  6. Na lista instant snapshot de origem, selecione o snapshot que você quer usar.

  7. Em Tipo, escolha Snapshot ou Arquivo snapshot.

  8. Na seção Local, escolha o local de armazenamento dos snapshots. O local padrão predefinido ou personalizado definido nas configurações de snapshot é selecionado automaticamente. Se preferir, modifique as configurações dos snapshots e os armazene em um local de armazenamento personalizado da seguinte forma:

    1. Escolha o tipo de local de armazenamento que você quer para os snapshots.

      • Escolha Multirregional para maior disponibilidade a um custo mais alto.
      • Escolha Snapshots regionais para ter mais controle sobre a localização física dos dados por um custo menor.

    2. No campo Selecionar local, escolha a região ou multirregião específica que você quer usar. Para usar a região ou multirregião mais próxima do disco de origem, selecione Com base no local do disco.

  9. Se o Instant Snapshot estiver criptografado por CSEK, forneça a chave de criptografia:

    1. Na seção Descriptografia, insira a chave de criptografia no campo Chave de criptografia.
    2. Se a chave estiver encapsulada com a chave RSA pública, selecione Chave encapsulada.

  10. Clique em Criar para criar o snapshot.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Crie um snapshot padrão com base em um instant snapshot zonal ou regional com o comando gcloud beta compute snapshots create. As flags diferentes serão usadas dependendo de o instant snapshot ser de um disco zonal ou regional.

instant snapshot zonal

Crie seu snapshot padrão ou de arquivo com base em um snapshot instantâneo zonal usando a política de local de armazenamento definida pelas configurações de snapshot (Visualização) ou outro local de armazenamento de sua escolha. Para mais informações, consulte Escolher o local de armazenamento dos snapshots.

  • Para criar um snapshot padrão ou de arquivo no local padrão predefinido ou personalizado definido nas configurações do snapshot, use o seguinte comando:

    gcloud beta compute snapshots create NEW_STANDARD_SNAPSHOT_NAME \
 --source-instant-snapshot=SRC_INSTANT_SNAPSHOT_NAME \
 --source-instant-snapshot-zone=SOURCE_ZONE \
 --snapshot-type=SNAPSHOT_TYPE

    Substitua os seguintes valores pelos valores correspondentes:

    • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo para o novo snapshot padrão.
    • SRC_INSTANT_SNAPSHOT_NAME: o nome do snapshot instantâneo de origem.
    • SOURCE_ZONE: a zona em que o snapshot instantâneo está localizado.
    • SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE. Se essa flag for omitida, um snapshot padrão será criado.

  • Para modificar as configurações de snapshot e criar um snapshot padrão ou de arquivo em um local de armazenamento personalizado, inclua a flag --storage-location para indicar onde armazenar seu snapshot:

    gcloud beta compute snapshots create NEW_STANDARD_SNAPSHOT_NAME \
 --source-instant-snapshot=SRC_INSTANT_SNAPSHOT_NAME \
 --source-instant-snapshot-zone=SOURCE_ZONE \
 --storage-location=STORAGE_LOCATION \
 --snapshot-type=SNAPSHOT_TYPE

    Substitua os seguintes valores pelos valores correspondentes:

    • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo do novo snapshot
    • SRC_INSTANT_SNAPSHOT_NAME: o nome do snapshot instantâneo de origem.
    • SOURCE_ZONE: a zona em que o snapshot instantâneo está localizado.
    • STORAGE_LOCATION: para locais de armazenamento personalizados, é a multirregião do Cloud Storage ou a região do Cloud Storage em que você quer armazenar snapshots. É possível especificar apenas um local de armazenamento.

    Use a flag --storage-location apenas quando quiser substituir o local de armazenamento padrão predefinido ou personalizado que está definido nas configurações de snapshot. + SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE. Se essa flag for omitida, um snapshot padrão será criado.

instant snapshot regional

Crie seu snapshot padrão ou de arquivo com base em um instant snapshot regional usando a política de local de armazenamento definida pelas configurações de snapshot (Visualização) ou outro local de armazenamento de sua escolha. Para mais informações, consulte Escolher o local de armazenamento dos snapshots.

  • Para criar um snapshot padrão ou de arquivo no local padrão predefinido ou personalizado definido nas configurações do snapshot, use o seguinte comando:

    gcloud beta compute snapshots create NEW_STANDARD_SNAPSHOT_NAME \
 --source-instant-snapshot=SRC_INSTANT_SNAPSHOT_NAME \
 --source-instant-snapshot-region=SOURCE_REGION \
 --snapshot-type=SNAPSHOT_TYPE

    Substitua os seguintes valores pelos valores correspondentes:

    • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo para o novo snapshot padrão.
    • SRC_INSTANT_SNAPSHOT_NAME: o nome do snapshot instantâneo de origem.
    • SOURCE_REGION: a região em que o snapshot instantâneo está localizado.
    • SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE. Se essa flag for omitida, um snapshot padrão será criado.

  • Para modificar as configurações de snapshot e criar um snapshot padrão ou de arquivo em um local de armazenamento personalizado, inclua a flag --storage-location para indicar onde armazenar seu snapshot:

    gcloud beta compute snapshots create NEW_STANDARD_SNAPSHOT_NAME \
 --source-instant-snapshot=SRC_INSTANT_SNAPSHOT_NAME \
 --source-instant-snapshot-region=SOURCE_REGION \
 --storage-location=STORAGE_LOCATION \
 --snapshot-type=SNAPSHOT_TYPE

    Substitua os seguintes valores pelos valores correspondentes:

    • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo do novo snapshot
    • SRC_INSTANT_SNAPSHOT_NAME: o nome do snapshot instantâneo de origem.
    • SOURCE_REGION: a região em que o snapshot instantâneo está localizado.
    • STORAGE_LOCATION: para locais de armazenamento personalizados, é a multirregião do Cloud Storage ou a região do Cloud Storage em que você quer armazenar snapshots. É possível especificar apenas um local de armazenamento.

    Use a flag --storage-location apenas quando quiser substituir o local de armazenamento padrão predefinido ou personalizado que está definido nas configurações de snapshot. + SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE. Se essa flag for omitida, um snapshot padrão será criado.

REST

Para criar um snapshot padrão com base em um instant snapshot zonal ou regional, faça uma solicitação POST para o método snapshots.insert.

As propriedades da solicitação de API dependem de o snapshot instantâneo ser de um disco zonal ou regional.

instant snapshot zonal

Crie seu snapshot padrão ou de arquivo com base em um snapshot instantâneo zonal usando a política de local de armazenamento definida pelas configurações de snapshot (Visualização) ou outro local de armazenamento de sua escolha. Para mais informações, consulte Escolher o local de armazenamento dos snapshots.

  • Para criar um snapshot padrão ou de arquivo no local padrão predefinido ou personalizado definido nas configurações do snapshot, faça uma solicitação POST para o método snapshots.insert.

  • Para modificar as configurações e criar o snapshot em um local de armazenamento personalizado, inclua a propriedade storageLocations na solicitação.

    POST https://compute.googleapis.com/compute/beta/projects/DESTINATION_PROJECT/global/snapshots { "name": "NEW_STANDARD_SNAPSHOT_NAME", "snapshotType": "NEW_SNAPSHOT_TYPE", "sourceInstantSnapshot": "projects/SOURCE_PROJECT/zones/SOURCE_ZONE/instantSnapshots/SOURCE_INSTANT_SNAPSHOT_NAME", "sourceInstantSnapshotEncryptionKey": "SOURCE_ENCRYPTION_KEY" }

Substitua os seguintes valores pelos valores correspondentes:

  • DESTINATION_PROJECT: o projeto em que o novo snapshot será criado.
  • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo do novo snapshot
  • NEW_SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE.
  • SOURCE_PROJECT: o projeto que contém o snapshot instantâneo de origem.
  • SOURCE_ZONE: a zona em que o snapshot instantâneo está localizado.
  • SOURCE_INSTANT_SNAPSHOT_NAME: o nome do snapshot instantâneo de origem.
  • SOURCE_ENCRYPTION_KEY: se o snapshot instantâneo for criptografado com uma chave fornecida pelo cliente ou gerenciada pelo cliente, substitua esse valor pelas informações da chave. Caso contrário, é possível omitir essa propriedade.
  • STORAGE_LOCATION: opcional. A multirregião do Cloud Storage ou a região do Cloud Storage em que você quer armazenar o snapshot. É possível especificar apenas um local de armazenamento.

Use o parâmetro storageLocations somente quando quiser substituir o local de armazenamento padrão predefinido ou personalizado que está definido nas configurações de snapshot.

instant snapshot regional

Crie um padrão regional ou snapshot de arquivo com base em um snapshot instantâneo regional usando a política de local de armazenamento definida pelas configurações de snapshot (Prévia) ou outro local de armazenamento de sua escolha. Para mais informações, consulte Escolher o local de armazenamento dos snapshots.

  • Para criar um volume de snapshot padrão ou de arquivo no local padrão predefinido ou personalizado definido nas configurações do snapshot, faça uma solicitação POST para o método snapshots.insert.

  • Crie um snapshot padrão ou de arquivo com base em um Instant Snapshot regional:

      POST https://compute.googleapis.com/compute/beta/projects/DESTINATION_PROJECT/global/snapshots
  {
    "name": "NEW_STANDARD_SNAPSHOT_NAME",
    "snapshotType": "NEW_SNAPSHOT_TYPE",
    "sourceInstantSnapshot": "projects/SOURCE_PROJECT/regions/SOURCE_REGION/instantSnapshots/SOURCE_INSTANT_SNAPSHOT_NAME",
    "sourceInstantSnapshotEncryptionKey": "SOURCE_ENCRYPTION_KEY"
  }

    Substitua os seguintes valores pelos valores correspondentes:

    • DESTINATION_PROJECT: o projeto em que o novo snapshot será criado.
    • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo do novo snapshot
    • NEW_SNAPSHOT_TYPE: o tipo de snapshot a ser criado, STANDARD ou ARCHIVE.
    • SOURCE_PROJECT: o projeto que contém o snapshot instantâneo de origem.
    • SOURCE_REGION: a região em que o instant snapshot está localizado.
    • SOURCE_INSTANT_SNAPSHOT_NAME: o nome do instant snapshot de origem.
    • SOURCE_ENCRYPTION_KEY: se o snapshot instantâneo for criptografado com uma chave fornecida pelo cliente ou gerenciada pelo cliente, substitua esse valor pelas informações da chave. Caso contrário, é possível omitir essa propriedade.

Resposta da solicitação de API

Se a solicitação POST for bem-sucedida, o corpo da resposta será um objeto que poderá ser pesquisado para conferir o status da criação do snapshot. Consulte Como processar respostas da API para mais informações.

A seguir