Esta página foi traduzida pela API Cloud Translation.

Adicionar discos de um pool de armazenamento às VMs

É possível criar discos em um pool de armazenamento de hiperdisco e, em seguida, anexar o disco a uma instância de máquina virtual (VM) ou criar discos no pool de armazenamento ao criar uma VM.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Papéis e permissões necessárias

Para receber as permissões necessárias para criar um disco de capacidade equilibrado de hiperdisco ou de capacidade de processamento em um pool de armazenamento, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Administrador da instância da computação (v1) (roles/compute.instanceAdmin.v1)
Para se conectar a uma instância de VM que possa ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (papel roles/iam.serviceAccountUser )

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos têm as permissões necessárias para criar um disco de capacidade equilibrado ou de capacidade de processamento de hiperdisco em um pool de armazenamento. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para criar um disco equilibrado de hiperdisco ou capacidade de processamento de hiperdisco em um pool de armazenamento:

Para criar discos em um pool de armazenamento e anexá-los a uma instância de VM, faça o seguinte:
- compute.disks.create no projeto
- compute.instances.attachDisk na VM
- compute.disks.use no volume que você quer anexar à VM
- compute.storagePools.use no pool de armazenamento em que você está criando discos
Para formatar e ativar o volume anexado: compute.instances.setMetadata na VM

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conhecer as permissões necessárias para criar uma instância, consulte Permissões necessárias.

Limitações

Analise as seguintes limitações para criar discos em um pool de armazenamento de hiperdisco:

Só é possível criar discos balanceados de hiperdisco em um pool de armazenamento equilibrado por hiperdisco e apenas discos de capacidade de processamento de hiperdisco em um pool de armazenamento de capacidade de processamento de hiperdisco.
Somente novos discos no mesmo projeto e zona podem ser criados em um pool de armazenamento.
Para criar discos de inicialização em um pool de armazenamento, use um pool de armazenamento balanceado por hiperdisco.
Não é permitido mover discos para dentro ou fora de um pool de armazenamento. Para mover um disco para dentro ou fora de um pool de armazenamento, é necessário recriar o disco com base em um snapshot. Para mais informações, consulte Alterar o tipo de disco.
É possível criar até 1.000 discos em um pool de armazenamento.
Os pools de armazenamento não oferecem suporte a discos regionais.

Opções de provisionamento

Dependendo do tipo de provisionamento do pool de armazenamento de hiperdisco, é possível escolher como provisionar a capacidade e o desempenho de cada disco criado no pool de armazenamento.

Provisionar a capacidade do disco

Se você criar um pool de armazenamento de capacidade avançado, poderá usar o provisionamento fino. É possível criar discos no pool de armazenamento com um tamanho cumulativo que exceda a capacidade provisionada do pool. A capacidade usada do pool de armazenamento é definida pelo total de dados em uso, e não pela quantidade de espaço em disco provisionado. É possível provisionar discos com uma capacidade agregada de até 500% da capacidade provisionada de um pool de armazenamento de capacidade avançada.

Se você estiver criando discos em um pool de armazenamento de capacidade padrão, crie discos no pool de armazenamento até que o tamanho total de todos os discos no pool de armazenamento alcance a capacidade provisionada. Os discos em um pool de armazenamento com capacidade padrão se comportam de maneira semelhante aos discos que não são do pool, em que a capacidade é consumida quando você cria os discos.

Desempenho do provisionamento

Se você criar um pool de armazenamento de desempenho avançado, poderá usar o provisionamento fino. É possível criar discos no pool de armazenamento com uma quantidade cumulativa de IOPS e throughput que exceda o desempenho provisionado do pool. O desempenho usado do pool de armazenamento é definido pelo desempenho total usado pelos discos, e não pela quantidade de desempenho provisionada para cada disco. É possível provisionar discos com uma performance agregada de até 500% da performance provisionada de um pool de armazenamento de desempenho avançado.

Se você estiver criando discos em um pool de armazenamento de desempenho padrão, as IOPS ou a capacidade de processamento provisionadas para um disco precisam ser menores que as IOPS ou a capacidade de processamento disponíveis no pool de armazenamento de hiperdisco. As IOPS ou a capacidade de processamento disponíveis são a quantidade provisionada para o pool de armazenamento menos a quantidade usada de todos os discos criados no pool de armazenamento.

