Modificar as configurações de um volume do Google Cloud Hyperdisk

Se a carga de trabalho exigir mais espaço de armazenamento, será possível aumentar o tamanho do volume do Google Cloud Hyperdisk. Os volumes do hiperdisco também permitem provisionar dinamicamente as características de desempenho dos discos.

Volumes de hiperdisco equilibrado (pré-lançamento): é possível especificar os níveis de IOPS e de capacidade de processamento ao criar o volume, bem como alterar esses valores a qualquer momento.
Com os volumes extremos de hiperdiscos, é possível especificar o nível de IOPS ao criar o volume e alterar esse valor a qualquer momento.
Volumes de capacidade de processamento do hiperdisco: é possível especificar o nível de capacidade ao criar o volume ou alterar esse valor a qualquer momento.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

Selecione a guia para como planeja usar as amostras nesta página:
Console

Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
```
gcloud init
```
  Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
2. Defina uma região e uma zona padrão.
REST

Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

Papéis e permissões necessárias

Para receber a permissão necessária para modificar um hiperdisco, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

administrador de instâncias 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 mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém a permissão compute.disks.update, que é necessária para modificar um hiperdisco.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Valores aceitos para volumes do Hyperdisk

A tabela a seguir mostra os valores máximo e mínimo que podem ser usados ao adicionar ou modificar volumes do Hyperdisk.

Propriedade	Hiperdisco equilibrado	Hiperdisco extremo	Capacidade de processamento do hiperdisco
Provisionamento dinâmico	IOPS e capacidade de processamento	IOPS	Capacidade de processamento
IOPS mínimas	O mínimo de 500 IOPS por GiB de capacidade de disco ou 3.000 IOPS	2 IOPS por GiB de capacidade	4 IOPS aleatórias ou 8 IOPS sequenciais por MBps de capacidade de processamento
Máximo de IOPS	500 IOPS por GiB de capacidade de disco, mas não mais que 160.000	1.000 IOPS por GiB de capacidade, mas não mais que 350.000	4 IOPS aleatórias ou 8 IOPS sequenciais por MBps de capacidade de processamento
Capacidade mínima	O maior número de IOPS dividido por 256 ou 140 MBps	256 KBps de capacidade de processamento por IOPS provisionadas	O que for maior: 10 MBps por TiB ou 20 MBps por disco
Capacidade máxima	IOPS dividido por 4, mas não mais que 2.400 MBps	256 KiBs de capacidade por IOPS provisionadas, mas não mais que 4.800 MBps	O que for menor: 90 MBps por TiB ou 600 MBps por disco
Frequência	A cada 4 horas	A cada 4 horas	A cada 4 horas
Tamanho mínimo do disco	4 GiB	64 GiB	2 TiB
Tamanho máximo do disco	64 TiB	64 TiB	32 TiB

Visão geral da modificação do hiperdisco

É possível mudar dinamicamente o tamanho do disco ou as características de desempenho dos volumes do Hyperdisk.

Mudanças de capacidade

Só é possível redimensionar um volume do hiperdisco para aumentar o tamanho dele. Não é possível reduzir a capacidade de um volume do Hyperdisk. Se você quiser diminuir o tamanho de um volume do hiperdisco, crie um volume menor, migre os dados do volume original para o menor e exclua o original.

É possível aumentar o tamanho provisionado para um volume extremo ou equilibrado do hiperdisco a cada 4 horas. Para um volume de capacidade de processamento do hiperdisco a cada seis horas. É possível redimensionar volumes do Hyperdisk mesmo que estejam anexados a uma VM em execução.

Para ter os melhores resultados, siga as etapas abaixo ao alterar a capacidade de um volume do Hyperdisk:

Aumente o tamanho do volume.
Fazer backup do disco
Redimensione as partições de disco.

Mudanças no desempenho

Depois de alterar a capacidade ou as IOPS provisionadas, pode levar até 15 minutos para que as alterações entrem em vigor. É possível alterar dinamicamente as IOPS ou a capacidade provisionadas de um volume a cada quatro horas. Alterar as IOPS ou a capacidade provisionadas para um volume de hiperdisco não exclui nem modifica dados de disco.

Modificar um volume do hiperdisco

