Sobre as pastas em buckets com namespace hierárquico ativado

Nesta página, você encontra informações sobre pastas em buckets com namespace hierárquico ativado.

Visão geral

As pastas existem como um recurso em buckets com o namespace hierárquico ativado. É possível organizar objetos em pastas em uma estrutura semelhante a um sistema de arquivos. O Cloud Storage oferece APIs de gerenciamento de pastas que permitem operações como criar, excluir, renomear e listar pastas, além de recuperar os metadados da pasta.

Metadados da pasta

Os metadados de uma pasta contêm informações estruturadas sobre ela. Para informações detalhadas sobre metadados de pasta, consulte o recurso Folder na documentação de referência da API JSON do Cloud Storage.

Os principais componentes dos metadados de uma pasta são:

  • bucket: o nome do bucket em que a pasta está. Por exemplo, my-bucket.
  • id: um identificador exclusivo da pasta no bucket. Por exemplo, hns-bucket/dir1/.
  • kind: o tipo de recurso. Para uma pasta, esse valor é sempre storage#folder.
  • name: o nome da pasta. Por exemplo, dir1/.
  • selfLink: um URL que faz referência à pasta na API Cloud Storage.
  • timeCreated: o carimbo de data/hora em que a pasta foi criada. Por exemplo, 2023-05-05T16:32:08.878000+00:00.
  • updated: o carimbo de data/hora da última atualização do recurso. Por exemplo, 2024-05-06T16:32:08.878000+00:00.

Considerações

Ao criar pastas, considere o seguinte:

  • Nomes de objetos e pastas: buckets com namespace hierárquico ativado oferecem suporte a todos os nomes de objeto válidos, incluindo aqueles com barras iniciais e finais (/) ou barras consecutivas. Cada barra encaminhada (/) em um nome de objeto representa uma pasta. A tabela a seguir mostra exemplos da relação entre nomes de objetos e seu local correspondente na hierarquia de pastas:

    Nome do objeto Local na hierarquia de pastas
    foo.txt Todo bucket possui uma pasta raiz. O objeto foo.txt fica na pasta raiz do bucket.
    dir1/foo.txt O objeto foo.txt fica em uma pasta de nível superior chamada dir1/. A pasta de nível superior é diferente da pasta raiz.
    dir1/ A barra à direita em nomes de objetos, como dir1/ indica que o objeto está na pasta. Neste exemplo, o nome do objeto dir1/ é igual ao nome da pasta mãe dir1/.
    dir1//foo.txt O objeto foo.txt reside em uma pasta de segundo nível chamada dir1//, uma pasta filha de dir1/.

  • Profundidade máxima da pasta: buckets com namespace hierárquico ativado dão suporte a uma profundidade de pasta máxima de 50. Como resultado, os nomes de objetos não podem ter mais de 50 barras (/).

  • Tamanho máximo do nome da pasta: 512 bytes (codificados em UTF-8).

  • Criação automática de pastas: a criação de um novo objeto cria automaticamente pastas inexistentes especificadas no caminho do objeto. Por exemplo: criar um objeto chamado dir1/foo.txt cria automaticamente a pasta dir1/, se ela ainda não existir.

  • Informações sensíveis ou de identificação pessoal (PII): os nomes das pastas são mais visíveis do que os metadados delas. Por exemplo, os nomes de pastas aparecem em URLs e ao listar pastas ou objetos em um bucket. Não inclua informações sensíveis ou PII nos nomes das pastas.

A seguir