Gerenciar pool de armazenamento de hiperdisco

Neste documento, explicamos como listar, descrever, modificar e excluir pools de armazenamento.

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.

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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Papéis e permissões necessárias

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

Administrador da instância da computação (v1) (roles/compute.instanceAdmin.v1)
Para se conectar a uma instância de VM que possa ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (papel roles/iam.serviceAccountUser )

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 têm as permissões necessárias para gerenciar um pool de armazenamento. Para conferir 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 gerenciar um pool de armazenamento:

Para listar os pools de armazenamento de um projeto e uma zona: compute.storagePools.list
Para listar os discos em um pool de armazenamento: compute.storagePools.get
Para ver as propriedades de um pool de armazenamento: compute.storagePools.get
Para atualizar a capacidade provisionada ou o desempenho de um pool de armazenamento:
- compute.storagePools.get
- compute.storagePools.update
Para excluir um pool de armazenamento: compute.storagePools.delete

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

Limitações

Observe as seguintes limitações ao gerenciar pools de armazenamento de hiperdisco:

É possível alterar a capacidade ou desempenho provisionado de um pool de armazenamento no máximo duas vezes em 24 horas.
Não é possível alterar o modelo de provisionamento de um pool. Não é possível mudar um pool de armazenamento de capacidade padrão para um de desempenho avançado ou um de desempenho avançado para um de desempenho padrão.
Não é permitido mover discos para dentro ou fora de um pool de armazenamento. Para mover um disco para dentro ou fora de um pool de armazenamento, é necessário recriar o disco com base em um snapshot. Para mais informações, consulte Alterar o tipo de disco.
Não é possível clonar, criar Instant Snapshots ou configurar a replicação assíncrona do Persistent Disk para discos em um pool de armazenamento.
É possível excluir no máximo cinco pools de armazenamento por hora.
O comando de gerenciamento do pool de armazenamento é bem-sucedido ou falha imediatamente, mas pode levar até cinco minutos para concluir a ação e até 30 minutos para que as alterações apareçam.

Para ver a lista completa das limitações do pool de armazenamento de hiperdisco, consulte Limitações dos pools de armazenamento.

Intervalos de valores ao modificar pools de armazenamento

Ao criar um pool de armazenamento, os novos valores de tamanho, IOPS e capacidade de processamento precisam estar dentro dos limites do tipo de pool de armazenamento que você está modificando. Além disso, só é possível especificar novos valores usando valores incrementais compatíveis.

Para limites detalhados de provisionamento de desempenho, consulte Limites de pools de armazenamento.

Listar os pools de armazenamento de um projeto

Para ver os pools de armazenamento criados em um projeto, use o console do Google Cloud, a CLI do Google Cloud ou o REST.

Console

Acesse a página Pools de armazenamento no console do Google Cloud.
Acessar a página "Pools de armazenamento"

A página exibe os pools de armazenamento criados no projeto selecionado.
Opcional: use a barra Filtro para exibir apenas os pools de armazenamento que correspondem aos parâmetros do filtro, como local, tipo, nome e capacidade restante do pool.

gcloud

Para listar todos os pools de armazenamento criados no projeto atual, use o comando gcloud compute storage-pools list.

gcloud compute storage-pools list

Para limitar os resultados a uma região ou zona específica, use a flag --filter, por exemplo:

--filter="zone ~ us
--filter="zone=us-east4-c"

REST

Para mostrar os pools de armazenamento criados em um projeto e uma zona, crie uma solicitação GET usando o método storagePools.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

Substitua:

PROJECT_ID: o ID do projeto que contém o pool de armazenamento.
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.

Listar os discos em um pool de armazenamento

Para consultar uma lista dos discos criados em um pool de armazenamento, use o console do Google Cloud, a CLI do Google Cloud ou o REST.

Console

Acesse a página Pools de armazenamento no console do Google Cloud.
Acessar a página "Pools de armazenamento"

A página exibe os pools de armazenamento criados no projeto selecionado.
No campo Nome, clique no nome do pool de armazenamento que você quer visualizar.

A página Gerenciar pool de armazenamento é aberta.
Na seção Discos do pool de armazenamento, é possível ver os discos que foram criados no pool de armazenamento.

gcloud

Para listar os discos criados em um pool de armazenamento, use o comando gcloud compute storage-pools list-disks.

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Substitua:

STORAGE_POOL_NAME: o nome do pool de armazenamento.
ZONE: opcional. A zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.

REST

Para listar os discos que estão usando um pool de armazenamento, crie uma solicitação GET usando o método storagePools.listDisks.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Substitua:

PROJECT_ID: o ID do projeto que contém o pool de armazenamento.
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do pool de armazenamento.

Descrever um pool de armazenamento

Para ver os detalhes de um pool de armazenamento, use o console do Google Cloud, a CLI do Google Cloud ou o REST.

Console

Acesse a página Pools de armazenamento no console do Google Cloud.
Acessar a página "Pools de armazenamento"
Para cada pool de armazenamento listado na página, é possível ver as seguintes informações:
- Status
- Nome
- Local
- Tipo de pool
- Capacidade do pool
- Capacidade restante do pool
- IOPS do pool
- IOPS de pool restantes
- Número de discos criados no pool
No campo Nome, clique no nome do pool de armazenamento que você quer visualizar.

