Crie uma instância com discos não de arranque adicionais

Quando cria uma instância de computação, pode criar e anexar discos que não sejam de arranque adicionais à instância ao mesmo tempo. Também pode escolher discos existentes para anexar como discos não de arranque.

Se quiser criar um disco no modo de gravação múltipla, não pode criar o disco ao mesmo tempo que cria a instância. Primeiro, tem de criar o disco e, em seguida, pode anexá-lo à instância.

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

    1. 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
    2. Set a default region and zone.

    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. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:

      gcloud init

    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 criar uma instância com discos não de arranque adicionados, peça ao seu administrador para lhe conceder a função de 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 criar uma instância com discos que não são de arranque adicionados. 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 criar uma instância com discos que não sejam de arranque adicionados:

  • compute.instances.create no projeto
  • Para criar um novo disco para a instância: compute.disks.create no projeto

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Crie uma instância com novos discos adicionais não de arranque

Para criar uma instância com discos não de arranque adicionais criados e anexados, siga estes passos:

Consola

  1. Na Trusted Cloud consola, aceda à página Criar uma instância.

    Aceda a 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 mostra o painel Configuração da máquina.

  2. No painel Configuração da máquina, faça o seguinte:

    1. No campo Nome, especifique um nome para a instância. Para mais informações, consulte a Convenção de nomenclatura de recursos.
    2. 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.

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

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

    5. Na secção Tipo de máquina, selecione o tipo de máquina para a sua instância.

  3. No menu de navegação, clique em SO e armazenamento. No painel Sistema operativo e armazenamento apresentado, conclua os seguintes passos.

    Para saber mais acerca dos parâmetros que pode configurar ao adicionar novos discos, consulte Acerca do Persistent Disk e Acerca do Google Cloud Hyperdisk.

    1. Para configurar o disco de arranque, clique em Alterar. O painel Disco de arranque é apresentado e mostra o separador Imagens públicas.

    2. Configure a origem de dados para o disco de arranque de uma das seguintes formas:

      • Para escolher uma imagem pública como origem de dados para o disco de arranque, no separador Imagens públicas, especifique o seguinte:

        1. Na lista Sistema operativo, selecione o tipo de SO.
        2. Na lista Versão, selecione a versão do SO.
        3. Na lista Tipo de disco de arranque, selecione o tipo de disco de arranque.
        4. No campo Tamanho (GB), especifique o tamanho do disco de arranque.
      • Para escolher uma imagem personalizada como origem de dados para o disco de arranque, clique em Imagens personalizadas e, de seguida, no separador Imagens personalizadas apresentado, especifique o seguinte:

        1. Para selecionar o projeto de imagem, clique em Alterar e, de seguida, selecione o projeto que contém a imagem.
        2. Na lista Imagem, selecione a imagem que quer importar.
        3. Na lista Tipo de disco de arranque, selecione o tipo de disco de arranque.
        4. No campo Tamanho (GB), especifique o tamanho do disco de arranque.
      • Para escolher uma imagem instantânea padrão como origem de dados para o disco de arranque, clique em Imagens instantâneas e, de seguida, no separador Imagens instantâneas apresentado, especifique o seguinte:

        1. Na lista Instantâneo, selecione o instantâneo.
        2. Na lista Tipo de disco de arranque, selecione o tipo de disco de arranque.
        3. No campo Tamanho (GB), especifique o tamanho do disco de arranque.
      • Para escolher um resumo do arquivo como origem de dados para o disco de arranque, clique em Resumos do arquivo e, de seguida, no separador Resumos do arquivo que é apresentado, especifique o seguinte:

        1. Na lista Arquivar instantâneo, selecione o instantâneo de arquivo.
        2. Na lista Tipo de disco de arranque, selecione o tipo de disco de arranque.
        3. No campo Tamanho (GB), especifique o tamanho do disco de arranque.
      • Para escolher um disco existente como disco de arranque, clique em Discos existentes. Em seguida, no separador Discos existentes apresentado, selecione um disco persistente regional existente ou um volume de alta disponibilidade equilibrado do Hyperdisk na lista Disco.

    3. Opcional: para opções de configuração avançadas, expanda a secção Mostrar configurações avançadas.

    4. Para confirmar as opções do disco de arranque e voltar ao painel Sistema operativo e armazenamento, clique em Selecionar.

    5. Para criar um novo disco não de arranque e anexá-lo à sua instância, na secção Armazenamento adicional e cópias de segurança de VMs, clique em Adicionar novo disco.

      No painel Adicionar novo disco apresentado, faça o seguinte:

      1. No campo Nome, especifique um nome para o disco não de arranque.
      2. Na lista Tipo de origem do disco, selecione o tipo de origem do disco não arrancável.
      3. Na lista Tipo de disco, selecione um tipo para o disco não de arranque.
      4. No campo Tamanho, especifique o tamanho do disco não de arranque.
      5. Na secção Definições de anexos, faça o seguinte:
      6. No campo Modo, selecione o modo de ligação do disco.
      7. No campo Regra de eliminação, selecione uma opção para especificar o que acontece ao disco quando a instância é eliminada.

      Repita este passo para cada disco que não seja de arranque que quer criar e anexar à sua instância.

  4. No menu de navegação, clique em Proteção de dados. No painel Proteção de dados apresentado, especifique como quer fazer uma cópia de segurança e replicar os dados da sua instância fazendo o seguinte.

    1. Para especificar como quer fazer uma cópia de segurança dos dados, selecione uma opção para Fazer uma cópia de segurança dos seus dados.
    2. Para especificar como quer replicar os dados, faça o seguinte:

      1. Se quiser que os novos discos da instância sejam replicados de forma síncrona numa segunda zona através de tipos de discos regionais, selecione a caixa de verificação Discos regionais.
      1. Se quiser que os discos da instância sejam replicados numa segunda região através da replicação assíncrona de discos persistentes, selecione a caixa de verificação Replicação assíncrona.
    3. Se quiser usar apenas as opções de proteção de dados especificadas em discos que não sejam de arranque, selecione a caixa de verificação Excluir discos de arranque.

  5. No menu de navegação, clique em Rede. No painel Rede apresentado, faça o seguinte:

    1. Aceda à secção Firewall.
    2. Para permitir o tráfego HTTP ou HTTPS para a instância, selecione Permitir tráfego HTTP ou Permitir tráfego HTTPS.

      O Compute Engine adiciona uma etiqueta 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) ou tcp:443 (HTTPS). A etiqueta de rede associa a regra de firewall à instância. Para mais informações, consulte o artigo Vista geral das regras da firewall na documentação da firewall de nova geração do Google Cloud.

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

  7. Para criar e iniciar a instância, clique em Criar.

