As cópias instantâneas de disco padrão ajudam a fazer cópias de segurança periódicas dos dados do seu disco persistente e Google Cloud Hyperdisk.
Pode ver, listar e eliminar instantâneos de disco. Também pode partilhar instantâneos entre projetos.
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: ConsoleWhen you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication. gcloud- 
 
 
  
  
   
   
  
   
   
  
   
   
     
   
  
  
   
   
  
   
   
  
   
   
  
 
 
   
   
      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: gcloud initSe estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada. 
- Set a default region and zone.
 RESTPara 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 initSe 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áriasPara receber as autorizações de que precisa para gerir as cópias de segurança instantâneas padrão, peça ao seu administrador que lhe conceda as seguintes funções de IAM no projeto: - 
  
  
    
      Administrador de instâncias do Compute (v1)  (roles/compute.instanceAdmin.v1)
- 
            Para estabelecer ligação a uma VM que pode ser executada como uma conta de serviço:
              
  
  
    
      Utilizador da conta de serviço (v1)  (roles/iam.serviceAccountUser)
 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 gerir as capturas de ecrã padrão. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias: Autorizações necessáriasSão necessárias as seguintes autorizações para gerir as capturas de ecrã padrão: - 
                Para listar instantâneos:
                  compute.snapshots.listno projeto
- 
                Para ver informações sobre um resumo:
                  compute.snapshots.getno resumo
- 
                Para eliminar um instantâneo:
                  compute.snapshots.deleteno instantâneo
- 
                Para eliminar instantâneos com base num filtro:
                - 
                      compute.snapshots.deleteno instantâneo
- 
                      compute.snapshots.listno projeto
 
- 
                      
- 
                Para partilhar dados de resumos entre projetos:
                - 
                      compute.storageAdminno projeto (para aceder a todos os instantâneos padrão)
- 
                      compute.disks.createno projeto para partilhar com
- 
                      compute.snapshots.createno projeto de origem
- 
                      compute.disks.createSnapshotno disco de origem
 
- 
                      
 Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas. Veja as fotos rápidas padrão num projeto ou numa localizaçãoPode ver ou listar os instantâneos padrão num projeto ou numa localização através da CLI gcloud, da consola ou da API REST. Google Cloud Consola- Na Google Cloud consola, aceda à página Instantâneos. 
- No separador Instantâneos, pode ver os instantâneos padrão do projeto atual. 
- Opcional. Limite os resultados com o campo filter_list Filtro. Introduza um nome ou um valor de propriedade no campo Filtro, ou escolha entre as propriedades disponíveis. 
 gcloud- Para ver uma lista de todas as imagens instantâneas disponíveis para si num projeto específico, use o comando - gcloud compute snapshots list.- gcloud compute snapshots list --project=PROJECT_ID 
- (Pré-visualização) Para ver uma lista de instantâneos com âmbito regional disponíveis para si num projeto específico, use o comando - gcloud compute snapshots liste especifique a região.- gcloud compute snapshots list --region=REGION_NAME 
- Para ver uma lista de instantâneos com âmbito global disponíveis para si num projeto específico, use o comando - gcloud compute snapshots liste inclua a flag- --global.- gcloud compute snapshots list --global 
 Substitua o seguinte: - PROJECT_ID: opcional. Substitua pelo ID do projeto. Se omitir esta flag, é usado o projeto atual. Pode definir o projeto predefinido para a sua sessão através do comando- gcloud config set project PROJECT_IDda CLI gcloud.
- REGION_NAME: o nome da região para a qual quer ver capturas de ecrã.
 REST- Para ver uma lista de todas as capturas instantâneas disponíveis para si num projeto específico, faça um pedido - GETao método- snapshots.liste especifique "aggregated".- GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/snapshots 
- (Pré-visualização) Para ver uma lista de instantâneos com âmbito regional disponíveis para si num projeto específico, faça um pedido - GETao método- snapshots.liste especifique a região.- GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots 
- Para ver uma lista de instantâneos com âmbito global disponíveis para si num projeto específico, faça um pedido - GETao método- snapshots.liste especifique "global".- GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots 
 Substitua o seguinte: - PROJECT_ID: o ID do projeto.
