Crie e gerencie instantâneos instantâneos


Este documento explica como criar e gerenciar instantâneos . Os instantâneos capturam o conteúdo de um disco e podem ser usados ​​para criar um novo disco em minutos.

Os instantâneos instantâneos são armazenados na mesma zona ou região que seus discos de origem e não substituem os instantâneos padrão , que oferecem backup externo para recuperação de desastres. Saiba mais sobre as outras opções de proteção de dados disponíveis no Compute Engine.

Para acessar os dados em um instantâneo, use o instantâneo para criar um novo disco .

Se você quiser copiar um snapshot instantâneo para outro local ou reter os dados do snapshot após a exclusão do disco de origem, crie um snapshot padrão a partir do 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 snapshots instantâneos, peça ao administrador que conceda 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 instantâneos. 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 instantâneos:

  • Para criar um instantâneo instantâneo: compute.instantSnapshots.create
  • Para visualizar instantâneos instantâneos: compute.instantSnapshots.list
  • Para visualizar detalhes de snapshots instantâneos: compute.instantSnapshots.get
  • Para excluir um snapshot instantâneo: compute.instantSnapshots.delete

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

Limitações

  • Não é possível criar snapshots instantâneos de volumes Extreme Persistent Disk, Hyperdisk Throughput ou Hyperdisk ML.
  • Não é possível selecionar o local de armazenamento de um snapshot instantâneo. É sempre armazenado na mesma região ou zona do disco de origem.

  • Quando você exclui um disco, todos os instantâneos do disco são excluídos. Isso significa que quando você exclui uma VM, os instantâneos do disco de inicialização da VM são excluídos. Os instantâneos instantâneos de discos que não são de inicialização anexados à VM também serão excluídos se você tiver habilitado a exclusão automática do disco . Para reter os dados em um instantâneo antes de serem excluídos, crie um instantâneo padrão a partir do instantâneo .

  • Um instantâneo instantâneo só pode ser acessado na zona ou região onde está armazenado. Para mover um snapshot instantâneo para outra região, você deve criar um snapshot padrão a partir do snapshot instantâneo.

  • Ao criar um disco a partir de um instantâneo criptografado por CMEK, você deve fornecer a chave de criptografia do instantâneo.

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

  • Não é possível criar uma VM a partir de um snapshot instantâneo de um disco de inicialização. Crie primeiro um disco a partir do instantâneo instantâneo e escolha o disco como origem da VM.

  • Você pode criar um instantâneo instantâneo de um determinado disco no máximo uma vez a cada 30 segundos.

  • Você não pode ter mais de 32 snapshots instantâneos do mesmo disco.

  • Não é possível criar snapshots instantâneos com programações de snapshots.

  • Não é possível criar snapshots instantâneos em volumes secundários de disco permanente replicados de forma assíncrona.

  • Os instantâneos instantâneos são consistentes com falhas e não com aplicativos. Isso significa que quaisquer dados na memória que ainda não tenham sido gravados no disco não serão capturados no snapshot instantâneo. Se você precisar de consistência de aplicativo, crie um snapshot padrão consistente de aplicativo .

  • Você não pode mover um disco até excluir todos os instantâneos do disco. Para obter mais informações, consulte Movendo um disco que contém instantâneos .

  • Você não pode editar os dados armazenados em um instantâneo.

  • Você não pode recuperar instantâneos excluídos.

Crie um instantâneo instantâneo de um disco

Os instantâneos instantâneos de discos zonais são armazenados na mesma zona que o disco de origem. Da mesma forma, os snapshots instantâneos de discos regionais são armazenados na mesma região do disco.

Você pode criar um snapshot instantâneo com a CLI gcloud, o console do Google Cloud ou REST.

Console

  1. No console do Google Cloud, acesse a página de instâncias de VM .

    Acesse as instâncias de VM

  2. Selecione o projeto com o qual deseja trabalhar.

  3. Na coluna Nome , clique no nome da VM anexada ao disco do qual deseja fazer backup.

  4. Na seção Armazenamento , selecione um disco de uma das seguintes maneiras:

    • Para fazer backup do disco de inicialização da VM, na seção Disco de inicialização , clique no Nome do disco de inicialização.
    • Para fazer backup de um volume de disco anexado, na seção Discos adicionais , clique no Nome do disco.
  5. Para concluir a criação de um instantâneo, na página Criar um instantâneo , faça o seguinte:

    1. No campo Nome , insira um nome exclusivo para identificar o snapshot instantâneo.
    2. Opcional: Adicione mais detalhes sobre a captura instantânea no campo Descrição .
    3. No campo Tipo , selecione Instantâneo instantâneo . O campo Localização é automaticamente definido para a mesma zona ou região do disco.
    4. No campo Tipo de origem do instantâneo , verifique se Disco está selecionado.
    5. Opcional: para organizar seu projeto, adicione um ou mais rótulos .
    6. Clique em Criar .

