Esta página mostra como obter informações sobre os metadados dos seus contentores do Cloud Storage, excluindo as políticas IAM e as ACLs.
Para saber como obter a Política IAM do seu contentor, consulte o artigo Ver a Política IAM de um contentor.
Funções necessárias
Para receber as autorizações necessárias para obter os metadados de um contentor do Cloud Storage, peça ao seu administrador para lhe conceder a função de administrador do armazenamento (roles/storage.admin
) no contentor.
Esta função contém as autorizações necessárias para obter os metadados de um contentor. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.buckets.get
storage.buckets.list
- Esta autorização só é necessária se planear usar a consola Trusted Cloud para realizar a tarefa nesta página.
Também pode conseguir estas autorizações com outras funções predefinidas ou funções personalizadas.
Para obter instruções sobre como conceder funções em contentores, consulte o artigo Use o IAM com contentores.
Apresente os metadados de um contentor
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor cujos metadados quer ver.
Clique no separador Configuração para ver os detalhes do contentor, como as regiões incluídas, a classe de armazenamento, as autorizações e o tipo de replicação.
Linha de comandos
Use o comando gcloud storage buckets describe
:
gcloud storage buckets describe gs://BUCKET_NAME
Onde:
BUCKET_NAME
é o nome do contentor cujos metadados quer ver. Por exemplo,my-awesome-bucket
.
Se for bem-sucedido, a resposta é semelhante ao seguinte exemplo:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Terraform
Pode usar um recurso do Terraform para ver os metadados de um contentor.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedidoGET
Bucket: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 contentor relevante. Por exemplo,my-bucket
.Opcionalmente, pode restringir os resultados dos metadados através do 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"
Onde
FIELD#
é uma propriedade de um contentor que quer incluir no resultado. Por exemplo,projectNumber
estorageClass
.
A resposta tem o seguinte aspeto:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com um pedido deGET
contentor:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?QUERY_PARAMETER"
Onde:
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.QUERY_PARAMETER
é o campo de metadados que quer devolver. Por exemplo,storageClass
para obter a classe de armazenamento do contentor. Só pode usar um parâmetro de consulta de cada vez com a API XML. Para ver uma lista dos campos de metadados suportados pela API XML, consulte aGET
página de referência de contentores.
A resposta tem o seguinte aspeto:
<StorageClass>STANDARD</StorageClass>
.
O que se segue?
- Leia a vista geral dos metadados do contentor.
- Liste os objetos no seu contentor.
- Obtenha o tamanho do seu grupo.
- Obtenha metadados de objetos.
- Altere a classe de armazenamento predefinida do seu contentor.