É possível criar discos em um pool de armazenamento de hiperdisco e, em seguida, anexar o disco a uma instância de máquina virtual (VM) ou criar discos no pool de armazenamento ao criar uma VM.
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 selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Java
Para usar os exemplos Java desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Node.js
Para usar os exemplos Node.js desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte 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 criar um disco de capacidade equilibrada de hiperdisco ou de capacidade de processamento em 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 criar um disco de capacidade equilibrado ou de capacidade de processamento de hiperdisco em 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 permissões a seguir são necessárias para criar um disco equilibrado de hiperdisco ou capacidade de processamento de hiperdisco em um pool de armazenamento:
-
Para criar discos em um pool de armazenamento e anexá-los a uma instância de VM, faça o seguinte:
-
compute.disks.create
no projeto -
compute.instances.attachDisk
na VM -
compute.disks.use
no volume que você quer anexar à VM -
compute.storagePools.use
no pool de armazenamento em que você está criando discos
-
-
Para formatar e ativar o volume anexado:
compute.instances.setMetadata
na VM
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Para conhecer as permissões necessárias para criar uma instância, consulte Permissões necessárias.
Limitações
Analise as seguintes limitações para criar discos em um pool de armazenamento de hiperdisco:
- Só é possível criar discos balanceados de hiperdisco em um pool de armazenamento equilibrado por hiperdisco e apenas discos de capacidade de processamento de hiperdisco em um pool de armazenamento de capacidade de processamento de hiperdisco.
- Somente novos discos no mesmo projeto e zona podem ser criados em um pool de armazenamento.
- Para criar discos de inicialização em um pool de armazenamento, use um pool de armazenamento balanceado por hiperdisco.
- 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.
- É possível criar até 1.000 discos em um pool de armazenamento.
- Os pools de armazenamento não oferecem suporte a discos regionais.
Opções de provisionamento
Dependendo do tipo de provisionamento do pool de armazenamento de hiperdisco, é possível escolher como provisionar a capacidade e o desempenho de cada disco criado no pool de armazenamento.
Provisionar a capacidade do disco
Se você criar um pool de armazenamento de capacidade avançado, poderá usar o provisionamento fino. É possível criar discos no pool de armazenamento com um tamanho cumulativo que exceda a capacidade provisionada do pool. A capacidade usada do pool de armazenamento é definida pelo total de dados em uso, e não pela quantidade de espaço em disco provisionado. É possível provisionar discos com uma capacidade agregada de até 500% da capacidade provisionada de um pool de armazenamento de capacidade avançada.
Se você estiver criando discos em um pool de armazenamento de capacidade padrão, crie discos no pool de armazenamento até que o tamanho total de todos os discos no pool de armazenamento alcance a capacidade provisionada. Os discos em um pool de armazenamento com capacidade padrão se comportam de maneira semelhante aos discos que não são do pool, em que a capacidade é consumida quando você cria os discos.
Desempenho do provisionamento
Se você criar um pool de armazenamento de desempenho avançado, poderá usar o provisionamento fino. É possível criar discos no pool de armazenamento com uma quantidade cumulativa de IOPS e throughput que exceda o desempenho provisionado do pool. O desempenho usado do pool de armazenamento é definido pelo desempenho total usado pelos discos, e não pela quantidade de desempenho provisionada para cada disco. É possível provisionar discos com uma performance agregada de até 500% da performance provisionada de um pool de armazenamento de desempenho avançado.
Se você estiver criando discos em um pool de armazenamento de performance padrão, as IOPS ou a capacidade de processamento provisionadas para um disco precisam ser menores que as IOPS ou a capacidade de processamento disponíveis no pool de armazenamento de hiperdisco. As IOPS ou a capacidade de processamento disponíveis são a quantidade provisionada para o pool de armazenamento menos a quantidade usada de todos os discos criados no pool de armazenamento.
Se alguma das condições no parágrafo anterior não for verdadeira, a solicitação para criar um disco no pool de armazenamento falhará, e o disco não será criado.
Exemplo
Suponha que você tenha um pool de armazenamento Hyperdisk Balanced com 100.000 IOPS provisionadas.
Com o provisionamento de desempenho padrão:
- É possível provisionar até 100.000 IOPS agregados ao criar discos de Hyperdisk Balanced no pool de armazenamento.
- Você vai receber uma cobrança pelas 100.000 IOPS de desempenho provisionadas do pool de armazenamento Hyperdisk Balanced.
Assim como os discos criados fora de um pool de armazenamento, os discos Hyperdisk Balanced em pools de armazenamento de desempenho padrão são provisionados automaticamente com até 3.000 IOPS de referência e 140 MiB/s de capacidade de processamento de valor de referência. O desempenho deste valor de referência não é contabilizado no desempenho provisionado para o pool de armazenamento. Somente quando você adiciona discos ao pool de armazenamento com desempenho provisionado acima do valor de referência é que ele é contabilizado para o desempenho provisionado do pool de armazenamento. Por exemplo:
- Um disco provisionado com 3.000 IOPS usa 0 IOPS do pool, e o pool ainda tem 100.000 IOPS provisionadas disponíveis para outros discos.
- Um disco provisionado com 13.000 IOPS usa 10.000 IOPS de pool, e o pool tem 90.000 IOPS provisionadas restantes que podem ser alocadas para outros discos no pool de armazenamento.
Com o provisionamento de desempenho avançado:
- É possível provisionar até 500.000 IOPS de desempenho agregado do Hyperdisk ao criar discos no pool de armazenamento.
- Você será cobrado por 100.000 IOPS provisionadas pelo pool de armazenamento.
- Se você criar um único disco (
Disk1
) no pool de armazenamento que tenha 5.000 IOPS, você não consome nenhuma IOPS das IOPS provisionadas do pool de armazenamento. No entanto, a quantidade de IOPS que você pode provisionar para novos discos criados no pool de armazenamento agora é de 495.000. - Se
Disk1
começar a ler e gravar dados e usar o máximo de 5.000 IOPS em um determinado minuto, 5.000 IOPS serão consumidas pelas IOPS provisionadas pelo pool de armazenamento. Todos os outros discos criados no mesmo pool de armazenamento podem usar um máximo agregado de 95.000 IOPS no mesmo minuto sem entrar em conflito.
Criar discos no pool de armazenamento
É possível usar o console do Google Cloud, a CLI do Google Cloud ou o REST para criar um disco em um pool de armazenamento.
Com o console do Google Cloud, é possível criar um novo disco em um pool de armazenamento por meio da página Pools de armazenamento ou Discos.
Na página Pools de armazenamento:
No console do Google Cloud, acesse a página Pools de armazenamento.
Clique no nome do pool de armazenamento em que você quer criar um disco.
Na página Gerenciar pool de armazenamento, clique em + Criar novo disco.
No painel Adicionar novo disco, digite um Nome para o disco.
Especifique ou altere os valores em que você não quer usar o valor padrão.
Quando terminar de especificar as propriedades do disco, clique em Salvar.
Na página Gerenciar pool de armazenamento, o novo disco vai aparecer na seção Discos do pool de armazenamento.
Na página Criar disco, siga estas etapas:
No console do Google Cloud, acesse a página Discos > Criar um disco.
Digite um Nome para o disco.
Selecione a zona que contém o pool de armazenamento em que você quer criar o disco.
Em Tipo de disco, escolha o tipo que corresponde ao pool de armazenamento de hiperdisco: capacidade de processamento ou balanceamento de hiperdisco.
Modifique os valores nos campos Tamanho, IOPS provisionadas e Capacidade de processamento provisionada conforme necessário.
Na seção Pool de armazenamento, selecione Ativar pool de armazenamento e escolha o nome do pool de armazenamento em que o disco será criado. Somente o pool de armazenamento que existe na zona selecionada aparece na lista.
Quando terminar de especificar as informações do disco, clique em Criar.
Para criar um ou mais discos em um pool de armazenamento, use o
comando gcloud compute disks create
.
gcloud compute disks createDISK_NAME \ --zone=ZONE \ --storage-pool=STORAGE_POOL_NAME \ --size=SIZE \ --type=DISK_TYPE \ --provisioned-iops=PROVISIONED_IOPS \ --provisioned-throughput=PROVISIONED_THROUGHPUT
Substitua:
- DISK_NAME: um nome exclusivo para o disco. É possível fornecer uma lista de nomes de discos especificados por espaços para criar vários discos com os mesmos atributos.
- ZONE: a zona em que o pool de armazenamento foi criado. Especifique
esse valor no formato de região-zona, por exemplo,
us-central1-a
. - STORAGE_POOL_NAME: o nome do pool de armazenamento em que o disco será criado.
- SIZE: (opcional) a capacidade provisionada do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. Se nenhum tamanho for especificado, 100 GB será usado como o valor padrão.
- DISK_TYPE: o tipo de disco a ser criado. Precisa corresponder ao tipo
do pool de armazenamento de hiperdisco,
hyperdisk-balanced
ouhyperdisk-throughput
. - PROVISIONED_IOPS: opcional: as IOPS a serem provisionadas para o disco. Só é possível usar essa sinalização com discos balanceados de hiperdisco.
- PROVISIONED_THROUGHPUT (opcional): a capacidade de processamento em mebibyte (MB) por segundo a ser provisionada para o disco.
Para criar um ou mais discos em um pool de armazenamento, crie um POST
usando o método disks.insert
.
Inclua as propriedades name
, sizeGb
, type
, storagePool
, provisionedIops
e provisionedThroughput
. Para criar esse disco como um que não será inicializado e não estará formatado, recomendamos não especificar uma imagem ou snapshot de origem.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /disks { "name": "DISK_NAME ", "description": "DESCRIPTION ", "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /diskTypes/DISK_TYPE ", "sizeGb": "DISK_SIZE ", "storagePool": "STORAGE_POOL_NAME ", "provisionedIops": "IOPS_LIMIT ", "provisionedThroughput": "THROUGHPUT_LIMIT ", }
Substitua:
- PROJECT_ID: o ID do projeto
- ZONE: a zona em que o pool de armazenamento está localizado,
por exemplo,
us-central1-a
. Essa é a zona em que o disco será criado. - DISK_NAME: um nome exclusivo para o disco.
- DESCRIPTION (opcional): uma string de texto que descreve o disco.
- DISK_TYPE: o tipo de disco, que precisa corresponder ao
tipo de pool de armazenamento. Use
hyperdisk-throughput
ouhyperdisk-balanced
. - DISK_SIZE: opcional: o tamanho do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibytes ou TB para tebibytes. Se nenhum tamanho for especificado, 100 GB será usado como o valor padrão.
- STORAGE_POOL_NAME: o nome do pool de armazenamento em que o disco será criado.
- IOPS_LIMIT: opcional: as IOPS a serem provisionadas para o disco. Só é possível usar essa sinalização com discos balanceados de hiperdisco.
- THROUGHPUT_LIMIT: opcional: a capacidade de processamento em mebibytes (MB) por segundo para provisionar o disco.
Depois de criar o disco, anexe-o a uma VM.
Criar uma VM que use discos no pool de armazenamento
Ao criar uma VM, você configura um disco de inicialização e, opcionalmente, pode criar discos de dados adicionais (que não sejam de inicialização), que são automaticamente anexados à VM. Nas seções a seguir, explicamos como criar cada tipo de disco em um pool de armazenamento como parte do processo de criação da VM.
Criar o disco de inicialização de uma VM em um pool de armazenamento
Para criar uma VM que use um disco de inicialização em um pool de armazenamento, primeiro crie um pool de armazenamento balanceado por hiperdisco. Em seguida, é possível criar uma VM usando um tipo de máquina compatível com discos Hyperdisk Balanced. O tipo de máquina, o tipo de disco e o pool de armazenamento precisam estar disponíveis na zona escolhida.
No console do Google Cloud, acesse a página Instâncias de VMs.
Clique em Criar instância.
Digite um nome para a instância.
Defina a zona como a mesma em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que aceite o balanceamento de hiperdisco, por exemplo, H3.
Na seção Disco de inicialização, clique em Alterar.
No painel Disco de inicialização, defina o Tipo de disco de inicialização como "Hiperdisco balanceado".
Configure as propriedades do disco.
Expanda Mostrar configuração avançada.
Sob a direção Pool de armazenamento, selecione Ativar pool de armazenamento.
Escolha na lista o pool de armazenamento em que o disco será criado.
Quando terminar a configuração do disco, clique em Selecionar.
Conclua a configuração das propriedades da VM.
Clique em Criar.
O console cria a VM na zona especificada e o disco de inicialização no pool de armazenamento selecionado.
É possível criar o disco de inicialização para uma nova VM no pool de armazenamento usando o comando gcloud compute instances create
e incluindo a propriedade storage-pool
para o disco de inicialização.
gcloud compute instances createVM_NAME \ --zone=ZONE \ --machine-type=MACHINE_TYPE \ --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE ,provisioned-throughput=THROUGHPUT , \ provisioned-iops=IOPS ,image=projects/IMAGE_PROJECT /global/images/IMAGE , \ storage-pool=STORAGE_POOL_NAME
Substitua:
- VM_NAME: o nome da VM.
- ZONE: a região e a zona em que a VM será criada, usando o formato
us-central1-a
. - MACHINE_TYPE: o tipo de máquina da VM, por exemplo,
m3-ultramem-32
. - DISK_SIZE: o tamanho do disco de inicialização em GiB
- THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
- IOPS: as IOPS a serem provisionadas para o disco
- IMAGE_PROJECT: selecione o projeto que contém a imagem
- IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por
exemplo:
debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser
formatada como
family/IMAGE_FAMILY
. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagensdebian-12
. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
- Uma versão específica da imagem do SO. Por
exemplo:
- STORAGE_POOL_NAME: o nome do pool de armazenamento em que o novo disco será criado.
É possível criar o disco de inicialização para uma nova VM no pool de armazenamento
criando uma solicitação POST
para o
método instances.insert
e incluindo a storagePool
do disco de inicialização.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /instances { "name": "VM_NAME ", "machineType": "zones/ZONE /machineTypes/MACHINE_TYPE ", "disks": [ { "deviceName": "BOOT_DISK_DEVICE_NAME ", "initializeParams": { "diskSizeGb": "DISK_SIZE ", "diskType": "DISK_TYPE ", "sourceImage": "projects/IMAGE_PROJECT /global/images/IMAGE " "boot": true, "provisionedIops": "IOPS_LIMIT ", "provisionedThroughput": "THROUGHPUT_LIMIT ", "storagePool": "POOL_URL " } } ] }
Substitua:
- PROJECT_ID: o ID do projeto
- ZONE: a zona em que o pool de armazenamento está localizado,
por exemplo,
us-central1-a
. Essa é a zona em que a VM e o disco de inicialização serão criados. - VM_NAME: o nome da VM.
- MACHINE_TYPE: o tipo de máquina da VM, por exemplo,
m3-ultramem-32
. - BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
- DISK_SIZE: o tamanho do disco de inicialização em GiB
- DISK_TYPE: o tipo de disco, especificado como um URI
- IMAGE_PROJECT: selecione o projeto que contém a imagem
- IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por
exemplo:
debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser
formatada como
family/IMAGE_FAMILY
. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagensdebian-12
. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
- Uma versão específica da imagem do SO. Por
exemplo:
- IOPS_LIMIT: as IOPS a serem provisionadas para o disco
- THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
- POOL_URL: o pool de armazenamento em que o novo disco é criado.
Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por
exemplo, os valores a seguir são válidos:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
zones/ZONE/storagePools/STORAGE_POOL_NAME
Criar mais discos em um pool de armazenamento durante a criação da VM
Ao criar discos em um pool de armazenamento durante a criação da VM, o tipo de máquina, o tipo de disco e o pool de armazenamento precisam estar disponíveis na zona escolhida.
Siga as etapas a seguir para usar o console na criação de uma nova VM com discos extras que não sejam de inicialização:
No console do Google Cloud, acesse a página Instâncias de VMs.
Clique em Criar instância.
Insira um nome para a VM.
Defina a zona como a mesma em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que aceite o tipo de disco usado pelo pool de armazenamento.
Expanda a seção Opções avançadas.
Expanda Discos.
Clique em
Adicionar novo disco.No painel Adicionar novo disco, insira as informações do disco. Defina o Tipo de disco para corresponder ao tipo de pool de armazenamento.
Na seção Pool de armazenamento, selecione Ativar pool de armazenamento.
No campo Selecionar um pool de armazenamento, escolha o pool em que o disco será criado.
Quando terminar a configuração do disco, clique em Salvar.
Conclua a configuração das propriedades da VM.
Clique em Criar.
O console cria a VM na zona especificada e o disco que não é de inicialização no pool de armazenamento selecionado.
Crie novos discos em um pool de armazenamento durante a criação da VM usando o comando gcloud compute instances create
e incluindo a propriedade storage-pool
para o disco.
gcloud compute instances createVM_NAME \ --zone=ZONE \ --machine-type=MACHINE_TYPE \ --create-disk=auto-delete=yes,boot=yes,device-name=BOOT_DISK_DEVICE_NAME ,image=IMAGE_NAME , \ size=BOOT_DISK_SIZE ,type=BOOT_DISK_TYPE --create-disk=auto-delete=yes,boot=no,device-name=DATA_DISK_DEVICE_NAME ,size=DATA_DISK_SIZE , \ type=DATA_DISK_TYPE ,provisioned-iops=IOPS ,provisioned-throughput=THROUGHPUT , \ storage_pool=STORAGE_POOL_NAME
Substitua:
- VM_NAME: o nome da VM.
- ZONE: a região e a zona em que a VM será criada, usando o formato
us-central1-a
. - MACHINE_TYPE: o tipo de máquina da VM
- BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
- IMAGE_NAME: o nome da imagem do sistema operacional a ser instalada
no disco de inicialização, por exemplo,
debian-12-bookworm-v20240213
- BOOT_DISK_SIZE: o tamanho do disco de inicialização em GiB
- BOOT_DISK_TYPE: o tipo de disco
- DATA_DISK_DEVICE_NAME: o nome do dispositivo de disco para o disco de dados
- DATA_DISK_SIZE: o tamanho do disco de dados, em GiB
- DATA_DISK_TYPE: o tipo de disco de dados,
hyperdisk-balanced
ouhyperdisk-throughput
- IOPS: as IOPS a serem provisionadas para o disco
- THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
- STORAGE_POOL_NAME: o nome exclusivo do pool de armazenamento em que você quer criar o disco.
É possível criar novos discos em um pool de armazenamento durante a criação da VM
criando uma solicitação POST
para o
método instances.insert
e incluindo a propriedade storagePool
para os discos adicionais.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /instances { "name": "VM_NAME ", "machineType": "zones/ZONE /machineTypes/MACHINE_TYPE ", "disks": [ { "initializeParams":{ "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot":true }, { "deviceName": "DEVICE_NAME ", "boot":false, "initializeParams": { "diskSizeGb": "DISK_SIZE ", "diskType": "DISK_TYPE ", "sourceImage": "projects/IMAGE_PROJECT /global/images/IMAGE " "provisionedIops": "IOPS_LIMIT ", "provisionedThroughput": "THROUGHPUT_LIMIT ", "storagePool": "POOL_URL " } } ] }
Substitua:
- PROJECT_ID: o ID do projeto
- ZONE: a zona em que o pool de armazenamento está localizado,
por exemplo,
us-central1-a
. Essa é a zona em que a VM e o disco de inicialização serão criados. - VM_NAME: o nome da VM.
- MACHINE_TYPE: o tipo de máquina da VM, por exemplo,
m3-ultramem-32
. - IMAGE_PROJECT: selecione o projeto que contém a imagem
- IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por
exemplo:
debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser
formatada como
family/IMAGE_FAMILY
. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagensdebian-12
. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
- Uma versão específica da imagem do SO. Por
exemplo:
- DEVICE_NAME: o nome do dispositivo para o disco de dados
- DISK_SIZE: o tamanho do disco de dados em GiB
- DISK_TYPE: o tipo de disco, especificado como um URI
- IOPS_LIMIT: as IOPS a serem provisionadas para o disco
- THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
- POOL_URL: o pool de armazenamento em que o novo disco é criado.
Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por
exemplo, os valores a seguir são válidos:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
zones/ZONE/storagePools/STORAGE_POOL_NAME
Usar o pool de armazenamento em um modelo de instância
Os modelos de instância usados para criar grupos gerenciados de instâncias (MIGs, na sigla em inglês) podem conter as informações do pool de armazenamento. Os discos criados com o uso do modelo de instância são colocados no pool de armazenamento especificado.
No Console do Google Cloud, acesse a página Modelos de instância.
Selecione Criar modelo de instância.
Digite um nome para o modelo de instância.
Escolha Regional como o local e, no campo Região, escolha a região em que o pool de armazenamento está localizado.
Escolha um tipo de máquina que ofereça suporte ao Hiperdisco Balanceado, por exemplo, C3.
Na seção Disco de inicialização, clique em Alterar.
No painel Disco de inicialização, defina o Tipo de disco de inicialização como "Hiperdisco balanceado".
Configure as propriedades do disco.
Expanda Mostrar configuração avançada.
Sob a direção Pool de armazenamento, selecione Ativar pool de armazenamento.
Escolha na lista o pool de armazenamento em que o disco será criado.
Quando terminar a configuração do disco, clique em Selecionar.
Conclua a configuração das propriedades da VM.
Clique em Criar.
O modelo cria a VM na zona especificada e o disco de inicialização no pool de armazenamento selecionado.
Especifique em um modelo de instância que o disco de inicialização seja criado em um pool de armazenamento usando o comando gcloud compute instance-templates create
e incluindo a propriedade storage-pool
do disco de inicialização.
gcloud compute instance-templates createTEMPLATE_NAME \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE ,provisioned-throughput=THROUGHPUT , \ provisioned-iops=IOPS ,image=projects/IMAGE_PROJECT /global/images/IMAGE , \ storage-pool=STORAGE_POOL_NAME
Substitua:
- TEMPLATE_NAME: o nome do modelo de instância.
- REGION: a região em que você quer criar o modelo de instância regional. A região precisa conter a zona em que o pool de armazenamento está localizado.
- MACHINE_TYPE: o tipo de máquina a ser usado ao criar a VM,
por exemplo,
h3-standard-88
. - DISK_SIZE: o tamanho do disco em GiB
- THROUGHPUT: a capacidade de processamento a ser provisionada para o disco
- IOPS: as IOPS a serem provisionadas para o disco
- IMAGE_PROJECT: o projeto que contém a imagem
- IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por
exemplo:
debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser
formatada como
family/IMAGE_FAMILY
. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, o Compute Engine criará uma VM usando a versão mais recente da imagem do SO na família de imagensdebian-12
. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
- Uma versão específica da imagem do SO. Por
exemplo:
- STORAGE_POOL_NAME: o nome do pool de armazenamento em que o novo disco será criado.
É possível criar o disco de inicialização para uma nova VM no pool de armazenamento
criando uma solicitação POST
para o
método instances.insert
e incluindo a storagePool
do disco de inicialização.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /global/instanceTemplates { "name": "VM_NAME ", "machineType": "zones/ZONE /machineTypes/MACHINE_TYPE ", "disks": [ { "deviceName": "BOOT_DISK_DEVICE_NAME ", "initializeParams": { "diskSizeGb": "DISK_SIZE ", "diskType": "DISK_TYPE ", "sourceImage": "projects/IMAGE_PROJECT /global/images/IMAGE " "boot": true, "provisionedIops": "IOPS_LIMIT ", "provisionedThroughput": "THROUGHPUT_LIMIT ", "storagePool": "POOL_URL " } } ] }
Substitua:
- PROJECT_ID: o ID do projeto;
- VM_NAME: o nome da VM.
- ZONE: a zona em que o pool de armazenamento está localizado,
por exemplo,
us-central1-a
. Essa é a zona em que a VM e o disco de inicialização serão criados. - MACHINE_TYPE: o tipo de máquina da VM, por exemplo,
m3-ultramem-32
. - BOOT_DISK_DEVICE_NAME: o nome do dispositivo para o disco de inicialização
- DISK_SIZE: o tamanho do disco de inicialização em GiB
- DISK_TYPE: o tipo de disco, especificado como um URI
- IMAGE_PROJECT: o projeto que contém a imagem
- IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO. Por
exemplo:
debian-12-bookworm-v20240213
- Uma família de imagens, que precisa ser
formatada como
family/IMAGE_FAMILY
. Isso cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, o Compute Engine vai criar uma instância usando a versão mais recente da imagem do SO na família de imagensdebian-12
. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
- Uma versão específica da imagem do SO. Por
exemplo:
- IOPS_LIMIT: as IOPS a serem provisionadas para o disco
- THROUGHPUT_LIMIT: a capacidade de processamento a ser provisionada para o disco
- POOL_URL: o pool de armazenamento em que o novo disco é criado.
Você pode fornecê-lo como um URL parcial ou completo para o recurso. Por
exemplo, os valores a seguir são válidos:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
zones/ZONE/storagePools/STORAGE_POOL_NAME