Se alguma das condições no parágrafo anterior não for verdadeira, a solicitação para criar um disco no pool de armazenamento falhará, e o disco não será criado.

Exemplo

Suponha que você tenha um pool de armazenamento Hyperdisk Balanced com 100.000 IOPS provisionadas.

Com o provisionamento de desempenho padrão:

É possível provisionar até 100.000 IOPS agregados ao criar discos de Hyperdisk Balanced no pool de armazenamento.
Você vai receber uma cobrança pelas 100.000 IOPS de desempenho provisionadas do pool de armazenamento Hyperdisk Balanced.
Assim como os discos criados fora de um pool de armazenamento, os discos Hyperdisk Balanced em pools de armazenamento de desempenho padrão são provisionados automaticamente com até 3.000 IOPS de referência e 140 MiB/s de capacidade de processamento de valor de referência. O desempenho deste valor de referência não é contabilizado no desempenho provisionado para o pool de armazenamento. Somente quando você adiciona discos ao pool de armazenamento com desempenho provisionado acima do valor de referência é que ele é contabilizado para o desempenho provisionado do pool de armazenamento. Por exemplo:
- Um disco provisionado com 3.000 IOPS usa 0 IOPS do pool, e o pool ainda tem 100.000 IOPS provisionadas disponíveis para outros discos.
- Um disco provisionado com 13.000 IOPS usa 10.000 IOPS de pool, e o pool tem 90.000 IOPS provisionadas restantes que podem ser alocadas para outros discos no pool de armazenamento.

Com o provisionamento de desempenho avançado:

É possível provisionar até 500.000 IOPS de desempenho agregado do Hyperdisk ao criar discos no pool de armazenamento.
Você será cobrado por 100.000 IOPS provisionadas pelo pool de armazenamento.
Se você criar um único disco (Disk1) no pool de armazenamento que tenha 5.000 IOPS, você não consome nenhuma IOPS das IOPS provisionadas do pool de armazenamento. No entanto, a quantidade de IOPS que você pode provisionar para novos discos criados no pool de armazenamento agora é de 495.000.
Se Disk1 começar a ler e gravar dados e usar o máximo de 5.000 IOPS em um determinado minuto, 5.000 IOPS serão consumidas pelas IOPS provisionadas pelo pool de armazenamento. Todos os outros discos criados no mesmo pool de armazenamento podem usar um máximo agregado de 95.000 IOPS no mesmo minuto sem entrar em conflito.

Criar discos no pool de armazenamento

É possível usar o console do Google Cloud, a CLI do Google Cloud ou o REST para criar um disco em um pool de armazenamento.

Console

Com o console do Google Cloud, é possível criar um novo disco em um pool de armazenamento por meio da página Pools de armazenamento ou Discos.

Na página Pools de armazenamento:

No console do Google Cloud, acesse a página Pools de armazenamento.

Acessar a página "Pools de armazenamento"
Clique no nome do pool de armazenamento em que você quer criar um disco.
Na página Gerenciar pool de armazenamento, clique em + Criar novo disco.
No painel Adicionar novo disco, digite um Nome para o disco.
Especifique ou altere os valores em que você não quer usar o valor padrão.
Quando terminar de especificar as propriedades do disco, clique em Salvar.
Na página Gerenciar pool de armazenamento, o novo disco vai aparecer na seção Discos do pool de armazenamento.

Na página Criar disco, siga estas etapas:

No console do Google Cloud, acesse a página Discos > Criar um disco.

Acesse a página Criar um disco
Digite um Nome para o disco.
Selecione a zona que contém o pool de armazenamento em que você quer criar o disco.
Em Tipo de disco, escolha o tipo que corresponde ao pool de armazenamento de hiperdisco: capacidade de processamento ou balanceamento de hiperdisco.
Modifique os valores nos campos Tamanho, IOPS provisionadas e Capacidade de processamento provisionada conforme necessário.
Na seção Pool de armazenamento, selecione Ativar pool de armazenamento e escolha o nome do pool de armazenamento em que o disco será criado. Somente o pool de armazenamento que existe na zona selecionada aparece na lista.
Quando terminar de especificar as informações do disco, clique em Criar.

