Criar e gerenciar discos regionais

O Hyperdisk Balanced High Availability e o Persistent Disk regional são opções de armazenamento que permitem implementar serviços de alta disponibilidade (HA) no Compute Engine. O Persistent Disk regional e o Hyperdisk Balanced High Availability replicam dados de maneira síncrona entre duas zonas na mesma região e garantem a alta disponibilidade para dados de disco de até uma falha na zona. O disco regional pode ser um disco de inicialização ou um disco não de inicialização.

Também é possível permitir que diferentes instâncias acessem simultaneamente um disco do Hyperdisk Balanced High Availability definindo o modo de acesso ao disco. Os discos regionais só podem ser anexados a instâncias nas mesmas zonas que as réplicas do disco. Para mais informações, consulte Compartilhar um disco entre instâncias.

Neste documento, explicamos como fazer as seguintes tarefas em discos regionais:

Antes de começar

Papéis e permissões necessárias

Para ter as permissões necessárias para criar um disco regional, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

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 contêm as permissões necessárias para criar um disco regional. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar um disco regional:

  • compute.disks.create
  • compute.instances.attachDisk
  • compute.disks.use
  • Crie um snapshot de um disco: compute.disks.createSnapshot
  • Crie um disco regional com base em uma imagem: compute.images.useReadOnly na imagem
  • Confira os detalhes de um disco: compute.disks.get
  • Receba uma lista de discos: compute.disks.list
  • Mudar o tamanho de um disco: compute.disks.update

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

Limitações

  • Só é possível anexar Persistent Disk regionais a VMs que usam tipos de máquina E2, N1, N2 e N2D.
  • Você pode anexar o Hyperdisk Balanced High Availability somente a arquivos tipos de máquina compatíveis.
  • Não é possível criar um disco regional clonando um disco do Hyperdisk ML ou do Hyperdisk Throughput. Crie um snapshot do disco de origem e, em seguida, crie um disco do Hyperdisk Balanced High Availability com base no snapshot. Para mais informações, consulte Mudar um disco zonal para um Hyperdisk Balanced High Availability.
  • Ao usar o modo somente leitura, é possível anexar um disco permanente equilibrado regional a, no máximo, 10 instâncias de VM.
  • O tamanho mínimo de um disco permanente padrão regional é 200 GiB.
  • Só é possível aumentar o tamanho do volume do Disco permanente regional ou do Hyperdisk Balanced High Availability; não é possível diminuir o tamanho.
  • Os volumes do Disco permanente regional e do Hyperdisk Balanced High Availability têm desempenhos diferentes do que os discos zonais correspondentes. Para mais informações, consulte Sobre o desempenho do Persistent Disk e Limites de desempenho do Hyperdisk Balanced High Availability.
  • Não é possível usar um volume do Hyperdisk Balanced High Availability que esteja no modo de vários gravadores como um disco de inicialização.
  • Se você criar um disco replicado clonando um disco zonal, as duas réplicas zonais não estarão totalmente sincronizadas no momento da criação. Após a criação, é possível usar o clone de disco regional em média em até três minutos. No entanto, talvez seja necessário aguardar diversos minutos até que o disco atinja um estado totalmente replicado e o objetivo de ponto de recuperação (RPO) esteja próximo de zero. Saiba como Verificar se o disco replicado foi totalmente replicado.
  • Não é possível criar discos regionais em zonas de IA.
  • A criação de um disco regional com base em uma imagem tem as seguintes limitações:
    • Ao criar um disco regional com base em uma imagem, é possível criar um disco em um projeto a cada 5 minutos. É possível emitir até cinco solicitações de uma vez, mas não é possível criar mais de cinco discos em um período de 25 minutos.
    • A criação de um disco regional com base em uma imagem está em prévia e é mais lenta do que a criação de um disco zonal com base em uma imagem.

Sobre o uso de um disco regional como um disco de inicialização para uma instância

É possível anexar um Persistent Disk regional ou um disco do Hyperdisk Balanced High Availability como um disco de inicialização para cargas de trabalho com estado provisionadas com antecedência, antes de provisionar uma carga de trabalho de produção. Os discos de inicialização regionais não são destinados a espera ativa, porque não é possível anexar simultaneamente um disco de inicialização a duas instâncias.

Em uma configuração de alta disponibilidade, se o dispositivo de inicialização for um disco regional, o Google recomenda não pré-criar e iniciar a instância em espera. Em vez disso, no estágio de failover, anexe o disco regional atual ao criar a instância em espera usando a opção forceAttach.

É possível criar um disco de inicialização regional com base em uma imagem (prévia), um snapshot padrão ou um instant snapshot.