- REGION_NAME: o nome da região para a qual quer ver capturas de ecrã.
 Veja os resumos padrão de um discoPode ver a lista de instantâneos padrão de um disco através da Google Cloud consola, da CLI gcloud ou do REST. Consola- Na Google Cloud consola, aceda à página Instantâneos. 
- No separador Snapshots, é apresentada uma lista de todos os snapshots padrão no projeto. 
- Restrinja os resultados por disco de origem: - Introduza - Source disk:no campo filter_list Filtro ou clique no campo Filtro e, de seguida, escolha o valor- Source diskna lista Propriedades.
- Selecione o nome do disco na lista Valores apresentada junto a - Source disk:no campo Filtro.- As imagens instantâneas apresentadas na consola mostram agora todas as imagens instantâneas padrão para o disco especificado. - Se não vir o nome de um disco na lista Valores, no campo Filtro junto a - Source disk:, introduza as primeiras letras do nome do disco de origem para alterar a lista de valores apresentada.
 
 gcloudListe as imagens instantâneas padrão de um disco com o comando gcloud compute snapshots liste o argumento--filter.- Liste os instantâneos padrão de um disco zonal: - gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME 
- Liste os instantâneos padrão de um disco regional: - gcloud compute snapshots list --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME 
 Substitua o seguinte: - PROJECT_ID: o ID do projeto.
- SOURCE_ZONE: (apenas discos zonais) o nome da zona para o disco, por exemplo,- us-west1-a.
- SOURCE_REGION: (apenas discos regionais) o nome da região do disco, por exemplo,- us-west1.
- DISK_NAME: o nome do disco, por exemplo,- disk-1.
 RESTListe as imagens instantâneas padrão de um disco zonal ou regional com um pedido GETao métodosnapshots.list.Use o parâmetro de consulta filter=sourceDiskpara especificar o nome do disco.- Liste os instantâneos padrão de um disco zonal: - GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME' 
- Liste os instantâneos padrão de um disco regional: - GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?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_ZONE: (apenas discos zonais) o nome da zona para o disco, por exemplo,- us-west1-a.
- SOURCE_REGION: (apenas discos regionais) o nome da região do disco, por exemplo,- us-west1.
- DISK_NAME: o nome do disco de origem, por exemplo,- disk-1.
 Veja informações sobre um instantâneo padrãoObtenha informações detalhadas sobre uma captura instantânea padrão, como a hora de criação, o disco de origem e o tamanho, através da Google Cloud consola, da Google Cloud CLI ou do REST. Consola- Na Google Cloud consola, aceda à página Instantâneos. 
- No separador Resumos, veja a lista de resumos no projeto. 
- Na coluna Nome, clique no nome da imagem instantânea padrão. É apresentada a página Detalhes do resumo do resumo selecionado, que mostra as respetivas propriedades. 
 gcloud- Para ver informações sobre uma imagem instantânea padrão com âmbito global, use o comando - gcloud compute snapshots describe.- gcloud compute snapshots describe SNAPSHOT_NAME 
- (Pré-visualização) Para ver informações sobre um resumo padrão com âmbito regional, use o comando - gcloud compute snapshots describee especifique a região.- gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME 
 Substitua o seguinte: - SNAPSHOT_NAME: o nome do resumo padrão.
- REGION_NAME: o nome da região à qual a sua imagem instantânea está delimitada.
 REST- Para ver informações sobre um instantâneo padrão com âmbito global, faça um pedido - GETao método- snapshots.get.- GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME 
- (Pré-visualização) Para ver informações sobre um instantâneo padrão com âmbito regional, faça um pedido - GETao método- snapshots.gete especifique a região.- GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME 
 Substitua o seguinte: - PROJECT_ID: o nome do projeto que contém a imagem instantânea padrão.
- SNAPSHOT_NAME: o nome do resumo padrão.
- REGION_NAME: o nome da região à qual a sua imagem instantânea está delimitada.
 Elimine um instantâneoO Compute Engine usa instantâneos diferenciais para que cada instantâneo contenha apenas os dados que foram alterados desde o instantâneo anterior. Uma vez que as capturas de ecrã subsequentes podem exigir informações armazenadas numa captura de ecrã anterior, tenha em atenção que a eliminação de uma captura de ecrã não elimina necessariamente todos os dados na captura de ecrã. Para saber mais sobre a eliminação de fotos instantâneas, consulte o artigo Eliminação de fotos instantâneas. Consola- Aceda à página Instantâneos na Google Cloud consola. 