gcloud

Para criar um ou mais discos em um pool de armazenamento, use o comando gcloud compute disks create.

gcloud compute disks create DISK_NAME \
    --zone=ZONE \
    --storage-pool=STORAGE_POOL_NAME \
    --size=SIZE \
    --type=DISK_TYPE \
    --provisioned-iops=PROVISIONED_IOPS \
    --provisioned-throughput=PROVISIONED_THROUGHPUT

Substitua:

DISK_NAME: um nome exclusivo para o disco. É possível fornecer uma lista de nomes de discos especificados por espaços para criar vários discos com os mesmos atributos.
ZONE: a zona em que o pool de armazenamento foi criado. Especifique esse valor no formato de região-zona, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do pool de armazenamento em que o disco será criado.
SIZE: (opcional) a capacidade provisionada do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. Se nenhum tamanho for especificado, 100 GB será usado como o valor padrão.
DISK_TYPE: o tipo de disco a ser criado. Precisa corresponder ao tipo do pool de armazenamento de hiperdisco, hyperdisk-balanced ou hyperdisk-throughput.
PROVISIONED_IOPS: opcional: as IOPS a serem provisionadas para o disco. Só é possível usar essa sinalização com discos balanceados de hiperdisco.
PROVISIONED_THROUGHPUT (opcional): a capacidade de processamento em mebibyte (MB) por segundo a ser provisionada para o disco.

REST

Para criar um ou mais discos em um pool de armazenamento, crie um POST usando o método disks.insert. Inclua as propriedades name, sizeGb, type, storagePool, provisionedIops e provisionedThroughput. Para criar esse disco como um que não será inicializado e não estará formatado, recomendamos não especificar uma imagem ou snapshot de origem.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks

{
    "name": "DISK_NAME",
    "description": "DESCRIPTION",
    "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE",
    "sizeGb": "DISK_SIZE",
    "storagePool": "STORAGE_POOL_NAME",
    "provisionedIops": "IOPS_LIMIT",
    "provisionedThroughput": "THROUGHPUT_LIMIT",
}

Substitua:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a. Essa é a zona em que o disco será criado.
DISK_NAME: um nome exclusivo para o disco.
DESCRIPTION (opcional): uma string de texto que descreve o disco.
DISK_TYPE: o tipo de disco, que precisa corresponder ao tipo de pool de armazenamento. Use hyperdisk-throughput ou hyperdisk-balanced.
DISK_SIZE: opcional: o tamanho do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibytes ou TB para tebibytes. Se nenhum tamanho for especificado, 100 GB será usado como o valor padrão.
STORAGE_POOL_NAME: o nome do pool de armazenamento em que o disco será criado.
IOPS_LIMIT: opcional: as IOPS a serem provisionadas para o disco. Só é possível usar essa sinalização com discos balanceados de hiperdisco.
THROUGHPUT_LIMIT: opcional: a capacidade de processamento em mebibytes (MB) por segundo para provisionar o disco.

Go


// createDiskInStoragePool creates a new Hyperdisk in the specified storage pool.
func createDiskInStoragePool(w io.Writer, projectId, zone, diskName, storagePoolName, diskType string) error {
	// Example usage:
	//   projectID := "your_project_id"
	//   zone := "europe-central2-b"
	//   diskName := "your_disk_name"
	//   storagePoolName := "https://www.googleapis.com/compute/v1/projects/your_project_id/zones/europe-central2-b/storagePools/your_storage_pool"
	//   diskType := "zones/europe-central2-b/diskTypes/hyperdisk-balanced"

	ctx := context.Background()
	client, err := compute.NewDisksRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewDisksRESTClient: %v", err)
	}
	defer client.Close()

	// Create the disk resource
	disk := &computepb.Disk{
		Name:                  proto.String(diskName),
		Type:                  proto.String(diskType),
		SizeGb:                proto.Int64(50),
		Zone:                  proto.String(zone),
		StoragePool:           proto.String(storagePoolName),
		ProvisionedIops:       proto.Int64(10000),
		ProvisionedThroughput: proto.Int64(1024),
	}

	// Create the insert disk request
	req := &computepb.InsertDiskRequest{
		Project:      projectId,
		Zone:         zone,
		DiskResource: disk,
	}

	// Send the insert disk request
	op, err := client.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("Insert disk request failed: %v", err)
	}

	// Wait for the insert disk operation to complete
	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Disk created in storage pool: %v\n", disk.Name)
	return nil
}

