Faça a gestão do conjunto de armazenamento do Hyperdisk

Este documento explica como listar, descrever, modificar e eliminar pools de armazenamento.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções e autorizações necessárias

Para receber as autorizações de que precisa para gerir um conjunto de armazenamento, peça ao seu administrador para lhe conceder as seguintes funções da IAM no projeto:

  • Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)
  • Para se ligar a uma instância de VM que pode ser executada como uma conta de serviço: Utilizador da conta de serviço (v1) (função roles/iam.serviceAccountUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para gerir um conjunto de armazenamento. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para gerir um conjunto de armazenamento:

  • Para listar os conjuntos de armazenamento de um projeto e uma zona: compute.storagePools.list
  • Para listar os discos num conjunto de armazenamento: compute.storagePools.get
  • Para ver as propriedades de um conjunto de armazenamento: compute.storagePools.get
  • Para atualizar a capacidade aprovisionada ou o desempenho de um conjunto de armazenamento:
    • compute.storagePools.get
    • compute.storagePools.update
  • Para eliminar um conjunto de armazenamento: compute.storagePools.delete

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Limitações

Tenha em atenção as seguintes limitações ao gerir pools de armazenamento Hyperdisk:

  • Pode alterar a capacidade aprovisionada ou o desempenho de um conjunto de armazenamento, no máximo, duas vezes num período de 24 horas.
  • Não pode alterar o modelo de aprovisionamento de um conjunto. Não pode alterar um conjunto de armazenamento de capacidade padrão para um conjunto de armazenamento de capacidade avançada nem um conjunto de armazenamento de desempenho avançado para um conjunto de armazenamento de desempenho padrão.
  • Não é permitido mover discos para dentro ou para fora de um conjunto de armazenamento. Para mover um disco para dentro ou para fora de um pool de armazenamento, tem de recriar o disco a partir de um instantâneo. Para mais informações, consulte o artigo Altere o tipo de disco.
  • Não pode clonar, criar instantâneos nem configurar a replicação assíncrona para discos num conjunto de armazenamento.
  • Pode eliminar, no máximo, 5 conjuntos de armazenamento por hora.
  • O comando de gestão do conjunto de armazenamento tem êxito ou falha imediatamente, mas pode demorar até 5 minutos a concluir a ação e até 30 minutos para que as alterações apareçam.

Para ver a lista completa das limitações do conjunto de armazenamento do Hyperdisk, consulte o artigo Limitações dos conjuntos de armazenamento.

Intervalos de valores ao modificar pools de armazenamento

Quando criar um conjunto de armazenamento, os novos valores de tamanho, IOPS e débito têm de estar dentro dos limites do tipo de conjunto de armazenamento que está a modificar. Além disso, só pode especificar novos valores através de valores incrementais suportados.

Para ver limites de aprovisionamento de desempenho detalhados, consulte o artigo Limites para conjuntos de armazenamento.

Apresenta as pools de armazenamento de um projeto

Para ver os conjuntos de armazenamento que foram criados num projeto, use a Google Cloud consola, a Google Cloud CLI ou o REST.

Consola

  1. Aceda à página Pools de armazenamento na Google Cloud consola.
    Aceda à página Pools de armazenamento

    A página apresenta os conjuntos de armazenamento criados no projeto selecionado.

  2. Opcional: use a barra de Filtro para apresentar apenas os conjuntos de armazenamento que correspondem aos parâmetros de filtro, como Localização, Tipo, Nome e capacidade restante do conjunto.

gcloud

Para apresentar uma lista de todos os conjuntos 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, pode usar a flag --filter , por exemplo:

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

REST

Para mostrar os conjuntos de armazenamento criados num projeto e numa zona, crie um GET pedido através do storagePools.list método.

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

Substitua o seguinte:

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

Liste os discos num conjunto de armazenamento

Para obter uma lista dos discos criados num conjunto de armazenamento, use aGoogle Cloud consola, a Google Cloud CLI ou o REST.

Consola

  1. Aceda à página Pools de armazenamento na Google Cloud consola.
    Aceda à página Pools de armazenamento

    A página apresenta os conjuntos de armazenamento criados no projeto selecionado.

  2. No campo Nome, clique no nome do conjunto de armazenamento que quer ver.

    É aberta a página Gerir conjunto de armazenamento.

  3. Na secção Discos do conjunto de armazenamento, pode ver os discos que foram criados no conjunto de armazenamento.

gcloud

Para listar os discos que foram criados num conjunto de armazenamento, use o comando gcloud compute storage-pools list-disks.

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

Substitua o seguinte:

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

REST

Para listar os discos que estão a usar um conjunto de armazenamento, crie um pedido GET com o método storagePools.listDisks.

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

Substitua o seguinte:

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

Descreva um conjunto de armazenamento

Para ver os detalhes de um conjunto de armazenamento, pode usar a Google Cloud consola, a Google Cloud CLI ou o REST.

Consola

  1. Aceda à página Pools de armazenamento na Google Cloud consola.
    Aceda à página Pools de armazenamento

  2. Para cada conjunto de armazenamento apresentado na página, pode ver as seguintes informações:

    • Estado
    • Nome
    • Localização
    • Tipo de piscina
    • Capacidade da piscina
    • Capacidade restante do conjunto
    • IOPS do conjunto
    • IOPS restantes do conjunto
    • Número de discos criados no conjunto

  3. No campo Nome, clique no nome do conjunto de armazenamento que quer ver.

    É aberta a página Gerir conjunto de armazenamento.

  4. Nos mosaicos na parte superior da página, pode ver a capacidade aprovisionada e usada, bem como o débito e os IOPS aprovisionados e usados para o conjunto de armazenamento.

  5. Na secção Definições do conjunto de armazenamento, pode ver propriedades adicionais do conjunto de armazenamento, como a hora de criação, o tipo de aprovisionamento de capacidade, o tipo de aprovisionamento de desempenho, o número total de discos no conjunto de armazenamento e as percentagens de utilização da capacidade, da taxa de transferência e das IOPS.

  6. Na secção Discos do conjunto de armazenamento, pode ver informações sobre os discos criados no conjunto de armazenamento.

  7. Opcional: para ver informações adicionais sobre a utilização do conjunto de armazenamento, pode clicar no separador Monitorização para ver gráficos de várias métricas do conjunto de armazenamento. Para mais informações, consulte o artigo Monitorize pools de armazenamento do Hyperdisk.

gcloud

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

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

Substitua o seguinte:

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

REST

Para obter detalhes sobre um conjunto de armazenamento, crie um pedido GET usando o método storagePools.get.

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

Substitua o seguinte:

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

Atualize a capacidade aprovisionada, os IOPS ou o débito de um conjunto de armazenamento

Pode aumentar ou diminuir a capacidade aprovisionada, os IOPS ou o débito de um conjunto de armazenamento. Para aumentar a capacidade, os IOPS ou a taxa de transferência de um conjunto de armazenamento, tem de ter quota disponível para o projeto e a região.

Consola

  1. Aceda à página Pools de armazenamento na Google Cloud consola.
    Aceda à página Pools de armazenamento

  2. No campo Nome, clique no nome do conjunto de armazenamento que quer modificar.

    É aberta a página Gerir conjunto de armazenamento.

  3. Clique em Editar.

    É apresentada a página Editar conjunto de armazenamento.

  4. Opcional: no campo Capacidade do conjunto de armazenamento, introduza o novo valor para a capacidade aprovisionada do conjunto. O novo valor tem de ser, pelo menos, 1 TiB e, no máximo, 100 TiB superior ou inferior ao valor atual. O tamanho mínimo não pode ser inferior a 10 TiB e o tamanho máximo não pode ser superior a 1024 TiB.

  5. Opcional: no campo Débito aprovisionado, introduza o novo valor para o débito aprovisionado.

  6. Opcional: para pools de armazenamento do tipo Hyperdisk Balanced, no campo IOPS aprovisionados, introduza o novo valor para os IOPS aprovisionados.

  7. Clique em Guardar para atualizar o conjunto de armazenamento.

gcloud

Use o comando gcloud compute storage-pools update para modificar um conjunto 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 o seguinte:

  • STORAGE_POOL_NAME: o nome do conjunto de armazenamento.
  • ZONE: opcional: a zona em que o conjunto de armazenamento está localizado, por exemplo, us-central1-a.
  • POOL_SIZE: Opcional: a capacidade aprovisionada do conjunto de armazenamento, em TiB.
  • IOPS: Opcional: os IOPS aprovisionados do conjunto de armazenamento. Só pode usar esta flag com pools de armazenamento equilibrado do Hyperdisk.
  • THROUGHPUT: opcional: o débito aprovisionado do conjunto de armazenamento, em MiB/s.
  • DESCRIPTION: Opcional: uma string descritiva para o conjunto de armazenamento.

REST

Para atualizar um conjunto de armazenamento, crie um pedido PATCH através do 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 o seguinte:

  • PROJECT_ID: o ID do projeto
  • ZONE: a zona onde o conjunto de armazenamento está localizado, por exemplo, us-central1-a.
  • STORAGE_POOL_NAME: o nome do conjunto de armazenamento.
  • DESCRIPTION: Opcional: um campo de texto para descrever o conjunto de armazenamento.
  • SIZE: Opcional: a capacidade aprovisionada do novo conjunto de armazenamento, em GiB.
  • IOPS: opcional: o novo valor para IOPS aprovisionadas do conjunto de armazenamento. Só pode especificar esta propriedade quando o conjunto de armazenamento contém discos do tipo hyperdisk-balanced.
  • THROUGHPUT: opcional: o novo valor para o débito aprovisionado do conjunto de armazenamento, especificado em MiB/s.

Elimine um conjunto de armazenamento

Para eliminar ou remover um conjunto de armazenamento, tem de eliminar primeiro todos os discos no conjunto de armazenamento. Em seguida, pode usar a Google Cloud consola, a Google Cloud CLI ou o REST para eliminar o conjunto de armazenamento.

A eliminação de um conjunto de armazenamento é irreversível. No entanto, a eliminação de um conjunto de armazenamento não elimina as capturas de ecrã feitas a partir de discos criados no conjunto de armazenamento. Tem de eliminar os instantâneos em separado.

Consola

  1. Aceda à página Pool de armazenamento na Google Cloud consola.
    Aceda à página Conjunto de armazenamento

  2. No campo Nome, clique no nome do conjunto de armazenamento que quer remover.

    É aberta a página Gerir conjunto de armazenamento.

  3. Na secção Discos do conjunto de armazenamento, verifique se não existem discos listados para o conjunto de armazenamento.

  4. Clique em Eliminar conjunto.

gcloud

Use o comando gcloud compute storage-pools delete para eliminar um conjunto de armazenamento.

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

Substitua o seguinte:

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

REST

Para remover um conjunto de armazenamento, crie um pedido para o método storagePools.delete.DELETE

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

Substitua o seguinte:

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

O que se segue?