gcloud

Para criar um snapshot instantâneo, use o comando gcloud compute instant-snapshots create :

Disco zonal

Para criar um snapshot instantâneo de um disco zonal:

 gcloud compute instant-snapshots create INSTANT_SNAPSHOT_NAME \
   --source-disk=SOURCE_DISK_NAME \
   --zone=SOURCE_DISK_ZONE
 

Substitua o seguinte:

  • INSTANT_SNAPSHOT_NAME : um nome exclusivo para o instantâneo instantâneo.
  • SOURCE_DISK_NAME : o nome do disco de origem.
  • SOURCE_DISK_ZONE : a zona do disco de origem. O instantâneo será criado na mesma zona.

Disco regional

Para criar um snapshot instantâneo de um disco regional:

 gcloud compute instant-snapshots create INSTANT_SNAPSHOT_NAME \
   --source-disk=SOURCE_DISK_NAME \
   --region=SOURCE_DISK_REGION
 

Substitua o seguinte:

  • INSTANT_SNAPSHOT_NAME : um nome exclusivo para o instantâneo instantâneo.
  • SOURCE_DISK_NAME : o nome do disco de origem.
  • SOURCE_DISK_REGION : a região do disco de origem. O instantâneo instantâneo será criado na mesma região.

DESCANSAR

Para criar um snapshot instantâneo, faça uma solicitação POST para o método instantSnapshots.insert .

  • Crie um snapshot instantâneo de um disco zonal:

    Especifique a zona na URL da solicitação POST . No corpo da solicitação, especifique um nome para o novo instantâneo e a URL do disco de origem.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/DISK_ZONE/instantSnapshots
    {
     "name": "INSTANT_SNAPSHOT_NAME",
     "sourceDisk": "projects/PROJECT_ID/zones/DISK_ZONE/disks/SOURCE_DISK_NAME"
    }
    

    Substitua o seguinte pelos valores correspondentes:

    • PROJECT_ID : o nome do projeto que contém o disco.
    • DISK_ZONE : a zona onde o disco está localizado. o instantâneo será criado nesta zona.
    • INSTANT_SNAPSHOT_NAME : um nome exclusivo para o instantâneo instantâneo.
    • SOURCE_DISK_NAME : o nome do disco de origem.
  • Crie um snapshot instantâneo de um disco regional:

    Especifique a região na URL da solicitação POST . Inclua o nome e o disco de origem do novo instantâneo no corpo da solicitação.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/DISK_REGION/instantSnapshots
    {
      "name": "INSTANT_SNAPSHOT_NAME",
      "sourceDisk": "projects/PROJECT_ID/regions/DISK_REGION/disks/SOURCE_DISK_NAME"
    }
    

    Substitua o seguinte no corpo da solicitação pelos valores correspondentes:

    • PROJECT_ID : o nome do projeto que contém o disco.
    • DISK_REGION : a região onde o disco de origem está localizado. O instantâneo será criado na mesma região.
    • INSTANT_SNAPSHOT_NAME : um nome exclusivo para o instantâneo.
    • SOURCE_DISK_NAME : o nome do disco de origem.

Solicitar resposta

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 snapshot instantâneo. Consulte Tratamento de respostas de API para obter mais informações.

Restaurar um snapshot instantâneo para um novo disco

Para restaurar dados armazenados em backup com um snapshot instantâneo, crie um novo disco a partir do snapshot instantâneo .

Visualize os instantâneos em um projeto ou local

Você pode visualizar a lista de todos os snapshots instantâneos em um projeto ou local usando a CLI gcloud, o console do Google Cloud ou REST.