Para usar um disco regional como disco de inicialização de uma instância, use um dos métodos a seguir.

  1. Crie a instância e o disco de inicialização ao mesmo tempo.

  2. Crie um disco de inicialização regional e anexe-o a uma instância:

    1. Crie um disco de inicialização regional com base em uma imagem ou snapshot de um disco.
    2. Anexe o disco de inicialização regional a uma instância.

    Recomendamos criar discos de inicialização regionais com base em snapshots, não em clones de discos zonais.

Para fazer o failover de um disco de inicialização regional para uma instância em espera em execução na zona de réplica, siga as etapas descritas em Anexar um disco de inicialização regional a uma instância.

Limites de tamanho e nomes de referência para discos regionais

O tamanho especificado para um disco regional precisa estar dentro dos intervalos listados na tabela a seguir.

Se você criar um disco regional com a Google Cloud CLI, REST ou as bibliotecas de cliente do Cloud para Compute Engine, indique o tipo de disco a ser criado fornecendo o valor na coluna Nome de referência da tabela a seguir.

Tipo de disco Nome da referência Tamanho mínimo Tamanho máximo Tamanho padrão
Hyperdisk Balanced High Availability hyperdisk-balanced-high-availability 4 GiB 64 TiB 100 GiB
Disco permanente equilibrado pd-balanced Por zona: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Persistent Disk (SSD) de desempenho pd-ssd Por zona: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Disco permanente padrão pd-standard Por zona: 10 GiB
Regional: 200 GiB		 64 TiB 500 GiB

Criar um disco regional com base em uma imagem ou snapshot

Crie um volume do Persistent Disk regional ou do Hyperdisk Balanced High Availability. O disco precisa estar na mesma região da instância de computação a que você planeja anexá-lo.

Se você criar um volume do Hyperdisk Balanced High Availability, também poderá permitir que diferentes instâncias acessem o disco simultaneamente definindo o modo de acesso ao disco. Para mais informações, consulte Compartilhar um disco entre instâncias.

Para o Persistent Disk regional, se você criar um disco no console do Google Cloud , o tipo de disco padrão será pd-balanced. Se você criar um disco usando a CLI gcloud ou REST, o tipo de disco padrão será pd-standard.

Console

  1. No console do Google Cloud , acesse a página Discos.

    Acessar "Discos"

  2. Selecione o projeto necessário.

  3. Clique em Criar disco.

  4. Especifique um Nome para o disco.

  5. Em Local, escolha Regional.

  6. Selecione a Região e a Zona. É preciso selecionar a mesma região ao criar a instância.

  7. Selecione a Zona de réplica na mesma região. Anote as zonas selecionadas porque você precisa anexar o disco à instância em uma delas.

  8. Em Tipo de origem do disco, escolha a fonte de dados do disco:

    • Para criar um disco em branco, selecione Disco em branco.
    • Para criar o disco com base em uma imagem:
      1. Selecione Imagem.
      2. Em Imagem de origem, escolha a imagem de origem para o disco.
    • Para criar o disco com base em um snapshot atual:
      1. Selecione Snapshot, Instant snapshot ou Snapshot de arquivamento, dependendo se o snapshot de origem é um snapshot padrão, um instant snapshot ou um snapshot de arquivamento, respectivamente.
      2. Em Snapshot de origem, selecione o snapshot ou instant snapshot de origem na lista. Somente os snapshots no local selecionado são listados.
    • Para criar o disco com base em um disco específico em uma imagem de máquina (prévia):
      1. Selecione Imagem de máquina.
      2. No menu suspenso Imagem da máquina de origem, selecione a imagem que você quer usar.
      3. No menu suspenso Disco de origem, selecione o nome do dispositivo do disco específico na imagem de máquina escolhida que você quer usar como origem do novo disco.
      4. Se a imagem de máquina selecionada estiver protegida por uma chave de criptografia fornecida pelo cliente (CSEK) (descontinuada), uma seção Criptografia vai aparecer. Insira a chave de descriptografia necessária no campo indicado.
      5. Configure outras propriedades do disco, como Nome, Tipo, Tamanho e regra de Exclusão, conforme necessário.

  9. Em Configurações de disco, escolha um Tipo de disco e um Tamanho. Para volumes do Hyperdisk Balanced High Availability, também é possível mudar as configurações padrão de IOPS provisionadas e Capacidade de processamento provisionada.

  10. Opcional: para volumes do Hyperdisk Balanced High Availability, é possível ativar a anexação do disco a várias instâncias criando o disco no modo de vários gravadores. Em Modo de acesso, selecione Leitura e gravação de várias VMs.

  11. Clique em Criar para concluir a criação do disco.

gcloud

