Este documento discute como executar determinadas tarefas em um disco. Para executar qualquer uma das tarefas a seguir, você deve criar um novo disco. Você não pode fazer as seguintes alterações em um disco.
- Altere o tipo de disco, por exemplo, altere um volume de rendimento de hiperdisco para um volume balanceado de hiperdisco.
- Altere o tipo de criptografia do disco, por exemplo, modifique a criptografia de um disco usando chaves geradas pelo Google para chaves de criptografia gerenciadas pelo cliente (CMEK).
- Mova um disco para dentro ou para fora de um pool de armazenamento de hiperdisco .
Siga estas etapas para executar qualquer uma das tarefas mencionadas anteriormente:
- Crie um instantâneo do disco existente.
- Crie um novo disco do tipo correto ou dentro de um pool de armazenamento (referido como seu posicionamento ), usando o instantâneo como fonte de dados do disco.
- Depois de verificar o novo disco, você poderá excluir o disco original.
Antes de começar
Se desejar colocar os novos volumes de hiperdisco em um conjunto de armazenamento, revise a documentação para conjuntos de armazenamento, especialmente:
- Tipos de pools de armazenamento de hiperdisco
- Suporte a tipo de máquina e disponibilidade regional para pools de armazenamento de taxa de transferência de hiperdisco e pools de armazenamento balanceados de hiperdisco
- Limitações para a criação de discos em um pool de armazenamento de hiperdisco
- 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.
- Administrador de instância do Compute (v1) (
roles/compute.instanceAdmin.v1
) - Para se conectar a uma VM que pode ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (
roles/iam.serviceAccountUser
) - Para criar um instantâneo do disco:
-
compute.snapshots.create
no projeto -
compute.disks.createSnapshot
no disco
-
- Para criar um novo disco:
compute.disks.create
no projeto - Para criar um disco em um pool de armazenamento:
-
compute.storagePools.use
no projeto -
compute.disks.create
no projeto
-
- Para anexar um disco a uma VM:
-
compute.instances.attachDisk
na VM -
compute.disks.use
no volume que você deseja anexar à VM
-
- Para excluir um disco:
compute.disks.delete
no projeto Prepare-se para criar um instantâneo de disco:
- Revise as práticas recomendadas para snapshots de disco do Compute Engine para preparar seu disco para snapshot.
- Leia Criar agendamentos para instantâneos de disco para saber como criar um agendamento de snapshot e anexá-lo aos seus discos. Fazer backup de seus discos regularmente com snapshots agendados pode reduzir o risco de perda inesperada de dados.
Importante: Se você pausar seus aplicativos antes de criar uma captura instantânea, retome suas cargas de trabalho somente depois que o recurso de captura instantânea atingir o status
UPLOADING
.Para obter mais informações, consulte a tabela em Criando manualmente capturas instantâneas consistentes de aplicativo .
Crie um instantâneo do seu disco existente.
- Opcional: Para criar novos hiperdiscos em um conjunto de armazenamento, você deverá criar um conjunto de armazenamento , se não existir um.
Vá para a página Discos .
Vá para discos- Clique em + Criar disco .
Em Tipo de disco , selecione Hyperdisk Extreme , Hyperdisk Throughput ou Hyperdisk Balanced .
Opcional: Para usar conjuntos de armazenamento, selecione Hyperdisk Balanced ou Hyperdisk Throughput.
- Para Disk source type , selecione Snapshot e selecione o nome do snapshot a ser restaurado.
- Especifique o tamanho do novo disco, em GiB. Esse número deve ser igual ou maior que o disco de origem original do snapshot.
Opcional: altere os padrões, se estiver alterando o tipo de disco:
- Hiperdisco balanceado: altere o valor de IOPS provisionadas e o valor de taxa de transferência provisionada .
- Hyperdisk Extreme: altere o valor de IOPS provisionadas .
- Taxa de transferência do hiperdisco: altere o valor da taxa de transferência provisionada .
Opcional: Para criar o novo disco em um conjunto de armazenamento:
- Na seção Pool de armazenamento , selecione Habilitar pool de armazenamento .
Escolha o nome do pool de armazenamento no qual criar o disco.
Somente conjuntos de armazenamento existentes na zona selecionada aparecem na lista.
- Clique em Criar para criar o novo disco.
- Depois de criar o disco, você poderá anexá-lo a qualquer instância de computação em execução ou interrompida.
Prepare-se para criar um instantâneo de disco:
- Revise as práticas recomendadas para snapshots de disco do Compute Engine para preparar seu disco para snapshot.
- Leia Criar agendamentos para instantâneos de disco para saber como criar um agendamento de snapshot e anexá-lo aos seus discos. Fazer backup de seus discos regularmente com snapshots agendados pode reduzir o risco de perda inesperada de dados.
Importante: Se você pausar seus aplicativos antes de criar uma captura instantânea, retome suas cargas de trabalho somente depois que o recurso de captura instantânea atingir o status
UPLOADING
.Para obter mais informações, consulte a tabela em Criando manualmente capturas instantâneas consistentes de aplicativo .
Crie um instantâneo do seu disco existente.
Use o comando
disks create
para criar um volume de hiperdisco a partir de sua captura instantânea.gcloud compute disks create DISK_NAME \ --zone=ZONE \ --storage-pool=STORAGE_POOL_NAME \ --size=SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE \ --provisioned-iops=PROVISIONED_IOPS \ --provisioned-throughput=PROVISIONED_THROUGHPUT
Substitua o seguinte:
- DISK_NAME : um nome exclusivo para o disco. Você 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 você deseja criar o disco. Se desejar criar o disco em um conjunto de armazenamento, você deverá especificar a zona onde o conjunto de armazenamento está localizado. Especifique esse valor no formato região-zona, por exemplo
us-central1-a
. - STORAGE_POOL_NAME : Opcional: o nome do pool de armazenamento no qual criar o disco. Se você não incluir esse parâmetro, um hiperdisco independente será criado.
- SIZE : Opcional: a capacidade provisionada do novo disco. O tamanho deve ser maior ou igual ao tamanho do disco permanente de origem. O valor deve ser um número inteiro seguido por uma unidade de tamanho GB para gibibyte ou TB para tebibyte. Se nenhum tamanho for especificado, 100 GB será usado como valor padrão.
- SNAPSHOT_NAME : o nome do instantâneo que você criou a partir do disco original.
- DISK_TYPE : o tipo de disco a ser criado. Se estiver criando um disco em um conjunto de armazenamento, esse valor deverá corresponder ao tipo do conjunto de armazenamento de hiperdisco, seja
hyperdisk-balanced
ouhyperdisk-throughput
. - PROVISIONED_IOPS : Opcional: o IOPS a ser provisionado para o disco. Você pode usar esse parâmetro somente ao criar um disco Hyperdisk Balanced ou Hyperdisk Extreme.
- PROVISIONED_THROUGHPUT : Opcional: para discos Hyperdisk Balanced e Hyperdisk Throughput, o rendimento em megabyte (MB) por segundo para provisionar o disco. O valor deve ser um número inteiro positivo.
Depois de criar o disco, você poderá anexá-lo a qualquer instância de computação em execução ou interrompida.
Construa uma solicitação
POST
para criar um hiperdisco zonal usando o métododisks.insert
. Inclua as propriedadesname
,sizeGb
,type
esourceSnapshot
.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", "sourceSnapshot": "SNAPSHOT_NAME", "provisionedIops": "IOPS_LIMIT", "provisionedThroughput": "THROUGHPUT_LIMIT", "accessMode": "DISK_ACCESS_MODE" }
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
ZONE
: a zona onde sua instância de computação e seu novo disco estão localizados -
DISK_NAME
: o nome do novo disco -
DISK_SIZE
: Opcional: o tamanho do novo disco. O valor deve ser um número inteiro seguido por uma unidade de tamanho GB para gibibytes ou TB para tebibytes. -
DISK_TYPE
: o tipo de disco. Para criar um volume de hiperdisco, use um dos seguintes valores:hyperdisk-balanced
,hyperdisk-extreme
,hyperdisk-ml
ouhyperdisk-throughput
. -
IOPS_LIMIT
: Opcional: para Hyperdisk Balanced e Hyperdisk Extreme, este é o número de operações de E/S por segundo que o disco pode manipular. -
THROUGHPUT_LIMIT
: Opcional: para volumes Hyperdisk Balanced, Hyperdisk ML ou Hyperdisk Throughput, este é um número inteiro que representa o rendimento, medido em MiB por segundo, que o disco pode manipular. DISK_ACCESS_MODE
: como as instâncias de computação podem acessar os dados no disco. Os valores suportados são:-
READ_WRITE_SINGLE
, para acesso de leitura e gravação de uma instância. Este é o valor padrão. -
READ_WRITE_MANY
, para acesso de leitura e gravação de múltiplas instâncias. -
READ_ONLY_MANY
, para acesso somente leitura de múltiplas instâncias.
Você pode definir o modo de acesso para os seguintes tipos de disco:
- Hiperdisco balanceado
- ML de hiperdisco
- Alta disponibilidade balanceada de hiperdisco ( visualização )
-
-
Opcional: Use o método
compute.disks.get
para ver uma descrição do seu disco.Depois de criar o disco, você poderá anexá-lo a qualquer instância de computação em execução ou interrompida.
Prepare-se para criar um instantâneo de disco:
- Revise as práticas recomendadas para snapshots de disco do Compute Engine para preparar seu disco para snapshot.
- Leia Criar agendamentos para instantâneos de disco para saber como criar um agendamento de snapshot e anexá-lo aos seus discos. Fazer backup de seus discos regularmente com snapshots agendados pode reduzir o risco de perda inesperada de dados.
Importante: Se você pausar seus aplicativos antes de criar uma captura instantânea, retome suas cargas de trabalho somente depois que o recurso de captura instantânea atingir o status
UPLOADING
.Para obter mais informações, consulte a tabela em Criando manualmente capturas instantâneas consistentes de aplicativo .
Crie um instantâneo do seu disco existente.
Vá para a página Discos .
Vá para discos- Clique em + Criar disco .
- Especifique um nome para o disco.
- No campo Local , escolha Regional .
Especifique a zona primária do disco nos campos Região e Zona .
O disco deve estar na mesma região que a instância de computação à qual você planeja anexá-lo.
- Especifique a zona secundária no campo Zona de réplica .
- Para Disk source type , selecione Snapshot e selecione o nome do snapshot a ser restaurado.
Em Tipo de disco , selecione Alta disponibilidade balanceada de hiperdisco .
Se você não vir o tipo de disco Hyperdisk Balanced High Availability na lista, talvez seja necessário escolher uma região que ofereça discos Hyperdisk Balanced High Availability .
- Especifique o tamanho do novo disco, em GiB. Esse número deve ser igual ou maior que o disco de origem original do snapshot.
Opcional: altere os valores padrão de IOPS provisionadas e de taxa de transferência provisionada para o novo disco:
- Clique em Criar para criar o novo disco.
- Depois de criar o disco, você poderá anexá-lo a qualquer instância de computação em execução ou interrompida.
Prepare-se para criar um instantâneo de disco:
- Revise as práticas recomendadas para snapshots de disco do Compute Engine para preparar seu disco para snapshot.
- Leia Criar agendamentos para instantâneos de disco para saber como criar um agendamento de snapshot e anexá-lo aos seus discos. Fazer backup de seus discos regularmente com snapshots agendados pode reduzir o risco de perda inesperada de dados.
Importante: Se você pausar seus aplicativos antes de criar uma captura instantânea, retome suas cargas de trabalho somente depois que o recurso de captura instantânea atingir o status
UPLOADING
.Para obter mais informações, consulte a tabela em Criando manualmente capturas instantâneas consistentes de aplicativo .
Crie um instantâneo do seu disco existente.
Use o comando
disks create
para criar um disco de alta disponibilidade balanceada de hiperdisco a partir de sua captura instantânea.gcloud compute disks create DISK_NAME \ --size=SIZE \ --type=hyperdisk-balanced-high-availability \ --source-snapshot=SNAPSHOT_NAME \ --provisioned-iops=PROVISIONED_IOPS \ --provisioned-throughput=PROVISIONED_THROUGHPUT \ --region=REGION \ --replica-zones=ZONE1,ZONE2
Substitua o seguinte:
-
DISK_NAME
: um nome exclusivo para o disco. -
SIZE
: Opcional: a capacidade provisionada do novo disco. O tamanho deve ser maior ou igual ao tamanho do disco de origem. O valor deve ser um número inteiro seguido por uma unidade de tamanho GB para gibibyte ou TB para tebibyte. -
SNAPSHOT_NAME
: o nome do instantâneo que você criou a partir do disco original. -
PROVISIONED_IOPS
: opcional: o IOPS a ser provisionado para o disco. -
PROVISIONED_THROUGHPUT
: Opcional: o rendimento em megabyte (MB) por segundo para provisionar o disco. -
REGION
: a região onde o disco regional residirá, por exemplo:europe-west1
-
ZONE1
,ZONE2
: as zonas dentro da região onde as duas réplicas de disco estão localizadas, por exemplo:europe-west1-b,europe-west1-c
-
-
PROJECT_ID
: o ID do seu projeto -
REGION
: a região onde o disco regional residirá, por exemplo:europe-west1
-
DISK_NAME
: o nome do novo disco -
SNAPSHOT_NAME
: o nome do instantâneo que você criou a partir do disco original. -
ZONE1
,ZONE2
: as zonas onde as réplicas do novo disco devem estar localizadas, por exemplo:europe-west1-b,europe-west1-c
-
DISK_SIZE
: o tamanho, em GiB, do novo disco - Saiba mais sobre o hiperdisco .
- Saiba mais sobre pools de armazenamento .
- Aprenda como gerenciar volumes de hiperdisco .
- Compare o desempenho do seu novo hiperdisco .
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.
Funções e permissões necessárias
Para obter as permissões necessárias para alterar o tipo de disco, peça ao administrador para conceder a você as seguintes funções do IAM no projeto:
Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .
Essas funções predefinidas contêm as permissões necessárias para alterar o tipo de disco. Para ver 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 alterar o tipo de disco:
Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .
Alterar o tipo ou posicionamento de um disco
Para migrar um volume de disco permanente para um hiperdisco ou para recriar um disco dentro ou fora de um pool de armazenamento, crie um instantâneo do disco e use-o ao criar um novo disco.
Ao criar um novo volume de hiperdisco, você pode criá-lo como um disco independente ou pode criar o disco em um pool de armazenamento, se existir.
Console
gcloud
DESCANSAR
Alterar um disco zonal para um disco regional de alta disponibilidade balanceada de hiperdisco
Para alterar um disco zonal para um disco de alta disponibilidade balanceada de hiperdisco, crie um instantâneo do disco zonal e use o instantâneo como origem ao criar o disco regional.
Console
gcloud
Terraforma
Para criar um volume de alta disponibilidade balanceada de hiperdisco, você pode usar o recurso
google_compute_region_disk
, conforme mostrado no exemplo a seguir, mas altere o tipo de disco depd-ssd
parahyperdisk-balanced-high-availability
.DESCANSAR
Para criar um volume de alta disponibilidade balanceada de hiperdisco, construa uma solicitação
POST
para o métodocompute.regionDisks.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_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/hyperdisk-balanced-high-availability" }
Substitua o seguinte:
Torne o novo disco acessível à sua instância de VM
Depois de criar o disco, você deverá anexá-lo ou anexar o disco regional à sua instância de computação antes de poder usá-lo.
Como o novo disco criado não é um disco vazio, depois de anexar o disco a uma instância, você só precisa montar o disco para disponibilizá-lo ao sistema operacional.
Para obter informações sobre como montar o disco, consulte o seguinte:
Remova o disco original
Depois de verificar o novo disco, você pode:
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-21 UTC.
-