Gerenciar pools de hiperdisco

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

Observação: os Exapools do Hyperdisk estão disponíveis para o público em geral com uma lista de permissões. Para modificar ou excluir um Exapool, entre em contato com sua equipe de conta.

Antes de começar

• Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

  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. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:

     gcloud init

     Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

     Observação: se você já instalou a gcloud CLI, execute o comando gcloud components update para verificar se você tem a versão mais recente.
  2. Set a default region and zone.

  REST

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

  Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:

  gcloud init

  Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

  Observação: se você já instalou a gcloud CLI, execute o comando gcloud components update para verificar se você tem a versão mais recente.

  Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Papéis e permissões necessárias

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

• Administrador da instância do Compute (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 contêm as permissões necessárias para gerenciar um pool. 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 gerenciar um pool:

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

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

Limitações

Limitações para gerenciar pools:

• Não é possível mudar o modelo de provisionamento de um pool. Por exemplo, não é possível mudar um pool de armazenamento de capacidade padrão para um de capacidade avançada ou um de desempenho avançado para um de desempenho padrão.
• Não é possível mover discos para dentro ou para fora de um pool. Para mover um disco para dentro ou fora de um pool, é 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 para discos em um pool.

Limitações específicas dos pools de armazenamento:

• É possível mudar a capacidade ou o desempenho provisionado de um pool de armazenamento no máximo duas vezes em um período de 24 horas.
• É 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 mudanças apareçam.

Limitações específicas dos Exapools:

• Entre em contato com sua equipe de conta para mudar a capacidade provisionada, os IOPS ou a taxa de transferência de uma Exapool.
• Entre em contato com sua equipe de conta para excluir um Exapool.

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

Intervalos de valores ao modificar pools

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.

Listar os pools de um projeto

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

Console

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

2. Selecione a guia Exapools ou Pools de armazenamento.

   A página mostra os pools criados no projeto selecionado.

3. Opcional: use a barra Filtro para exibir apenas os pools que correspondem aos parâmetros do filtro, como local, tipo, nome e capacidade restante do pool.

gcloud

Para listar todos os pools 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 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 está localizado, por exemplo, us-central1-a.

Listar os discos em um pool

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

Console

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

2. Selecione a guia Exapools ou Pools de armazenamento.

   A página mostra os pools criados no projeto selecionado.

3. No campo Nome, clique no nome do pool que você quer visualizar.

   A página Gerenciar pool de armazenamento é aberta.

4. Na seção Discos do pool de armazenamento, é possível ver os discos que foram criados no pool.

gcloud

Para listar os discos criados em um pool, 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.
• ZONE: opcional. A zona em que o pool está localizado, por exemplo, us-central1-a.

REST

Para listar os discos que estão usando um pool, 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 está localizado, por exemplo, us-central1-a.
• STORAGE_POOL_NAME: o nome do pool.

Descrever um pool

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

Console

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

2. Selecione a guia Exapools ou Pools de armazenamento.

3. Para cada pool 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

4. No campo Nome, clique no nome do pool que você quer visualizar.

   A página Gerenciar pool de armazenamento é aberta.

5. 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.

6. Na seção Configurações do pool de armazenamento, é possível visualizar outras propriedades do pool, 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 e as porcentagens de utilização para capacidade, capacidade de processamento e IOPS.

7. Na seção Discos do pool de armazenamento, é possível ver informações sobre os discos criados no pool.

8. Opcional: para mais informações sobre o uso do pool, clique na guia Monitoring para ver gráficos de várias métricas do pool. Para mais informações, consulte Monitorar pools.

gcloud

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

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

Substitua:

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

REST

Para recuperar detalhes sobre um pool, 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
• ZONE: a zona em que o pool está localizado, por exemplo, us-central1-a.
• STORAGE_POOL_NAME: o nome do pool

Modificar um pool

É possível aumentar ou diminuir a capacidade provisionada, as IOPS ou a capacidade de processamento de um pool.

Modificar 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. Pode levar até 30 minutos para que os novos valores de provisionamento sejam exibidos para o pool de armazenamento.

Console

1. Acesse a página Pools de armazenamento no console do Google Cloud .
   Acessar a página Pools de armazenamento
2. Selecione a guia Pools de armazenamento.

3. No campo Nome, clique no nome do pool de armazenamento que você quer modificar.

   A página Gerenciar pool de armazenamento é aberta.

4. Clique em Editar.

   A página Editar pool de armazenamento é aberta.

5. 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.

6. Opcional: no campo Capacidade provisionada, insira o novo valor da capacidade provisionada.

7. Opcional: para pools de armazenamento equilibrado por hiperdisco, no campo IOPS provisionadas, insira o novo valor das IOPS provisionadas.

8. 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.
• ZONE (opcional): a zona em que o pool está localizado, por exemplo, us-central1-a.
• POOL_SIZE: (opcional) a capacidade provisionada do pool, em TiB.
• IOPS: opcional: as IOPS provisionadas pelo pool. Só é possível usar essa sinalização com pools de armazenamento equilibrados de hiperdisco.
• THROUGHPUT: (opcional) a capacidade de processamento provisionada do pool, em MiB/s.
• DESCRIPTION (opcional): uma string descritiva para o pool.

REST

Para atualizar um pool, 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 está localizado, por exemplo, us-central1-a.
• STORAGE_POOL_NAME: o nome do pool.
• DESCRIPTION (opcional): um campo de texto para descrever o pool.
• SIZE: (opcional) a nova capacidade provisionada do pool, em GiB.
• IOPS: opcional: o novo valor de IOPS provisionadas do pool. Só é possível especificar essa propriedade quando o pool contém discos do tipo hyperdisk-balanced.
• THROUGHPUT: opcional: o novo valor da capacidade de processamento provisionada do pool, especificado em MiB/s.

Modificar uma Exapool

Para mudar a capacidade provisionada, as IOPS ou a capacidade de processamento de uma Exapool, entre em contato com sua equipe de conta.

Excluir um pool

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

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 Google Cloud , a Google Cloud CLI ou a REST para excluir o pool de armazenamento.

Console

1. Acesse a página Pools de armazenamento no console do Google Cloud .
   Acessar a página Pools de armazenamento
2. 1. Selecione a guia Pools de armazenamento.

3. No campo Nome, clique no nome do pool de armazenamento que você quer excluir.

   A página Gerenciar pool de armazenamento é aberta.

4. Na seção Discos do pool de armazenamento, verifique se não há discos listados para o pool de armazenamento.

5. Clique em Excluir pool.

gcloud

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

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

Substitua:

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

REST

Para remover um pool, 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 está localizado, por exemplo, us-central1-a.
• STORAGE_POOL_NAME: o nome exclusivo do pool.

Excluir uma Exapool

Para excluir um Exapool, entre em contato com sua equipe de conta.

A seguir

• Saiba mais sobre os pools do Hyperdisk.