- Selecione uma ou mais capturas instantâneas que quer eliminar. 
- Na parte superior da página Momentos, clique em Eliminar. 
 gcloud- Para eliminar uma imagem instantânea com âmbito global, use o comando - gcloud compute snapshots delete.- gcloud compute snapshots delete SNAPSHOT_NAME
- (Pré-visualização) Para eliminar uma captura de ecrã com âmbito regional, use o comando - gcloud compute snapshots deletee especifique o nome da região.- gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
 Substitua o seguinte: - SNAPSHOT_NAME: o nome do resumo que quer eliminar.
- REGION_NAME: a região à qual o resumo está limitado.
 IrJavaNode.jsPythonREST- Para eliminar uma captura instantânea com âmbito global, faça um - DELETEpedido ao método- snapshots.delete.- DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME 
- (Pré-visualização) Para eliminar uma captura de ecrã com âmbito regional, faça um pedido - DELETEao método- snapshots.deletee especifique a região.- DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME 
 Substitua o seguinte: - PROJECT_ID: o nome do seu projeto.
- SNAPSHOT_NAME: o nome do instantâneo a eliminar.
- REGION_NAME: a região à qual o resumo está limitado.
 Elimine várias capturas instantâneas com base num filtroO Compute Engine usa instantâneos diferenciais para que cada instantâneo contenha apenas os dados que foram alterados desde o instantâneo anterior. Uma vez que as capturas de ecrã subsequentes podem exigir informações armazenadas numa captura de ecrã anterior, a eliminação de uma captura de ecrã não elimina necessariamente todos os dados na captura de ecrã. Para saber mais sobre a eliminação de fotos instantâneas, consulte o artigo Eliminação de fotos instantâneas. Pode eliminar várias capturas de ecrã com base num filtro específico. Para mais informações sobre como usar filtros com a CLI gcloud, consulte o artigo Filtros de tópicos da CLI gcloud. Para eliminar as capturas de ecrã, use uma combinação do comando gcloud compute snapshots listcom um filtro específico e o comandogcloud compute snapshots deletecomxargs.gcloud compute snapshots list --filter="EXPRESSION" --uri | xargs gcloud compute snapshots delete Substitua EXPRESSIONpor um filtro de tópico da CLI gcloud.Por exemplo, --filter="creationTimestamp<'2023-12-31'"elimina todas as capturas de ecrã criadas antes de 31 de dezembro de 2023.Partilhe dados de instantâneos entre projetos na mesma organizaçãoPode usar este procedimento para mover dados de um disco num projeto para um disco num projeto diferente na mesma organização. gcloud- Crie uma captura instantânea padrão no projeto de destino com o comando - gcloud compute snapshots create. Por exemplo, para criar uma imagem instantânea de um disco persistente zonal ou de um Hyperdisk, use o seguinte comando:- gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/SOURCE_DISK_NAME \ --project DESTINATION_PROJECT_ID - Substitua o seguinte: - SNAPSHOT_NAME: um nome para o novo instantâneo.
- SOURCE_PROJECT_ID: o ID do projeto do disco de origem.
- ZONE: a zona do disco de origem.
- SOURCE_DISK_NAME: o nome do disco de origem.
- DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.
 
- No projeto de destino, crie um disco zonal ou regional com base na captura de ecrã através do comando - gcloud compute disks create:- gcloud compute disks create DISK_NAME \ --source-snapshot SNAPSHOT_NAME \ --project DESTINATION_PROJECT_ID - Substitua o seguinte: - DISK_NAME: um nome para o novo disco.
- SNAPSHOT_NAME: o nome do resumo.
- DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo disco.
 
 REST- Crie um instantâneo padrão no projeto de destino chamando o método - snapshots.insert. Por exemplo, para tirar uma captura de ecrã de um disco persistente zonal ou de um Hyperdisk, faça o seguinte pedido:- POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": SNAPSHOT_NAME "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME }- Substitua o seguinte: - DESTINATION_PROJECT_ID: o ID do projeto de destino do novo instantâneo.
- SNAPSHOT_NAME: um nome para o resumo.
- SOURCE_PROJECT_ID: o ID do projeto do disco de origem.
- SOURCE_ZONE: a zona do disco de origem.
- SOURCE_DISK_NAME: o nome do disco de origem.
 
