Copie um instantâneo para uma localização diferente

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

  • Preservar os dados num instantâneo antes de eliminar o disco de origem, uma vez que a eliminação do disco elimina os respetivos instantâneos.
  • Proteger a captura instantânea de uma indisponibilidade zonal ou regional armazenando-a numa localização diferente.
  • Mover uma captura instantânea com dados de um evento ou um marco do projeto para o armazenamento a longo prazo.
  • Usar uma captura instantânea num local para criar um novo disco noutro local.

Nestes cenários, tem de criar um instantâneo padrão ou de arquivo a partir do instantâneo e usar esse instantâneo recém-criado.

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

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Funções e autorizações necessárias

Para receber as autorizações de que precisa para criar uma captura de ecrã padrão a partir de uma captura de ecrã instantânea, peça ao seu administrador que lhe conceda as seguintes funções de IAM no projeto:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para criar uma captura de ecrã padrão a partir de uma captura de ecrã instantânea. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para criar um instantâneo padrão a partir de um instantâneo:

  • Para criar uma imagem instantânea padrão:
    • compute.snapshots.create no projeto de destino para a nova imagem instantânea padrão
    • compute.instantSnapshots.useReadOnly no instantâneo de origem

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Restrições

Se o disco de origem de um instantâneo instantâneo estiver encriptado com uma chave de encriptação fornecida pelo cliente (CSEK), o instantâneo instantâneo também é encriptado com a mesma chave. Por conseguinte, para criar um instantâneo padrão a partir de um instantâneo instantâneo encriptado com CSEK, tem de fornecer a chave que usou para encriptar o disco de origem.

Pode criar uma captura instantânea 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 instantâneo padrão a partir de um instantâneo de um disco.

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

Pode criar um resumo padrão ou de arquivo a partir de um resumo instantâneo através da CLI gcloud, da consola ou da REST. Google Cloud

Consola

  1. Encontre o instantâneo:

    1. Na Google Cloud consola, aceda à página Instantâneos.

      Aceder a Resumos

    2. Clique no separador Capturas instantâneas.

    3. Na coluna Nome, tome nota do nome da imagem instantânea que quer restaurar.

  2. Clique em Criar instantâneo.

  3. No campo Nome, introduza um nome exclusivo para identificar a imagem instantânea.

  4. Opcional. Adicione mais detalhes sobre o resumo 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 quer usar.

  7. Em Tipo, escolha Instantâneo ou Instantâneo de arquivo.

  8. Na secção Localização, escolha a localização de armazenamento das suas capturas de ecrã. A localização predefinida predefinida ou personalizada nas definições do resumo é selecionada automaticamente. Opcionalmente, pode substituir as definições de captura instantânea e armazenar as suas capturas instantâneas numa localização de armazenamento personalizada da seguinte forma:

    1. Escolha o tipo de localização de armazenamento que quer para a sua captura instantânea.

      • Escolha Multirregional para uma maior disponibilidade a um custo mais elevado.
      • Escolha Capturas de ecrã regionais para ter mais controlo sobre a localização física dos seus dados a um custo inferior.

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

  9. Se o instantâneo estiver encriptado com CSEK, faculte a chave de encriptação:

    1. Na secção Desencriptação, introduza a chave de encriptação no campo Chave de encriptação.
    2. Se a chave estiver envolvida com a chave RSA pública, selecione Chave envolvida.

  10. Clique em Criar para criar a captura de ecrã.

gcloud

Crie um instantâneo padrão a partir de um instantâneo zonal ou regional com o comando gcloud compute snapshots create. Usa flags diferentes consoante a imagem instantânea seja de um disco zonal ou regional.

Instantâneo instantâneo zonal

Crie o seu instantâneo padrão ou de arquivo a partir de um instantâneo zonal usando a política de localização de armazenamento definida nas suas definições de instantâneos ou usando uma localização de armazenamento alternativa à sua escolha. Para mais informações, consulte o artigo Escolha a localização de armazenamento das capturas de ecrã.

  • Para criar um instantâneo padrão ou do arquivo na localização predefinida ou personalizada configurada nas definições de instantâneos, 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 resumo padrão.
  • SRC_INSTANT_SNAPSHOT_NAME: o nome do resumo instantâneo de origem.
  • SOURCE_ZONE: a zona onde se encontra a captura de ecrã instantânea.

  • SNAPSHOT_TYPE: o tipo de resumo a criar, STANDARD ou ARCHIVE. Se esta flag for omitida, é criado um instantâneo padrão.

  • Para substituir as definições de instantâneo e criar um instantâneo padrão ou de arquivo numa localização de armazenamento personalizada, inclua a flag --storage-location para indicar onde armazenar o instantâneo:

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 único para o novo resumo.
  • SRC_INSTANT_SNAPSHOT_NAME: o nome do resumo instantâneo de origem.
  • SOURCE_ZONE: a zona onde se encontra a captura de ecrã instantânea.

  • STORAGE_LOCATION: Para localizações de armazenamento personalizadas, esta é a multirregião do Cloud Storage ou a região do Cloud Storage onde quer armazenar a sua captura de ecrã. Pode especificar apenas uma localização de armazenamento.

    Use a flag --storage-location apenas quando quiser substituir a localização de armazenamento predefinida ou personalizada configurada nas definições de instantâneo.

  • SNAPSHOT_TYPE: o tipo de resumo a criar, STANDARD ou ARCHIVE. Se esta flag for omitida, é criado um instantâneo padrão.