Java


import com.google.cloud.compute.v1.Disk;
import com.google.cloud.compute.v1.DisksClient;
import com.google.cloud.compute.v1.InsertDiskRequest;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateDiskInStoragePool {
  public static void main(String[] args)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Google Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone in which you want to create the disk.
    String zone = "europe-central2-b";
    // Name of the disk you want to create.
    String diskName = "YOUR_DISK_NAME";
    // Link to the storagePool you want to use. Use format :
    // https://www.googleapis.com/compute/v1/projects/%s/zones/%s/storagePools/%s"
    String storagePoolName = "YOUR_STORAGE_POOL_LINK";
    // The type of disk you want to create. This value uses the following format:
    // "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-throughput)".
    // For example: "zones/us-west3-b/diskTypes/hyperdisk-balanced"
    String diskType = String.format("zones/%s/diskTypes/hyperdisk-balanced", zone);
    // Size of the new disk in gigabytes.
    long diskSizeGb = 10;
    // Optional: the IOPS to provision for the disk.
    // You can use this flag only with Hyperdisk Balanced disks.
    long provisionedIops = 3000;
    // Optional: the throughput in mebibyte (MB) per second to provision for the disk.
    long provisionedThroughput = 140;

    createDiskInStoragePool(projectId, zone, diskName, storagePoolName, diskType,
            diskSizeGb, provisionedIops, provisionedThroughput);
  }

  // Creates a hyperdisk in the storage pool
  public static Disk createDiskInStoragePool(String projectId, String zone, String diskName,
                                             String storagePoolName, String diskType,
                                             long diskSizeGb, long iops, long throughput)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (DisksClient client = DisksClient.create()) {
      // Create a disk.
      Disk disk = Disk.newBuilder()
              .setZone(zone)
              .setName(diskName)
              .setType(diskType)
              .setSizeGb(diskSizeGb)
              .setStoragePool(storagePoolName)
              .setProvisionedIops(iops)
              .setProvisionedThroughput(throughput)
              .build();

      InsertDiskRequest request = InsertDiskRequest.newBuilder()
              .setProject(projectId)
              .setZone(zone)
              .setDiskResource(disk)
              .build();

      // Wait for the insert disk operation to complete.
      Operation operation = client.insertAsync(request).get(1, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("Disk creation failed!");
        throw new Error(operation.getError().toString());
      }

      // Wait for server update
      TimeUnit.SECONDS.sleep(10);

      Disk hyperdisk = client.get(projectId, zone, diskName);

      System.out.printf("Hyperdisk '%s' has been created successfully", hyperdisk.getName());

      return hyperdisk;
    }
  }
}

Node.js

// Import the Compute library
const computeLib = require('@google-cloud/compute');
const compute = computeLib.protos.google.cloud.compute.v1;

// Instantiate a diskClient
const disksClient = new computeLib.DisksClient();
// Instantiate a zoneOperationsClient
const zoneOperationsClient = new computeLib.ZoneOperationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// Project ID or project number of the Google Cloud project you want to use.
const projectId = await disksClient.getProjectId();

// The zone where your VM and new disk are located.
// zone = 'us-central1-a';

// The name of the new disk
// diskName = 'disk-from-pool-name';

// The name of the storage pool
// storagePoolName = 'storage-pool-name';

// Link to the storagePool you want to use. Use format:
// https://www.googleapis.com/compute/v1/projects/{projectId}/zones/{zone}/storagePools/{storagePoolName}
const storagePool = `https://www.googleapis.com/compute/v1/projects/${projectId}/zones/${zone}/storagePools/${storagePoolName}`;
// The type of disk. This value uses the following format:
// "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-extreme|hyperdisk-ml|hyperdisk-throughput)".
// For example: "zones/us-west3-b/diskTypes/hyperdisk-balanced"
const diskType = `zones/${zone}/diskTypes/hyperdisk-balanced`;
// Size of the new disk in gigabytes.
const diskSizeGb = 10;
// Optional: For Hyperdisk Balanced or Hyperdisk Extreme disks,
// this is the number of I/O operations per second (IOPS) that the disk can handle.
const provisionedIops = 3000;
// Optional: For Hyperdisk Balanced or Hyperdisk Throughput volumes,
// this is an integer that represents the throughput,
// measured in MiB per second, that the disk can handle.
const provisionedThroughput = 140;

