Copie um snapshot instantâneo para um local diferente

Em determinados cenários, talvez você queira copiar um instantâneo instantâneo para uma zona ou região diferente de seu disco de origem. As ocasiões possíveis incluem:

  • Preservar os dados em um instantâneo antes de excluir o disco de origem, pois a exclusão do disco exclui seus instantâneos.
  • Proteger o snapshot instantâneo contra uma interrupção zonal ou regional armazenando-o em um local diferente.
  • Mover um instantâneo instantâneo com dados de um evento ou marco de projeto para armazenamento de longo prazo.
  • Usar um snapshot instantâneo em um local para criar um novo disco em outro local.

Nesses cenários, você deve criar uma captura instantânea padrão ou de arquivo a partir da captura instantânea e usar essa captura instantânea recém-criada.

Esta página explica como criar um snapshot padrão ou de arquivo a partir de um snapshot instantâneo.

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:

    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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções e permissões necessárias

Para obter as permissões necessárias para criar um snapshot padrão a partir de um snapshot instantâneo, peça ao administrador para conceder a você as seguintes funções do IAM no projeto:

Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Essas funções predefinidas contêm as permissões necessárias para criar um snapshot padrão a partir de um snapshot instantâneo. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Permissões necessárias

As seguintes permissões são necessárias para criar um snapshot padrão a partir de um snapshot instantâneo:

  • Para criar um instantâneo padrão:
    • compute.snapshots.create no projeto de destino para o novo instantâneo padrão
    • compute.instantSnapshots.useReadOnly no snapshot instantâneo de origem

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Restrições

Se o disco de origem de um instantâneo for criptografado com uma chave de criptografia fornecida pelo cliente (CSEK) , o instantâneo também será criptografado com a mesma chave. Portanto, para criar um snapshot padrão a partir de um snapshot criptografado por CSEK, você deve fornecer a chave usada para criptografar o disco de origem.

Você pode criar um instantâneo padrão de um disco individual no máximo 6 vezes a cada 60 minutos. Este limite também se aplica à criação de um snapshot padrão a partir de um snapshot instantâneo de um disco.

Crie um snapshot padrão ou de arquivo a partir de um snapshot instantâneo

Você pode criar um snapshot padrão ou de arquivo a partir de um snapshot instantâneo usando a CLI gcloud, o console do Google Cloud ou REST.

Console

  1. Encontre o instantâneo instantâneo:

    1. No console do Google Cloud, acesse a página Instantâneos .

      Vá para Instantâneos

    2. Clique na guia Instantâneos .

    3. Na coluna Nome , anote o nome do instantâneo que você deseja restaurar.

  2. Clique em Criar instantâneo .

  3. No campo Nome , insira um nome exclusivo para identificar o instantâneo.

  4. Opcional. Adicione mais detalhes sobre o instantâneo no campo Descrição .

  5. Em Tipo de origem do instantâneo , escolha Instantâneo instantâneo .

  6. Na lista Instantâneo de origem , selecione o instantâneo que deseja usar.

  7. Para Type , escolha Snapshot ou Archive snapshot .

  8. Na seção Local , escolha o local de armazenamento do snapshot . O local padrão predefinido ou personalizado definido nas configurações do snapshot é selecionado automaticamente. Opcionalmente, você pode substituir as configurações de snapshot e armazená-los em um local de armazenamento personalizado fazendo o seguinte:

    1. Escolha o tipo de local de armazenamento que deseja para seu instantâneo.

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

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

  9. Se o instantâneo for 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 agrupada com a chave RSA pública, selecione Chave agrupada .

  10. Clique em Criar para criar o instantâneo.

gcloud

Crie um snapshot padrão a partir de um snapshot zonal ou regional com o comando gcloud compute snapshots create . Você usa sinalizadores diferentes dependendo se o snapshot instantâneo é de um disco zonal ou regional.

Instantâneo zonal

Crie seu snapshot padrão ou de arquivo a partir de um snapshot zonal usando a política de local de armazenamento definida pelas configurações do snapshot ou usando um local de armazenamento alternativo de sua escolha. Para obter mais informações, consulte Escolha o local de armazenamento do snapshot .

  • Para criar uma captura instantânea padrão ou de arquivo no local padrão predefinido ou customizado configurado nas configurações da captura instantânea, use o seguinte comando: 
gcloud 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 o seguinte pelos valores correspondentes:

  • NEW_STANDARD_SNAPSHOT_NAME : um nome exclusivo para o novo instantâneo padrão.
  • SRC_INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo de origem.
  • SOURCE_ZONE : a zona onde o snapshot instantâneo está localizado.

  • SNAPSHOT_TYPE : o tipo de instantâneo a ser criado, STANDARD ou ARCHIVE . Se este sinalizador for omitido, um instantâneo padrão será criado.

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