Crie um disco regional usando o comando compute disks create.

É possível criar um disco em branco ou com base em uma imagem (pré-lançamento), um instant snapshot ou um snapshot padrão.

Disco em branco 

gcloud compute disks create DISK_NAME \
 --size=DISK_SIZE \
 --type=DISK_TYPE \
 --region=REGION \
 --replica-zones=ZONE1,ZONE2 \
 --access-mode=DISK_ACCESS_MODE

Substitua:

  • DISK_NAME: o nome do novo disco
  • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
  • DISK_TYPE: Para o Persistent Disk regional, esse é o tipo do disco regional. O valor padrão é pd-standard. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
  • REGION: a região do disco regional, por exemplo, europe-west1.
  • ZONE1,ZONE2: as zonas dentro da região em que as duas réplicas de disco estão localizadas, por exemplo: europe-west1-b,europe-west1-c
  • DISK_ACCESS_MODE: opcional: para discos Hyperdisk Balanced High Availability, Os seguintes valores são aceitos:
    • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
    • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.

Snapshot

Para criar o disco com base em um snapshot padrão ou snapshot de arquivamento, use a flag --source-snapshot para especificar o nome do snapshot.

gcloud compute disks create DISK_NAME \
  --size=DISK_SIZE \
  --type=DISK_TYPE \
  --region=REGION \
  --replica-zones=ZONE1,ZONE2 \
  --access-mode=DISK_ACCESS_MODE \
  --source-snapshot=SNAPSHOT_NAME \
  [ --source-snapshot-region=SOURCE_REGION ]

Substitua:

  • DISK_NAME: o nome do novo disco
  • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
  • DISK_TYPE: Para o Persistent Disk regional, esse é o tipo do disco regional. O valor padrão é pd-standard. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
  • REGION: a região do disco regional, por exemplo, europe-west1.
  • ZONE1,ZONE2: as zonas dentro da região em que as duas réplicas de disco estão localizadas, por exemplo: europe-west1-b,europe-west1-c
  • DISK_ACCESS_MODE: opcional: para discos Hyperdisk Balanced High Availability, Os seguintes valores são aceitos:
    • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
    • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.
  • SNAPSHOT_NAME com o nome do snapshot.
  • SOURCE_REGION: opcional. Se o snapshot for regional, especifique a região em que ele está no escopo.

Para criar o disco de um Instant Snapshot, use a flag --source-instant-snapshot para especificar o nome do Instant Snapshot.

 gcloud compute disks create DISK_NAME \
    --source-instant-snapshot=INSTANT_SNAPSHOT_NAME

Substitua INSTANT_SNAPSHOT_NAME pelo nome do Instant Snapshot.

Imagem

Para criar o disco com uma versão específica de uma imagem pública ou de uma imagem personalizada, use a versão Beta do comando. Especifique o nome da imagem com a flag --image:

 gcloud beta compute disks create DISK_NAME \
    --size=DISK_SIZE \
    --type=DISK_TYPE \
    --region=REGION \
    --replica-zones=ZONE1,ZONE2 \
    --access-mode=DISK_ACCESS_MODE \
    --image=IMAGE_NAME

Substitua:

  • DISK_NAME: o nome do novo disco
  • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
  • DISK_TYPE: Para o Persistent Disk regional, esse é o tipo do disco regional. O valor padrão é pd-standard. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
  • REGION: a região do disco regional, por exemplo, europe-west1.
  • ZONE1,ZONE2: as zonas dentro da região em que as duas réplicas de disco estão localizadas, por exemplo: europe-west1-b,europe-west1-c
  • DISK_ACCESS_MODE: opcional: para discos Hyperdisk Balanced High Availability, Os seguintes valores são aceitos:
    • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
    • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.
  • IMAGE_NAME com o nome da imagem, por exemplo, debian-13-trixie-v20260902.

Para criar o disco usando a versão mais recente de uma família de imagens, use a versão Beta do comando. Especifique o nome da família de imagens com a flag --image-family:

 gcloud beta compute disks create DISK_NAME \
    --size=DISK_SIZE \
    --type=DISK_TYPE  --region=REGION \
    --replica-zones=ZONE1,ZONE2 \
    --image-family=IMAGE_FAMILY_NAME

Substitua IMAGE_FAMILY_NAME pelo nome da família de imagens, por exemplo, debian-13.

Terraform

Para criar um Persistent Disk regional ou um volume do Hyperdisk Balanced High Availability, use o recurso google_compute_region_disk.

Para especificar o tipo de disco, defina o argumento type com o valor correspondente da lista a seguir.

  • Hyperdisk Balanced High Availability: hyperdisk-balanced-high-availability
  • Disco permanente SSD: pd-ssd
  • Disco permanente equilibrado: pd-balanced
  • Disco permanente padrão: pd-standard