async function callCreateComputeHyperdiskFromPool() {
  // Create a disk
  const disk = new compute.Disk({
    sizeGb: diskSizeGb,
    name: diskName,
    type: diskType,
    zone,
    storagePool,
    provisionedIops,
    provisionedThroughput,
  });

  const [response] = await disksClient.insert({
    project: projectId,
    zone,
    diskResource: disk,
  });

  let operation = response.latestResponse;

  // Wait for the create disk operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await zoneOperationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log(`Disk: ${diskName} created.`);
}

await callCreateComputeHyperdiskFromPool();

Depois de criar o disco, anexe-o a uma VM.

Criar uma VM que use discos no pool de armazenamento

Ao criar uma VM, você configura um disco de inicialização e, opcionalmente, pode criar discos de dados adicionais (que não sejam de inicialização), que são automaticamente anexados à VM. Nas seções a seguir, explicamos como criar cada tipo de disco em um pool de armazenamento como parte do processo de criação da VM.

Criar o disco de inicialização de uma VM em um pool de armazenamento

Para criar uma VM que use um disco de inicialização em um pool de armazenamento, primeiro crie um pool de armazenamento balanceado por hiperdisco. Em seguida, crie uma VM usando um tipo de máquina compatível com discos Hyperdisk Balanced. O tipo de máquina, o tipo de disco e o pool de armazenamento precisam estar disponíveis na zona escolhida.

Console

No console do Google Cloud, acesse a página Instâncias de VMs.

Acessar instâncias de VM
Clique em Criar instância.
Digite um nome para a instância.
Defina a zona como a mesma em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que aceite o balanceamento de hiperdisco, por exemplo, H3.
Na seção Disco de inicialização, clique em Alterar.
No painel Disco de inicialização, defina o Tipo de disco de inicialização como "Hiperdisco balanceado".
Configure as propriedades do disco.
Expanda Mostrar configuração avançada.
Sob a direção Pool de armazenamento, selecione Ativar pool de armazenamento.
Escolha na lista o pool de armazenamento em que o disco será criado.
Quando terminar a configuração do disco, clique em Selecionar.
Conclua a configuração das propriedades da VM.
Clique em Criar.

O console cria a VM na zona especificada e o disco de inicialização no pool de armazenamento selecionado.

gcloud

É possível criar o disco de inicialização para uma nova VM no pool de armazenamento usando o comando gcloud compute instances create e incluindo a propriedade storage-pool para o disco de inicialização.

gcloud compute instances create VM_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE,provisioned-throughput=THROUGHPUT, \
    provisioned-iops=IOPS,image=projects/IMAGE_PROJECT/global/images/IMAGE, \
    storage-pool=STORAGE_POOL_NAME

Substitua:

VM_NAME: o nome da VM.
ZONE: a região e a zona em que a VM será criada, usando o formato us-central1-a.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
DISK_SIZE: o tamanho do disco de inicialização em GiB
THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
IOPS: as IOPS a serem provisionadas para o disco
IMAGE_PROJECT: selecione o projeto que contém a imagem
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por exemplo: debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser formatada como family/IMAGE_FAMILY. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
STORAGE_POOL_NAME: o nome do pool de armazenamento em que o novo disco será criado.

REST

É possível criar o disco de inicialização para uma nova VM no pool de armazenamento criando uma solicitação POST para o método instances.insert e incluindo a storagePool do disco de inicialização.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
         "deviceName": "BOOT_DISK_DEVICE_NAME",
         "initializeParams": {
            "diskSizeGb": "DISK_SIZE",
            "diskType": "DISK_TYPE",
            "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            "boot": true,
            "provisionedIops": "IOPS_LIMIT",
            "provisionedThroughput": "THROUGHPUT_LIMIT",
            "storagePool": "POOL_URL"
         }
      }
   ]
}

