Nesta página, descrevemos como criar, listar e excluir buckets com o namespace hierárquico ativado.
Crie um bucket
Nesta seção, descrevemos como criar um bucket com namespace hierárquico ativado.
Linha de comando
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
No ambiente de desenvolvimento, execute o comando
gcloud alpha storage buckets create
:gcloud alpha storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --uniform-bucket-level-access --enable-hierarchical-namespace
Em que:
BUCKET_NAME
é o nome que você quer dar ao bucket, sujeito a requisitos de nomenclatura. Exemplo:my-bucket
BUCKET_LOCATION
é o local do bucket. Por exemplo,us-east1
.--uniform-bucket-level-access
: ative o acesso uniforme no nível do bucket para seu bucket.
--enable-hierarchical-namespace
: ative o namespace hierárquico do bucket. Não é possível ativar o namespace hierárquico em um bucket atual.
Se a solicitação for bem-sucedida, o comando retornará a seguinte mensagem:
Creating gs://BUCKET_NAME/...
Para ter mais controle sobre a criação do bucket, defina as seguintes flags:
--project
: especifique o ID ou número do projeto a que o bucket será associado. Por exemplo,my-project
.--default-storage-class
: especifique a classe de armazenamento padrão do bucket. Por exemplo,STANDARD
.
Para uma lista completa de opções para criar buckets usando a CLI do Google Cloud, consulte
buckets create
opções.Exemplo:
gcloud alpha storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara 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
.- Crie um arquivo JSON com as configurações do bucket, incluindo um
name
para o bucket. Consulte a documentação Buckets:Insert para ver uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas: BUCKET_NAME
é o nome que você quer dar ao bucket, sujeito a requisitos de nomenclatura. Por exemplo,my-bucket
.BUCKET_LOCATION
é o local em que você quer armazenar os dados de objeto do intervalo. Por exemplo,US-EAST1
.STORAGE_CLASS
é a classe de armazenamento padrão do bucket. Por exemplo,STANDARD
.hierarchicalNamespace.enabled
está definido comoTRUE
para ativar o namespace hierárquico do bucket. Não é possível ativar o namespace hierárquico em um bucket atual.- Use
cURL
para chamar a API JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Em que:
JSON_FILE_NAME
é o nome do arquivo JSON que contém as configurações do bucket.PROJECT_IDENTIFIER
é o ID ou número do projeto ao qual o bucket será associado. Por exemplo,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "hierarchicalNamespace": { "enabled": "BOOLEAN" }, }
Em que:
O layout de armazenamento de um bucket descreve como os objetos são organizados em um bucket, seja em um namespace plano ou hierárquico. Para conferir instruções sobre como visualizar o layout de armazenamento de um bucket, consulte Receber o layout de armazenamento de um bucket.
Para listar todos os buckets, independente do layout de armazenamento, siga as instruções detalhadas em Listar buckets.
É possível excluir um bucket com namespace hierárquico ativado da mesma maneira que qualquer outro bucket. Para fins de exclusão, se um bucket ativado com namespace hierárquico tiver apenas pastas vazias e nenhum objeto ou pastas gerenciadas, ele será considerado vazio. Para instruções sobre como excluir buckets, consulte Excluir buckets.
A seguir
- Acesse informações sobre os metadados de um bucket.
- Receber informações sobre o layout de armazenamento de um bucket.
- 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