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
-
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.
- Set a default region and zone.
- Administrador de instância do Compute (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 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
- 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.
No console do Google Cloud, acesse a página de instâncias de VM .
Selecione o projeto com o qual deseja trabalhar.
Na coluna Nome , clique no nome da VM anexada ao disco do qual deseja fazer backup.
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.
Para concluir a criação de um instantâneo, na página Criar um instantâneo , faça o seguinte:
- No campo Nome , insira um nome exclusivo para identificar o snapshot instantâneo.
- Opcional: Adicione mais detalhes sobre a captura instantânea no campo Descrição .
- No campo Tipo , selecione Instantâneo instantâneo . O campo Localização é automaticamente definido para a mesma zona ou região do disco.
- No campo Tipo de origem do instantâneo , verifique se Disco está selecionado.
- Opcional: para organizar seu projeto, adicione um ou mais rótulos .
- Clique em Criar .
-
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. -
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. 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.
-
No console do Google Cloud, acesse a página Instantâneos .
Clique na guia Instantâneos . A lista de instantâneos é exibida.
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.
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.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
.
-
No console do Google Cloud, acesse a página Instantâneos .
Clique na guia Instantâneos . A lista de todos os instantâneos do projeto é exibida.
Limite os resultados por disco de origem:
Insira
Source disk:
no campo Filtro filter_list .Uma lista de discos com instantâneos é exibida.
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ê.
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
.
-
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
.
-
No console do Google Cloud, acesse a página Instantâneos .
Clique na guia Instantâneos . A lista de instantâneos é exibida.
Na coluna Nome , clique no nome do instantâneo instantâneo. A página de detalhes do instantâneo selecionado é exibida, mostrando suas propriedades.
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
.
-
-
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. -
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. No console do Google Cloud, acesse a página Instantâneos .
Clique na guia Instantâneos .
Selecione mais um instantâneo para excluir.
Na parte superior da página Instantâneos , clique em Excluir .
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.
-
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.
-
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:
Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .
Limitações
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
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:
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:
DESCANSAR
Para criar um snapshot instantâneo, faça uma solicitação
POST
para o método instantSnapshots.insert .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
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:
DESCANSAR
Você pode recuperar uma lista de instantâneos em um projeto ou local específico.
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
gcloud
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.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
gcloud
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:
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:
Excluir um instantâneo
Você pode excluir um snapshot instantâneo usando a CLI gcloud, o console do Google Cloud ou REST.
Console
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.DESCANSAR
Exclua um snapshot instantâneo com uma solicitação
DELETE
para o método instantSnapshots.delete :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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-17 UTC.
-