Substitua:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a. Essa é a zona em que a VM e o disco de inicialização serão criados.
VM_NAME: o nome da VM.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
DISK_SIZE: o tamanho do disco de inicialização em GiB
DISK_TYPE: o tipo de disco, especificado como um URI
IMAGE_PROJECT: selecione o projeto que contém a imagem
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por exemplo: debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser formatada como family/IMAGE_FAMILY. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
IOPS_LIMIT: as IOPS a serem provisionadas para o disco
THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
POOL_URL: o pool de armazenamento em que o novo disco é criado. Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por exemplo, os valores a seguir são válidos:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME

Criar mais discos em um pool de armazenamento durante a criação da VM

Ao criar discos em um pool de armazenamento durante a criação da VM, o tipo de máquina, o tipo de disco e o pool de armazenamento precisam estar disponíveis na zona escolhida.

Console

Siga as etapas a seguir para usar o console na criação de uma nova VM com discos extras que não sejam de inicialização:

No console do Google Cloud, acesse a página Instâncias de VMs.

Acessar instâncias de VM
Clique em Criar instância.
Insira um nome para a VM.
Defina a zona como a mesma em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que aceite o tipo de disco usado pelo pool de armazenamento.
Expanda a seção Opções avançadas.
Expanda Discos.
Clique em Adicionar novo disco.
No painel Adicionar novo disco, insira as informações do disco. Defina o Tipo de disco para corresponder ao tipo de pool de armazenamento.
Na seção Pool de armazenamento, selecione Ativar pool de armazenamento.
No campo Selecionar um pool de armazenamento, escolha o pool em que o disco será criado.
Quando terminar a configuração do disco, clique em Salvar.
Conclua a configuração das propriedades da VM.
Clique em Criar.

O console cria a VM na zona especificada e o disco que não é de inicialização no pool de armazenamento selecionado.

gcloud

Crie novos discos em um pool de armazenamento durante a criação da VM usando o comando gcloud compute instances create e incluindo a propriedade storage-pool para o disco.

gcloud compute instances create VM_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=auto-delete=yes,boot=yes,device-name=BOOT_DISK_DEVICE_NAME,image=IMAGE_NAME, \
    size=BOOT_DISK_SIZE,type=BOOT_DISK_TYPE
    --create-disk=auto-delete=yes,boot=no,device-name=DATA_DISK_DEVICE_NAME,size=DATA_DISK_SIZE, \
    type=DATA_DISK_TYPE,provisioned-iops=IOPS,provisioned-throughput=THROUGHPUT, \
    storage_pool=STORAGE_POOL_NAME

Substitua:

VM_NAME: o nome da VM.
ZONE: a região e a zona em que a VM será criada, usando o formato us-central1-a.
MACHINE_TYPE: o tipo de máquina da VM
BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
IMAGE_NAME: o nome da imagem do sistema operacional a ser instalada no disco de inicialização, por exemplo, debian-12-bookworm-v20240213
BOOT_DISK_SIZE: o tamanho do disco de inicialização em GiB
BOOT_DISK_TYPE: o tipo de disco
DATA_DISK_DEVICE_NAME: o nome do dispositivo de disco para o disco de dados
DATA_DISK_SIZE: o tamanho do disco de dados, em GiB
DATA_DISK_TYPE: o tipo de disco de dados, hyperdisk-balanced ou hyperdisk-throughput
IOPS: as IOPS a serem provisionadas para o disco
THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
STORAGE_POOL_NAME: o nome exclusivo do pool de armazenamento em que você quer criar o disco.

REST

É possível criar novos discos em um pool de armazenamento durante a criação da VM criando uma solicitação POST para o método instances.insert e incluindo a propriedade storagePool para os discos adicionais.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
        "initializeParams":{
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot":true
      },
      {
        "deviceName": "DEVICE_NAME",
        "boot":false,
        "initializeParams": {
           "diskSizeGb": "DISK_SIZE",
           "diskType": "DISK_TYPE",
           "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
           "provisionedIops": "IOPS_LIMIT",
           "provisionedThroughput": "THROUGHPUT_LIMIT",
           "storagePool": "POOL_URL"
        }
      }
   ]
}

