Depois de criar um disco persistente ou um Hyperdisk no Compute Engine, pode rever as informações sobre a configuração do disco. Pode usar estas informações para monitorizar o desempenho do disco, melhorar a segurança dos dados e otimizar o armazenamento e os custos. Este documento explica como ver os seguintes detalhes essenciais do disco:
- Uma lista de todos os discos disponíveis num projeto, incluindo os discos que não estão associados a uma instância
- Instâncias anexadas
- Se um disco é eliminado automaticamente com a respetiva instância
- Modo de acesso
- Métricas de desempenho de débito e operações de entrada/saída por segundo (IOPS)
- Informações de encriptação
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
-
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.
- 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.
Veja todos os discos num projeto
Para uma vista abrangente dos seus recursos de armazenamento, pode listar todos os discos num projeto, incluindo discos que não estão associados a uma instância.
Consola
Na Google Cloud consola, aceda à página Discos.
A página Discos lista todos os discos no seu projeto.
gcloud
Execute o comando
disks list
.gcloud compute disks list
Resultado do comando
Uma lista de todos os volumes de discos persistentes e Hyperdisk no seu projeto.
Para ver discos numa região ou zona específica, use a flag
--zone
ou--region
para especificar a localização.REST
Faça um pedido
POST
ao métodocompute.disks.aggregatedList
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/disks/
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.
Pedir resposta
Uma lista de todos os volumes de discos persistentes e Hyperdisk no seu projeto.
Veja as instâncias às quais um disco está anexado
Compreenda como o disco está a ser usado e evite incorrer em custos de discos não usados, identificando as instâncias associadas ao mesmo.
Consola
Na Google Cloud consola, aceda à página Discos.
Na coluna Nome, clique no nome do disco.
Na tabela Propriedades, a linha etiquetada como Em utilização por apresenta todas as instâncias associadas ao disco.
gcloud
Execute o comando
gcloud compute disks describe
.gcloud compute disks describe DISK_NAME
--zone=ZONE --format="json(users)"Substitua o seguinte:
ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Resultado do comando
Se o resultado for
null
, o disco não está associado a nenhuma instância. Caso contrário, o resultado é um objeto JSON que contém um campo denominadousers
. O campousers
apresenta os URLs de todas as instâncias que usam o disco.REST
Faça um pedido
POST
ao métodocompute.disks.get
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Pedir resposta
A resposta REST é um objeto JSON que contém um campo denominado
users
.Se o valor do campo
users
fornull
, o disco não está associado a nenhuma instância. Caso contrário, o objeto users apresenta os URLs de todas as instâncias que usam o disco.Veja se um disco tem a eliminação automática ativada
Para evitar a perda acidental de dados, verifique se o disco de arranque ou não arranque vai ser eliminado quando eliminar a instância anexada.
Por predefinição, os discos de arranque têm a opção
autoDelete
ativada, o que significa que a eliminação de uma instância também elimina o respetivo disco de arranque anexado. No entanto, pode substituir esta definição se quiser preservar o disco de arranque anexado. Os discos não de arranque também são eliminados se tiverem a opçãoautoDelete
ativada.Consola
Na Google Cloud consola, aceda à página Instâncias de VM.
Na coluna Nome, clique no nome da instância.
Na secção Armazenamento, navegue para a coluna Quando eliminar a instância. When deleting instance pode ter um dos seguintes valores:
- Eliminar disco: o disco é eliminado com a instância.
- Manter disco: o disco não é eliminado com a instância.
gcloud
Execute o comando
gcloud compute disks describe
.gcloud compute disks describe DISK_NAME
--zone=ZONESubstitua o seguinte:
ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Resultado do comando
Um objeto JSON que contém um campo denominado
autoDelete
.autoDelete
descreve se o disco vai ser eliminado com a respetiva instância anexada e pode ter um dos seguintes valores:true
: o disco é eliminado com a instância.false
: o disco não é eliminado com a instância.
REST
Faça um pedido
POST
ao métodocompute.disks.get
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Pedir resposta
Um objeto JSON que contém um campo denominado
autoDelete
.autodelete
descreve se o disco vai ser eliminado com a respetiva instância anexada e pode ter um dos seguintes valores:true
: o disco é eliminado com a instância.false
: o disco não é eliminado com a instância.
Veja a quantidade de espaço disponível num disco
Para ver a quantidade de espaço disponível num disco sem estabelecer ligação à instância anexada, tem de instalar o agente de operações nas suas instâncias. O agente de operações fornece métricas adicionais para
bytes_used
(bytes usados no disco) epercent_used
(utilização do disco).Para saber mais sobre a monitorização do espaço em disco, consulte as métricas do agente de operações.
Veja o modo de acesso de um Hyperdisk
O modo de acesso determina se um volume do Hyperdisk pode ser associado a várias instâncias e se as instâncias associadas têm acesso de leitura ou leitura/escrita ao disco.
Consola
Na Google Cloud consola, aceda à página Discos.
Na coluna Nome, clique no nome do disco.
Na tabela Propriedades, a linha etiquetada como Modo de acesso descreve como as instâncias podem aceder aos dados no disco e pode ter um dos seguintes valores:
- Leitura/escrita de VM única (predefinição), para acesso de leitura/escrita a partir de uma instância.
- Várias VMs de leitura/escrita para acesso de leitura/escrita a partir de várias instâncias.
- Várias VMs só de leitura para acesso só de leitura a partir de várias instâncias.
gcloud
Execute o comando
gcloud compute disks describe
.gcloud compute disks describe DISK_NAME
--zone=ZONE
--format="json(accessMode)"Substitua o seguinte:
ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Resultado do comando
Um objeto JSON que contém um campo denominado
accessMode
.accessMode
descreve como as instâncias podem aceder aos dados no disco e pode ter um dos seguintes valores:READ_ONLY_MANY
, para acesso só de leitura a partir de várias instâncias.READ_WRITE_MANY
, para acesso de leitura/escrita a partir de várias instâncias.READ_WRITE_SINGLE
, para acesso de leitura/escrita a partir de uma instância.
REST
Faça um pedido
POST
ao métodocompute.disks.get
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco
Pedir resposta
A resposta REST é um objeto JSON que contém um campo denominado
accessMode
.accessMode
descreve como as instâncias podem aceder aos dados no disco e pode ter um dos seguintes valores:READ_ONLY_MANY
, para acesso só de leitura a partir de várias instâncias.READ_WRITE_MANY
, para acesso de leitura/escrita a partir de várias instâncias.READ_WRITE_SINGLE
, para acesso de leitura/escrita a partir de uma instância.
Determine se um disco está a ter o desempenho esperado
Os discos têm limites para o número máximo de IOPS e a taxa de transferência que podem alcançar. Estes limites dependem do tamanho do disco e da instância ligada. O desempenho máximo de um disco não pode exceder os limites da instância à qual está anexado.
Para determinar se um volume do Hyperdisk ou do disco persistente está a ter o desempenho esperado com base no respetivo tamanho e instância associada, conclua os seguintes passos:
- Verifique o desempenho aprovisionado ou máximo do disco.
- Compare o desempenho aprovisionado ou máximo com o desempenho real do disco.
Os passos para verificar o desempenho aprovisionado ou máximo de um disco dependem de o disco ser um Hyperdisk ou um disco persistente.
Veja o desempenho aprovisionado de um Hyperdisk
Para ver os valores de IOPS aprovisionados e débito para um volume do Hyperdisk, consulte o artigo Veja as definições de desempenho aprovisionadas para o Hyperdisk.
Veja o desempenho máximo de um disco persistente
Os volumes do Persistent Disk têm limites de débito e IOPS por GiB e por instância que podem suportar. As secções seguintes fornecem informações detalhadas sobre os limites de desempenho do disco persistente zonal e regional:
- Limites de IOPS e débito para o disco persistente zonal
- Limites de IOPS e débito para o disco persistente regional
O disco persistente equilibrado e o disco persistente SSD (desempenho) também oferecem um desempenho de base para IOPS e débito sustentados. Para calcular os valores máximos de IOPS e débito para um volume de disco persistente equilibrado ou de disco persistente SSD, use a seguinte equação:
Maximum expected performance = Baseline performance + (Per GiB performance limit * Combined disk size in GiB)
Para mais informações, consulte o artigo Desempenho de base.
Veja o desempenho real de um disco
Para ver o desempenho de IOPS e débito de um disco, use a Google Cloud consola.
Consola
Na Google Cloud consola, aceda à página Instâncias de VM.
Na coluna Nome, clique no nome da VM à qual o disco está associado.
Clique em Observabilidade.
No menu, selecione Disco > Desempenho
São apresentados gráficos que ilustram o desempenho de IOPS e débito do disco. Para ver todos os gráficos, tem de instalar o agente de operações.
Para ver um relatório mais detalhado sobre o desempenho de um disco, consulte o artigo Reveja as métricas de desempenho do disco.
Se o disco não estiver a ter o desempenho esperado, reveja as orientações em Monitorizar o estado de funcionamento de um disco.
Veja informações sobre a encriptação de um disco
Os discos no Compute Engine são encriptados com um dos seguintes tipos de chaves de encriptação:
- Google-owned and managed keys
- Chaves de encriptação geridas pelo cliente (CMEKs)
- Chaves de encriptação fornecidas pelos clientes (CSEKs)
Por predefinição, o Compute Engine usa Google-owned and managed keys.
Consola
Na Google Cloud consola, aceda à página Discos.
Na coluna Nome, clique no nome do disco.
Na tabela Propriedades, a linha com a etiqueta Encriptação indica o tipo de encriptação: gerida pela Google, gerida pelo cliente ou fornecida pelo cliente.
gcloud
Execute o comando
gcloud compute disks describe
.gcloud compute disks describe DISK_NAME
--zone=ZONE
--format="json(diskEncryptionKey)"Substitua o seguinte:
ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco.
Resultado do comando
Se a saída for
null
, o disco usa um Google-owned and managed key.Caso contrário, a saída é um objeto JSON.
Se o objeto JSON contiver um campo denominado
diskEncryptionKey
, o disco está encriptado. O objetodiskEncryptionKey
contém informações sobre se o disco está encriptado com CMEK ou CSEK:- Se a propriedade
diskEncryptionKey.kmsKeyName
estiver presente, o disco está encriptado com CMEK. A propriedadekmsKeyName
indica o nome da chave específica usada para encriptar o disco:{ "diskEncryptionKey": { "kmsKeyName": "projects/my-proj/.." } }
- Se a propriedade
diskEncryptionKey.sha256
estiver presente, o disco está encriptado com CSEK. A propriedadesha256
é o hash SHA-256 da chave de encriptação fornecida pelo cliente que protege o disco.{ "diskEncryptionKey": { "sha256": "abcdefghijk134560459345dssfd" } }
REST
Faça um pedido
POST
ao métodocompute.disks.get
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco
Pedir resposta
Se a resposta for
null
, o disco usa um Google-owned and managed key.Caso contrário, a resposta é um objeto JSON.
Se o objeto JSON contiver um campo denominado
diskEncryptionKey
, o disco está encriptado. O objetodiskEncryptionKey
contém informações sobre se o disco está encriptado com CMEK ou CSEK:- Se a propriedade
diskEncryptionKey.kmsKeyName
estiver presente, o disco está encriptado com CMEK. A propriedadekmsKeyName
indica o nome da chave específica usada para encriptar o disco:{ "diskEncryptionKey": { "kmsKeyName": "projects/my-proj/.." } }
- Se a propriedade
diskEncryptionKey.sha256
estiver presente, o disco está encriptado com CSEK. A propriedadesha256
é o hash SHA-256 da chave de encriptação fornecida pelo cliente que protege o disco.{ "diskEncryptionKey": { "sha256": "abcdefghijk134560459345dssfd" } }
Se o disco usar CMEKs, pode encontrar informações detalhadas sobre a chave, o respetivo conjunto de chaves e a localização seguindo os passos em Ver chaves por projeto.
Se o disco usar CSEKs, contacte o administrador da sua organização para obter detalhes sobre a chave. Ao usar uma CMEK, também pode ver que recursos essa chave protege com a monitorização da utilização de chaves. Para mais informações, consulte o artigo Veja a utilização de chaves.
Veja todos os detalhes de um disco
Para obter informações gerais sobre o disco, pode ver todas as propriedades de um disco de uma só vez.
Consola
Na Google Cloud consola, aceda à página Discos.
Na coluna Nome, clique no nome do disco.
A tabela Propriedades é apresentada com um resumo das informações básicas do disco.
Para ver informações adicionais sobre o disco, clique em EQUIVALENTE REST.
É apresentada uma janela de diálogo com a resposta REST original da API Compute Engine.
gcloud
Execute o comando
gcloud compute disks describe
.gcloud compute disks describe DISK_NAME \ --zone=ZONE
Substitua o seguinte:
DISK_NAME
: o nome do disco.ZONE
: a zona onde o disco está localizado.
Resultado do comando
Todos os dados associados ao disco do Compute Engine.
REST
Faça um pedido
POST
ao métodocompute.disks.get
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do seu projeto.ZONE
: a zona onde o disco está localizado.DISK_NAME
: o nome do disco
Pedir resposta
A resposta REST contém todos os dados associados ao disco do Compute Engine.
O que se segue?
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-25 UTC.
-