Acesse o layout de armazenamento de um bucket

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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 de objetos do Storage (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. Tenha 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 recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

Faça uma avaliação sem custo financeiro do Cloud Storage