Para criar um disco de uma imagem (prévia), substitua o argumento snapshot no exemplo a seguir pelo image.

O exemplo a seguir cria um disco regional com base em um snapshot.

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

REST

Para criar um Disco permanente regional ou volume do Hyperdisk Balanced High Availability, crie uma solicitação POST para o método compute.regionDisks.insert.

É possível criar um disco em branco ou com base em uma imagem (Preview) ou um snapshot padrão ou Instant Snapshot.

Disco em branco

Para criar um disco em branco, crie uma solicitação POST com o seguinte corpo:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks
{
 
   "name": "DISK_NAME",
   "region": "projects/PROJECT_ID/regions/REGION",
   "replicaZones": [
   "projects/PROJECT_ID/zones/ZONE1",
   "projects/PROJECT_ID/zones/ZONE2"
   ],
   "sizeGb": "DISK_SIZE",
   "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
   "accessMode": "DISK_ACCESS_MODE"
}

Substitua:

  • PROJECT_ID: ID do projeto;
  • REGION: a região do disco regional, por exemplo, europe-west1.
  • DISK_NAME: o nome do novo disco
  • ZONE1,ZONE2: as zonas em que as réplicas do novo disco devem estar localizadas.
  • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
  • DISK_TYPE: Para o Persistent Disk regional, este é o tipo de disco permanente. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
  • DISK_ACCESS_MODE: opcional: para discos de Hyperdisk Balanced High Availability, especifique como as instâncias podem acessar os dados no disco de Hyperdisk Balanced High Availability. Os valores a seguir são aceitos:
    • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
    • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.

Snapshot

Para criar o disco com base em um snapshot padrão ou snapshot de arquivamento, use o campo sourceSnapshot para especificar o URL do snapshot.

  • Se o snapshot for global:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/ REGION/disks
{

   "name": "DISK_NAME",
   "region": "projects/PROJECT_ID/regions/REGION",
   "replicaZones": [
   "projects/PROJECT_ID/zones/ZONE1",
   "projects/PROJECT_ID/zones/ZONE2"
   ],
   "sizeGb": "DISK_SIZE",
   "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
   "accessMode": "DISK_ACCESS_MODE",
"sourceSnapshot": "SNAPSHOT_NAME"
}

    Substitua:

    • PROJECT_ID: ID do projeto;
    • REGION: a região do disco regional, por exemplo, europe-west1.
    • DISK_NAME: o nome do novo disco
    • ZONE1,ZONE2: as zonas em que as réplicas do novo disco devem estar localizadas.
    • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
    • DISK_TYPE: Para o Persistent Disk regional, este é o tipo de disco permanente. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
    • DISK_ACCESS_MODE: opcional: para discos de Hyperdisk Balanced High Availability, especifique como as instâncias podem acessar os dados no disco de Hyperdisk Balanced High Availability. Os valores a seguir são aceitos:
      • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
      • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.
    • SNAPSHOT_NAME: o nome do snapshot padrão ou de arquivo.

  • Se o snapshot for regional (prévia), use a versão Beta do endpoint:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks
{
  "name": "DISK_NAME",
  "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME"
}

    Substitua:

    • REGION: a região do disco regional, por exemplo, europe-west1.
    • SOURCE_REGION: a região em que o snapshot de origem está no escopo
    • SNAPSHOT_NAME: o snapshot de origem do disco.

Para criar o disco com base em um instant snapshot, use o campo sourceInstantSnapshot em vez de sourceSnapshot para especificar o URL do instant snapshot.

POST https://compute.googleapis.com/compute/v1/projects/ PROJECT_ID/regions/REGION/disks
{
 "name": "DISK_NAME",
 "sourceInstantSnapshot": "projects/PROJECT/regions/SOURCE_REGION/instantSnapshots/ SOURCE_INSTANT_SNAPSHOT_NAME"
}

Substitua SOURCE_INSTANT_SNAPSHOT_NAME pelo nome do Instant Snapshot.

Imagem

