Nesta página, você aprenderá como receber informações sobre o tamanho e os metadados de buckets do Cloud Storage.
Pré-requisitos
Os pré-requisitos podem variar com base na ferramenta usada:
Console
Para concluir este guia usando o Console do Google Cloud, é preciso ter as permissões de IAM adequadas. Se você não criou o bucket que quer acessar, talvez seja necessário que o proprietário do projeto atribua a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para o Console do Google Cloud.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Linha de comando
Para concluir este guia usando um utilitário de linha de comando, você precisa ter as permissões de IAM adequadas. Se você não criou o bucket que quer acessar, talvez seja necessário que o proprietário do projeto atribua a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para comandos gsutil.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Amostras de código
Para concluir este guia usando as bibliotecas de cliente do Cloud Storage, é preciso ter as permissões de IAM adequadas. Se você não criou o bucket que quer acessar, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias. Salvo indicação contrária, as solicitações de biblioteca de cliente são feitas pela API JSON.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
APIs REST
API JSON
Para concluir este guia usando a API JSON, é preciso ter as permissões do IAM adequadas. Se você não criou o bucket que quer acessar, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Determinar o tamanho de um bucket
Console
Se quiser usar o Metrics Explorer para visualizar as métricas de um recurso monitorado, siga estes passos:
- No Console do Google Cloud, acesse a página Metrics Explorer no Monitoring.
- Na barra de ferramentas, selecione a guia Explorer.
- Selecione a guia Configuração.
- Expanda o menu Selecionar uma métrica, digite
Total bytes
na barra de filtros e use os submenus para selecionar um tipo específico de recurso e métrica:- No menu Recursos ativos, selecione Bucket do GCS.
- No menu Categorias de métricas ativas, selecione Armazenamento.
- No menu Métricas ativas, selecione Total de bytes.
- Clique em Aplicar.
- Opcional: para configurar a visualização dos dados, adicione filtros e use os menus Agrupar por, Agregador e do tipo de gráfico. Por exemplo, é possível agrupar por rótulos de recurso ou métrica. Saiba mais em Selecionar métricas ao usar o Metrics Explorer.
- Opcional: altere as configurações do gráfico:
- Para cotas e outras métricas que geram relatórios de uma amostra por dia, defina o período como pelo menos uma semana e o tipo de gráfico como Gráfico de barras empilhadas.
- Para métricas com valor de distribuição, defina o tipo de gráfico como Gráfico de mapa de calor.
Use o Metrics Explorer também para medir outras métricas de bucket, como storage.googleapis.com/storage/object_count e storage.googleapis.com/storage/total_byte_seconds, que calculam, respectivamente, o número de objetos e a quantidade de armazenamento consumido diariamente. Consulte a documentação sobre métricas do Google Cloud para uma lista completa das métricas disponíveis. Consulte Métricas, séries temporais e recursos para mais informações sobre como usar o Metrics Explorer.
Linha de comando
Use o comando gsutil du
com uma sinalização -s
:
gsutil du -s gs://BUCKET_NAME
em que BUCKET_NAME
é o nome do bucket
pertinente.
A resposta terá esta aparência:
134620 gs://my-bucket
Nesse exemplo, o tamanho do bucket chamado my-bucket
é 134.620 bytes.
Exibir os metadados de um intervalo
Console
- No Console do Cloud, acesse a página Buckets do Cloud Storage.
Opcional: é possível limitar as colunas exibidas na lista de buckets do console do Google Cloud clicando no menu Opções de exibição de coluna ().
Na lista de buckets, encontre o bucket que você quer verificar e analise os cabeçalhos das colunas dos metadados a serem visualizados.
Linha de comando
Use o seguinte gsutil ls
comando:
gsutil ls -L -b gs://BUCKET_NAME
em que BUCKET_NAME
é o nome do bucket
pertinente.
A resposta terá esta aparência:
gs://my-bucket/ : Storage class: STANDARD Location constraint: US ...
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Terraform
É possível usar um recurso Terraform para visualizar os metadados de um bucket.
APIs REST
API JSON
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.
Use
cURL
(em inglês) para chamar a API JSON com uma solicitaçãoGET
Bucket:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Em que:
OAUTH2_TOKEN
é o nome do token de acesso que você gerou na etapa 1.BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Reduza os resultados aos campos do interesse usando parâmetros de consulta:
curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
Em que
FIELD#
é uma propriedade de bucket que você quer incluir no resultado. Por exemplo,location
estorageClass
.
A resposta terá esta aparência:
{ "location": "US", "storageClass": "STANDARD" }
API XML
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.
Use
cURL
para chamar a API XML com uma solicitaçãoGET
bucket:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
Em que:
OAUTH2_TOKEN
é o nome do token de acesso que você gerou na etapa 1.BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.QUERY_PARAMETER
é o campo de metadados que você quer retornar. Por exemplo,location
para receber o local do bucket. Somente é possível usar um parâmetro de consulta por vez com a API XML.
A resposta será parecida com este exemplo:
<LocationConstraint>US</LocationConstraint>
.
A seguir
- Leia a visão geral dos metadados do bucket.
- Liste os objetos no seu bucket.
- Altere a classe de armazenamento padrão do seu bucket.
- Adicione, remova e visualize os rótulos do seu bucket.
- Saiba mais sobre como monitorar seus recursos no Monitoring.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça uma avaliação gratuita do Cloud Storage