Nesta página, mostramos como receber informações sobre os metadados dos buckets do Cloud Storage, exceto políticas de IAM e ACLs.
Para saber como conseguir a política do IAM do bucket, consulte Visualizar a política do IAM de um bucket.
Funções exigidas
Para receber as permissões necessárias para receber os metadados de um bucket do Cloud Storage, peça ao administrador para conceder a você o papel de Administrador do Storage (roles/storage.admin
) no bucket.
Este papel contém as permissões necessárias para receber os metadados de um bucket. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.get
storage.buckets.list
- Essa permissão só será necessária se você planeja usar o console do Trusted Cloud para executar a tarefa nesta página.
Também é possível conseguir essas permissões com outros papéis predefinidos ou personalizados.
Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Exibir os metadados de um intervalo
Console
- No console Trusted 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 comando gcloud storage buckets describe
:
gcloud storage buckets describe gs://BUCKET_NAME
Em que:
BUCKET_NAME
é o nome do bucket em que há metadados que você quer acessar. Por exemplo,my-awesome-bucket
.
Se a operação for bem-sucedida, a resposta será semelhante a esta:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
C#
Saiba mais na documentação de referência C# da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Go
Saiba mais na documentação de referência Go da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Java
Saiba mais na documentação de referência Java da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Node.js
Saiba mais na documentação de referência Node.js da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
PHP
Saiba mais na documentação de referência PHP da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Python
Saiba mais na documentação de referência Python da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Ruby
Saiba mais na documentação de referência Ruby da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Terraform
É possível usar um recurso Terraform para visualizar os metadados de um bucket.
APIs REST
API JSON
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação de bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
Em que
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
. Por exemplo:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
Em que
FIELD#
é uma propriedade de bucket que você quer incluir no resultado. Por exemplo,projectNumber
estorageClass
.
A resposta terá esta aparência:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
API XML
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com uma solicitaçãoGET
bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?QUERY_PARAMETER"
Em que:
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.QUERY_PARAMETER
é o campo de metadados que você quer retornar. Por exemplo,storageClass
para acessar a classe de armazenamento 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:
<StorageClass>STANDARD</StorageClass>
.
A seguir
- Leia a visão geral dos metadados do bucket.
- Liste os objetos no seu bucket.
- Acesse o tamanho do bucket.
- Receber metadados do objeto.
- Altere a classe de armazenamento padrão do seu bucket.