É possível aumentar o tamanho do volume e alterar a IOPS ou a capacidade provisionada de um volume do Hyperdisk com os seguintes limites de tempo:

Aumente o tamanho do disco: uma vez a cada quatro horas para o hiperdisco extremo ou o hiperdisco balanceado, uma vez a cada seis horas para a capacidade de processamento do hiperdisco.
Modificar as IOPS ou a capacidade de processamento provisionadas: uma vez a cada quatro horas

Se você tentar alterar o disco antes do prazo de quatro horas, receberá uma mensagem de erro como Cannot update provisioned throughput due to being rate limited.

Console

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

Acessar "Discos"
Na lista de discos do projeto, clique no nome do volume do hiperdisco para o qual você quer alterar a capacidade ou o desempenho provisionado.
Na página de detalhes do disco, clique em Editar.
1. No campo Tamanho, insira o novo tamanho do disco. O tamanho do disco precisa estar no intervalo de valores compatíveis.
2. Para hiperdisco extremo e hiperdisco equilibrado (pré-lançamento): no campo IOPS provisionadas, insira o novo valor de IOPS do volume.
3. Para a capacidade de processamento do hiperdisco e o hiperdisco equilibrado: no campo Capacidade de processamento provisionada, insira o novo valor de capacidade para o volume.
Clique em Salvar para aplicar as mudanças ao disco.

gcloud

Use o comando disks update e especifique as sinalizações --size, --provisioned-iops ou --provisioned-throughput.

gcloud compute disks update DISK_NAME  \
    --size=DISK_SIZE  \
    --provisioned-iops=IOPS_LIMIT  \
    --provisioned-throughput=THROUGHPUT_LIMIT

Substitua:

DISK_NAME: o nome do volume do hiperdisco que você está modificando.
DISK_SIZE (opcional): o novo tamanho do disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. O tamanho do disco precisa estar no intervalo de valores compatíveis.
IOPS_LIMIT (opcional): a configuração de IOPS para os volumes de hiperdisco extremo e equilibrado (pré-lançamento). O valor precisa estar no intervalo de valores compatíveis.
THROUGHPUT_LIMIT (opcional): a configuração para o volume de capacidade de processamento ou balanceamento de hiperdisco do hiperdisco, especificado como um número inteiro que representa a capacidade medida em MiB por segundo. O valor precisa estar no intervalo de valores compatíveis.

REST

Crie uma solicitação POST para o método compute.disks.update. No corpo da solicitação, especifique os parâmetros sizeGb, provisionedIops ou provisionedThroughput.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/update
{
   "sizeGb": "DISK_SIZE,
   "provisionedIops": "IOPS_LIMIT",
   "provisionedThroughput": "THROUGHPUT_LIMIT"
}

Substitua:

PROJECT_ID: o ID do projeto.
ZONE: a zona em que o volume do hiperdisco está localizado.
DISK_NAME: o nome do volume do hiperdisco a ser modificado.
DISK_SIZE (opcional): o novo tamanho do disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. O tamanho do disco precisa estar no intervalo de valores compatíveis.
IOPS_LIMIT: opcional: a configuração de IOPS para o volume de hiperdisco extremo ou hiperdisco equilibrado (pré-lançamento). O valor precisa estar no intervalo de valores compatíveis.
THROUGHPUT_LIMIT (opcional): a configuração para o volume de capacidade de processamento ou balanceamento de hiperdisco do hiperdisco, especificado como um número inteiro que representa a capacidade medida em MiB por segundo. O valor precisa estar no intervalo de valores compatíveis.

Fazer backup do volume do Hyperdisk

O redimensionamento de um disco não exclui nem modifica os dados dele. No entanto, como prática recomendada, sempre faça um backup do disco criando um snapshot antes de fazer alterações no sistema de arquivos ou partições.

Redimensionar o sistema de arquivos e as partições

Depois de aumentar o tamanho do volume do hiperdisco, talvez seja necessário redimensionar o sistema de arquivos e as partições dele. Para mais informações, consulte Redimensionar o sistema de arquivos e as partições na documentação do Persistent Disk.

A seguir

Saiba mais sobre o Hyperdisk.
Saiba como analisar o nível atual de IOPS de um volume do Hyperdisk.