Esta página foi traduzida pela API Cloud Translation.

Crie um novo volume do Hyperdisk

Pode usar um volume Hyperdisk Balanced, Hyperdisk Extreme ou Hyperdisk Throughput com a sua instância do Compute Engine concluindo as seguintes tarefas:

Crie um volume do Hyperdisk em branco, não inicializável e zonal, e anexe-o à sua instância durante ou após a criação da instância.
Formate e monte o volume para fornecer acesso a um sistema de dados ou de ficheiros.

Para volumes Hyperdisk Balanced, também pode criar discos de arranque e discos de dados.

Para obter informações gerais sobre o Hyperdisk, consulte o artigo Acerca do Hyperdisk.

Para adicionar um disco Hyperdisk Balanced de alta disponibilidade à sua instância, use os seguintes procedimentos:

Antes de começar

Reveja as limitações do Hyperdisk antes de adicionar um volume do Hyperdisk à sua instância de computação.
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 adicionar um volume do Hyperdisk à sua instância, peça ao seu administrador para lhe conceder as seguintes funções de IAM no projeto:

Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)
Para se ligar a uma instância que pode ser executada como uma conta de serviço: Utilizador da conta de serviço (v1) (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 adicionar um volume do Hyperdisk à sua instância. 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 adicionar um volume do Hyperdisk à sua instância:

Para criar e anexar um volume do Hyperdisk:
- compute.disks.create no projeto
- compute.instances.attachDisk na instância
- compute.disks.use no volume que quer anexar à instância
Para formatar e montar o volume anexado: compute.instances.setMetadata na instância

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

Valores suportados para volumes Hyperdisk

Limites de tamanho

O tamanho que especificar para um volume do Hyperdisk tem de estar dentro dos intervalos indicados na tabela seguinte.

Tipo de Hyperdisk	Tamanho mínimo	Tamanho máximo	Tamanho predefinido
Hyperdisk Balanced	4 GiB	64 TiB	100 GiB
Hiperdisco equilibrado de alta disponibilidade	4 GiB	64 TiB	100 GiB
Hyperdisk Extreme	64 GiB	64 TiB	1 TiB
Hyperdisk ML	4 GiB	64 TiB	100 GiB
Débito do Hyperdisk	2 TiB	32 TiB	2 TiB

No entanto, o tamanho de um volume do Hyperdisk anexado a uma VM não pode exceder os limites do Hyperdisk para a VM.

Limites de desempenho

A tabela seguinte apresenta os limites de desempenho que pode especificar para cada tipo de Hyperdisk. No entanto, os níveis de IOPS e débito que pode especificar também dependem do tamanho do volume. Para um resumo detalhado de cada limite, consulte a secção Limites de tamanho e desempenho para Hyperdisk Balanced, Hyperdisk Balanced High Availability, Hyperdisk Extreme, Hyperdisk ML e Hyperdisk Throughput.

Tipo de Hyperdisk	Limite de IOPS	Limite de débito (MiB/s)
Hyperdisk Balanced	160 000	2400
Hiperdisco equilibrado de alta disponibilidade	100 000	1200
Hyperdisk Extreme	350 000	Não pode aprovisionar um nível de débito para volumes do Hyperdisk Extreme. Cada volume recebe 250 MiB/s de débito com cada 1000 IOPS, até 5000 MiB/s.
Hyperdisk ML	Não pode aprovisionar um nível de IOPS, mas cada MiB/s de débito aprovisionado inclui 16 IOPS, até 19 200 000 IOPS.	1 200 000
Débito do Hyperdisk	Não pode aprovisionar um nível de IOPS, mas cada MiB/s de débito aprovisionado inclui 4 IOPS, até 9600 IOPS.	2400

Variáveis de tipo Hyperdisk

A tabela seguinte lista os valores de referência de cada tipo de Hyperdisk. Quando cria um volume do Hyperdisk com a Google Cloud CLI, a API REST ou as bibliotecas de cliente da nuvem para o Compute Engine, indique o tipo de Hyperdisk a criar fornecendo o respetivo valor correspondente da tabela.

Tipo de disco	Nome de referência
Hyperdisk Balanced	`hyperdisk-balanced`
Hiperdisco equilibrado de alta disponibilidade	`hyperdisk-balanced-high-availability`
Hyperdisk Extreme	`hyperdisk-extreme`
Débito do Hyperdisk	`hyperdisk-throughput`
Hyperdisk ML	`hyperdisk-ml`

Adicione um volume Hyperdisk à sua instância

Pode criar e anexar um volume do Hyperdisk através da Google Cloud consola, da Google Cloud CLI ou da API REST.

O tamanho, a taxa de transferência e as IOPS que especificar quando criar um volume do Hyperdisk têm de estar no intervalo de valores suportados.

Quando cria um volume Hyperdisk Balanced, pode permitir opcionalmente que várias instâncias acedam ao disco em simultâneo criando o disco no modo de gravação múltipla.

Consola

Aceda à página Instâncias de VM.

Aceder às instâncias de VM
Clique no nome da instância à qual quer adicionar um disco.
Na página Detalhes da instância de VM, clique em Editar.
No cabeçalho Discos adicionais, clique em Adicionar novo disco.
Especifique um nome para o disco e, opcionalmente, adicione uma descrição. Selecione Disco em branco como o Tipo de origem do disco.
Em Definições do disco, escolha um tipo de disco na lista seguinte. Os valores que especificar têm de estar no intervalo de valores suportados.
1. Hyperdisk Balanced. Também pode alterar as definições predefinidas de tamanho do disco, IOPS aprovisionados e débito aprovisionado.
2. Hyperdisk Extreme. Também pode alterar o tamanho do disco predefinido e as definições de IOPS aprovisionados.
3. Hyperdisk ML. Também pode alterar as definições predefinidas de tamanho do disco e débito aprovisionado.
4. Débito do Hyperdisk.Também pode alterar as definições predefinidas de Tamanho e Débito aprovisionado do disco.
Opcional: para volumes Hyperdisk Balanced, pode ativar a associação do disco a várias instâncias criando o disco no modo de gravação múltipla. Em Modo de acesso, selecione Leitura/escrita de várias VMs.
Clique em Guardar.
Para aplicar as alterações à instância, clique em Guardar.

gcloud

Use o comando gcloud compute disks create para criar o volume do Hyperdisk.
```
gcloud compute disks create DISK_NAME \
   --zone=ZONE \
   --size=DISK_SIZE \
   --type=DISK_TYPE \
   --provisioned-iops=IOPS_LIMIT
   --provisioned-throughput=THROUGHPUT_LIMIT
   --access-mode=DISK_ACCESS_MODE
```
Substitua o seguinte:
- DISK_NAME: o nome do novo disco.
- ZONE: o nome da zona onde o novo disco está a ser criado.
- 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 gibibyte ou TB para tebibyte. Se não for especificada nenhuma unidade de tamanho, é usado 100 GB como valor predefinido. Os valores aceites para o tamanho do disco são:
  - Hyperdisk Balanced: de 4 GiB a 64 TiB, inclusive, em incrementos de 1 GiB.
  - Hyperdisk Extreme: de 64 GiB a 64 TiB, inclusive, em incrementos de 1 GiB.
  - Hyperdisk ML: de 4 GiB a 64 TiB, inclusive, em incrementos de 1 GiB.
  - Débito do Hyperdisk: de 2 TiB a 32 TiB, inclusive, em incrementos de 1 GiB.
- DISK_TYPE: o tipo de disco. Use um dos seguintes valores: hyperdisk-balanced, hyperdisk-extreme, hyperdisk-ml ou hyperdisk-throughput
- IOPS_LIMIT: opcional: para discos Hyperdisk Balanced ou Hyperdisk Extreme, este é o número de operações de E/S por segundo (IOPS) que o disco pode processar.
- THROUGHPUT_LIMIT: Opcional: para volumes Hyperdisk Balanced, Hyperdisk ML ou Hyperdisk Throughput, este é um número inteiro que representa o débito máximo, medido em MiB por segundo, que o disco pode fornecer.
- DISK_ACCESS_MODE: opcional: como as instâncias de computação podem aceder aos dados no disco. Os valores suportados são:
  - READ_WRITE_SINGLE, para acesso de leitura/escrita a partir de uma instância. Esta é a predefinição.
  - READ_WRITE_MANY, (apenas Hyperdisk Balanced e Hyperdisk Balanced de alta disponibilidade) para acesso de leitura/escrita simultâneo a partir de várias instâncias.
  - READ_ONLY_MANY, (apenas Hyperdisk ML) para acesso simultâneo só de leitura a partir de várias instâncias.
  Para definir o modo de acesso para discos Hyperdisk Balanced de elevada disponibilidade, consulte o artigo Crie um disco regional.
Opcional: use o comando gcloud compute disks describe DISK_NAME para ver uma descrição do seu disco.
Depois de criar o disco, pode anexá-lo a uma instância.

REST

Construa um pedido POST para criar um Hyperdisk zonal usando o método disks.insert. Inclua as propriedades name, sizeGb, type, 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",
   "sizeGb": "DISK_SIZE",
   "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE",
   "provisionedIops": "IOPS_LIMIT",
   "provisionedThroughput": "THROUGHPUT_LIMIT",
   "accessMode": "DISK_ACCESS_MODE"
}
```
Substitua o seguinte:
- PROJECT_ID: o ID do seu projeto
- ZONE: a zona onde a sua instância e o novo disco se encontram
- DISK_NAME: o nome do novo disco
- 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.
- DISK_TYPE: o tipo de disco. Para criar um volume do Hyperdisk, use um dos seguintes valores: hyperdisk-balanced, hyperdisk-extreme, hyperdisk-ml ou hyperdisk-throughput.
- IOPS_LIMIT: opcional: para o Hyperdisk Balanced e o Hyperdisk Extreme, este é o número de operações de E/S por segundo que o disco consegue processar.
- THROUGHPUT_LIMIT: Opcional: para volumes Hyperdisk Balanced, Hyperdisk ML ou Hyperdisk Throughput, este é um número inteiro que representa o débito máximo, medido em MiB por segundo, que o disco pode fornecer.
- DISK_ACCESS_MODE: opcional: como as instâncias de computação podem aceder aos dados no disco. Os valores suportados são:
  - READ_WRITE_SINGLE, para acesso de leitura/escrita a partir de uma instância. Esta é a predefinição.
  - READ_WRITE_MANY (apenas para Hyperdisk Balanced e Hyperdisk Balanced de alta disponibilidade) para acesso de leitura/escrita simultâneo a partir de várias instâncias.
  - READ_ONLY_MANY, (apenas para Hyperdisk ML) para acesso só de leitura concorrente a partir de várias instâncias.
  Para definir o modo de acesso para discos Hyperdisk Balanced de elevada disponibilidade, consulte o artigo Crie um disco regional.
Opcional: use o método compute.disks.get para ver uma descrição do disco.
Depois de criar o disco, pode anexá-lo a qualquer instância em execução ou parada.

Go

// createHyperdisk creates a new Hyperdisk in the specified project and zone.
func createHyperdisk(w io.Writer, projectId, zone, diskName string) error {
	//   projectID := "your_project_id"
	//   zone := "europe-central2-b"
	//   diskName := "your_disk_name"

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

	// use format "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-throughput)".
	diskType := fmt.Sprintf("zones/%s/diskTypes/hyperdisk-balanced", zone)

	// Create the disk
	disk := &computepb.Disk{
		Name:   proto.String(diskName),
		Type:   proto.String(diskType),
		SizeGb: proto.Int64(10),
		Zone:   proto.String(zone),
	}

	req := &computepb.InsertDiskRequest{
		Project:      projectId,
		Zone:         zone,
		DiskResource: disk,
	}

	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, "Hyperdisk created: %v\n", diskName)
	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 CreateHyperdisk {
  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";
    // The type of disk you want to create. This value uses the following format:
    // "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-extreme|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: For Hyperdisk Balanced or Hyperdisk Extreme disks,
    // this is the number of I/O operations per second (IOPS) that the disk can handle
    long 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.
    long provisionedThroughput = 140;

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

  // Creates a hyperdisk in a project
  public static Disk createHyperdisk(String projectId, String zone, String diskName,
                                     String diskType, long diskSizeGb, long provisionedIops,
                                     long provisionedThroughput)
          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)
              .setProvisionedIops(provisionedIops)
              .setProvisionedThroughput(provisionedThroughput)
              .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 = 'europe-central2-b';

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

// 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 callCreateComputeHyperdisk() {
  // Create a disk
  const disk = new compute.Disk({
    sizeGb: diskSizeGb,
    name: diskName,
    zone,
    type: diskType,
    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 callCreateComputeHyperdisk();

Depois de criar o disco, pode anexá-lo a qualquer instância em execução ou parada.

Formate e monte o disco

Depois de criar e anexar o novo disco a uma instância, tem de formatar e montar o disco para que o sistema operativo possa usar o espaço de armazenamento disponível.

Linux: consulte o artigo Formatar e montar um disco não de arranque numa instância de computação do Linux
Windows: consulte o artigo Formatar e montar um disco não inicializável numa instância do Compute do Windows

O que se segue?

Saiba como personalizar as IOPS e a taxa de transferência nos seus volumes do Hyperdisk.
Saiba como fazer regularmente uma cópia de segurança dos seus discos através de capturas de ecrã para evitar a perda de dados não intencional.

Crie um novo volume do Hyperdisk 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

Valores suportados para volumes Hyperdisk

Limites de tamanho

Limites de desempenho

Variáveis de tipo Hyperdisk

Adicione um volume Hyperdisk à sua instância

Consola

gcloud

REST

Go

Java

Node.js

Formate e monte o disco

O que se segue?

Crie um novo volume do Hyperdisk