gcloud

  1. In the Trusted Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Execute o comando gcloud compute instances create para criar uma instância com discos que não são de arranque adicionais.

    Pode adicionar até 127 discos não de arranque enquanto cria a instância. Especifique a flag --create-disk para cada disco que não seja de arranque que criar.

    Para criar discos não de arranque a partir de uma imagem pública ou de stock, especifique as propriedades image ou image-family e image-project com a flag --create-disk. Para criar um disco em branco, não inclua estas propriedades.

    Opcionalmente, pode incluir propriedades para:

    • Tamanho do disco: use a propriedade --size.
    • Tipo de disco: use a propriedade --type.
    gcloud compute instances create INSTANCE_NAME \
        --zone=ZONE \
        --image-project=IMAGE_PROJECT \
        IMAGE_FLAG \
        --create-disk DISK_IMAGE,image-project=DISK_IMAGE_PROJECT,size=SIZE_GB,type=DISK_TYPE \
        --create-disk device-name=DISK_NAME,replica-zones=^:^ZONE:REMOTE-ZONE,boot=false
    

    Substitua o seguinte:

    • INSTANCE_NAME: name da nova instância
    • ZONE: zona na qual criar a instância
    • IMAGE_PROJECT: project que contém a imagem
    • IMAGE_FLAG: especifique uma das seguintes opções:

      • Use a flag --image IMAGE_NAME para especificar uma versão específica de uma imagem pública ou personalizada. Por exemplo, --image debian-12-bookworm-v20241112.

      • Use a flag --image-family IMAGE_FAMILY_NAME para especificar uma família de imagens. Isto cria a instância que usa a imagem do SO mais recente e não descontinuada na família de imagens. Por exemplo, se especificar --image-family debian-12, o Compute Engine usa a versão mais recente da imagem do SO na família de imagens do Debian 12 quando cria a instância.

    • Para discos adicionais, substitua o seguinte:

      • DISK_IMAGE: especifique uma das seguintes opções:
        • image=DISK_IMAGE_NAME: nome da imagem que quer usar quando cria um disco não inicializável
        • image-family=DISK_IMAGE_FAMILY>: uma família de imagens a usar quando cria um disco não inicializável
      • DISK_IMAGE_PROJECT: um projeto de imagem ao qual a imagem de disco pertence
      • SIZE_GB: Opcional: tamanho do disco que não é de arranque
      • DISK_TYPE: Opcional: URL completo ou parcial para o tipo do disco

        Por exemplo, https://www.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced. Para ver os tipos de discos disponíveis numa ou mais zonas, use o comando gcloud compute disk-types list --zones=ZONE_LIST. Substitua ZONE_LIST por uma lista de zonas separada por vírgulas.

      • DISK_NAME: opcional: o nome do disco apresentado ao SO convidado após a criação da instância.

      • REMOTE_ZONE: a zona para onde o disco deve ser replicado

      Para discos em branco, não especifique os parâmetros image, image-project ou image-family.

      Para discos zonais, não especifique a propriedade do disco replica-zones.

  3. Terraform

    Para gerar o código do Terraform, pode usar o componente Código equivalente na Trusted Cloud consola.
    1. Na Trusted Cloud consola, aceda à página Instâncias de VM.

      Aceder a Instâncias de VM

    2. Clique em Criar instância.
    3. Especifique os parâmetros pretendidos.
    4. Na parte superior ou inferior da página, clique em Código equivalente e, de seguida, clique no separador Terraform para ver o código Terraform.

    Ir

    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 como s3nsapis.fr.

    import (
    	"context"
    	"fmt"
    	"io"
    
    	compute "cloud.google.com/go/compute/apiv1"
    	computepb "cloud.google.com/go/compute/apiv1/computepb"
    	"google.golang.org/protobuf/proto"
    )
    
    // createWithAdditionalDisk create a new VM instance with Debian 10 operating system and a 11 GB additional empty disk.
    func createWithAdditionalDisk(w io.Writer, projectID, zone, instanceName string) error {
    	// projectID := "your_project_id"
    	// zone := "europe-central2-b"
    	// instanceName := "your_instance_name"
    
    	ctx := context.Background()
    	instancesClient, err := compute.NewInstancesRESTClient(ctx)
    	if err != nil {
    		return fmt.Errorf("NewInstancesRESTClient: %w", err)
    	}
    	defer instancesClient.Close()
    
    	imagesClient, err := compute.NewImagesRESTClient(ctx)
    	if err != nil {
    		return fmt.Errorf("NewImagesRESTClient: %w", err)
    	}
    	defer imagesClient.Close()
    
    	// List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details.
    	newestDebianReq := &computepb.GetFromFamilyImageRequest{
    		Project: "debian-cloud",
    		Family:  "debian-12",
    	}
    	newestDebian, err := imagesClient.GetFromFamily(ctx, newestDebianReq)
    	if err != nil {
    		return fmt.Errorf("unable to get image from family: %w", err)
    	}
    
    	req := &computepb.InsertInstanceRequest{
    		Project: projectID,
    		Zone:    zone,
    		InstanceResource: &computepb.Instance{
    			Name: proto.String(instanceName),
    			Disks: []*computepb.AttachedDisk{
    				{
    					InitializeParams: &computepb.AttachedDiskInitializeParams{
    						DiskSizeGb:  proto.Int64(10),
    						SourceImage: newestDebian.SelfLink,
    						DiskType:    proto.String(fmt.Sprintf("zones/%s/diskTypes/pd-standard", zone)),
    					},
    					AutoDelete: proto.Bool(true),
    					Boot:       proto.Bool(true),
    					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
    				},
    				{
    					InitializeParams: &computepb.AttachedDiskInitializeParams{
    						DiskSizeGb: proto.Int64(11),
    						DiskType:   proto.String(fmt.Sprintf("zones/%s/diskTypes/pd-standard", zone)),
    					},
    					AutoDelete: proto.Bool(true),
    					Boot:       proto.Bool(false),
    					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
    				},
    			},
    			MachineType: proto.String(fmt.Sprintf("zones/%s/machineTypes/n1-standard-1", zone)),
    			NetworkInterfaces: []*computepb.NetworkInterface{
    				{
    					Name: proto.String("global/networks/default"),
    				},
    			},
    		},
    	}
    
    	op, err := instancesClient.Insert(ctx, req)
    	if err != nil {
    		return fmt.Errorf("unable to create instance: %w", err)
    	}
    
    	if err = op.Wait(ctx); err != nil {
    		return fmt.Errorf("unable to wait for the operation: %w", err)
    	}
    
    	fmt.Fprintf(w, "Instance created\n")
    
    	return nil
    }
    

    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 como s3nsapis.fr.

    
    import com.google.api.gax.longrunning.OperationFuture;
    import com.google.cloud.compute.v1.AttachedDisk;
    import com.google.cloud.compute.v1.AttachedDisk.Type;
    import com.google.cloud.compute.v1.AttachedDiskInitializeParams;
    import com.google.cloud.compute.v1.Image;
    import com.google.cloud.compute.v1.ImagesClient;
    import com.google.cloud.compute.v1.InsertInstanceRequest;
    import com.google.cloud.compute.v1.Instance;
    import com.google.cloud.compute.v1.InstancesClient;
    import com.google.cloud.compute.v1.NetworkInterface;
    import com.google.cloud.compute.v1.Operation;
    import java.io.IOException;
    import java.util.Vector;
    import java.util.concurrent.ExecutionException;
    import java.util.concurrent.TimeUnit;
    import java.util.concurrent.TimeoutException;
    
    public class CreateInstancesAdvanced {
    
      /**
       * Create an AttachedDisk object to be used in VM instance creation. Uses an image as the source
       * for the new disk.
       *
       * @param diskType the type of disk you want to create. This value uses the following format:
       * "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)". For example:
       * "zones/us-west3-b/diskTypes/pd-ssd"
       * @param diskSizeGb size of the new disk in gigabytes
       * @param boot boolean flag indicating whether this disk should be used as a boot disk of an
       * instance
       * @param sourceImage source image to use when creating this disk. You must have read access to
       * this disk. This can be one of the publicly available images or an image from one of your
       * projects. This value uses the following format:
       * "projects/{project_name}/global/images/{image_name}"
       * @return AttachedDisk object configured to be created using the specified image.
       */
      private static AttachedDisk diskFromImage(String diskType, int diskSizeGb, boolean boot,
          String sourceImage) {
        AttachedDisk disk =
            AttachedDisk.newBuilder()
                .setBoot(boot)
                // Remember to set auto_delete to True if you want the disk to be deleted when
                // you delete your VM instance.
                .setAutoDelete(true)
                .setType(Type.PERSISTENT.toString())
                .setInitializeParams(
                    AttachedDiskInitializeParams.newBuilder()
                        .setSourceImage(sourceImage)
                        .setDiskSizeGb(diskSizeGb)
                        .setDiskType(diskType)
                        .build())
                .build();
        return disk;
      }
    
    
      /**
       * Create an AttachedDisk object to be used in VM instance creation. The created disk contains no
       * data and requires formatting before it can be used.
       *
       * @param diskType the type of disk you want to create. This value uses the following format:
       * "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)". For example:
       * "zones/us-west3-b/diskTypes/pd-ssd"
       * @param diskSizeGb size of the new disk in gigabytes
       * @return AttachedDisk object configured to be created as an empty disk.
       */
      private static AttachedDisk emptyDisk(String diskType, int diskSizeGb) {
        AttachedDisk disk =
            AttachedDisk.newBuilder()
                .setBoot(false)
                // Remember to set auto_delete to True if you want the disk to be deleted when
                // you delete your VM instance.
                .setAutoDelete(true)
                .setType(Type.PERSISTENT.toString())
                .setInitializeParams(
                    AttachedDiskInitializeParams.newBuilder()
                        .setDiskSizeGb(diskSizeGb)
                        .setDiskType(diskType)
                        .build())
                .build();
        return disk;
      }
    
      /**
       * Send an instance creation request to the Compute Engine API and wait for it to complete.
       *
       * @param project project ID or project number of the Cloud project you want to use.
       * @param zone name of the zone to create the instance in. For example: "us-west3-b"
       * @param instanceName name of the new virtual machine (VM) instance.
       * @param disks a list of compute_v1.AttachedDisk objects describing the disks you want to attach
       * to your new instance.
       * @param machineType machine type of the VM being created. This value uses the following format:
       * "zones/{zone}/machineTypes/{type_name}".
       * For example: "zones/europe-west3-c/machineTypes/f1-micro"
       * @param network name of the network you want the new instance to use. For example:
       * "global/networks/default" represents the network named "default", which is created
       * automatically for each project.
       * @param subnetwork name of the subnetwork you want the new instance to use. This value uses the
       * following format: "regions/{region}/subnetworks/{subnetwork_name}"
       * @return Instance object.
       */
      private static Instance createWithDisks(String project, String zone, String instanceName,
          Vector<AttachedDisk> disks, String machineType, String network, String subnetwork)
          throws IOException, InterruptedException, ExecutionException, TimeoutException {
        try (InstancesClient instancesClient = InstancesClient.create()) {
          // Use the network interface provided in the networkName argument.
          NetworkInterface networkInterface;
          if (subnetwork != null) {
            networkInterface = NetworkInterface.newBuilder()
                .setName(network).setSubnetwork(subnetwork)
                .build();
          } else {
            networkInterface = NetworkInterface.newBuilder()
                .setName(network).build();
          }
    
          machineType = String.format("zones/%s/machineTypes/%s", zone, machineType);
    
          // Bind `instanceName`, `machineType`, `disk`, and `networkInterface` to an instance.
          Instance instanceResource =
              Instance.newBuilder()
                  .setName(instanceName)
                  .setMachineType(machineType)
                  .addAllDisks(disks)
                  .addNetworkInterfaces(networkInterface)
                  .build();
    
          System.out.printf("Creating instance: %s at %s ", instanceName, zone);
    
          // Insert the instance in the specified project and zone.
          InsertInstanceRequest insertInstanceRequest = InsertInstanceRequest.newBuilder()
              .setProject(project)
              .setZone(zone)
              .setInstanceResource(instanceResource).build();
    
          OperationFuture<Operation, Operation> operation = instancesClient.insertAsync(
              insertInstanceRequest);
    
          // Wait for the operation to complete.
          Operation response = operation.get(3, TimeUnit.MINUTES);
    
          if (response.hasError()) {
            System.out.println("Instance creation failed ! ! " + response);
            return null;
          }
          System.out.println("Operation Status: " + response.getStatus());
    
          return instancesClient.get(project, zone, instanceName);
        }
      }
    
      /**
       * Create a new VM instance with Debian 11 operating system and a 11 GB additional empty disk.
       *
       * @param project project ID or project number of the Cloud project you want to use.
       * @param zone name of the zone to create the instance in. For example: "us-west3-b"
       * @param instanceName name of the new virtual machine (VM) instance.
       * @return Instance object.
       */
      public static Instance createWithAdditionalDisk(String project, String zone, String instanceName)
          throws IOException, InterruptedException, ExecutionException, TimeoutException {
        try (ImagesClient imagesClient = ImagesClient.create()) {
          // List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details
          Image image = imagesClient.getFromFamily("debian-cloud", "debian-11");
          String diskType = String.format("zones/%s/diskTypes/pd-standard", zone);
          Vector<AttachedDisk> disks = new Vector<>();
          disks.add(diskFromImage(diskType, 10, true, image.getSelfLink()));
          disks.add(emptyDisk(diskType, 11));
          return createWithDisks(project, zone, instanceName, disks, "n1-standard-1",
              "global/networks/default", null);
        }
      }

    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 como s3nsapis.fr.

    /**
     * TODO(developer): Uncomment and replace these variables before running the sample.
     */
    // const projectId = 'YOUR_PROJECT_ID';
    // const zone = 'europe-central2-b';
    // const instanceName = 'YOUR_INSTANCE_NAME';
    
    const compute = require('@google-cloud/compute');
    
    // Create a new VM instance with Debian 10 operating system and a 11 GB additional empty disk.
    async function createWithAdditionalDisk() {
      const instancesClient = new compute.InstancesClient();
      const imagesClient = new compute.ImagesClient();
    
      // List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details.
      const [newestDebian] = await imagesClient.getFromFamily({
        project: 'debian-cloud',
        family: 'debian-11',
      });
    
      const [response] = await instancesClient.insert({
        project: projectId,
        zone,
        instanceResource: {
          name: instanceName,
          disks: [
            {
              initializeParams: {
                diskSizeGb: '10',
                sourceImage: newestDebian.selfLink,
                diskType: `zones/${zone}/diskTypes/pd-standard`,
              },
              autoDelete: true,
              boot: true,
              type: 'PERSISTENT',
            },
            {
              initializeParams: {
                diskSizeGb: '11',
                diskType: `zones/${zone}/diskTypes/pd-standard`,
              },
              autoDelete: true,
              boot: false,
              type: 'PERSISTENT',
            },
          ],
          machineType: `zones/${zone}/machineTypes/n1-standard-1`,
          networkInterfaces: [
            {
              name: 'global/networks/default',
            },
          ],
        },
      });
      let operation = response.latestResponse;
      const operationsClient = new compute.ZoneOperationsClient();
    
      // Wait for the create operation to complete.
      while (operation.status !== 'DONE') {
        [operation] = await operationsClient.wait({
          operation: operation.name,
          project: projectId,
          zone: operation.zone.split('/').pop(),
        });
      }
    
      console.log('Instance created.');
    }
    
    createWithAdditionalDisk();

    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 como s3nsapis.fr.

    from __future__ import annotations
    
    import re
    import sys
    from typing import Any
    import warnings
    
    from google.api_core.extended_operation import ExtendedOperation
    from google.cloud import compute_v1
    
    
    def get_image_from_family(project: str, family: str) -> compute_v1.Image:
        """
        Retrieve the newest image that is part of a given family in a project.
    
        Args:
            project: project ID or project number of the Cloud project you want to get image from.
            family: name of the image family you want to get image from.
    
        Returns:
            An Image object.
        """
        image_client = compute_v1.ImagesClient()
        # List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details
        newest_image = image_client.get_from_family(project=project, family=family)
        return newest_image
    
    
    def disk_from_image(
        disk_type: str,
        disk_size_gb: int,
        boot: bool,
        source_image: str,
        auto_delete: bool = True,
    ) -> compute_v1.AttachedDisk:
        """
        Create an AttachedDisk object to be used in VM instance creation. Uses an image as the
        source for the new disk.
    
        Args:
             disk_type: the type of disk you want to create. This value uses the following format:
                "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)".
                For example: "zones/us-west3-b/diskTypes/pd-ssd"
            disk_size_gb: size of the new disk in gigabytes
            boot: boolean flag indicating whether this disk should be used as a boot disk of an instance
            source_image: source image to use when creating this disk. You must have read access to this disk. This can be one
                of the publicly available images or an image from one of your projects.
                This value uses the following format: "projects/{project_name}/global/images/{image_name}"
            auto_delete: boolean flag indicating whether this disk should be deleted with the VM that uses it
    
        Returns:
            AttachedDisk object configured to be created using the specified image.
        """
        boot_disk = compute_v1.AttachedDisk()
        initialize_params = compute_v1.AttachedDiskInitializeParams()
        initialize_params.source_image = source_image
        initialize_params.disk_size_gb = disk_size_gb
        initialize_params.disk_type = disk_type
        boot_disk.initialize_params = initialize_params
        # Remember to set auto_delete to True if you want the disk to be deleted when you delete
        # your VM instance.
        boot_disk.auto_delete = auto_delete
        boot_disk.boot = boot
        return boot_disk
    
    
    def empty_disk(
        disk_type: str, disk_size_gb: int, boot: bool = False, auto_delete: bool = True
    ) -> compute_v1.AttachedDisk():
        """
        Create an AttachedDisk object to be used in VM instance creation. The created disk contains
        no data and requires formatting before it can be used.
    
        Args:
             disk_type: the type of disk you want to create. This value uses the following format:
                "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)".
                For example: "zones/us-west3-b/diskTypes/pd-ssd"
            disk_size_gb: size of the new disk in gigabytes
            boot: boolean flag indicating whether this disk should be used as a boot disk of an instance
            auto_delete: boolean flag indicating whether this disk should be deleted with the VM that uses it
    
        Returns:
            AttachedDisk object configured to be created as an empty disk.
        """
        disk = compute_v1.AttachedDisk()
        initialize_params = compute_v1.AttachedDiskInitializeParams()
        initialize_params.disk_type = disk_type
        initialize_params.disk_size_gb = disk_size_gb
        disk.initialize_params = initialize_params
        # Remember to set auto_delete to True if you want the disk to be deleted when you delete
        # your VM instance.
        disk.auto_delete = auto_delete
        disk.boot = boot
        return disk
    
    
    def wait_for_extended_operation(
        operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
    ) -> Any:
        """
        Waits for the extended (long-running) operation to complete.
    
        If the operation is successful, it will return its result.
        If the operation ends with an error, an exception will be raised.
        If there were any warnings during the execution of the operation
        they will be printed to sys.stderr.
    
        Args:
            operation: a long-running operation you want to wait on.
            verbose_name: (optional) a more verbose name of the operation,
                used only during error and warning reporting.
            timeout: how long (in seconds) to wait for operation to finish.
                If None, wait indefinitely.
    
        Returns:
            Whatever the operation.result() returns.
    
        Raises:
            This method will raise the exception received from `operation.exception()`
            or RuntimeError if there is no exception set, but there is an `error_code`
            set for the `operation`.
    
            In case of an operation taking longer than `timeout` seconds to complete,
            a `concurrent.futures.TimeoutError` will be raised.
        """
        result = operation.result(timeout=timeout)
    
        if operation.error_code:
            print(
                f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
                file=sys.stderr,
                flush=True,
            )
            print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
            raise operation.exception() or RuntimeError(operation.error_message)
    
        if operation.warnings:
            print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
            for warning in operation.warnings:
                print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)
    
        return result
    
    
    def create_instance(
        project_id: str,
        zone: str,
        instance_name: str,
        disks: list[compute_v1.AttachedDisk],
        machine_type: str = "n1-standard-1",
        network_link: str = "global/networks/default",
        subnetwork_link: str = None,
        internal_ip: str = None,
        external_access: bool = False,
        external_ipv4: str = None,
        accelerators: list[compute_v1.AcceleratorConfig] = None,
        preemptible: bool = False,
        spot: bool = False,
        instance_termination_action: str = "STOP",
        custom_hostname: str = None,
        delete_protection: bool = False,
    ) -> compute_v1.Instance:
        """
        Send an instance creation request to the Compute Engine API and wait for it to complete.
    
        Args:
            project_id: project ID or project number of the Cloud project you want to use.
            zone: name of the zone to create the instance in. For example: "us-west3-b"
            instance_name: name of the new virtual machine (VM) instance.
            disks: a list of compute_v1.AttachedDisk objects describing the disks
                you want to attach to your new instance.
            machine_type: machine type of the VM being created. This value uses the
                following format: "zones/{zone}/machineTypes/{type_name}".
                For example: "zones/europe-west3-c/machineTypes/f1-micro"
            network_link: name of the network you want the new instance to use.
                For example: "global/networks/default" represents the network
                named "default", which is created automatically for each project.
            subnetwork_link: name of the subnetwork you want the new instance to use.
                This value uses the following format:
                "regions/{region}/subnetworks/{subnetwork_name}"
            internal_ip: internal IP address you want to assign to the new instance.
                By default, a free address from the pool of available internal IP addresses of
                used subnet will be used.
            external_access: boolean flag indicating if the instance should have an external IPv4
                address assigned.
            external_ipv4: external IPv4 address to be assigned to this instance. If you specify
                an external IP address, it must live in the same region as the zone of the instance.
                This setting requires `external_access` to be set to True to work.
            accelerators: a list of AcceleratorConfig objects describing the accelerators that will
                be attached to the new instance.
            preemptible: boolean value indicating if the new instance should be preemptible
                or not. Preemptible VMs have been deprecated and you should now use Spot VMs.
            spot: boolean value indicating if the new instance should be a Spot VM or not.
            instance_termination_action: What action should be taken once a Spot VM is terminated.
                Possible values: "STOP", "DELETE"
            custom_hostname: Custom hostname of the new VM instance.
                Custom hostnames must conform to RFC 1035 requirements for valid hostnames.
            delete_protection: boolean value indicating if the new virtual machine should be
                protected against deletion or not.
        Returns:
            Instance object.
        """
        instance_client = compute_v1.InstancesClient()
    
        # Use the network interface provided in the network_link argument.
        network_interface = compute_v1.NetworkInterface()
        network_interface.network = network_link
        if subnetwork_link:
            network_interface.subnetwork = subnetwork_link
    
        if internal_ip:
            network_interface.network_i_p = internal_ip
    
        if external_access:
            access = compute_v1.AccessConfig()
            access.type_ = compute_v1.AccessConfig.Type.ONE_TO_ONE_NAT.name
            access.name = "External NAT"
            access.network_tier = access.NetworkTier.PREMIUM.name
            if external_ipv4:
                access.nat_i_p = external_ipv4
            network_interface.access_configs = [access]
    
        # Collect information into the Instance object.
        instance = compute_v1.Instance()
        instance.network_interfaces = [network_interface]
        instance.name = instance_name
        instance.disks = disks
        if re.match(r"^zones/[a-z\d\-]+/machineTypes/[a-z\d\-]+$", machine_type):
            instance.machine_type = machine_type
        else:
            instance.machine_type = f"zones/{zone}/machineTypes/{machine_type}"
    
        instance.scheduling = compute_v1.Scheduling()
        if accelerators:
            instance.guest_accelerators = accelerators
            instance.scheduling.on_host_maintenance = (
                compute_v1.Scheduling.OnHostMaintenance.TERMINATE.name
            )
    
        if preemptible:
            # Set the preemptible setting
            warnings.warn(
                "Preemptible VMs are being replaced by Spot VMs.", DeprecationWarning
            )
            instance.scheduling = compute_v1.Scheduling()
            instance.scheduling.preemptible = True
    
        if spot:
            # Set the Spot VM setting
            instance.scheduling.provisioning_model = (
                compute_v1.Scheduling.ProvisioningModel.SPOT.name
            )
            instance.scheduling.instance_termination_action = instance_termination_action
    
        if custom_hostname is not None:
            # Set the custom hostname for the instance
            instance.hostname = custom_hostname
    
        if delete_protection:
            # Set the delete protection bit
            instance.deletion_protection = True
    
        # Prepare the request to insert an instance.
        request = compute_v1.InsertInstanceRequest()
        request.zone = zone
        request.project = project_id
        request.instance_resource = instance
    
        # Wait for the create operation to complete.
        print(f"Creating the {instance_name} instance in {zone}...")
    
        operation = instance_client.insert(request=request)
    
        wait_for_extended_operation(operation, "instance creation")
    
        print(f"Instance {instance_name} created.")
        return instance_client.get(project=project_id, zone=zone, instance=instance_name)
    
    
    def create_with_additional_disk(
        project_id: str, zone: str, instance_name: str
    ) -> compute_v1.Instance:
        """
        Create a new VM instance with Debian 10 operating system on a 20 GB disk
        and a 25 GB additional empty disk.
    
        Args:
            project_id: project ID or project number of the Cloud project you want to use.
            zone: name of the zone to create the instance in. For example: "us-west3-b"
            instance_name: name of the new virtual machine (VM) instance.
    
        Returns:
            Instance object.
        """
        newest_debian = get_image_from_family(project="debian-cloud", family="debian-12")
        disk_type = f"zones/{zone}/diskTypes/pd-standard"
        disks = [
            disk_from_image(disk_type, 20, True, newest_debian.self_link),
            empty_disk(disk_type, 25),
        ]
        instance = create_instance(project_id, zone, instance_name, disks)
        return instance
    
    

    REST

    Pode criar até 127 discos não de arranque no momento em que cria uma instância através da propriedade initializeParams para cada disco adicional. Crie discos adicionais com uma imagem pública ou privada. Para adicionar um disco em branco, defina a entrada initializeParams sem valor sourceImage.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
    
    {
       "machineType":"zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
       "name":"VM_NAME",
       
       "disks":[
          {
             "initializeParams":{
                "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE"
             },
             "boot":true
          },
          {
             "initializeParams":{
                "diskSizeGb":"SIZE_GB",
                "sourceImage":"projects/DISK_IMAGE_PROJECT/global/images/DISK_IMAGE",
                "diskType":"DISK_TYPE"
             }
          },
          {
             "initializeParams":{
                "diskSizeGb":"SIZE_GB",
                "diskType":"DISK_TYPE"
             },
          },
          {
             "boot": false,
             "deviceName":"DISK_NAME",
             "initializeParams": {
                "diskType": "DISK_TYPE",
                "replicaZones": [
                   "projects/PROJECT_ID/zones/ZONE",
                   "projects/PROJECT_ID/zones/REMOTE_ZONE"
                ]
             }
          }
       ],
       
       
       "networkInterfaces":[
          {
             "network":"global/networks/NETWORK_NAME"
          }
       ],
       
      
       "shieldedInstanceConfig":{
          "enableSecureBoot":"ENABLE_SECURE_BOOT"
       }
    }
    

    Substitua o seguinte:

    • PROJECT_ID: ID do projeto no qual criar a VM
    • ZONE: zona na qual criar a VM
    • MACHINE_TYPE_ZONE: zona que contém o tipo de máquina a usar para a nova VM
    • MACHINE_TYPE: tipo de máquina, predefinido ou personalizado, para a nova VM
    • VM_NAME: name da nova VM
    • IMAGE_PROJECT: project que contém a imagem
      Por exemplo, se especificar debian-10 como a família de imagens, especifique debian-cloud como o projeto de imagens.
    • IMAGE: especifique uma das seguintes opções:
      • IMAGE: uma versão específica de uma imagem pública

        Por exemplo, "sourceImage": "projects/debian-cloud/global/images/debian-10-buster-v20200309"

      • IMAGE_FAMILY: uma família de imagens

        Isto cria a VM a partir da imagem do SO não descontinuada mais recente. Por exemplo, se especificar "sourceImage": "projects/debian-cloud/global/images/family/debian-10", o Compute Engine cria uma VM a partir da versão mais recente da imagem do SO na família de imagens Debian 10.

    • Para discos adicionais, substitua o seguinte:

      • SIZE_GB: tamanho do disco
      • DISK_IMAGE ou
      • DISK_IMAGE_FAMILY: Especifique uma imagem de origem ou uma família de imagens para o disco que não é de arranque:
        • DISK_IMAGE: nome da imagem que quer usar como um disco não arrancável. Por exemplo, "sourceImage": "projects/DISK_IMAGE_PROJECT/global/images/DISK_IMAGE".
        • DISK_IMAGE_FAMILY: uma família de imagens a usar como disco não de arranque. Por exemplo, "sourceImage": "projects/DISK_IMAGE_PROJECT/global/images/family/DISK_IMAGE_FAMILY".
      • DISK_TYPE: URL completo ou parcial para o tipo do tipo de disco. Por exemplo, https://www.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced.
      • DISK_NAME: opcional. O nome do disco apresentado ao SO convidado após a criação da VM.
      • REMOTE_ZONE: a zona para replicar o disco regional

      Para discos em branco, não especifique a propriedade sourceImage.

      Para discos zonais, não especifique a propriedade replicaZones.

    • NETWORK_NAME: a rede VPC que quer usar para a VM. Pode especificar default para usar a sua rede predefinida.
    • ENABLE_SECURE_BOOT: Opcional: se escolheu uma imagem que suporta as funcionalidades da VM protegida, o Compute Engine ativa, por predefinição, o módulo de plataforma fidedigna virtual (vTPM) e a monitorização da integridade. O Compute Engine não ativa o Arranque seguro por predefinição.

      Se especificar true para enableSecureBoot, o Compute Engine cria uma VM com todas as três funcionalidades da VM protegida ativadas. Depois de o Compute Engine iniciar a VM, para modificar as opções da VM protegida, tem de parar a VM.

Formate e monte os discos antes de os usar.