- No projeto de destino, crie um disco zonal ou regional com base na captura de ecrã através do - disks.insertmétodo zonal ou do- regionDisks.insertmétodo regional.- Por exemplo, para criar um disco zonal, faça o seguinte pedido: - POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/zones/DESTINATION_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }- Substitua o seguinte: - DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo disco.
- DESTINATION_ZONE: a zona no projeto de destino para o novo disco.
- DISK_NAME: um nome para o novo disco.
- SNAPSHOT_NAME: o nome do resumo.
 
 Para ver uma lista dos instantâneos disponíveis, consulte o artigo Veja os instantâneos padrão num projeto ou numa localização. Partilhe uma imagem instantânea entre projetos em diferentes organizaçõesPode usar este procedimento para partilhar uma imagem instantânea padrão num projeto de uma organização com um projeto diferente noutra organização. gcloud- No projeto de origem, crie um disco baseado na captura de ecrã com o comando - gcloud compute disks create.- gcloud compute disks create DISK_NAME \ --source-snapshot SNAPSHOT_NAME \ --project SOURCE_PROJECT_ID \ --zone ZONE - Substitua o seguinte: - DISK_NAME: um nome para o novo disco.
- SNAPSHOT_NAME: o nome do resumo.
- SOURCE_PROJECT_ID: o ID do projeto de origem.
- ZONE: a zona na qual criar o novo disco.
 - Este disco é um disco temporário criado apenas para copiar o instantâneo entre organizações. 
- No projeto de destino, crie uma captura instantânea com o comando - gcloud compute snapshots create.- Por exemplo, para criar um resumo com o disco zonal criado no primeiro passo, use o seguinte comando: - gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/DISK_NAME \ --project DESTINATION_PROJECT_ID - Substitua o seguinte: - SNAPSHOT_NAME: um nome para o resumo.
- SOURCE_PROJECT_ID: o ID do projeto que contém o disco de origem.
- ZONE: a zona do disco de origem.
- DISK_NAME: o nome do disco criado no passo 1.
- DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.
 - Para ver uma lista dos instantâneos disponíveis, consulte o artigo Veja os instantâneos padrão num projeto ou numa localização. 
- Elimine o disco temporário criado no primeiro passo com o comando - gcloud compute disks delete.- gcloud compute disks delete DISK_NAME \ --project SOURCE_PROJECT_ID --zone ZONE - Substitua o seguinte: - DISK_NAME: o nome do disco criado no passo 1.
- SOURCE_PROJECT_ID: o ID do projeto que contém o disco de origem.
- ZONE: a zona do disco.
 
 REST- No projeto de origem, crie um disco zonal ou regional com base na captura de ecrã através do método - disks.insertzonal.- Por exemplo, para criar um disco zonal, faça o seguinte pedido: - POST https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }- Substitua o seguinte: - SOURCE_PROJECT_ID: o ID do projeto de origem do novo disco.
- SOURCE_ZONE: a zona do novo disco.
- DISK_NAME: um nome para o novo disco.
- SNAPSHOT_NAME: o nome do resumo.
 - Este disco é um disco temporário criado apenas para copiar o instantâneo entre organizações. 
- Crie um instantâneo no projeto de destino chamando o método - snapshots.insert.- Por exemplo, para criar um resumo com o disco zonal criado no primeiro passo, use o seguinte comando: - POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": SNAPSHOT_NAME "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME }- Substitua o seguinte: - DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.
- SNAPSHOT_NAME: um nome para o resumo.
- SOURCE_PROJECT_ID: O ID do projeto que contém o disco de origem.
- SOURCE_ZONE: a zona do disco de origem.
- DISK_NAME: o nome do disco de origem.
 
- Elimine o disco temporário criado no primeiro passo através do método - disks.delete.- DELETE https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME - Substitua o seguinte: - SOURCE_PROJECT_ID: o ID do projeto que contém o disco temporário.
- SOURCE_ZONE: a zona do disco.
- DISK_NAME: o nome do disco temporário criado no passo 1.
 
 O que se segue?- Saiba como criar instantâneos programados para discos.
- Saiba como criar uma imagem de disco a partir do seu instantâneo.
 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-10-19 UTC. -