Para criar o disco com uma imagem personalizada ou pública, use a versão Beta do endpoint e especifique o URL da imagem com o campo sourceImage.

  • Para usar uma imagem personalizada ou a versão mais recente de uma família de imagens personalizadas:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks
{

   "name": "DISK_NAME",
   "region": "projects/PROJECT_ID/regions/REGION",
   "replicaZones": [
   "projects/PROJECT_ID/zones/ZONE1",
   "projects/PROJECT_ID/zones/ZONE2"
   ],
   "sizeGb": "DISK_SIZE",
   "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
   "accessMode": "DISK_ACCESS_MODE",
"sourceImage": "global/images/IMAGE_NAME_OR_PATH"
}

    Substitua:

    • PROJECT_ID: ID do projeto;
    • REGION: a região do disco regional, por exemplo, europe-west1.
    • DISK_NAME: o nome do novo disco
    • ZONE1,ZONE2: as zonas em que as réplicas do novo disco devem estar localizadas.
    • DISK_SIZE: o tamanho do novo disco em GiB. Precisa estar dentro dos limites de tamanho para o tipo de disco.
    • DISK_TYPE: Para o Persistent Disk regional, este é o tipo de disco permanente. Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
    • DISK_ACCESS_MODE: opcional: para discos de Hyperdisk Balanced High Availability, especifique como as instâncias podem acessar os dados no disco de Hyperdisk Balanced High Availability. Os valores a seguir são aceitos:
      • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Essa é a opção padrão.
      • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.
    • IMAGE_NAME_OR_PATH: para usar uma imagem específica, substitua IMAGE_NAME_OR_PATH pelo nome da imagem, por exemplo: custom-debug-image. Para usar uma imagem de uma família, especifique family/IMAGE_FAMILY_NAME, em que IMAGE_FAMILY_NAME é o nome da família. Por exemplo, family/debug-image-family.

  • Para usar uma imagem pública específica ou a versão mais recente de uma família de imagens públicas:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks
{
"name": "DISK_NAME",
"sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_NAME_OR_PATH"
}

    Substitua:

    • IMAGE_PROJECT: o projeto que contém a imagem pública. Por exemplo, para usar uma imagem do Debian, especifique debian-cloud.
    • IMAGE_NAME_OR_PATH: o nome ou caminho da imagem. Para usar uma versão específica de uma imagem, especifique o nome dela, por exemplo: debian-13-trixie-v20260902. Para usar a versão mais recente de uma imagem de SO pública, especifique o nome da família de imagens, por exemplo: family/debian-13.

Depois de criar o disco, use-o como um disco de inicialização para uma instância ou anexe-o como um disco de dados a uma instância.

Anexar um disco regional à instância

Para discos que não são de inicialização, depois de criar um Persistent Disk regional ou um volume do Hyperdisk Balanced High Availability, é possível anexá-lo a uma instância. A instância precisa estar na mesma região que o disco.

Para anexar um disco de inicialização regional a uma instância, consulte Anexar um disco de inicialização regional a uma instância.

Para anexar um disco Hyperdisk Balanced High Availability a várias instâncias, repita o procedimento desta seção para cada instância. Só é possível anexar discos do Hyperdisk Balanced High Availability no modo de leitura e gravação.

Console

  1. Para anexar um disco a uma instância, acesse a página Instâncias de VM.

    Acessar instâncias de VM

  2. Na coluna Nome, clique no nome da instância.

  3. Clique em Editar .

  4. Clique em Anexar disco atual.

  5. Escolha o disco regional criado anteriormente para adicionar à instância.

  6. Se você vir um aviso indicando que o disco selecionado já está anexado a outra instância, marque a caixa Forçar anexação de disco para forçar a anexação do disco à instância em que você está editando.

    Confira os casos de uso para anexação forçada de discos regionais em Failover de disco regional.

  7. Opcional: se você estiver anexando um disco do Hyperdisk Balanced High Availability a várias instâncias, em Modo de anexação de disco, selecione Leitura/gravação.

  8. Clique em Salvar.

  9. Na página Editar VM, clique em Salvar.

gcloud

Para anexar um disco regional a uma instância em execução ou parada, use o comando compute instances attach-disk com a flag --disk-scope definida como regional.

Se você anexar um disco Hyperdisk Balanced High Availability no modo de vários gravadores a várias instâncias, o único modo de anexação compatível é rw, que é o modo de acesso padrão. Não é necessário incluir a flag --mode.

gcloud compute instances attach-disk INSTANCE_NAME \
    --disk=DISK_NAME \
    --disk-scope=regional \
    --device-name=DEVICE_NAME

Substitua:

  • INSTANCE_NAME: o nome da instância a que você está adicionando o disco regional.
  • DISK_NAME: o nome do novo disco que você está anexando à instância.
  • DEVICE_NAME (opcional): um nome que o SO convidado usa para criar um link simbólico, que ajuda a identificar o disco no nível do SO.

Terraform

Para anexar um Persistent Disk regional ou um volume do Hyperdisk Balanced High Availability a uma instância, use o recurso google_compute_attached_disk.

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }


}

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

REST

Para anexar um disco regional a uma instância em execução ou interrompida, crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL do disco regional que você criou.

