Acesse o layout de armazenamento de um bucket

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

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

2. 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

• Entender as pastas.
• Criar e gerenciar pastas.
• Renomear pastas.

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