Nesta página, você aprenderá como receber informações sobre o tamanho e os metadados de buckets do Cloud Storage.
Permissões necessárias
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.
Bibliotecas de cliente
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.
A menos que indicado de outra forma, as solicitações da biblioteca de cliente são feitas por meio da API JSON e exigem permissões conforme listado nas permissões do IAM para métodos JSON. Para conferir quais métodos da API JSON são invocados ao fazer solicitações usando uma biblioteca de cliente, registre as solicitações brutas.
Para conferir a lista de papéis do IAM 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.
- No painel Selecionar uma métrica, expanda o menu Métrica,
insira
Total bytes
na barra de filtros e use os submenus para selecionar um tipo de recurso e métrica específicos:- 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, agrupamentos e configure
os campos de alinhamento. Por padrão, o Metrics Explorer adiciona um agrupamento que faz a média de todas as séries temporais:
- Para agrupar séries temporais por identificadores de recursos ou métricas, abra o menu Identificadores na seção Agrupar por e faça as seleções. Também é possível alterar a função de agrupamento.
- Para visualizar todas as séries temporais, na entrada Agrupar por, clique em deleteExcluir.
- Para acessar os campos de alinhamento, clique em Mais opções.
- Opcional: mude as configurações no painel Exibir:
- Para cotas e outras métricas que registram uma amostra por dia, defina o Tipo de widget como Gráfico de barras empilhadas.
- Para métricas de valor de distribuição, defina o tipo de widget como Gráfico de mapa de calor.
- Opcional: para cota e outras métricas que registram uma amostra por dia, defina o período como pelo menos uma semana.
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.
Na lista de buckets, clique no nome do bucket cujos metadados você quer ver.
Clique na guia Configuração para ver detalhes do bucket, como regiões incluídas, classe de armazenamento, permissões e tipo de replicação.
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 type: multi-region Location constraint: US ...
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
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
.
Como alternativa, é possível restringir os resultados de metadados usando o parâmetro de string de consulta
fields
. Exemplo: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. Para ver uma lista de campos de metadados compatíveis com a API XML, consulte a página de referência do bucketGET
.
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.
- Receber metadados do objeto.
- Altere a classe de armazenamento padrão 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