Console

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

    Vá para a página Instantâneos

  2. Clique na guia Instantâneos . A lista de instantâneos é exibida.

  3. Opcional: restrinja seus resultados com o campo Filtro filter_list . Insira um nome ou valor de propriedade no campo Filtro filter_list ou escolha uma das propriedades disponíveis.

gcloud

Você pode listar os instantâneos em um projeto ou local específico com o comando gcloud compute instant-snapshots list .

Liste todos os snapshots em um projeto ou em uma zona ou região:

  • Liste todos os instantâneos em um projeto específico:

    gcloud compute instant-snapshots list --project=PROJECT_ID
    

    Substitua PROJECT_ID pelo ID do projeto.

  • Liste os snapshots instantâneos em uma zona com o argumento --zones :

    gcloud compute instant-snapshots list --zones=ZONE
    

    Substitua ZONE pelo nome da zona de destino.

  • Liste os instantâneos regionais em uma região usando o argumento --regions :

    gcloud compute instant-snapshots list --regions=REGION
    

    Substitua REGION : pelo nome da região de destino.

DESCANSAR

Você pode recuperar uma lista de instantâneos em um projeto ou local específico.

  • Liste os snapshots em um projeto:

    Faça uma solicitação GET para o método instantSnapshots.gregatedList :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instantSnapshots
    

    Substitua PROJECT_ID pelo ID do projeto.

  • Liste os instantâneos em uma zona ou região:

    Faça uma solicitação GET para o método instantSnapshots.list .

    • Liste os snapshots instantâneos em uma zona:

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE//instantSnapshots
      

      Substitua o seguinte:

      • PROJECT_ID : o ID do projeto.
      • SOURCE_ZONE : a zona de destino, por exemplo, us-west1-a .
    • Liste os instantâneos regionais em uma região:

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/instantSnapshots
      

      Substitua o seguinte:

      • PROJECT_ID : o ID do projeto.
      • SOURCE_REGION : a região de destino, por exemplo, us-west1 .

Visualize os instantâneos instantâneos de um disco

Você pode visualizar a lista de snapshots instantâneos de um disco usando a CLI gcloud, o console do Google Cloud ou REST.

Console

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

    Vá para a página Instantâneos

  2. Clique na guia Instantâneos . A lista de todos os instantâneos do projeto é exibida.

  3. Limite os resultados por disco de origem:

    1. Insira Source disk: no campo Filtro filter_list . Entrando no filtro do disco de origem

      Uma lista de discos com instantâneos é exibida.

    2. Selecione o nome do disco na lista Valores . A lista de instantâneos mostra todos os instantâneos do disco.

      Se você não vir o nome de um disco no campo Filtro filter_list , digite as primeiras letras do nome do disco para alterar a lista de opções filtradas que você vê.

gcloud

  1. Liste os snapshots instantâneos de um disco com o comando gcloud compute instant-snapshots list e o argumento --filter :

    • Liste os snapshots instantâneos de um disco zonal:

      gcloud compute instant-snapshots list \
      --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
      

      Substitua o seguinte:

      • PROJECT_ID : o ID do projeto.
      • ZONE : o nome da zona do disco, por exemplo, us-west1-a .
      • DISK_NAME : o nome do disco de origem, por exemplo, disk-1 .
    • Liste os snapshots instantâneos para um disco regional:

      gcloud compute instant-snapshots list \
      --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME
      

      Substitua o seguinte:

      • PROJECT_ID : o ID do projeto.
      • SOURCE_REGION : o nome da região do disco, por exemplo, us-west1 .
      • DISK_NAME : o nome do disco, por exemplo, disk-1 .

DESCANSAR

Liste os snapshots instantâneos de um disco zonal ou regional com uma solicitação GET para o método instantSnapshots.list .

Use o parâmetro de consulta filter=sourceDisk para especificar o nome do disco.

  • Liste os snapshots instantâneos de um disco zonal:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME'
    

    Substitua o seguinte:

    • PROJECT_ID : o ID do projeto.
    • SOURCE_ZONE : a zona de destino, por exemplo, us-west1-a .
    • DISK_NAME : o nome do disco de origem, por exemplo, disk-1 .
  • Liste os snapshots instantâneos de um volume regional de disco permanente:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME'
    

    Substitua o seguinte:

    • PROJECT_ID : o ID do projeto.
    • SOURCE_REGION : a região de destino, por exemplo, us-west1 .
    • DISK_NAME : o nome do disco de origem, por exemplo, disk-1 .

