Você pode criar um volume de disco permanente em branco ou criar um disco a partir de uma fonte de dados . Você pode usar o disco permanente como um disco de inicialização para uma instância de máquina virtual (VM) ou como um disco de dados anexado a uma VM.
Este documento explica como criar um volume de disco permanente zonal em branco e sem inicialização e anexá-lo à sua VM.
Para outros tipos de criação e adição de disco, consulte o seguinte:
Para criar um disco de inicialização que você possa usar posteriormente para criar uma VM, consulte Criar um disco de inicialização personalizado .
Para adicionar um disco do Google Cloud Hyperdisk à sua VM, consulte Adicionar armazenamento de hiperdisco a uma VM .
Para adicionar um disco a uma VM que faz parte de um grupo de instâncias gerenciadas (MIG), consulte Atualizar a configuração da VM em um MIG .
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Durante a criação da VM, você pode anexar até 127 volumes secundários de discos permanentes zonais sem inicialização.
- Você pode ter uma capacidade total anexada de 257 TB por VM. Para obter informações sobre como garantir desempenho máximo com volumes grandes, consulte Tamanho do volume lógico .
Acesse a página de instâncias de VM .
Clique no nome da VM onde você deseja adicionar um disco.
Na página de detalhes, clique em Editar .
Em Discos adicionais , clique em Adicionar novo disco .
Especifique um nome para o disco, configure as propriedades do disco e selecione Em branco como Tipo de origem .
Opcional: sob o título Nome do dispositivo , selecione a opção Usar um nome de dispositivo personalizado . O nome inserido é usado para gerar um link simbólico para o disco, o que facilita a identificação do disco.
Clique em Concluído para concluir a configuração do disco.
Clique em Salvar para aplicar suas alterações à VM e adicionar o novo disco.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Use o comando
gcloud compute disks create
para criar o volume zonal do disco permanente.gcloud compute disks create DISK_NAME \ --size DISK_SIZE \ --type DISK_TYPE
Substitua o seguinte:
-
DISK_NAME
: o nome do novo disco. -
DISK_SIZE
: o tamanho, em gigabytes, do novo disco. Os tamanhos aceitáveis variam, em incrementos de 1 GB, de 10 GB a 65.536 GB inclusive. -
DISK_TYPE
: URL completo ou parcial para o tipo de volume do disco permanente. Por exemplo,https://www.googleapis.com/compute/v1/projects/ PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
.
-
Depois de criar o disco, anexe-o a qualquer VM em execução ou interrompida. Use o comando
gcloud compute instances attach-disk
:gcloud compute instances attach-disk VM_NAME \ --disk DISK_NAME --device-name=DEVICE_NAME
Substitua o seguinte:
-
VM_NAME
: o nome da VM onde você está adicionando o novo volume zonal do disco permanente -
DISK_NAME
: o nome do novo disco que você está anexando à VM. -
DEVICE_NAME
: opcional: um nome que o sistema operacional convidado usa para identificar o disco.
-
Use o comando
gcloud compute disks describe
para ver uma descrição do seu disco.Crie uma solicitação
POST
para criar um disco permanente zonal usando o métododisks.insert
. Inclua as propriedadesname
,sizeGb
etype
. Para criar este disco como um disco sem inicialização vazio e não formatado, não especifique uma imagem de origem ou 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": "DISK_TYPE" }
Substitua o seguinte:
-
PROJECT_ID
: seu ID do projeto. -
ZONE
: a zona onde sua VM e o novo disco estão localizados. -
DISK_NAME
: o nome do novo disco. -
DISK_SIZE
: o tamanho, em gigabytes, do novo disco. Os tamanhos aceitáveis variam, em incrementos de 1 GB, de 10 GB a 65.536 GB inclusive. -
DISK_TYPE
: URL completo ou parcial para o tipo de disco permanente. Por exemplo,https://www.googleapis.com/compute/v1/projects/ PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
.
-
Crie uma solicitação POST para o método
compute.instances.attachDisk
e inclua o URL para o volume zonal do disco permanente que você acabou de criar:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk { "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME", "deviceName": DEVICE_NAME }
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
ZONE
: a zona onde sua VM e o novo disco estão localizados -
VM_NAME
: o nome da VM onde você está adicionando o novo volume do disco permanente -
DISK_NAME
: o nome do novo disco -
DEVICE_NAME
: opcional: um nome que o sistema operacional convidado usa para identificar o disco.
-
- Aprenda como formatar e montar seus novos discos em uma VM Linux .
- Aprenda como formatar e montar seus novos discos em uma VM do Windows .
- Aprenda como redimensionar os volumes do disco permanente .
- Aprenda como fazer backup regularmente de seus discos usando instantâneos para evitar perda de dados não intencional.
- Saiba mais sobre o disco permanente regional , que fornece replicação síncrona entre duas zonas.
Terraform
Para usar os exemplos do Terraform nesta página em um ambiente de desenvolvimento local, instale e inicialize a gcloud CLI e, em seguida, configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Restrições
Adicionando um disco que não é de inicialização à sua VM
Crie e anexe um disco zonal sem inicialização usando o console do Google Cloud , a CLI do Google Cloud ou REST .
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
.Você deve especificar um nome de dispositivo personalizado ao anexar o disco a uma VM. O nome especificado é usado para gerar um link simbólico para o disco no sistema operacional convidado, facilitando a identificação.
Console
gcloud
Terraforma
Para criar um disco, use o recurso
google_compute_disk
.Para anexar o disco a uma VM, use o recurso
google_compute_instance
.Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform .
DESCANSAR
Depois de criar o novo disco e anexá-lo a uma VM, você deverá formatar e montar o disco, para que o sistema operacional possa usar o espaço de armazenamento disponível.
O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-17 UTC.
-