Nesta página, descrevemos como criar, listar, fazer upload, excluir e receber metadados de pastas em buckets com o namespace hierárquico ativado.
Antes de começar
Verifique se o namespace hierárquico está ativado no bucket. Para instruções detalhadas sobre como ativar o namespace hierárquico em um bucket, consulte Criar buckets com namespace hierárquico ativado.
Criar uma pasta
Esta seção descreve como criar uma pasta.
Console
-
No console do Google Cloud, acesse a página Buckets do Cloud Storage.
- Na lista de buckets, clique no nome do bucket em que você quer criar a pasta.
- Na página Detalhes do bucket, clique em Criar pasta para criar uma pasta vazia.
- No campo Nome, insira um nome para a pasta. Para considerações de nomenclatura, consulte Considerações.
- Clique em Criar
A pasta recém-criada será exibida no painel Navegador de pastas.
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 para desenvolvedores, execute o comando
gcloud storage folders create
:gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME
Em que:
BUCKET_NAME
é o nome do bucket. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta gerenciada que você quer criar. Por exemplo,my-folder/
. Para informações sobre nomes de pastas, consulte a documentação com a visão geral de pastas.--recursive
é uma sinalização que cria automaticamente todas as pastas mãe inexistentes com a pasta. Essa configuração é opcional quando já existem pastas mãe.
Se a solicitação for bem-sucedida, o comando retornará a seguinte mensagem:
Completed 1/1
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, acesse Configurar a autenticação para 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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.- Crie um arquivo JSON com as configurações da pasta, que precisa incluir um
name
para a pasta. Consulte a documentação Folders: Insert para conferir uma lista completa de configurações. Estas são as configurações necessárias para incluir:{ "name": "FOLDER_NAME", }
Em que FOLDER_NAME é o nome da pasta gerenciada que você quer criar. Por exemplo,
my-folder/
. Para informações sobre nomes de pastas, consulte a documentação com a visão geral de pastas. - Use
cURL
(em inglês) 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/BUCKET_NAME/folders?recursive=true"
Em que:
JSON_FILE_NAME
é o nome do arquivo JSON que contém as configurações da pasta.BUCKET_NAME
é o nome do bucket em que você quer criar a pasta.recursive
está definido como verdadeiro para criar automaticamente todas as pastas mãe inexistentes com a pasta. Essa configuração é opcional quando já existem pastas mãe.
Listar pastas
Esta seção descreve como listar pastas.
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket que contém as pastas que você quer listar.
No painel Navegador de pastas, use a seta de expansão
para expandir a lista de pastas no bucket.Uma lista mostra as pastas, as pastas simuladas e as pastas gerenciadas no bucket.
Linha de comando
Para listar todas as pastas em um bucket, execute o comando gcloud storage folders list
:
gcloud storage folders list gs://BUCKET_NAME/
Em que:
BUCKET_NAME
é o nome do bucket que contém as pastas gerenciadas que você quer listar. Por exemplo,my-bucket
.
Uma resposta bem-sucedida é semelhante ao exemplo a seguir:
bucket: hns-bucket id: hns-bucket/A/ kind: storage#folder name: A/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/A timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/ kind: storage#folder name: B/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/D/ kind: storage#folder name: D/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B/D timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/ kind: storage#folder name: C/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/E/ kind: storage#folder name: E/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C/E timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' ...
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, acesse Configurar a autenticação para 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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação para listar pastas:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders"
Em que
BUCKET_NAME
é o nome do bucket que contém as pastas gerenciadas que você quer listar. Por exemplo,my-bucket
.
Fazer upload de uma pasta
Esta seção descreve como fazer upload de pastas para um bucket.
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket para fazer o upload da pasta.
Na guia Detalhes do bucket, realize uma das seguintes ações:
Arraste pastas da área de trabalho ou do gerenciador de arquivos para o painel principal no console do Google Cloud.
Clique em Fazer upload > Fazer upload de pasta, selecione a pasta que você quer enviar na caixa de diálogo exibida e clique em Abrir.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud, consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage cp
com a sinalização --recursive
:
gcloud storage cp --recursive FOLDER_LOCATION gs://DESTINATION_BUCKET_NAME
Em que:
FOLDER_LOCATION
é o caminho local da pasta que você quer enviar. Por exemplo,../uploads/my-folder/
.DESTINATION_BUCKET_NAME
é o nome do bucket para o qual você está fazendo o upload da pasta. Por exemplo,my-bucket
.
Se funcionar, a resposta será parecida com esta:
Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Completed files 2/2 | 1.7MiB/1.7MiB
excluir uma pasta
Esta seção descreve como excluir pastas.
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket com as pastas que você quer excluir.
No painel Navegador de pastas, use a seta de expansão
para expandir a lista de pastas no bucket.Encontre a pasta que você quer excluir.
Clique no menu
Mais ações da pasta.Clique em Excluir pasta.
Para confirmar que você quer excluir a pasta gerenciada, digite
DELETE
no campo Excluir.Clique em Excluir.
A pasta gerenciada e seu conteúdo, incluindo objetos armazenados e outras pastas gerenciadas, são excluídos do bucket do Cloud Storage.
Linha de comando
Para excluir uma pasta vazia, execute o comando gcloud storage folders delete
:
gcloud storage folders delete gs://BUCKET_NAME/FOLDER_NAME
Em que:
BUCKET_NAME
é o nome do bucket. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta gerenciada que você quer criar. Por exemplo,my-folder/
.
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, acesse Configurar a autenticação para 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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação deDELETE
pasta:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Em que:
BUCKET_NAME
é o nome do bucket que contém a pasta que você quer excluir. Por exemplo,my-bucket
.FOLDER_NAME
é o nome codificado por URL da pasta que você quer excluir. Por exemplo,my-folder/
, codificado por URL comomy-folder%2F
.
Receber os metadados de uma pasta
Esta seção descreve como receber os metadados de uma pasta.
Linha de comando
Para acessar os metadados de uma pasta, execute o comando gcloud storage folders describe
:
gcloud storage folders describe gs://BUCKET_NAME/FOLDER_NAME
Em que:
BUCKET_NAME
é o nome do bucket que contém a pasta cujos metadados você quer recuperar. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta com metadados. que você quer recuperar. Por exemplo,my-folder/
.
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, acesse Configurar a autenticação para 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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
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, acesse Configurar a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação deGET
pasta:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Em que:
BUCKET_NAME
é o nome do bucket; que contém a pasta cujos metadados você quer recuperar. Por exemplo,my-bucket
.FOLDER_NAME
é o nome codificado pelo URL. da pasta cujos metadados você quer recuperar. Por exemplo,my-folder/
, codificado em URL comomy-folder%2F
.
Gerenciar o acesso a uma pasta
Nesta seção descrevemos como gerenciar o acesso à pasta definindo as políticas do Identity and Access Management (IAM) para ter controle de acesso refinado sobre grupos específicos de objetos em um bucket.
Para gerenciar o acesso à pasta, siga estas etapas:
Ative o gerenciamento na pasta criando uma pasta gerenciada com o mesmo nome da pasta atual. Para instruções detalhadas, consulte Criar uma pasta gerenciada.
Defina e gerencie políticas de gerenciamento de identidade e acesso (IAM) na pasta gerenciada criada.
A seguir
- Renomear pastas.
- Crie buckets com namespace hierárquico ativado.
- Usar o namespace hierárquico para cargas de trabalho do Hadoop.
- Otimize o gerenciamento de 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