Ver informações sobre um snapshot instantâneo

Recupere informações detalhadas sobre um snapshot instantâneo, como localização, disco de origem e tamanho, usando a CLI gcloud, o console do Google Cloud ou REST.

Console

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

    Vá para a página Instantâneos

  2. Clique na guia Instantâneos . A lista de instantâneos é exibida.

  3. Na coluna Nome , clique no nome do instantâneo instantâneo. A página de detalhes do instantâneo selecionado é exibida, mostrando suas propriedades.

gcloud

  1. Para visualizar informações sobre um snapshot instantâneo, use o comando gcloud compute instant-snapshots describe .

    • Se o instantâneo for de um disco zonal, especifique a zona com o sinalizador --zone :

      gcloud compute instant-snapshots describe INSTANT_SNAPSHOT_NAME  \
         --zone=ZONE
      

      Substitua o seguinte pelos valores correspondentes:

      • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.
      • ZONE : a zona onde o snapshot instantâneo foi criado, por exemplo, us-west1-a .
    • Se o snapshot for de um disco regional, especifique a região com o sinalizador --region :

      gcloud compute instant-snapshots describe INSTANT_SNAPSHOT_NAME \
      --region=REGION
      

      Substitua o seguinte pelos valores correspondentes:

      • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.
      • REGION : a região onde o snapshot foi criado, por exemplo, us-central1 .

DESCANSAR

A solicitação do método de API que você usa depende se você está trabalhando com um snapshot instantâneo regional ou zonal.

Instantâneo zonal

Faça uma solicitação GET para o método instantSnapshots.get especificando a zona na solicitação:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME

Substitua o seguinte pelos valores correspondentes:

  • PROJECT_ID : o nome do projeto que contém o snapshot instantâneo.
  • ZONE : a zona onde o instantâneo foi criado.
  • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.

Instantâneo instantâneo regional

Faça uma solicitação GET para o método instantSnapshots.get especificando a região na solicitação:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME

Substitua o seguinte pelos valores correspondentes:

  • PROJECT_ID : o nome do projeto que contém o snapshot instantâneo.
  • REGION : a região onde o snapshot instantâneo foi criado.
  • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.

Excluir um instantâneo

Você pode excluir um snapshot instantâneo usando a CLI gcloud, o console do Google Cloud ou REST.

Console

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

    Vá para a página Instantâneos

  2. Clique na guia Instantâneos .

  3. Selecione mais um instantâneo para excluir.

  4. Na parte superior da página Instantâneos , clique em Excluir .

gcloud

Exclua um snapshot instantâneo com o comando gcloud compute instant-snapshots delete , especificando a zona de origem ou a região de origem.

  • Exclua um snapshot instantâneo de um disco zonal:

    gcloud compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \
        --zone=ZONE
     

    Substitua o seguinte pelos valores correspondentes:

    • ZONE : o nome da zona.
    • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.
  • Exclua um snapshot instantâneo de um disco regional:

    gcloud compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \
       --region=REGION
    

    Substitua o seguinte:

    • REGION : o nome da região.
    • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.

DESCANSAR

Exclua um snapshot instantâneo com uma solicitação DELETE para o método instantSnapshots.delete :

  • Exclua um snapshot instantâneo do disco zonal:

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME
    

    Substitua o seguinte pelos valores correspondentes:

    • PROJECT_ID : o ID do projeto.
    • ZONE : o nome da zona.
    • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.
  • Exclua um snapshot instantâneo de um disco regional:

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME

    Substitua o seguinte pelos valores correspondentes:

    • PROJECT_ID : o ID do projeto.
    • REGION : o nome da região.
    • INSTANT_SNAPSHOT_NAME : o nome do instantâneo instantâneo.

Alterar o local de armazenamento de um snapshot instantâneo

Um snapshot instantâneo é sempre armazenado no mesmo local do disco de origem. Você não pode tornar um snapshot acessível de uma zona ou região diferente. Em vez disso, você pode criar um snapshot padrão a partir do snapshot instantâneo e usar o snapshot padrão.

Aprenda como criar um snapshot padrão a partir de um snapshot instantâneo .

Solução de problemas

Consulte Solução de problemas de snapshots instantâneos para resolver problemas encontrados ao trabalhar com snapshots instantâneos.