Esta página foi traduzida pela API Cloud Translation.

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:

Preservar os dados em um Instant Snapshot antes de você excluir o disco de origem, já que a exclusão do disco exclui os snapshots instantâneos.
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.

Nessas situações, você precisa criar um snapshot de arquivamento ou padrão do Instant Snapshot e usar o 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 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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Papéis e permissões necessárias

Para receber as permissões necessárias e criar um snapshot padrão a partir de um Instant Snapshot, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Administrador da instância da computação (v1) (roles/compute.instanceAdmin.v1)
Para se conectar a uma VM que pode ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (roles/iam.serviceAccountUser)

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

Esses papéis predefinidos contêm as permissões necessárias para criar um snapshot padrão a partir de um Instant Snapshot. Para conferir 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 com base em um Instant Snapshot:

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

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

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

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.
Clique em Criar snapshot.
No campo Nome, insira um nome exclusivo para identificar o snapshot.
Opcional. Adicione mais detalhes sobre o snapshot no campo Descrição.
Em Tipo de origem do snapshot, escolha instant snapshot.
Na lista instant snapshot de origem, selecione o snapshot que você quer usar.
Em Tipo, escolha Snapshot ou Arquivo snapshot.
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.
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.
Clique em Criar para criar o snapshot.

gcloud

Crie um snapshot padrão com base em um instant snapshot zonal ou regional com o comando gcloud 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 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 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 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 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

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/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 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.

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

Saiba como compartilhar o snapshot padrão entre projetos.
Saiba como criar uma VM a partir do snapshot padrão.
Receba ajuda para solucionar erros na criação de snapshots padrão e erros na criação de snapshots instantâneos.