Um disco é um disco de arranque usado para iniciar e executar o sistema operativo numa instância de computação ou um disco sem arranque que uma instância usa apenas para armazenamento de dados.
Pode usar instantâneos para fazer cópias de segurança e restaurar dados do disco das seguintes formas:
Depois de tirar uma captura instantânea de um disco de arranque ou não arranque, crie um novo disco com base na captura instantânea.
Depois de tirar uma captura instantânea de um disco de arranque, crie uma nova instância com base na captura instantânea do disco de arranque.
Depois de tirar uma captura de um disco não de arranque, crie uma nova instância com um novo disco não de arranque com base na captura.
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 Trusted Cloud by S3NS serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
- Set a default region and zone.
Ir
Para usar os Go exemplos nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para mais informações, consulte Set up authentication for a local development environment.
Java
Para usar os Java exemplos nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para mais informações, consulte Set up authentication for a local development environment.
Node.js
Para usar os Node.js exemplos nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para mais informações, consulte Set up authentication for a local development environment.
Python
Para usar os Python exemplos nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para mais informações, consulte Set up authentication for a local development environment.
REST
Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.
Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.
Para mais informações, consulte o artigo Autenticar para usar REST na Trusted Cloud documentação de autenticação.
Funções necessárias
Para receber as autorizações de que precisa para restaurar a partir de uma imagem instantânea, peça ao seu administrador para lhe conceder a função IAM Administrador de instâncias do Compute (v1) (
roles/compute.instanceAdmin.v1
) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.Esta função predefinida contém as autorizações necessárias para restaurar a partir de uma captura instantânea. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para restaurar a partir de uma captura instantânea:
-
Para criar um disco a partir de um instantâneo com âmbito global (predefinição):
-
compute.disks.create
no projeto -
compute.instances.attachDisk
na instância -
compute.disks.use
no disco a anexar -
compute.snapshots.useReadOnly
,compute.snapshots.create
oucompute.disks.createSnapshot
no projeto
-
- (Pré-visualização) Para criar um disco a partir de uma imagem instantânea com âmbito regional
-
Para criar uma instância a partir de um instantâneo do disco de arranque e de um disco que não seja de arranque, precisa, no mínimo, das seguintes autorizaçõ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
-
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Limitações
O novo disco tem de ter, pelo menos, o mesmo tamanho que o disco de origem original do instantâneo. Se criar um disco maior do que o disco de origem original para o instantâneo, tem de redimensionar o sistema de ficheiros nesse disco para incluir o espaço em disco adicional. Consoante o seu sistema operativo e o tipo de sistema de ficheiros, pode ter de usar uma ferramenta de redimensionamento do sistema de ficheiros diferente. Para mais informações, consulte a documentação do sistema operativo.
Pode criar um novo disco zonal ou regional a partir de uma determinada cópia de segurança no máximo uma vez a cada dez minutos. Se quiser emitir uma série de pedidos para criar uma imagem instantânea dos seus discos, pode emitir, no máximo, 6 pedidos em 60 minutos. Este limite não se aplica quando cria discos regionais a partir de uma cópia instantânea. Para mais informações, consulte o artigo Limites de frequência de instantâneos.
Crie um disco a partir de um instantâneo e, opcionalmente, anexe-o a uma instância
Se fez uma cópia de segurança de um disco de arranque ou não de arranque com uma imagem instantânea, pode criar um novo disco com base na imagem instantânea.
Consola
Na Trusted Cloud consola, aceda à página Instantâneos.
Encontre o nome da captura instantânea que quer restaurar.
Aceda à 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, pode substituir a seleção predefinida de região e zona. Pode selecionar qualquer região e zona, independentemente da localização de armazenamento do instantâneo de origem.
Em Tipo de origem, clique em Snapshot.
Selecione o nome da captura de ecrã a restaurar.
Selecione o tamanho do novo disco, em gigabytes. Este número tem de ser igual ou superior ao disco de origem original do instantâneo.
Clique em Criar para criar o disco.
Opcionalmente, pode anexar um disco não de arranque a uma instância.
gcloud
Use o comando
gcloud compute snapshots list
para encontrar o nome da captura de ecrã que quer restaurar:gcloud compute snapshots list
Use o comando
gcloud compute snapshots describe
para encontrar o tamanho da captura instantânea que quer restaurar:gcloud compute snapshots describe SNAPSHOT_NAME
Substitua SNAPSHOT_NAME pelo nome do instantâneo que está a ser restaurado.
Use o comando
gcloud compute disks create
para criar um novo disco regional ou zonal a partir da sua captura de ecrã. Pode incluir a flag--type
para especificar o tipo de disco a criar.- Para criar um disco zonal a partir de uma imagem instantânea com âmbito global:
gcloud compute disks create DISK_NAME \ --zone=ZONE \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE
- (Pré-visualização) Para criar um disco zonal a partir de um instantâneo com âmbito 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 uma captura de ecrã com âmbito global:
gcloud beta compute disks create DISK_NAME \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2
- (Pré-visualização) Para criar um disco regional a partir de um instantâneo com âmbito 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). Este número tem de ser igual ou superior ao disco de origem original para a imagem instantânea.
- SNAPSHOT_NAME: o nome do instantâneo que está a ser restaurado
- DISK_TYPE: o
tipo de disco, por exemplo,
hyperdisk-throughput
ouhyperdisk-balanced-high-availability
- REGION: a região onde o disco regional vai residir, por exemplo:
europe-west1
- SOURCE_REGION: a região à qual o instantâneo de origem está delimitado
- ZONE: a zona onde o novo disco vai residir
- ZONE1,ZONE2: as zonas na região onde se encontram as duas réplicas de disco, por exemplo:
europe-west1-b
eeurope-west1-c
Opcional: anexe o novo disco a uma instância existente através do 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 instantâneo
Ir
Go
Antes de experimentar este exemplo, siga as Goinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Go Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Java
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Java Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Node.js
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Node.js Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Python
Python
Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Python Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.REST
Construa um pedido
GET
parasnapshots.list
para apresentar a lista de instantâneos no seu projeto.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/global/snapshots
Substitua PROJECT_ID pelo ID do seu projeto.
Construa um pedido
POST
para criar um disco zonal ou um disco regional através do métododisks.insert
respetivo:- Para discos zonais:
disks.insert
- Para discos regionais:
regionDisks.insert
Inclua as propriedades
name
,sizeGb
etype
. Para restaurar um disco usando uma imagem instantânea, tem de incluir a propriedadesourceSnapshot
.- Para criar um disco zonal a partir de uma imagem instantânea com âmbito global:
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_NAME", "sizeGb": "DISK_SIZE", "type": "zones/ZONE/diskTypes/DISK_TYPE" }
- (Pré-visualização) Para criar um disco zonal a partir de um instantâneo com âmbito regional:
POST https://compute.s3nsapis.fr/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 uma captura de ecrã com âmbito global:
POST https://compute.s3nsapis.fr/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" }
- (Pré-visualização) Para criar um disco regional a partir de um instantâneo com âmbito regional:
POST https://compute.s3nsapis.fr/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 a sua instância e o novo disco se encontram
- DISK_NAME: o nome do novo disco
- SNAPSHOT_NAME: o instantâneo de origem do disco que está a restaurar
- REGION: a região onde o disco regional vai residir, por exemplo:
europe-west1
- SOURCE_REGION: a região à qual o instantâneo de origem está delimitado
- ZONE1, ZONE2: as zonas onde devem estar localizadas as réplicas do novo disco
- DISK_SIZE: o tamanho do novo disco, em gibibytes (GiB). Este número tem de ser igual ou superior ao disco de origem original do instantâneo.
- DISK_TYPE: URL completo ou parcial para o
tipo
do disco, por exemplo,
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 um pedido
POST
para oinstances.attachDisk
método e inclua o URL para o disco que acabou de criar a partir da sua captura de ecrã.Para discos zonais:
POST https://compute.s3nsapis.fr/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.s3nsapis.fr/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 a sua instância e o novo disco estão localizados
- REGION: a região onde o disco regional está localizado. Tem de ser a mesma região em que a instância de computação está localizada.
- INSTANCE_NAME: o nome da instância onde está a adicionar o novo disco
- DISK_NAME: o nome do novo disco
Depois de criar e anexar um novo disco a uma instância, tem de montar o disco para que o sistema operativo possa usar o espaço de armazenamento disponível.
Crie uma instância a partir de discos existentes
Pode criar discos de arranque e discos de dados a partir de instantâneos e, em seguida, anexar estes discos a uma nova instância de computação.
Ir
Go
Antes de experimentar este exemplo, siga as Goinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Go Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Java
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Java Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Node.js
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Node.js Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Python
Python
Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Python Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Crie uma instância a partir de um instantâneo de disco de arranque
Se criou um resumo do disco de arranque de uma instância de computação,pode usar esse resumo para criar uma nova instância.
Para criar rapidamente mais do que uma instância com o mesmo disco de arranque, crie uma imagem personalizada e, em seguida, crie instâncias a partir dessa imagem em vez de usar um instantâneo.
Para criar uma instância de computação com um disco de arranque regional que foi criado a partir de uma captura de ecrã, use a Google Cloud CLI ou a REST.
Consola
Na Trusted Cloud consola, aceda à página Criar uma instância.
Se lhe for solicitado, selecione o seu projeto e clique em Continuar. É apresentada a página Criar uma instância, que apresenta 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 a instância. Para mais informações, consulte a Convenção de nomenclatura de recursos.
Opcional: no campo Zona, selecione uma zona para esta instância.
A seleção predefinida é Qualquer. Se não alterar esta seleção predefinida, a Google escolhe automaticamente uma zona para si com base no tipo de máquina e na disponibilidade.
Selecione a família de máquinas para a sua instância. A Trusted Cloud consola apresenta as séries de máquinas disponíveis para a família de máquinas selecionada. Estão disponíveis as seguintes opções de família de máquinas:
- Utilização geral
- Otimizado para computação
- Otimizada para memória
- Otimizado para armazenamento
- GPUs
Na coluna Série, selecione a série de máquinas para a sua instância.
Se selecionou GPUs como a família de máquinas no passo anterior, selecione o tipo de GPU pretendido. A série de máquinas é, em seguida, selecionada automaticamente para o tipo de GPU selecionado.
Na secção Tipo de máquina, selecione o tipo de máquina para a sua instância.
No menu de navegação, clique em SO e armazenamento. No painel Sistema operativo e armazenamento apresentado, configure o disco de arranque da seguinte forma:
- Clique em Alterar. O painel Disco de arranque é apresentado e mostra o separador Imagens públicas.
- Clique em Instantâneos. É apresentado o separador Instantâneo.
- Na lista Instantâneo, selecione o instantâneo a usar.
- Na lista Tipo de disco de arranque, selecione o tipo de disco de arranque.
- No campo Tamanho (GB), especifique o tamanho do disco de arranque.
- Opcional: para opções de configuração avançadas, expanda a secção Mostrar configurações avançadas.
- Para confirmar as opções do disco de arranque e voltar ao painel Sistema operativo e armazenamento, clique em Selecionar.
No menu de navegação, clique em Rede. No painel Rede apresentado, faça o seguinte:
- Aceda à secção Firewall.
- Para permitir o tráfego HTTP ou HTTPS para a instância, selecione Permitir tráfego HTTP ou Permitir tráfego HTTPS.
A Trusted Cloud consola adiciona uma etiqueta de rede à sua instância e cria a regra de firewall de entrada correspondente que permite todo o tráfego recebido em
tcp:80
(HTTP) outcp:443
(HTTPS). A etiqueta de rede associa a regra de firewall à instância. Para mais informações, consulte a vista geral das regras de firewall na documentação da nuvem privada virtual.Opcional: especifique outras opções de configuração. Para mais informações, consulte o artigo Opções de configuração durante a criação da instância.
Para criar e iniciar a instância, clique em Criar.
gcloud
Disco de arranque zonal
Use o comando
gcloud compute instances create
e inclua a flag--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:
INSTANCE_NAME
: name para a nova instânciaBOOT_SNAPSHOT_NAME
: nome da captura de ecrã do disco de arranque que quer restaurar para o disco de arranque da nova instânciaBOOT_DISK_SIZE
: opcional: tamanho, em GiB, do novo disco de arranqueO tamanho tem de ser igual ou superior ao tamanho do disco de origem a partir do qual foi criada a captura de ecrã.
BOOT_DISK_TYPE
: Opcional: tipo do disco de arranque, por exemploPROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced
BOOT_DISK_NAME
: nome do novo disco de arranque para esta instância
Disco de arranque regional
Use o comando
gcloud compute instances create
e inclua a flag--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 carateres
^:^
especificam que é usado um dois pontos:
como separador entre cada uma das propriedades do disco. Isto é necessário para poder usar uma vírgula,
quando especificar as zonas parareplica-zones
.Substitua o seguinte:
INSTANCE_NAME
: name para a nova instânciaZONE
: para criar a instância na zonaDISK_NAME
: opcional: um nome para o discoBOOT_SNAPSHOT_NAME
: nome da imagem instantânea do disco de arranque que quer restaurar para o disco de arranque da nova instância.BOOT_DISK_TYPE
: Opcional: tipo do disco de arranque, por exemplohyperdisk-balanced-high-availability
REMOTE_ZONE
: a região para a qual o disco de arranque é replicado. A propriedadereplica-zones
requer duas zonas separadas por vírgula e uma das zonas tem de ser igual à zona da instância.
Ir
Go
Antes de experimentar este exemplo, siga as Goinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Go Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Java
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Java Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Node.js
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Node.js Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.Python
Python
Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no guia de início rápido do Compute Engine com bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Python Compute Engine.
Para se autenticar no Compute Engine, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável
GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment comos3nsapis.fr
.REST
Quando usa a API para criar uma instância a partir de uma captura de ecrã, aplicam-se as seguintes restrições:
- Só é possível usar um disco como disco de arranque.
- Tem de anexar o disco de arranque como o primeiro disco dessa instância.
- Se especificar a propriedade
source
, também não pode especificar a propriedadeinitializeParams
. A indicação de umsource
indica que o disco de arranque já existe, mas a propriedadeinitializeParams
indica que o Compute Engine deve criar um novo disco de arranque.
Disco de arranque zonal
Para criar uma instância a partir de uma imagem instantânea do disco de arranque, use o métodoinstances.insert
e especifique o camposourceSnapshot
na propriedadedisks
. Opcionalmente, pode especificar as propriedadesdiskSizeGb
ediskType
para o novo disco de arranque. Substitua o seguinte:POST https://compute.s3nsapis.fr/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" } ] }
PROJECT_ID
: o ID do seu projetoZONE
: zona onde quer criar a nova instânciaINSTANCE_NAME
: name da instância para a qual quer restaurar uma imagem instantâneaMACHINE_TYPE
: tipo de máquina da instânciaBOOT_SNAPSHOT_NAME
: nome da imagem instantânea que quer usar para criar o disco de arranque da nova instânciaBOOT_DISK_SIZE
: Opcional: tamanho, em gibibytes (GiB), para o novo disco de arranqueO tamanho tem de ser igual ou superior ao tamanho do disco de origem a partir do qual foi criada a captura de ecrã.
BOOT_DISK_TYPE
: opcional: tipo do disco de arranque, por exemplo,PROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced
Disco de arranque regional
Para criar uma instância de computação com um disco de arranque regional usando um instantâneo do disco de arranque como origem, use o métodoinstances.insert
e especifique os campossourceSnapshot
ereplicaZones
na propriedadedisks
.POST https://compute.s3nsapis.fr/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:
PROJECT_ID
: o ID do seu projetoZONE
: o nome da zona onde quer criar a instânciaINSTANCE_NAME
`: um nome para a instânciaBOOT_SNAPSHOT_NAME
: o nome do instantâneo do disco de arranqueREMOTE_ZONE
: a zona remota para o disco regionalBOOT_DISK_TYPE
: opcional: tipo do disco de arranque, por exemploPROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced-high-availability
Crie uma instância de computação a partir de um instantâneo de disco não de arranque
Se fez uma cópia de segurança de um disco não de arranque com um instantâneo, pode criar uma instância com um disco não de arranque adicional com base no instantâneo.
Consola
Quando restaura instantâneos não de arranque para uma nova instância a partir da consola, crie primeiro um disco a partir de cada instantâneo. Em seguida, anexe os novos discos quando criar a instância.
Restaure cada instantâneo que não seja de arranque para um novo disco.
Na Trusted Cloud consola, aceda à página Discos.
Clique em Criar disco.
Especifique um Nome para o disco. Para mais informações, consulte o artigo Convenção de nomenclatura de recursos.
Selecione a Região e a Zona para este disco. O disco e a instância têm de 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 Snapshot.
No novo campo Imagem instantânea de origem, selecione uma imagem instantânea que não seja de arranque e que queira restaurar para o novo disco.
Para criar o disco, clique em Criar.
Repita estes passos para criar um disco a partir de cada instantâneo que quer restaurar.
Na Trusted Cloud consola, aceda à página Instâncias de VM.
Selecione o projeto e clique em Continuar.
Clique em Criar instância.
Especifique um nome para a instância. Para mais informações, consulte o artigo Convenção de nomenclatura de recursos.
Selecione a Região e a Zona para esta instância. O disco e a instância têm de estar na mesma zona para discos zonais ou na mesma região para discos regionais.
Selecione um Tipo de máquina para a sua instância.
Se quiser permitir tráfego externo de entrada, altere as regras da firewall para a instância.
Para anexar discos à instância, expanda a secção Opções avançadas e, em seguida, faça o seguinte:
- Expanda a secção Discos.
- Clique em Anexar disco existente.
- Na lista Disco, selecione um disco para anexar a esta instância.
- Na secção Definição de anexo, selecione o Modo de anexo do disco e a Regra de eliminação. Para mais informações sobre como adicionar novos discos, consulte os artigos Adicione um Hyperdisk.
- Clique em Guardar.
Repita estes passos para cada disco que quer anexar.
Para criar e iniciar a instância, clique em Criar.
gcloud
Crie uma instância através do comando
gcloud compute instances create
. Para cada instantâneo de não arranque que quer restaurar, inclua a flag--create-disk
e especifique umsource-snapshot
.Por exemplo, para restaurar dois instantâneos de discos não de arranque 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:
INSTANCE_NAME
: name para a nova instânciaSNAPSHOT_1_NAME
eSNAPSHOT_2_NAME
: nomes das imagens instantâneas do disco que não é de arranque que quer restaurarDISK_1_NAME
eDISK_2_NAME
: nomes dos novos discos não de arranque a criar para esta instânciaDISK_1_SIZE
eDISK_2_SIZE
: opcional: tamanhos, em gibibytes (GiB), de cada novo disco não de arranqueOs tamanhos têm de ser iguais ou superiores aos tamanhos dos discos de origem a partir dos quais foi criada a captura de ecrã.
DISK_1_TYPE
eDISK_2_TYPE
: opcional: os tipos de disco a criar, por exemplo,hyperdisk-balanced
REST
Quando usa a REST para restaurar uma captura de ecrã não de arranque para uma nova instância, aplicam-se as seguintes restrições:
- Só pode existir um disco de arranque.
- Tem de anexar o disco de arranque como o primeiro disco dessa instância.
- Se especificar a propriedade
source
, também não pode especificar a propriedadeinitializeParams
. A indicação de umsource
indica que o disco de arranque já existe, mas a propriedadeinitializeParams
indica que o Compute Engine deve criar um novo disco de arranque.
Crie um pedido
POST
para o métodoinstances.insert
e especifique o camposourceSnapshot
na propriedadeinitializeParams
. Pode adicionar vários discos não de arranque repetindo a propriedadeinitializeParams
para cada disco não de arranque que quer criar. Opcionalmente, pode especificar as propriedadesdiskSizeGb
ediskType
para qualquer um dos discos que criar.Por exemplo, para restaurar duas imagens instantâneas de discos não de arranque para uma nova instância, faça o seguinte pedido:
POST https://compute.s3nsapis.fr/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:
PROJECT_ID
: o ID do seu projetoZONE
: zona onde quer criar a instânciaINSTANCE_NAME
: um nome para a nova instânciaMACHINE_TYPE
: tipo de máquina da instânciaDISK_SIZE
: Opcional: tamanho, em gibibytes (GiB), do disco correspondenteQuando fornecida, esta propriedade tem de ser igual ou superior ao tamanho do disco de origem a partir do qual foi criada a imagem instantânea.
DISK_TYPE
: Opcional: URL completo ou parcial para o tipo do disco correspondente, por exemplo,PROJECT_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. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada nessa família. Por exemplo, se especificar"sourceImage": "projects/debian-cloud/global/images/family/debian-11"
, o Compute Engine cria uma instância com a versão mais recente da imagem do SO na família de imagens do Debian 11.DEVICE_NAME
: opcional: o nome do dispositivo apresentado no SO convidado da instânciaSNAPSHOT_NAME
: os nomes das capturas de ecrã de discos não de arranque correspondentes que quer restaurar para novos discos na instância
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-09-30 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-30 UTC."],[],[],null,[]] -