Se você anexar um disco Hyperdisk Balanced High Availability no modo de vários gravadores a várias instâncias, o único modo de anexação compatível é READ-WRITE, que é o modo de acesso padrão. Não é necessário incluir a propriedade mode.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
 {
  "source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME",
  "deviceName": DEVICE_NAME
 }

Substitua:

  • PROJECT_ID: o ID do projeto;
  • ZONE: o local da instância;
  • INSTANCE_NAME: o nome da instância a que você está adicionando o novo disco regional.
  • REGION: a região em que o disco está localizado
  • DISK_NAME: o nome do disco regional (como mostrado no console Google Cloud ).
  • DEVICE_NAME (opcional): um nome que o SO convidado usa para criar um link simbólico, que ajuda a identificar o disco no nível do SO.

Para discos não inicializáveis, depois de criar e anexar um disco regional em branco a uma instância, é necessário formatar e montar o disco, para que o sistema operacional possa usar o espaço de armazenamento disponível.

Mudar um disco zonal para um disco regional

Para converter um disco zonal dos seguintes tipos em um disco regional, crie um disco regional clonando o disco de origem.

  • Hiperdisco equilibrado
  • Hiperdisco extremo
  • Disco permanente equilibrado
  • Disco permanente SSD
  • Disco permanente padrão

Para converter um volume do Hyperdisk ML ou do Hyperdisk Throughput em um disco regional, crie um novo disco do Hyperdisk Balanced High Availability com base em um snapshot do disco atual, conforme descrito em Mudar um disco zonal para um disco do Hyperdisk Balanced High Availability.

Criar uma instância com um novo disco de inicialização regional

Ao configurar uma instância de computação altamente disponível, é possível criar a instância principal com um novo disco de inicialização regional. Ao criar uma instância ao mesmo tempo que o disco de inicialização regional, é possível criar o disco de inicialização com base em uma imagem (prévia) ou um snapshot padrão.

Para criar um disco regional com base em um disco zonal, primeiro mude o disco zonal para um disco regional e crie a instância com o novo disco regional.

Nesta seção, descrevemos como criar uma instância com um novo disco de inicialização regional usando o console Google Cloud , a Google Cloud CLI ou o REST.

Console

  1. No console do Google Cloud , acesse a página Criar uma instância.

    Acesse "Criar uma instância"

    Se solicitado, selecione o projeto e clique em Continuar.

    A página Criar uma instância aparece e mostra o painel Configuração da máquina.

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

    1. No campo Nome, especifique um nome para a instância. Para mais informações, consulte Convenção de nomenclatura de recursos.

    2. Opcional: no campo Zona, selecione uma zona para esta instância.

      A seleção padrão é Qualquer. Se você não mudar essa seleção padrão, o Google vai escolher automaticamente uma zona com base no tipo de máquina e na disponibilidade.

    3. Selecione uma família de máquinas para sua instância em uma das seguintes opções:

      • Uso geral
      • Otimizado para computação
      • Otimização de memória
      • Otimizado para armazenamento
      • Rede otimizada
      • GPUs
      • TPUs

      O console do Google Cloud mostra as séries de máquinas disponíveis para a família selecionada.

    4. Na coluna Série, selecione a série de máquinas da sua instância.

      Se você selecionou GPUs como a família de máquinas na etapa anterior, selecione o Tipo de GPU desejado. A série de máquinas é selecionada automaticamente para o tipo de GPU escolhido.

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

  3. No menu de navegação, clique em SO e armazenamento. No painel Sistema operacional e armazenamento, siga estas etapas:

    Para saber mais sobre os parâmetros que podem ser configurados ao adicionar novos discos, consulte Sobre o Persistent Disk e Sobre o Google Cloud Hyperdisk.

    1. Para começar a configurar o disco de inicialização, clique em Mudar. O painel Disco de inicialização aparece e mostra a guia Imagens públicas.

    2. Configure a fonte de dados para o disco de inicialização de uma das seguintes maneiras:

      • Para escolher uma imagem pública como fonte de dados do disco de inicialização, na guia Imagens públicas, especifique o seguinte:
        1. Na lista Sistema operacional, selecione o tipo de SO.
        2. Na lista Versão, selecione a versão do SO.
        3. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        4. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.
      • Para escolher uma imagem personalizada como a fonte de dados do disco de inicialização, clique em Imagens personalizadas e, na guia Imagens personalizadas que aparece, especifique o seguinte:
        1. Para selecionar o projeto de imagem, clique em Mudar e selecione o projeto que contém a imagem.
        2. Na lista Imagem, selecione a imagem que você quer importar.
        3. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        4. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.
      • Para escolher um snapshot padrão como a fonte de dados do disco de inicialização, clique em Snapshots e, na guia Snapshots que aparece, especifique o seguinte:
        1. Na lista Snapshot, selecione o snapshot.
        2. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        3. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.
      • Para escolher um snapshot de arquivamento como a fonte de dados do disco de inicialização, clique em Snapshots de arquivamento e, na guia Snapshots de arquivamento que aparece, especifique o seguinte:
        1. Na lista Snapshot de arquivamento, selecione o snapshot de arquivamento.
        2. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        3. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.
      • Para escolher um disco atual como disco de inicialização, clique em Discos atuais. Em seguida, na guia Discos atuais que aparece, selecione um disco na lista Disco. Essa opção usa o disco atual como disco de inicialização e não cria um novo disco.

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

    4. Para confirmar as opções do disco de inicialização e voltar ao painel Sistema operacional e armazenamento, clique em Selecionar.

    5. Opcional: para saber como anexar discos que não são de inicialização à sua instância, consulte Criar uma instância com discos extras que não são de inicialização.

  4. Se você não escolheu um disco de inicialização, configure-o como um disco regional fazendo o seguinte:

    1. No menu de navegação, clique em Proteção de dados. No painel Proteção de dados, faça o seguinte:

      1. Para configurar todos os novos discos da instância para usar a replicação síncrona de disco (Persistent Disk regional ou Hyperdisk Balanced High Availability), marque a caixa de seleção Discos regionais.

      2. Nenhuma ação é necessária por padrão. Desmarque a caixa de seleção Excluir discos de inicialização.

  5. Opcional: especifique outras opções de configuração. Para mais informações, consulte Opções de configuração durante a criação da instância.

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