Substitua:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a. Essa é a zona em que a VM e o disco de inicialização serão criados.
VM_NAME: o nome da VM.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
IMAGE_PROJECT: selecione o projeto que contém a imagem
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por exemplo: debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser formatada como family/IMAGE_FAMILY. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
DEVICE_NAME: o nome do dispositivo para o disco de dados
DISK_SIZE: o tamanho do disco de dados em GiB
DISK_TYPE: o tipo de disco, especificado como um URI
IOPS_LIMIT: as IOPS a serem provisionadas para o disco
THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
POOL_URL: o pool de armazenamento em que o novo disco é criado. Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por exemplo, os valores a seguir são válidos:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME

Usar o pool de armazenamento em um modelo de instância

Os modelos de instância usados para criar grupos gerenciados de instâncias (MIGs, na sigla em inglês) podem conter as informações do pool de armazenamento. Os discos criados com o uso do modelo de instância são colocados no pool de armazenamento especificado.

Console

No Console do Google Cloud, acesse a página Modelos de instância.

Acesse "Modelos de instância"
Selecione Criar modelo de instância.
Digite um nome para o modelo de instância.
Escolha Regional como o local e, no campo Região, escolha a região em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que ofereça suporte ao Hiperdisco Balanceado, por exemplo, C3.
Na seção Disco de inicialização, clique em Alterar.
No painel Disco de inicialização, defina o Tipo de disco de inicialização como "Hiperdisco balanceado".
Configure as propriedades do disco.
Expanda Mostrar configuração avançada.
Sob a direção Pool de armazenamento, selecione Ativar pool de armazenamento.
Escolha na lista o pool de armazenamento em que o disco será criado.
Quando terminar a configuração do disco, clique em Selecionar.
Conclua a configuração das propriedades da VM.
Clique em Criar.

O modelo cria a VM na zona especificada e o disco de inicialização no pool de armazenamento selecionado.

gcloud

Especifique em um modelo de instância que o disco de inicialização seja criado em um pool de armazenamento usando o comando gcloud compute instance-templates create e incluindo a propriedade storage-pool do disco de inicialização.

gcloud compute instance-templates create TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE,provisioned-throughput=THROUGHPUT, \
    provisioned-iops=IOPS,image=projects/IMAGE_PROJECT/global/images/IMAGE, \
    storage-pool=STORAGE_POOL_NAME

Substitua:

TEMPLATE_NAME: o nome do modelo de instância.
REGION: a região em que você quer criar o modelo de instância regional. A região precisa conter a zona em que o pool de armazenamento está localizado.
MACHINE_TYPE: o tipo de máquina a ser usado ao criar a VM, por exemplo, h3-standard-88.
DISK_SIZE: o tamanho do disco em GiB
THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
IOPS: as IOPS a serem provisionadas para o disco
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por exemplo: debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser formatada como family/IMAGE_FAMILY. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
STORAGE_POOL_NAME: o nome do pool de armazenamento em que o novo disco será criado.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
         "deviceName": "BOOT_DISK_DEVICE_NAME",
         "initializeParams": {
            "diskSizeGb": "DISK_SIZE",
            "diskType": "DISK_TYPE",
            "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            "boot": true,
            "provisionedIops": "IOPS_LIMIT",
            "provisionedThroughput": "THROUGHPUT_LIMIT",
            "storagePool": "POOL_URL"
         }
      }
   ]
}

Substitua:

PROJECT_ID: o ID do projeto;
VM_NAME: o nome da VM.
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a. Essa é a zona em que a VM e o disco de inicialização serão criados.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
DISK_SIZE: o tamanho do disco de inicialização em GiB
DISK_TYPE: o tipo de disco, especificado como um URI
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por exemplo: debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser formatada como family/IMAGE_FAMILY. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, o Compute Engine vai criar uma instância usando a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
IOPS_LIMIT: as IOPS a serem provisionadas para o disco
THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
POOL_URL: o pool de armazenamento em que o novo disco é criado. Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por exemplo, os valores a seguir são válidos:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME