Esta página descreve como criar, listar, carregar, eliminar e obter metadados de pastas em contentores com o espaço de nomes hierárquico ativado.
Antes de começar
Certifique-se de que o seu contentor tem o espaço de nomes hierárquico ativado. Para obter instruções detalhadas sobre como ativar o espaço de nomes hierárquico num contentor, consulte o artigo Crie contentores com o espaço de nomes hierárquico ativado.
Criar pasta
Esta secção descreve como criar uma pasta.
Consola
-
Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
- Na lista de contentores, clique no nome do contentor no qual quer criar a pasta.
- Na página Detalhes do contentor, clique em Criar pasta para criar uma pasta vazia.
- No campo Nome, introduza um nome para a pasta. Para considerações de nomenclatura, consulte Considerações.
-
Clique em Criar.
A pasta que acabou de criar é apresentada no painel do explorador de pastas.
Linha de comandos
-
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 seu ambiente de programação, execute o comando
gcloud storage folders create
:gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME
Onde:
BUCKET_NAME
é o nome do seu contentor. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta que quer criar. Por exemplo,my-folder/
. Para ver informações acerca dos nomes das pastas, consulte a documentação de vista geral das pastas.--recursive
é uma flag que cria automaticamente todas as pastas principais inexistentes, juntamente com a pasta. Esta definição é opcional quando já existem pastas principais.
Se o pedido for bem-sucedido, o comando devolve a seguinte mensagem:
Completed 1/1
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.- Crie um ficheiro JSON que contenha as definições da pasta, que tem de incluir um
name
para a pasta. Consulte a documentação Pastas: inserir para ver uma lista completa de definições. Seguem-se as definições obrigatórias a incluir:{ "name": "FOLDER_NAME", }
Em que FOLDER_NAME é o nome da pasta que quer criar. Por exemplo,
my-folder/
. Para ver informações sobre os nomes das pastas, consulte a documentação de vista geral das pastas. - 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/BUCKET_NAME/folders?recursive=true"
Onde:
JSON_FILE_NAME
é o nome do ficheiro JSON que contém as definições da pasta.BUCKET_NAME
é o nome do contentor onde quer criar a pasta.recursive
está definido como verdadeiro para criar automaticamente todas as pastas principais inexistentes juntamente com a pasta. Esta definição é opcional quando já existem pastas principais.
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Listar pastas
Esta secção descreve como listar pastas.
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor cujas pastas quer listar.
No painel Explorador de pastas, use a seta de expansão
para expandir a lista de pastas no seu contentor.É apresentada uma lista das pastas, das pastas simuladas e das pastas geridas no seu contentor.
Linha de comandos
Para apresentar uma lista de todas as pastas num contentor, execute o comando gcloud storage folders list
:
gcloud storage folders list gs://BUCKET_NAME/
Onde:
BUCKET_NAME
é o nome do contentor que contém as pastas que quer listar. Por exemplo,my-bucket
.
Uma resposta bem-sucedida tem o seguinte aspeto:
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 cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido para listar pastas:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders"
Onde
BUCKET_NAME
é o nome do contentor que contém as pastas que quer listar. Por exemplo,my-bucket
.
Carregue uma pasta
Esta secção descreve como carregar pastas para um contentor.
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor para o qual quer carregar a pasta.
No separador Detalhes do depósito, realize uma das seguintes ações:
Arraste pastas do ambiente de trabalho ou do gestor de ficheiros para o painel principal na consola Google Cloud .
Clique em Carregar > Carregar pasta, selecione a pasta que quer carregar na caixa de diálogo apresentada e, de seguida, clique em Abrir.
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
Use o comando gcloud storage cp
com a flag --recursive
:
gcloud storage cp --recursive FOLDER_LOCATION gs://DESTINATION_BUCKET_NAME
Onde:
FOLDER_LOCATION
é o caminho local para a pasta que quer carregar. Por exemplo,../uploads/my-folder/
.DESTINATION_BUCKET_NAME
é o nome do contentor para o qual está a carregar a sua pasta. Por exemplo,my-bucket
.
Se for bem-sucedido, a resposta é semelhante ao exemplo seguinte:
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
Elimine uma pasta
Esta secção descreve como eliminar pastas.
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor cujas pastas quer eliminar.
No painel Explorador de pastas, use a seta de expansão
para expandir a lista de pastas no seu contentor.Encontre a pasta que quer eliminar.
Clique no menu
Mais ações da pasta.Clique em Eliminar pasta.
Para confirmar que quer eliminar a pasta, escreva
DELETE
no campo Eliminar.Clique em Eliminar.
A pasta e o respetivo conteúdo, incluindo objetos armazenados e outras pastas geridas, são eliminados do seu contentor do Cloud Storage.
Linha de comandos
Para eliminar uma pasta vazia, execute o comando gcloud storage folders delete
:
gcloud storage folders delete gs://BUCKET_NAME/FOLDER_NAME
Onde:
BUCKET_NAME
é o nome do contentor. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta que quer eliminar. Por exemplo,my-folder/
.
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido 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"
Onde:
BUCKET_NAME
é o nome do contentor que contém a pasta que quer eliminar. Por exemplo,my-bucket
.FOLDER_NAME
é o nome codificado em URL da pasta que quer eliminar. Por exemplo,my-folder/
, URL codificado comomy-folder%2F
.
Obtenha os metadados de uma pasta
Esta secção descreve como obter os metadados de uma pasta.
Linha de comandos
Para obter os metadados de uma pasta, execute o comando gcloud storage folders describe
:
gcloud storage folders describe gs://BUCKET_NAME/FOLDER_NAME
Onde:
BUCKET_NAME
é o nome do contentor que contém a pasta cujos metadados quer obter. Por exemplo,my-bucket
.FOLDER_NAME
é o nome da pasta cujos metadados quer obter. Por exemplo,my-folder/
.
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedidoGET
Folder:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Onde:
BUCKET_NAME
é o nome do contentor que contém a pasta cujos metadados quer obter. Por exemplo,my-bucket
.FOLDER_NAME
é o nome com codificação de URL da pasta cujos metadados quer obter. Por exemplo,my-folder/
, codificado por URL comomy-folder%2F
.
Faça a gestão do acesso numa pasta
Esta secção descreve como gerir o acesso à sua pasta definindo políticas de gestão de identidade e de acesso (IAM), para que possa ter um controlo de acesso detalhado sobre grupos específicos de objetos num contentor.
Para gerir o acesso à sua pasta, siga estes passos:
Ative a gestão na sua pasta criando uma pasta gerida com o mesmo nome da sua pasta existente. Para instruções detalhadas, consulte o artigo Crie uma pasta gerida.
O que se segue?
- Mude o nome das pastas.
- Crie contentores com o espaço de nomes hierárquico ativado.
- Use o espaço de nomes hierárquico para cargas de trabalho do Hadoop.
- Otimize a gestão de pastas.
Experimente
Se está a usar o Google Cloud pela primeira vez, crie uma conta para avaliar o desempenho do Cloud Storage em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.
Experimentar o Cloud Storage gratuitamente