gcloud

Use o comando gcloud compute instances create para criar uma instância e a flag --create-disk para especificar o disco regional. Ao especificar os parâmetros de disco, os caracteres ^:^ definem que o caractere de separação entre os parâmetros é dois-pontos (:). Isso permite usar uma vírgula (,) ao especificar o parâmetro "replica-zones".

  • Para criar uma instância e o disco de inicialização regional dela com base em uma imagem pública ou personalizada (prévia):

    gcloud compute instances create PRIMARY_INSTANCE_NAME \
--zone=ZONE --project=PROJECT_ID \
--create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:replica-zones=ZONE,REMOTE_ZONE:[IMAGE_NAME_OR_FAMILY]

    Substitua:

    • PRIMARY_INSTANCE_NAME: um nome para a instância
    • ZONE: o nome da zona em que a instância será criada.
    • PROJECT_ID: o nome do projeto em que a instância será criada.
    • REGIONAL_DISK_NAME: um nome para o disco regional
    • DISK_TYPE: o tipo de disco a ser criado, por exemplo, hyperdisk-balanced-high-availability. Se você estiver usando um Persistent Disk, especifique também scope=regional na flag --create-disk para criar um Persistent Disk regional.
    • REMOTE_ZONE: a zona alternativa para o disco regional

    • IMAGE_NAME_OR_FAMILY: o nome ou a família da imagem a ser usada.

    • Para usar uma versão específica de uma imagem pública ou personalizada, especifique image=<var>IMAGE_NAME</var>, em que <var>IMAGE_NAME</var> é o nome da imagem. Por exemplo, image=debian-13-trixie-v20260902 ou image=my-custom-image.

    • Para usar uma família de imagens, especifique image-family=<var>IMAGE_FAMILY</var>:image-family-scope=global. Isso cria a instância que usa a imagem do SO mais recente e não obsoleta na família de imagens.

      Por exemplo, para usar a versão mais recente da imagem do SO na família de imagens do Debian 13, especifique image-family=debian-13:image-family-scope=global.

  • Para criar uma instância e um disco de inicialização regional com base em um snapshot:

    gcloud compute instances create PRIMARY_INSTANCE_NAME \
--zone=ZONE --project=PROJECT_ID \
--create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE

    Use os mesmos parâmetros do comando anterior e substitua <var>SNAPSHOT_NAME</var> pelo nome do snapshot do disco de inicialização, por exemplo, dev-snapshot-may2026.

REST

Crie uma solicitação POST para o método instances.insert e especifique as propriedades boot: 'true' e replicaZones. Para criar a instância de um snapshot, especifique a propriedade sourceSnapshot. Para criar a instância de uma imagem, especifique a propriedade sourceImage.

  • Para criar uma instância e o disco de inicialização regional dela com base em um snapshot:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

