Acesse o layout de armazenamento de um bucket

Nesta página, descrevemos como determinar o layout de armazenamento do bucket. O armazenamento do layout se refere a como os objetos são organizados em um bucket, seja em um namespace plano ou um namespace hierárquico. O layout é importante para aplicativos que interagem com o bucket, como os métodos de acesso e manipulação de objetos variam de acordo com o layout. O layout de armazenamento também inclui informações sobre a localização do bucket.

Ao usar a API getStorageLayout, o aplicativo pode se adaptar com base no uso de um namespace hierárquico ou não, o que garante uma compatibilidade ideal e aproveita os recursos apropriados com base na configuração do bucket.

Papéis necessários

Para receber as permissões necessárias para receber os tamanhos de um bucket do Cloud Storage, peça ao administrador para conceder a você o papel de Usuário do objeto de armazenamento (roles/storage.objectUser) no bucket.

O papel contém a permissão storage.objects.list, que é para conseguir o layout de armazenamento do bucket.

Essa permissão também pode ser concedida com outros papéis personalizados ou papéis predefinidos. Para conferir quais papéis estão associados a quais permissões, consulte Papéis do IAM para o Cloud Storage.

Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.

Acesse o layout de armazenamento de um bucket

Linha de comando

Use o comando gcloud alpha storage buckets describe com a sinalização --format:

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Em que:

BUCKET_NAME é o nome do bucket relevante. Por exemplo, my-bucket.

Se bem-sucedido e o namespace hierárquico estiver ativado, a resposta procurará semelhante ao seguinte exemplo:

  hierarchicalNamespace:
    enabled: true

API JSON

Ter a gcloud CLI instalada e inicializada para gerar um token de acesso para o cabeçalho Authorization.

Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho Authorization.

Use cURL para chamar a API JSON com uma solicitação getStorageLayout:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

Em que BUCKET_NAME é o nome do bucket pertinente. Por exemplo, my-bucket.

Se funcionar, a resposta será parecida com esta:

  {
      "kind": "storage#storageLayout",
      "bucket": "my-bucket",
      "location": "us-central1",
      "locationType": "region",
      "hierarchicalNamespace":{enabled: true},
  }

A seguir

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