A página Gerenciar pool de armazenamento é aberta.
Nos blocos na parte de cima da página, é possível conferir a capacidade provisionada e usada, a capacidade de processamento e as IOPS provisionadas e usadas para o pool de armazenamento.
Na seção Configurações do pool de armazenamento, é possível visualizar outras propriedades do pool de armazenamento, como o horário de criação, o tipo de provisionamento de capacidade, o tipo de provisionamento de desempenho, o número total de discos no pool de armazenamento e as porcentagens de utilização para capacidade, capacidade de processamento e IOPS.
Na seção Discos do pool de armazenamento, é possível ver informações sobre os discos criados no pool de armazenamento.

gcloud

Use o comando gcloud compute storage-pools describe para visualizar os detalhes de um pool de armazenamento.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Substitua:

STORAGE_POOL_NAME: o nome do pool de armazenamento exclusivo.
ZONE: opcional. A zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.

REST

Para recuperar detalhes sobre um pool de armazenamento, crie uma solicitação GET usando o método storagePools.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Substitua:

PROJECT_ID: o ID do projeto que contém o pool de armazenamento.
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do pool de armazenamento.

Atualizar a capacidade provisionada, as IOPS ou a capacidade de processamento de um pool de armazenamento

É possível aumentar ou diminuir a capacidade provisionada, as IOPS ou a capacidade de processamento de um pool de armazenamento. Para aumentar a capacidade, as IOPS ou a capacidade de processamento de um pool de armazenamento, é preciso ter uma cota disponível para o projeto e a região.

Console

Acesse a página Pools de armazenamento no console do Google Cloud.
Acessar a página "Pools de armazenamento"
No campo Nome, clique no nome do pool de armazenamento que você quer modificar.

A página Gerenciar pool de armazenamento é aberta.
Clique em Editar.

A página Editar pool de armazenamento é aberta.
Opcional: no campo Capacidade do pool de armazenamento, insira o novo valor da capacidade provisionada do pool. O novo valor precisa ser de pelo menos 1 TiB e no máximo 100 TiB acima ou abaixo do valor atual. O tamanho mínimo não pode ser menor que 10 TiB, e o máximo não pode ser maior que 1.024 TiB.
Opcional: no campo Capacidade provisionada, insira o novo valor da capacidade provisionada.
Opcional: para pools de armazenamento do tipo Hyperdisk Balanceado, no campo IOPS provisionadas, insira o novo valor das IOPS provisionadas.
Clique em Salvar para atualizar o pool de armazenamento.

gcloud

Use o comando gcloud compute storage-pools update para modificar um pool de armazenamento.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Substitua:

STORAGE_POOL_NAME: o nome do pool de armazenamento.
ZONE (opcional): a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.
POOL_SIZE: (opcional) a capacidade provisionada do pool de armazenamento, em TiB.
IOPS: (opcional) as IOPS provisionadas do pool de armazenamento. Só é possível usar essa sinalização com pools de armazenamento equilibrados de hiperdisco.
THROUGHPUT: (opcional) a capacidade de processamento provisionada do pool de armazenamento, em MBps.
DESCRIPTION (opcional): uma string descritiva para o pool de armazenamento.

REST

Para atualizar um pool de armazenamento, crie uma solicitação PATCH usando o método storagePools.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Substitua:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do pool de armazenamento.
DESCRIPTION (opcional): um campo de texto para descrever o pool de armazenamento.
SIZE: (opcional) a nova capacidade provisionada do pool de armazenamento, em GiB.
IOPS: opcional: o novo valor de IOPS provisionadas do pool de armazenamento. Só é possível especificar essa propriedade quando o pool de armazenamento contém discos do tipo hyperdisk-balanced.
THROUGHPUT: (opcional) o novo valor da capacidade de processamento provisionada do pool de armazenamento, especificado em MBps.

Excluir um pool de armazenamento

Para excluir ou remover um pool de armazenamento, primeiro você precisa excluir todos os discos dele. Em seguida, use o console do Google Cloud, a CLI do Google Cloud ou o REST para excluir o pool de armazenamento.

A exclusão de um pool de armazenamento é irreversível. No entanto, excluir um pool de armazenamento não exclui nenhum snapshot obtido de discos criados no pool de armazenamento. Os snapshots precisam ser excluídos separadamente.

Console

Acesse a página Pool de armazenamento no console do Google Cloud.
Acessar a página "Pool de armazenamento"
No campo Nome, clique no nome do pool de armazenamento que você quer remover.

A página Gerenciar pool de armazenamento é aberta.
Na seção Discos do pool de armazenamento, verifique se não há discos listados para o pool de armazenamento.
Clique em Excluir pool.

gcloud

Use o comando gcloud compute storage-pools delete para excluir um pool de armazenamento.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Substitua:

STORAGE_POOL_NAME: o nome do pool de armazenamento exclusivo.
ZONE (opcional): a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.

REST

Para remover um pool de armazenamento, crie uma solicitação DELETE para o método storagePools.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Substitua:

PROJECT_ID: o ID do projeto
ZONE: a zona em que o pool de armazenamento está localizado, por exemplo, us-central1-a.
STORAGE_POOL_NAME: o nome do pool de armazenamento exclusivo.

A seguir

Saiba mais sobre pools de armazenamento.