Esta página foi traduzida pela API Cloud Translation.

Adicione discos de um conjunto de armazenamento a VMs

Pode criar discos num conjunto de armazenamento Hyperdisk e, em seguida, anexar o disco a uma instância de máquina virtual (VM) ou pode criar discos no conjunto de armazenamento quando cria uma VM.

Antes de começar

Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
  gcloud init
  Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
  
  Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.
2. Set a default region and zone.
Go

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.
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.
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.
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.
Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções e autorizações necessárias

Para receber as autorizações de que precisa para criar um disco Hyperdisk Balanced ou Hyperdisk Throughput num conjunto de armazenamento, peça ao seu administrador para lhe conceder as seguintes funções do IAM no projeto:

Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)
Para se ligar a uma instância de VM que pode ser executada como uma conta de serviço: Utilizador da conta de serviço (v1) (função roles/iam.serviceAccountUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para criar um disco Hyperdisk Balanced ou Hyperdisk Throughput num conjunto de armazenamento. 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 um disco Hyperdisk Balanced ou Hyperdisk Throughput num conjunto de armazenamento:

Para criar discos num conjunto de armazenamento e anexar os discos a uma instância de VM:
- compute.disks.create no projeto
- compute.instances.attachDisk na VM
- compute.disks.use no volume que quer anexar à VM
- compute.storagePools.use no conjunto de armazenamento no qual está a criar discos
Para formatar e montar o volume anexado: compute.instances.setMetadata na VM

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

Para ver as autorizações necessárias para criar uma instância, consulte o artigo Autorizações necessárias.

Limitações

Reveja as seguintes limitações para criar discos num Hyperdisk Storage Pool:

Só pode criar discos Hyperdisk Balanced num conjunto de armazenamento Hyperdisk Balanced e só pode criar discos Hyperdisk Throughput num conjunto de armazenamento Hyperdisk Throughput.
Só é possível criar novos discos no mesmo projeto e zona num conjunto de armazenamento.
Para criar discos de arranque num conjunto de armazenamento, tem de usar um conjunto de armazenamento equilibrado de hiperdisco.
Não é permitido mover discos para dentro ou para fora de um conjunto de armazenamento. Para mover um disco para dentro ou para fora de um pool de armazenamento, tem de recriar o disco a partir de um instantâneo. Para mais informações, consulte o artigo Altere o tipo de disco.
Pode criar até 1000 discos num conjunto de armazenamento.
Os conjuntos de armazenamento não são compatíveis com discos regionais.

Opções de aprovisionamento

Consoante o tipo de aprovisionamento do conjunto de armazenamento Hyperdisk, pode escolher como aprovisionar a capacidade e o desempenho de cada disco que criar no conjunto de armazenamento.

Aprovisionamento da capacidade do disco

Se criar um conjunto de armazenamento de capacidade avançada, pode usar o aprovisionamento reduzido. Pode criar discos no conjunto de armazenamento com um tamanho cumulativo que excede a capacidade aprovisionada do conjunto. A capacidade usada do conjunto de armazenamento é definida pelos dados totais em utilização e não pela quantidade de espaço em disco que aprovisionou. Pode aprovisionar discos com uma capacidade agregada de até 500% da capacidade aprovisionada de um conjunto de armazenamento de capacidade avançada.

Se estiver a criar discos num conjunto de armazenamento de capacidade padrão, cria discos no conjunto de armazenamento até que o tamanho total de todos os discos no conjunto de armazenamento atinja a capacidade aprovisionada do conjunto de armazenamento. Os discos num conjunto de armazenamento com capacidade padrão comportam-se de forma semelhante aos discos não pertencentes a conjuntos, em que a capacidade é consumida quando cria os discos.

Desempenho do aprovisionamento

Se criar um conjunto de armazenamento de desempenho avançado, pode usar o aprovisionamento reduzido. Pode criar discos no conjunto de armazenamento com uma quantidade cumulativa de IOPS e débito que exceda o desempenho aprovisionado do conjunto. O desempenho usado do conjunto de armazenamento é definido pelo desempenho total usado pelos discos e não pela quantidade de desempenho aprovisionado para cada disco. Pode aprovisionar discos com um desempenho agregado de até 500% do desempenho aprovisionado de um conjunto de armazenamento de desempenho avançado.

Se estiver a criar discos num conjunto de armazenamento de desempenho padrão, os IOPS ou a taxa de transferência que aprovisiona para um disco têm de ser inferiores aos IOPS ou à taxa de transferência disponíveis no conjunto de armazenamento de hiperdisco. Os IOPS ou a taxa de transferência disponíveis são o valor aprovisionado para o conjunto de armazenamento menos o valor usado para todos os discos criados no conjunto de armazenamento.

Se alguma das condições no parágrafo anterior não se observar, o pedido de criação de um disco no conjunto de armazenamento falha e o disco não é criado.

Exemplo

Suponha que tem um conjunto de armazenamento equilibrado do Hyperdisk com 100 000 IOPS aprovisionadas.

Com o aprovisionamento de desempenho padrão:

Pode aprovisionar até 100 000 IOPS agregados quando criar discos Hyperdisk Balanced no conjunto de armazenamento.
É-lhe cobrado o desempenho aprovisionado de 100 000 IOPS do Hyperdisk Balanced Storage Pool.
Tal como os discos criados fora de um conjunto de armazenamento, os discos Hyperdisk Balanced em conjuntos de armazenamento de desempenho Standard são aprovisionados automaticamente com até 3000 IOPS de base e 140 MiB/s de débito de base. Este desempenho de base não é contabilizado no desempenho aprovisionado para o conjunto de armazenamento. Só quando adiciona discos ao conjunto de armazenamento com um desempenho aprovisionado acima do desempenho base é que conta para o desempenho aprovisionado do conjunto de armazenamento. Por exemplo:
- Um disco aprovisionado com 3000 IOPS usa 0 IOPS do conjunto e o conjunto continua a ter 100 000 IOPS aprovisionados disponíveis para outros discos.
- Um disco aprovisionado com 13 000 IOPS usa 10 000 IOPS do conjunto e o conjunto tem 90 000 IOPS aprovisionadas restantes que pode atribuir a outros discos no conjunto de armazenamento.

Com o aprovisionamento de desempenho avançado:

Pode aprovisionar até 500 000 IOPS de desempenho agregado do Hyperdisk quando cria discos no conjunto de armazenamento.
São-lhe cobradas 100 000 IOPS aprovisionadas pelo conjunto de armazenamento.
Se criar um único disco (Disk1) no conjunto de armazenamento que tenha 5000 IOPS, não consome nenhuma IOPS das IOPS aprovisionadas do conjunto de armazenamento. No entanto, a quantidade de IOPS que pode aprovisionar para novos discos criados no conjunto de armazenamento é agora de 495 000.
Se o Disk1 começar a ler e escrever dados e usar o máximo de 5000 IOPS num determinado minuto, são consumidos 5000 IOPS dos IOPS aprovisionados do conjunto de armazenamento. Quaisquer outros discos que tenha criado no mesmo conjunto de armazenamento podem usar um máximo agregado de 95 000 IOPS nesse mesmo minuto sem entrar em conflito.

Crie discos no conjunto de armazenamento

Pode usar a Google Cloud consola, a Google Cloud CLI ou o REST para criar um disco num conjunto de armazenamento.

Consola

Através da Google Cloud consola, pode criar um novo disco num conjunto de armazenamento através da página Conjuntos de armazenamento ou da página Discos.

Na página Pools de armazenamento:

Na Google Cloud consola, aceda à página Pools de armazenamento.

Aceda à página Conjuntos de armazenamento
Clique no nome do conjunto de armazenamento no qual quer criar um disco.
Na página Gerir conjunto de armazenamento, clique em + Criar novo disco.
No painel Adicionar novo disco, introduza um Nome para o disco.
Especifique ou altere os valores para os quais não quer usar o valor predefinido.
Quando terminar de especificar as propriedades do disco, clique em Guardar.
Na página Gerir conjunto de armazenamento, deve ver o novo disco listado na secção Discos do conjunto de armazenamento.

Na página Criar disco:

Na Google Cloud consola, aceda a Discos > página Criar um disco.

Aceda à página Crie um disco
Introduza um nome para o disco.
Selecione a zona que contém o conjunto de armazenamento no qual quer criar o disco.
Para o Tipo de disco, escolha o tipo de disco que corresponde ao conjunto de armazenamento Hyperdisk, Hyperdisk Throughput ou Hyperdisk Balanced.
Modifique os valores nos campos Tamanho, IOPS aprovisionadas e Débito aprovisionado, conforme necessário.
Na secção Conjunto de armazenamento, selecione Ativar conjunto de armazenamento e, de seguida, escolha o nome do conjunto de armazenamento no qual quer criar o disco. Apenas o conjunto de armazenamento existente 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 num conjunto 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 o seguinte:

DISK_NAME: um nome único para o disco. Pode fornecer uma lista de nomes de discos especificados por espaços para criar vários discos com os mesmos atributos.
ZONE: a zona onde o conjunto de armazenamento foi criado. Especifique este valor no formato de região-zona, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do conjunto de armazenamento no qual criar o disco
SIZE: opcional: a capacidade aprovisionada do novo disco. O valor tem de ser um número inteiro seguido de uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. Se não for especificado nenhum tamanho, é usado 100 GB como o valor predefinido.
DISK_TYPE: o tipo de disco a criar. Tem de corresponder ao tipo do conjunto de armazenamento do Hyperdisk, hyperdisk-balanced ou hyperdisk-throughput.
PROVISIONED_IOPS: opcional: os IOPS a aprovisionar para o disco. Só pode usar esta flag com discos Hyperdisk Balanced.
PROVISIONED_THROUGHPUT: Opcional: a taxa de transferência em mebibytes (MB) por segundo a aprovisionar para o disco.

REST

Para criar um ou mais discos num conjunto de armazenamento, crie um POST usando o método disks.insert. Inclua as propriedades name, sizeGb, type, storagePool, provisionedIops e provisionedThroughput. Para criar este disco como um disco não de arranque vazio e não formatado, não especifique uma imagem de origem nem um instantâneo 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 o seguinte:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o conjunto de armazenamento está localizado, por exemplo, us-central1-a. Esta é a zona em que o disco vai ser criado.
DISK_NAME: um nome único para o disco.
DESCRIPTION: Opcional: uma string de texto que descreve o disco.
DISK_TYPE: o tipo de disco, que tem de corresponder ao tipo de conjunto de armazenamento. Use hyperdisk-throughput ou hyperdisk-balanced.
DISK_SIZE: Opcional: o tamanho do novo disco. O valor tem de ser um número inteiro seguido de uma unidade de tamanho de GB para gibibytes ou TB para tebibytes. Se não for especificado nenhum tamanho, é usado 100 GB como o valor predefinido.
STORAGE_POOL_NAME: o nome do conjunto de armazenamento no qual criar o disco.
IOPS_LIMIT: opcional: os IOPS a aprovisionar para o disco. Só pode usar esta flag com discos Hyperdisk Balanced.
THROUGHPUT_LIMIT: opcional: o débito em mebibytes (MB) por segundo a aprovisionar para 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, pode anexá-lo a uma VM.

Crie uma VM que use discos no conjunto de armazenamento

Quando cria uma VM, configura um disco de arranque e, opcionalmente, pode criar discos de dados adicionais (não de arranque), que são anexados automaticamente à VM. As secções seguintes explicam como criar cada tipo de disco num conjunto de armazenamento como parte do processo de criação de VMs.

Crie o disco de arranque para uma VM num conjunto de armazenamento

Para criar uma VM que use um disco de arranque num conjunto de armazenamento, tem primeiro de criar um conjunto de armazenamento equilibrado do Hyperdisk. Em seguida, pode criar uma VM com um tipo de máquina que suporte discos Hyperdisk Balanced. O tipo de máquina, o tipo de disco e o conjunto de armazenamento têm de estar disponíveis na zona que escolher.

Consola

Na Google Cloud consola, aceda à página Instâncias de VM.

Aceder às instâncias de VM
Clique em Criar instância.
Introduza um nome para a instância.
Defina a zona para a mesma zona onde o conjunto de armazenamento está localizado.
Escolha um tipo de máquina que suporte o Hyperdisk Balanced, por exemplo, H3.
Na secção Disco de arranque, clique em Alterar.
No painel Disco de arranque, defina o Tipo de disco de arranque como Hyperdisk Balanced.
Configure as propriedades do disco.
Expanda Mostrar configurações avançadas.
No cabeçalho Conjunto de armazenamento, selecione Ativar conjunto de armazenamento.
Escolha o conjunto de armazenamento no qual quer criar o disco a partir da lista.
Quando terminar a configuração do disco, clique em Selecionar.
Conclua a configuração das propriedades da VM.
Clique em Criar.

A consola cria a VM na zona especificada e cria o disco de arranque no conjunto de armazenamento selecionado.

gcloud

Pode criar o disco de arranque para uma nova VM no conjunto de armazenamento através do comando gcloud compute instances create e incluindo a propriedade storage-pool para o disco de arranque.

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 o seguinte:

VM_NAME: o nome da VM.
ZONE: a região e a zona onde criar a VM, usando o formato us-central1-a.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
DISK_SIZE: o tamanho, em GiB, do disco de arranque
THROUGHPUT: o débito a aprovisionar para o disco
IOPS: os IOPS a aprovisionar para o disco
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma das seguintes opções:
- Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240213.
- Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma VM com a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.
STORAGE_POOL_NAME: o nome do conjunto de armazenamento no qual criar o novo disco.

REST

Pode criar o disco de arranque para uma nova VM no conjunto de armazenamento criando um pedido POST para o método instances.insert e incluindo a propriedade storagePool para o disco de arranque.

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 o seguinte:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o conjunto de armazenamento está localizado, por exemplo, us-central1-a. Esta é a zona na qual a VM e o disco de arranque sã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 do disco de arranque
DISK_SIZE: o tamanho, em GiB, do disco de arranque
DISK_TYPE: o tipo de disco, especificado como um URI
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma das seguintes opções:
- Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240213.
- Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma VM com a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.
IOPS_LIMIT: os IOPS a aprovisionar para o disco
THROUGHPUT_LIMIT: o débito a aprovisionar para o disco
POOL_URL: o conjunto de armazenamento no qual o novo disco é criado. Pode indicar este URL como parcial ou completo para o recurso. Por exemplo, os seguintes são valores 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

Crie discos adicionais num conjunto de armazenamento durante a criação da VM

Quando cria discos num conjunto de armazenamento durante a criação da VM, o tipo de máquina, o tipo de disco e o conjunto de armazenamento têm de estar disponíveis na zona que escolher.

Consola

Siga estes passos para usar a consola e criar uma nova VM com discos adicionais que não sejam de arranque:

Na Google Cloud consola, aceda à página Instâncias de VM.

Aceder às instâncias de VM
Clique em Criar instância.
Introduza um nome para a VM.
Defina a zona para a mesma zona onde o conjunto de armazenamento está localizado.
Escolha um tipo de máquina que suporte o tipo de disco usado pelo conjunto de armazenamento.
Expanda a secção Opções avançadas.
Expanda Discos.
Clique em Adicionar novo disco.
No painel Adicionar novo disco, introduza as informações do disco. Defina o Tipo de disco de modo a corresponder ao tipo de conjunto de armazenamento.
Na secção Conjunto de armazenamento, selecione Ativar conjunto de armazenamento.
No campo Selecione um conjunto de armazenamento, selecione o conjunto de armazenamento no qual quer criar o disco.
Quando terminar a configuração do disco, clique em Guardar.
Conclua a configuração das propriedades da VM.
Clique em Criar.

A consola cria a VM na zona especificada e cria o disco não de arranque no conjunto de armazenamento selecionado.

gcloud

Pode criar novos discos num conjunto de armazenamento durante a criação da VM através do 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 o seguinte:

VM_NAME: o nome da VM.
ZONE: a região e a zona onde criar a VM, usando o formato us-central1-a
MACHINE_TYPE: o tipo de máquina da VM
BOOT_DISK_DEVICE_NAME: o nome do dispositivo do disco de arranque
IMAGE_NAME: o nome da imagem do sistema operativo a instalar no disco de arranque, por exemplo, debian-12-bookworm-v20240213
BOOT_DISK_SIZE: o tamanho, em GiB, do disco de arranque
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: os IOPS a aprovisionar para o disco
THROUGHPUT: o débito a aprovisionar para o disco
STORAGE_POOL_NAME: o nome exclusivo do conjunto de armazenamento no qual quer criar o disco.

REST

Pode criar novos discos num conjunto de armazenamento durante a criação da VM criando um pedido 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 o seguinte:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o conjunto de armazenamento está localizado, por exemplo, us-central1-a. Esta é a zona na qual a VM e o disco de arranque são criados.
VM_NAME: o nome da VM.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma das seguintes opções:
- Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240213.
- Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma VM com a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.
DEVICE_NAME: o nome do dispositivo do disco de dados
DISK_SIZE: o tamanho, em GiB, do disco de dados
DISK_TYPE: o tipo de disco, especificado como um URI
IOPS_LIMIT: os IOPS a aprovisionar para o disco
THROUGHPUT_LIMIT: o débito a aprovisionar para o disco
POOL_URL: o conjunto de armazenamento no qual o novo disco é criado. Pode indicar este URL como parcial ou completo para o recurso. Por exemplo, os seguintes são valores 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

Use um conjunto de armazenamento num modelo de instância

Os modelos de instâncias usados para criar grupos de instâncias geridas (MIGs) podem conter as informações do conjunto de armazenamento. Os discos criados com o modelo de instância são colocados no conjunto de armazenamento especificado.

Consola

Na Google Cloud consola, aceda à página Modelos de instâncias.

Aceda a Modelos de instâncias
Clique em Criar modelo de instância.
Introduza um nome para o modelo de instância.
Escolha Regional para a localização e, no campo Região, escolha a região onde o conjunto de armazenamento está localizado.
Escolha um tipo de máquina que suporte o Hyperdisk Balanced, por exemplo, C3.
Na secção Disco de arranque, clique em Alterar.
No painel Disco de arranque, defina o Tipo de disco de arranque como Hyperdisk Balanced.
Configure as propriedades do disco.
Expanda Mostrar configurações avançadas.
No cabeçalho Conjunto de armazenamento, selecione Ativar conjunto de armazenamento.
Escolha o conjunto de armazenamento no qual quer criar o disco a partir da lista.
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 cria o disco de arranque no conjunto de armazenamento selecionado.

gcloud

Pode especificar num modelo de instância que o disco de arranque seja criado num conjunto de armazenamento através do comando gcloud compute instance-templates create e incluindo a propriedade storage-pool para o disco de arranque.

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 o seguinte:

TEMPLATE_NAME: o nome do modelo de instância.
REGION: a região onde quer criar o modelo de instância regional. A região tem de conter a zona onde o conjunto de armazenamento está localizado.
MACHINE_TYPE: o tipo de máquina a usar ao criar a VM, por exemplo, h3-standard-88.
DISK_SIZE: o tamanho, em GiB, do disco
THROUGHPUT: o débito a aprovisionar para o disco
IOPS: os IOPS a aprovisionar para o disco
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma das seguintes opções:
- Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240213.
- Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma VM com a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.
STORAGE_POOL_NAME: o nome do conjunto de armazenamento no qual criar o novo disco.

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 o seguinte:

PROJECT_ID: o ID do projeto
VM_NAME: o nome da VM.
ZONE: a zona em que o conjunto de armazenamento está localizado, por exemplo, us-central1-a. Esta é a zona na qual a VM e o disco de arranque são criados.
MACHINE_TYPE: o tipo de máquina da VM, por exemplo, m3-ultramem-32.
BOOT_DISK_DEVICE_NAME: o nome do dispositivo do disco de arranque
DISK_SIZE: o tamanho, em GiB, do disco de arranque
DISK_TYPE: o tipo de disco, especificado como um URI
IMAGE_PROJECT: o projeto que contém a imagem
IMAGE: especifique uma das seguintes opções:
- Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240213.
- Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma instância com a versão mais recente da imagem do SO na família de imagens debian-12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.
IOPS_LIMIT: os IOPS a aprovisionar para o disco
THROUGHPUT_LIMIT: o débito a aprovisionar para o disco
POOL_URL: o conjunto de armazenamento no qual o novo disco é criado. Pode indicar este URL como parcial ou completo para o recurso. Por exemplo, os seguintes são valores 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

Adicione discos de um conjunto de armazenamento a VMs Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

Go

Java

Node.js

REST

Funções e autorizações necessárias

Autorizações necessárias

Limitações

Opções de aprovisionamento

Aprovisionamento da capacidade do disco

Desempenho do aprovisionamento

Crie discos no conjunto de armazenamento

Consola

gcloud

REST

Go

Java

Node.js

Crie uma VM que use discos no conjunto de armazenamento

Crie o disco de arranque para uma VM num conjunto de armazenamento

Consola

gcloud

REST

Crie discos adicionais num conjunto de armazenamento durante a criação da VM

Consola

gcloud

REST

Use um conjunto de armazenamento num modelo de instância

Consola

gcloud

REST

Adicione discos de um conjunto de armazenamento a VMs