Substitua:

  • PROJECT_ID: ID do projeto;
  • ZONE: o nome da zona em que você quer criar a instância
  • INSTANCE_NAME: um nome para a instância
  • BOOT_SNAPSHOT_NAME: o nome do snapshot do disco de inicialização
  • REMOTE_ZONE: a zona remota do disco regional

  • DISK_TYPE: o tipo de disco a ser criado, por exemplo, hyperdisk-balanced-high-availability ou pd-balanced.

  • Para criar uma instância e o disco de inicialização regional dela com base em uma imagem (prévia):

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

Criar uma instância com discos regionais extras

Ao criar uma instância, você pode incluir volumes regionais de Persistent Disk ou Hyperdisk Balanced High Availability como discos adicionais.

Para criar e anexar um Persistent Disk regional ou um volume do Hyperdisk Balanced High Availability a uma instância durante a criação dela, consulte uma destas opções:

Anexar um disco de inicialização regional a uma instância

Siga estas etapas:

  • Substitua o disco de inicialização de uma instância atual por um disco de inicialização regional.
  • Faça failover de um disco de inicialização regional para uma instância em espera ativa em execução na zona de backup. Para fazer isso, anexe o disco regional à instância como o disco de inicialização.

Estas etapas pressupõem que o disco e a instância regionais já existem.

gcloud

  1. Interrompa a instância. 
    gcloud compute instances stop INSTANCE_NAME  --zone=ZONE
  2. Remova o disco de inicialização atual da instância. 
    gcloud compute instances detach-disk INSTANCE_NAME \
 --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
  3. Anexe o disco de inicialização regional à instância. 
    gcloud compute instances attach-disk INSTANCE_NAME  \
 --zone=ZONE  \
 --disk=REGIONAL_DISK_NAME  \
 --disk-scope=regional --force-attach \
 --boot

  4. Reinicie a instância. 

    gcloud compute instances start INSTANCE_NAME

Substitua as variáveis nos comandos anteriores pelas seguintes:

  • INSTANCE_NAME: o nome da instância a que você quer anexar o disco de inicialização regional.
  • ZONE: a zona em que a instância está localizada
  • CURRENT_BOOT_DEVICE_NAME: o nome do disco de inicialização que está sendo usado pela instância. Geralmente, é igual ao nome da instância.
  • REGIONAL_DISK_NAME: o nome do disco regional que você quer anexar à instância como um disco de inicialização.

Opcional: se não for possível remover o disco de inicialização regional da instância principal devido a uma interrupção ou falha, inclua a flag --force-attach.

REST

  1. Interrompa a instância.

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

  2. Remova o disco de inicialização atual da instância.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME

  3. Anexe o disco de inicialização regional à instância.

    Crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL do disco de inicialização regional:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
{
"source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REGIONAL_DISK_NAME",
"boot": true
}

  4. Reinicie a instância.

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

Substitua as variáveis nos comandos anteriores pelas seguintes:

  • PROJECT_ID: ID do projeto;
  • INSTANCE_NAME: o nome da instância a que você quer anexar o disco regional.
  • ZONE: a zona em que a instância está localizada
  • CURRENT_BOOT_DEVICE_NAME: o nome do disco de inicialização que está sendo usado pela instância. Geralmente, é igual ao nome da instância.
  • REGION: a região em que o disco regional está localizado.
  • REGIONAL_DISK_NAME: o nome do disco regional que você quer anexar à instância como um disco de inicialização.

Opcional: se não for possível remover o disco de inicialização regional da instância a que ele foi originalmente anexado devido a uma interrupção ou falha, inclua "forceAttach": true no corpo da solicitação.

Listar e descrever seus discos regionais

É possível conferir uma lista de todos os discos regionais configurados e informações sobre as propriedades, incluindo o seguinte:

  • ID do disco
  • Nome do disco
  • Tamanho
  • Tipo de disco
  • Região
  • Réplicas zonais

Para conferir informações detalhadas sobre os discos regionais, use o seguinte:

Redimensionar um disco regional

É possível redimensionar os discos quando as instâncias com discos regionais precisam de mais espaço de armazenamento. É possível redimensionar discos a qualquer momento, independentemente de o disco estar anexado a uma instância em execução. Se precisar separar seus dados em volumes exclusivos, crie vários discos secundários para a instância. No Hyperdisk Balanced High Availability, também é possível aumentar os limites de IOPS e de capacidade de processamento do disco.

O comando para redimensionar um disco regional é muito semelhante ao comando para redimensionar um disco zonal. No entanto, é necessário especificar uma região em vez de uma zona para o local do disco.

É possível apenas aumentar, e não diminuir, o tamanho do disco. Para diminuir o tamanho do disco, crie um novo com um tamanho menor. Até excluir o disco maior e original, haverá cobrança pelos dois discos.

Para instruções sobre como modificar um disco regional, consulte:

A seguir