Instantâneo regional

Crie o seu instantâneo padrão ou de arquivo a partir de um instantâneo regional usando a política de localização de armazenamento definida nas suas definições de instantâneo ou usando uma localização de armazenamento alternativa à sua escolha. Para mais informações, consulte o artigo Escolha a localização de armazenamento das capturas de ecrã.

  • Para criar um instantâneo padrão ou do arquivo na localização predefinida ou personalizada configurada nas definições de instantâneos, 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 resumo padrão.
  • SRC_INSTANT_SNAPSHOT_NAME: o nome do resumo instantâneo de origem.
  • SOURCE_REGION: a região onde se encontra a captura de ecrã instantânea.

  • SNAPSHOT_TYPE: o tipo de resumo a criar, STANDARD ou ARCHIVE. Se esta flag for omitida, é criado um instantâneo padrão.

  • Para substituir as definições de instantâneo e criar um instantâneo padrão ou de arquivo numa localização de armazenamento personalizada, inclua a flag --storage-location para indicar onde armazenar o instantâneo:

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 único para o novo resumo.
  • SRC_INSTANT_SNAPSHOT_NAME: o nome do resumo instantâneo de origem.
  • SOURCE_REGION: a região onde se encontra a captura de ecrã instantânea.

  • STORAGE_LOCATION: Para localizações de armazenamento personalizadas, esta é a multirregião do Cloud Storage ou a região do Cloud Storage onde quer armazenar a sua captura de ecrã. Pode especificar apenas uma localização de armazenamento.

    Use a flag --storage-location apenas quando quiser substituir a localização de armazenamento predefinida ou personalizada configurada nas definições de instantâneo.

  • SNAPSHOT_TYPE: o tipo de resumo a criar, STANDARD ou ARCHIVE. Se esta flag for omitida, é criado um instantâneo padrão.

REST

Para criar um instantâneo padrão a partir de um instantâneo zonal ou regional, faça um pedido POST ao método snapshots.insert.

As propriedades do pedido da API dependem de o resumo instantâneo ser de um disco zonal ou regional.

Instantâneo instantâneo zonal

Crie o seu instantâneo padrão ou de arquivo a partir de um instantâneo zonal usando a política de localização de armazenamento definida nas suas definições de instantâneos ou usando uma localização de armazenamento alternativa à sua escolha. Para mais informações, consulte o artigo Escolha a localização de armazenamento das capturas de ecrã.

  • Para criar uma captura instantânea padrão ou de arquivo na localização predefinida ou personalizada configurada nas definições de captura instantânea, faça um POSTpedido ao método snapshots.insert.

  • Para substituir as definições do instantâneo e criar o instantâneo numa localização de armazenamento personalizada, inclua a propriedade storageLocations no seu pedido.

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 criar o novo instantâneo.
  • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo para o novo resumo.
  • NEW_SNAPSHOT_TYPE: o tipo de resumo a criar, STANDARD ou ARCHIVE.
  • SOURCE_PROJECT: o projeto que contém o resumo instantâneo de origem.
  • SOURCE_ZONE: a zona onde se encontra a captura de ecrã instantânea.
  • SOURCE_INSTANT_SNAPSHOT_NAME: o nome do resumo instantâneo de origem.
  • SOURCE_ENCRYPTION_KEY: se a captura instantânea estiver encriptada com uma chave fornecida pelo cliente ou uma chave gerida pelo cliente, substitua este valor pelas informações da chave. Caso contrário, pode omitir esta propriedade.
  • STORAGE_LOCATION: opcional. A multirregião do Cloud Storage ou a região do Cloud Storage onde quer armazenar a sua captura de ecrã. Pode especificar apenas uma localização de armazenamento.

Use o parâmetro storageLocations apenas quando quiser substituir a localização de armazenamento predefinida ou personalizada configurada nas definições de instantâneo.

Instantâneo regional

Crie o seu instantâneo padrão ou de arquivo regional a partir de um instantâneo regional usando a política de localização de armazenamento definida pelas suas definições de instantâneo ou usando uma localização de armazenamento alternativa à sua escolha. Para mais informações, consulte o artigo Escolha a localização de armazenamento das capturas de ecrã.

Para criar um volume de instantâneo padrão ou de arquivo na localização predefinida ou personalizada configurada nas definições de instantâneo, faça um pedido POST ao 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 criar o novo instantâneo.
  • NEW_STANDARD_SNAPSHOT_NAME: um nome exclusivo para o novo resumo.
  • NEW_SNAPSHOT_TYPE: o tipo de instantâneo a criar, STANDARD ou ARCHIVE.
  • SOURCE_PROJECT: o projeto que contém o instantâneo instantâneo de origem.
  • SOURCE_REGION: a região onde o instantâneo está localizado.
  • SOURCE_INSTANT_SNAPSHOT_NAME: o nome do instantâneo instantâneo de origem.
  • SOURCE_ENCRYPTION_KEY: se a captura instantânea estiver encriptada com uma chave fornecida pelo cliente ou uma chave gerida pelo cliente, substitua este valor pelas informações da chave. Caso contrário, pode omitir esta propriedade.

Resposta do pedido de API

Se o pedido POST for bem-sucedido, o corpo da resposta é um objeto que pode sondar para obter o estado da criação da captura de ecrã. Consulte Processar respostas da API para mais informações.

O que se segue?