Um disco é um disco de inicialização usado para iniciar e executar o sistema operacional em uma instância de computação ou um disco que não é de inicialização e que uma instância usa apenas para armazenamento de dados.
Você pode usar snapshots para fazer backup e restaurar dados de disco das seguintes maneiras:
Depois de tirar um instantâneo de um disco de inicialização ou não, crie um novo disco com base no instantâneo .
Depois de tirar um snapshot de um disco de inicialização, crie uma nova instância com base no snapshot do disco de inicialização .
Depois de tirar um snapshot de um disco que não é de inicialização, crie uma nova instância com um novo disco que não seja de inicialização com base no snapshot .
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.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Para criar um disco a partir de um snapshot com escopo global (padrão):
-
compute.disks.create
no projeto -
compute.instances.attachDisk
na instância -
compute.disks.use
no disco para anexar -
compute.snapshots.useReadOnly
,compute.snapshots.create
oucompute.disks.createSnapshot
no projeto
-
- ( Visualização ) Para criar um disco a partir de um snapshot com escopo regional:
-
compute.disks.create
no projeto -
compute.instances.attachDisk
na instância -
compute.disks.use
no disco para anexar -
compute.snapshots.useReadOnly
no projeto
-
- Para criar uma instância a partir de um disco de inicialização e de um snapshot de disco que não seja de inicialização, você precisa, no mínimo, das seguintes permissões:
-
compute.instances.create
no projeto -
compute.snapshots.useReadOnly
no instantâneo -
compute.disks.create
no projeto -
compute.disks.use
no disco -
compute.instances.attachDisk
na instância
-
O novo disco deve ter pelo menos o mesmo tamanho do disco de origem original do snapshot. Se você criar um disco maior que o disco de origem original do instantâneo, deverá redimensionar o sistema de arquivos nesse disco para incluir o espaço em disco adicional. Dependendo do sistema operacional e do tipo de sistema de arquivos, talvez seja necessário usar uma ferramenta de redimensionamento de sistema de arquivos diferente. Para obter mais informações, consulte a documentação do sistema operacional.
Você pode criar novos discos zonais ou regionais a partir de um determinado snapshot no máximo uma vez a cada dez minutos. Se quiser emitir uma série de solicitações para capturar instantâneos de seus discos, você poderá emitir no máximo 6 solicitações em 60 minutos. Este limite não se aplica ao criar discos regionais a partir de um snapshot. Para obter mais informações, consulte Limites de frequência de instantâneo .
No console do Google Cloud, acesse a página Instantâneos .
Encontre o nome do instantâneo que você deseja restaurar.
Vá para a página Discos .
Clique em Criar novo disco .
Especifique os seguintes parâmetros de configuração:
- Um nome para o disco.
- Um tipo para o disco.
- Opcionalmente, você pode substituir a seleção padrão de região e zona. Você pode selecionar qualquer região e zona, independentemente do local de armazenamento do snapshot de origem.
Em Tipo de origem , clique em Instantâneo .
Selecione o nome do instantâneo a ser restaurado.
Selecione o tamanho do novo disco, em gigabytes. Esse número deve ser igual ou maior que o disco de origem original do snapshot.
Clique em Criar para criar o disco.
Use o comando
gcloud compute snapshots list
para encontrar o nome do snapshot que você deseja restaurar:gcloud compute snapshots list
Use o comando
gcloud compute snapshots describe
para encontrar o tamanho do snapshot que você deseja restaurar:gcloud compute snapshots describe SNAPSHOT_NAME
Substitua SNAPSHOT_NAME pelo nome do instantâneo que está sendo restaurado.
Use o comando
gcloud compute disks create
para criar um novo disco regional ou zonal a partir do seu snapshot. Você pode incluir o sinalizador--type
para especificar o tipo de disco a ser criado.- Para criar um disco zonal a partir de um snapshot com escopo global:
gcloud compute disks create DISK_NAME \ --zone=ZONE \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE
- ( Visualização ) Para criar um disco zonal a partir de um instantâneo com escopo regional:
gcloud beta compute disks create DISK_NAME \ --zone=ZONE \ --source-snapshot=SNAPSHOT_NAME \ --source-snapshot-region=SOURCE_REGION \ --type=DISK_TYPE
- Para criar um disco regional a partir de um snapshot com escopo global:
gcloud beta compute disks create DISK_NAME \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2
- ( Visualização ) Para criar um disco regional a partir de um instantâneo com escopo regional:
gcloud beta compute disks create DISK_NAME \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --source-snapshot-region=SOURCE_REGION \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2
Substitua o seguinte:
- DISK_NAME : o nome do novo disco
- DISK_SIZE : o tamanho do novo disco, em gibibytes (GiB). Esse número deve ser igual ou maior que o disco de origem original do snapshot.
- SNAPSHOT_NAME : o nome do snapshot que está sendo restaurado
- DISK_TYPE : o tipo do disco, por exemplo,
pd-ssd
,hyperdisk-throughput
ouhyperdisk-balanced-high-availability
- REGION : a região onde o disco regional residirá, por exemplo:
europe-west1
- SOURCE_REGION : a região cujo escopo o snapshot de origem tem como escopo
- ZONE : a zona onde o novo disco residirá
- ZONE1,ZONE2 : as zonas dentro da região onde as duas réplicas de disco estão localizadas, por exemplo:
europe-west1-b
eeurope-west1-c
Opcional: anexe o novo disco a uma instância existente usando o comando
gcloud compute instances attach-disk
:gcloud compute instances attach-disk INSTANCE_NAME \ --disk DISK_NAME
Substitua o seguinte:
- INSTANCE_NAME : o nome da instância
- DISK_NAME : o nome do disco criado a partir do seu snapshot
Construa uma solicitação
GET
parasnapshots.list
para exibir a lista de snapshots em seu projeto.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
Substitua PROJECT_ID pelo ID do seu projeto.
Construa uma solicitação
POST
para criar um disco zonal ou regional usando o respectivo métododisks.insert
:- Para discos zonais:
disks.insert
- Para discos regionais:
regionDisks.insert
Inclua as propriedades
name
,sizeGb
etype
. Para restaurar um disco usando um instantâneo, você deve incluir a propriedadesourceSnapshot
.- Para criar um disco zonal a partir de um snapshot com escopo global:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_NAME", "sizeGb": "DISK_SIZE", "type": "zones/ZONE/diskTypes/DISK_TYPE" }
- ( Visualização ) Para criar um disco zonal a partir de um snapshot com escopo regional:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME", "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE", "zone": "projects/PROJECT_ID/zones/ZONE" }
- Para criar um disco regional a partir de um snapshot com escopo global:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_NAME", "region": "projects/PROJECT_ID/regions/REGION", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "zones/ZONE/diskTypes/DISK_TYPE" }
- ( Visualização ) Para criar um disco regional a partir de um instantâneo com escopo regional:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE" }
Substitua o seguinte:
- PROJECT_ID : o ID do seu projeto
- ZONE : a zona onde sua instância e seu novo disco estão localizados
- DISK_NAME : o nome do novo disco
- SNAPSHOT_NAME : o instantâneo de origem do disco que você está restaurando
- REGION : a região onde o disco regional residirá, por exemplo:
europe-west1
- SOURCE_REGION : a região cujo escopo o snapshot de origem tem como escopo
- ZONE1 , ZONE2 : as zonas onde as réplicas do novo disco devem estar localizadas
- DISK_SIZE : o tamanho do novo disco, em gibibytes (GiB). Esse número deve ser igual ou maior que o disco de origem original do snapshot.
- DISK_TYPE : URL completo ou parcial para o tipo de disco, por exemplo,
PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
,PROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
ouPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced-high-availability
- Para discos zonais:
Opcional. Anexe o novo disco a uma instância existente.
Construa uma solicitação
POST
para o métodoinstances.attachDisk
e inclua a URL do disco que você acabou de criar a partir do snapshot.Para discos zonais:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk { "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME" }
Para discos regionais:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk { "source": "/compute/v1/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME" }
Substitua o seguinte:
- PROJECT_ID : o ID do seu projeto
- ZONE : a zona onde sua instância e seu novo disco estão localizados
- REGION : a região onde o disco regional está localizado. Esta deve ser a mesma região em que a instância de computação está localizada.
- INSTANCE_NAME : o nome da instância onde você está adicionando o novo disco
- DISK_NAME : o nome do novo disco
No console do Google Cloud, acesse a página Criar uma instância .
Se solicitado, selecione seu projeto e clique em Continuar . A página Criar uma instância é exibida e exibe o painel Configuração da máquina .
No painel Configuração da máquina , faça o seguinte:
- No campo Nome , especifique um nome para sua instância. Para obter mais informações, consulte Convenção de nomenclatura de recursos .
Opcional: No campo Zona , selecione uma zona para esta instância.
A seleção padrão é Qualquer . Se você não alterar essa seleção padrão, o Google escolherá automaticamente uma zona para você com base no tipo de máquina e na disponibilidade.
Selecione a família de máquinas para sua instância. O console do Google Cloud exibe as séries de máquinas disponíveis para a família de máquinas selecionada. As seguintes opções de famílias de máquinas estão disponíveis:
- Uso geral
- Computação otimizada
- Memória otimizada
- Armazenamento otimizado
- GPU
Na coluna Série , selecione a série de máquinas da sua instância.
Se você selecionou GPUs como família de máquinas na etapa anterior, selecione o tipo de GPU desejado. A série da máquina é então selecionada automaticamente para o tipo de GPU selecionado.
Na seção Tipo de máquina , selecione o tipo de máquina da sua instância.
No menu de navegação, clique em SO e armazenamento . No painel Sistema operacional e armazenamento exibido, configure seu disco de inicialização fazendo o seguinte:
- Clique em Alterar . O painel Disco de inicialização aparece e exibe a guia Imagens públicas .
- Clique em Instantâneos . A guia Instantâneo é exibida.
- Na lista Instantâneo , selecione o instantâneo a ser usado.
- Na lista Tipo de disco de inicialização , selecione o tipo de disco de inicialização.
- No campo Tamanho (GB) , especifique o tamanho do disco de inicialização.
- Opcional: para opções de configuração avançadas, expanda a seção Mostrar configurações avançadas .
- Para confirmar as opções do disco de inicialização e retornar ao painel Sistema operacional e armazenamento , clique em Selecionar .
No menu de navegação, clique em Rede . No painel Rede exibido, faça o seguinte:
- Vá para a seção Firewall .
- Para permitir o tráfego HTTP ou HTTPS para a instância, selecione Permitir tráfego HTTP ou Permitir tráfego HTTPS .
O console do Google Cloud adiciona uma tag de rede à sua instância e cria a regra de firewall de entrada correspondente que permite todo o tráfego de entrada em
tcp:80
(HTTP) outcp:443
(HTTPS). A tag de rede associa a regra de firewall à instância. Para obter mais informações, consulte Visão geral das regras de firewall na documentação da Virtual Private Cloud.Opcional: Especifique outras opções de configuração. Para obter mais informações, consulte Opções de configuração durante a criação da instância .
Para criar e iniciar a instância, clique em Criar .
-
INSTANCE_NAME
: nome da nova instância -
BOOT_SNAPSHOT_NAME
: nome do snapshot do disco de inicialização que você deseja restaurar no disco de inicialização da nova instância BOOT_DISK_SIZE
: Opcional: tamanho, em GiB, do novo disco de bootO tamanho deve ser igual ou maior que o tamanho do disco de origem a partir do qual o snapshot foi feito.
BOOT_DISK_TYPE
: Opcional: tipo do disco de inicialização, por exemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
ouPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
BOOT_DISK_NAME
: nome do novo disco de inicialização desta instância-
INSTANCE_NAME
: nome da nova instância -
ZONE
: Para zona para criar a instância em -
DISK_NAME
: Opcional: um nome para o disco -
BOOT_SNAPSHOT_NAME
: nome do snapshot do disco de inicialização que você deseja restaurar no disco de inicialização da nova instância. -
BOOT_DISK_TYPE
: Opcional: tipo do disco de inicialização, por exemplopd-ssd
ouhyperdisk-balanced-high-availability
-
REMOTE_ZONE
: a região para a qual o disco de inicialização é replicado. A propriedadereplica-zones
requer duas zonas separadas por vírgula e uma das zonas deve ser igual à zona da instância. - Apenas um disco pode ser usado como disco de inicialização.
- Você deve anexar o disco de inicialização como o primeiro disco dessa instância.
- Se você especificar a propriedade
source
, também não poderá especificar a propriedadeinitializeParams
. Fornecer umasource
indica que o disco de inicialização já existe, mas a propriedadeinitializeParams
indica que o Compute Engine deve criar um novo disco de inicialização. -
PROJECT_ID
: o ID do seu projeto -
ZONE
: zona onde você deseja criar a nova instância -
INSTANCE_NAME
: nome da instância para a qual você deseja restaurar um snapshot -
MACHINE_TYPE
: tipo de máquina da instância -
BOOT_SNAPSHOT_NAME
: nome do snapshot que você deseja usar para criar o disco de boot da nova instância BOOT_DISK_SIZE
: Opcional: tamanho, em gibibytes (GiB), para o novo disco de bootO tamanho deve ser igual ou maior que o tamanho do disco de origem a partir do qual o snapshot foi feito.
BOOT_DISK_TYPE
: Opcional: tipo do disco de inicialização, por exemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
ouPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
-
PROJECT_ID
: o ID do seu projeto -
ZONE
: o nome da zona onde você deseja criar a instância -
INSTANCE_NAME
`: um nome para a instância -
BOOT_SNAPSHOT_NAME
: o nome do instantâneo do disco de inicialização -
REMOTE_ZONE
: a zona remota do disco regional BOOT_DISK_TYPE
: Opcional: tipo do disco de inicialização, por exemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
ouPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced-high-availability
Restaure cada instantâneo que não seja de inicialização em um novo disco.
No console do Google Cloud, acesse a página Discos .
Clique em Criar disco .
Especifique um nome para o seu disco. Para obter mais informações, consulte Convenção de nomenclatura de recursos .
Selecione a região e a zona deste disco. O disco e a instância devem estar na mesma zona para discos zonais ou na mesma região para discos regionais.
Selecione um tipo de disco.
Em Tipo de origem , selecione Instantâneo .
No novo campo Instantâneo de origem , selecione um instantâneo que não seja de inicialização que você deseja restaurar no novo disco.
Para criar o disco, clique em Criar .
Repita essas etapas para criar um disco de cada instantâneo que você deseja restaurar.
No console do Google Cloud, acesse a página de instâncias de VM .
Selecione seu projeto e clique em Continuar .
Clique em Criar instância .
Especifique um nome para sua instância. Para obter mais informações, consulte Convenção de nomenclatura de recursos .
Selecione a região e a zona para esta instância. O disco e a instância devem estar na mesma zona para discos zonais ou na mesma região para discos regionais.
Selecione um tipo de máquina para sua instância.
Se quiser permitir tráfego externo de entrada, altere as regras de Firewall da instância.
Para anexar discos à instância, expanda a seção Opções avançadas e faça o seguinte:
- Expanda a seção Discos .
- Clique em Anexar disco existente .
- Na lista Disco , selecione um disco para anexar a esta instância.
- Na seção Configuração de anexo , selecione o modo de anexo do disco e a regra de exclusão . Para obter mais informações sobre como adicionar novos discos, consulteAdicione um disco permanente ouAdicione o hiperdisco .
- Clique em Salvar .
Repita essas etapas para cada disco que deseja anexar.
Para criar e iniciar a instância, clique em Criar .
-
INSTANCE_NAME
: nome da nova instância -
SNAPSHOT_1_NAME
eSNAPSHOT_2_NAME
: nomes dos instantâneos de disco que não são de inicialização que você deseja restaurar -
DISK_1_NAME
eDISK_2_NAME
: nomes dos novos discos que não são de inicialização a serem criados para esta instância DISK_1_SIZE
eDISK_2_SIZE
: Opcional: tamanhos, em gibibytes (GiB), de cada novo disco que não é de inicializaçãoOs tamanhos devem ser iguais ou maiores que os tamanhos dos discos de origem a partir dos quais o snapshot foi feito.
DISK_1_TYPE
eDISK_2_TYPE
: Opcional: os tipos de disco a serem criados, por exemplopd-ssd
ouhyperdisk-balanced
- Apenas um disco pode ser o disco de inicialização.
- Você deve anexar o disco de inicialização como o primeiro disco dessa instância.
- Se você especificar a propriedade
source
, também não poderá especificar a propriedadeinitializeParams
. Fornecer umasource
indica que o disco de inicialização já existe, mas a propriedadeinitializeParams
indica que o Compute Engine deve criar um novo disco de inicialização. -
PROJECT_ID
: o ID do seu projeto -
ZONE
: zona onde você deseja criar a instância -
INSTANCE_NAME
: um nome para a nova instância -
MACHINE_TYPE
: tipo de máquina da instância DISK_SIZE
: Opcional: tamanho, em gibibytes (GiB), do disco correspondenteQuando fornecida, esta propriedade deve ser igual ou maior que o tamanho do disco de origem a partir do qual a captura instantânea foi feita.
DISK_TYPE
: Opcional: URL completo ou parcial para o tipo de disco correspondente, por exemplo,PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
ouPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
IMAGE_PROJECT
: o projeto que contém a imagem. Por exemplo,debian-cloud
IMAGE_FAMILY
: uma família de imagens. Isso cria a instância a partir da imagem de sistema operacional mais recente e não obsoleta dessa família. Por exemplo, se você especificar"sourceImage": "projects/debian-cloud/global/images/family/debian-11"
, o Compute Engine criará uma instância usando a versão mais recente da imagem do sistema operacional na família de imagens Debian 11.DEVICE_NAME
: opcional: o nome do dispositivo exibido no sistema operacional convidado da instânciaSNAPSHOT_NAME
: os nomes dos snapshots de disco que não são de inicialização correspondentes que você deseja restaurar em novos discos na instância
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Java
Para usar os exemplos Java desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Node.js
Para usar os exemplos Node.js desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
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 obrigatórias
Para obter as permissões necessárias para restaurar a partir de um snapshot, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .Essa função predefinida contém as permissões necessárias para restaurar a partir de um snapshot. 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 restaurar a partir de um snapshot:
Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .
Limitações
Crie um disco a partir de um snapshot e, opcionalmente, anexe-o a uma instância
Se você fez backup de um disco inicializável ou não inicializável com um instantâneo, poderá criar um novo disco com base no instantâneo.
Console
Opcionalmente, você pode anexar um disco que não seja de inicialização a uma instância .
gcloud
Ir
Go
Antes de testar este exemplo, siga as instruções de configuração Go no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Compute Engine Go .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Java
Java
Antes de testar este exemplo, siga as instruções de configuração Java no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Java do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração Node.js no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Node.js do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Pitão
Python
Antes de testar este exemplo, siga as instruções de configuração Python no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Python do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
DESCANSAR
Depois de criar e anexar um novo disco a uma instância, você deverá montar o disco para que o sistema operacional possa usar o espaço de armazenamento disponível.
Crie uma instância a partir de discos existentes
Você pode criar discos de inicialização e discos de dados a partir de instantâneos e, em seguida, anexar esses discos a uma nova instância de computação.
Ir
Go
Antes de testar este exemplo, siga as instruções de configuração Go no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Compute Engine Go .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Java
Java
Antes de testar este exemplo, siga as instruções de configuração Java no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Java do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração Node.js no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Node.js do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Pitão
Python
Antes de testar este exemplo, siga as instruções de configuração Python no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Python do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Crie uma instância a partir de um snapshot do disco de inicialização
Se você criou um snapshot do disco de inicialização de uma instância de computação, poderá usar esse snapshot para criar uma nova instância.
Para criar rapidamente mais de uma instância com o mesmo disco de inicialização, crie uma imagem personalizada e, em seguida, crie instâncias a partir dessa imagem em vez de usar um snapshot.
Para criar uma instância de computação com um disco de inicialização regional criado a partir de um snapshot, use a Google Cloud CLI ou REST.
Console
gcloud
Disco de inicialização zonal
Use o comando
gcloud compute instances create
e inclua a sinalização--source-snapshot
.gcloud compute instances create INSTANCE_NAME
--source-snapshot=BOOT_SNAPSHOT_NAME
--boot-disk-size=BOOT_DISK_SIZE
--boot-disk-type=BOOT_DISK_TYPE
--boot-disk-device-name=BOOT_DISK_NAMESubstitua o seguinte:
Disco de inicialização regional
Use o comando
gcloud compute instances create
e inclua a sinalização--create-disk
com as propriedadessource-snapshot
,replica-zones
eboot
.gcloud compute instances create INSTANCE_NAME
--zone=ZONE
--create-disk=^:^name=DISK_NAME:source-snapshot=BOOT_SNAPSHOT_NAME:boot=true:type=BOOT_DISK_TYPE:replica-zones=ZONE,REMOTE_ZONEOs caracteres
^:^
especificam que dois pontos:
são usados como separador entre cada uma das propriedades do disco. Isso é necessário para que você possa usar uma,
ao especificar as zonas parareplica-zones
.Substitua o seguinte:
Ir
Go
Antes de testar este exemplo, siga as instruções de configuração Go no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Compute Engine Go .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Java
Java
Antes de testar este exemplo, siga as instruções de configuração Java no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Java do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração Node.js no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Node.js do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
Pitão
Python
Antes de testar este exemplo, siga as instruções de configuração Python no guia de início rápido do Compute Engine usando bibliotecas de cliente . Para mais informações, consulte a documentação de referência da API Python do Compute Engine .
Para autenticar no Compute Engine, configure as credenciais padrão do aplicativo. Para obter mais informações, consulte Configurar autenticação para um ambiente de desenvolvimento local .
DESCANSAR
Ao usar a API para criar uma instância a partir de um snapshot, as seguintes restrições se aplicam:
Disco de inicialização zonal
Para criar uma instância a partir de um instantâneo de disco de inicialização, use o métodoinstances.insert
e especifique o camposourceSnapshot
na propriedadedisks
. Opcionalmente, você pode especificar as propriedadesdiskSizeGb
ediskType
para o novo disco de inicialização. Substitua o seguinte:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "machineTypes/MACHINE_TYPE", "disks": [{ "boot": true, "initializeParams": { "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME", "diskSizeGb": "BOOT_DISK_SIZE", "diskType": "BOOT_DISK_TYPE" } }], "networkInterfaces": [ { "nicType": "GVNIC" } ] }
Disco de inicialização regional
Para criar uma instância de computação com um disco de inicialização regional usando um instantâneo de disco de inicialização como origem, use o métodoinstances.insert
e especifique os campossourceSnapshot
ereplicaZones
na propriedadedisks
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "disks": [ { "boot": true, "initializeParams": { "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE", "projects/PROJECT_ID/zones/REMOTE_ZONE" ], "diskType": "BOOT_DISK_TYPE" } } ], "networkInterfaces": [ { "nicType": "GVNIC" } ] }
Substitua o seguinte:
Criar uma instância de computação a partir de um instantâneo de disco que não é de inicialização
Se você fez backup de um disco que não é de inicialização com um snapshot, poderá criar uma instância com um disco que não é de inicialização adicional com base no snapshot.
Console
Ao restaurar snapshots que não são de inicialização para uma nova instância a partir do console, primeiro crie um disco de cada snapshot. Em seguida, anexe os novos discos ao criar a instância.
gcloud
Crie uma instância usando o comando
gcloud compute instances create
. Para cada snapshot que não seja de inicialização que você deseja restaurar, inclua o sinalizador--create-disk
e especifique umsource-snapshot
.Por exemplo, para restaurar dois snapshots de discos que não são de inicialização para uma nova instância, use o seguinte comando:
gcloud compute instances create INSTANCE_NAME \ --create-disk source-snapshot=SNAPSHOT_1_NAME,name=DISK_1_NAME,size=DISK_1_SIZE,type=DISK_1_TYPE \ --create-disk source-snapshot=SNAPSHOT_2_NAME,name=DISK_2_NAME,size=DISK_2_SIZE,type=DISK_2_TYPE
Substitua o seguinte:
DESCANSAR
Ao usar REST para restaurar um snapshot que não seja de inicialização para uma nova instância, as seguintes restrições se aplicam:
Crie uma solicitação
POST
para o métodoinstances.insert
e especifique o camposourceSnapshot
na propriedadeinitializeParams
. Você pode adicionar vários discos que não são de inicialização, repetindo a propriedadeinitializeParams
para cada disco que não é de inicialização que deseja criar. Opcionalmente, você pode especificar as propriedadesdiskSizeGb
ediskType
para qualquer um dos discos criados.Por exemplo, para restaurar dois snapshots de disco que não são de inicialização para uma nova instância, faça a seguinte solicitação:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "machineTypes/MACHINE_TYPE", "networkInterfaces": [ { "nicType": "GVNIC" } ], "disks": [ { "autoDelete": "true", "boot": "true", "diskSizeGb": "BOOT_DISK_SIZE", "diskType": "BOOT_DISK_TYPE", "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY" } }, { "deviceName": "DEVICE_1_NAME", "initializeParams": { "sourceSnapshot": "global/snapshots/SNAPSHOT_1_NAME", "diskSizeGb": "DISK_1_SIZE", "diskType": "DISK_1_TYPE" } }, { "deviceName": "DEVICE_2_NAME", "initializeParams": { "sourceSnapshot": "global/snapshots/SNAPSHOT_2_NAME", "diskSizeGb": "DISK_2_SIZE", "diskType": "DISK_2_TYPE" } } ] }
Substitua o seguinte:
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.
-