gcloud 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 o seguinte pelos valores correspondentes:

  • NEW_STANDARD_SNAPSHOT_NAME : um nome exclusivo para o novo instantâneo.
  • SRC_INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo de origem.
  • SOURCE_ZONE : a zona onde o snapshot instantâneo está localizado.

  • STORAGE_LOCATION : para locais de armazenamento personalizados, esta é a multirregião do Cloud Storage ou a região do Cloud Storage onde você deseja armazenar seu snapshot. Você pode especificar apenas um local de armazenamento.

    Use o sinalizador --storage-location somente quando desejar substituir o local de armazenamento padrão predefinido ou personalizado configurado nas configurações do snapshot.

  • SNAPSHOT_TYPE : o tipo de instantâneo a ser criado, STANDARD ou ARCHIVE . Se este sinalizador for omitido, um instantâneo padrão será criado.

Instantâneo instantâneo regional

Crie seu snapshot padrão ou de arquivo a partir de um snapshot regional usando a política de local de armazenamento definida pelas configurações do snapshot ou usando um local de armazenamento alternativo de sua escolha. Para obter mais informações, consulte Escolha o local de armazenamento do snapshot .

  • Para criar uma captura instantânea padrão ou de arquivo no local padrão predefinido ou customizado configurado nas configurações da captura instantânea, use o seguinte comando: 
gcloud 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 o seguinte pelos valores correspondentes:

  • NEW_STANDARD_SNAPSHOT_NAME : um nome exclusivo para o novo instantâneo padrão.
  • SRC_INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo de origem.
  • SOURCE_REGION : a região onde o snapshot instantâneo está localizado.

  • SNAPSHOT_TYPE : o tipo de instantâneo a ser criado, STANDARD ou ARCHIVE . Se este sinalizador for omitido, um instantâneo padrão será criado.

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

gcloud 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 o seguinte pelos valores correspondentes:

  • NEW_STANDARD_SNAPSHOT_NAME : um nome exclusivo para o novo instantâneo.
  • SRC_INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo de origem.
  • SOURCE_REGION : a região onde o snapshot instantâneo está localizado.

  • STORAGE_LOCATION : para locais de armazenamento personalizados, esta é a multirregião do Cloud Storage ou a região do Cloud Storage onde você deseja armazenar seu snapshot. Você pode especificar apenas um local de armazenamento.

    Use o sinalizador --storage-location somente quando desejar substituir o local de armazenamento padrão predefinido ou personalizado configurado nas configurações do snapshot.

  • SNAPSHOT_TYPE : o tipo de instantâneo a ser criado, STANDARD ou ARCHIVE . Se este sinalizador for omitido, um instantâneo padrão será criado.

DESCANSAR

Para criar um snapshot padrão a partir de um 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âneo zonal

Crie seu snapshot padrão ou de arquivo a partir de um snapshot zonal usando a política de local de armazenamento definida pelas configurações do snapshot ou usando um local de armazenamento alternativo de sua escolha. Para obter mais informações, consulte Escolha o local de armazenamento do snapshot .

  • Para criar uma captura instantânea padrão ou de arquivo no local padrão predefinido ou personalizado configurado nas configurações da captura instantânea, faça uma solicitação POST para o método snapshots.insert .

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

POST https://compute.googleapis.com/compute/v1/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 o seguinte pelos valores correspondentes:

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

Use o parâmetro storageLocations somente quando desejar substituir o local de armazenamento padrão predefinido ou customizado configurado nas configurações de snapshot.

Instantâneo instantâneo regional

Crie seu padrão regional ou snapshot de arquivo a partir de um snapshot instantâneo regional usando a política de local de armazenamento definida pelas configurações do snapshot ou usando um local de armazenamento alternativo de sua escolha. Para obter mais informações, consulte Escolha o local de armazenamento do snapshot .

Para criar um volume de captura instantânea padrão ou de arquivo no local padrão predefinido ou customizado configurado em suas configurações de captura instantânea, faça uma solicitação POST para o método snapshots.insert .

POST https://compute.googleapis.com/compute/v1/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 o seguinte pelos valores correspondentes:

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

Resposta de solicitação de API

Se a solicitação POST for bem-sucedida, o corpo da resposta será um objeto que você poderá pesquisar para obter o status da criação do instantâneo. Consulte Tratamento de respostas de API para obter mais informações.

O que vem a seguir