Acerca das pastas em contentores com o espaço de nomes hierárquico ativado

Esta página fornece informações sobre pastas em contentores com o espaço de nomes hierárquico ativado.

Vista geral

As pastas existem como um recurso em contentores com o espaço de nomes hierárquico ativado. Pode organizar objetos em pastas numa estrutura semelhante a um sistema de ficheiros. O Cloud Storage fornece APIs de gestão de pastas que permitem operações como criar, eliminar, mudar o nome e listar pastas, bem como obter metadados de pastas.

Metadados da pasta

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

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

  • bucket: o nome do contentor onde a pasta reside. Por exemplo, my-bucket.
  • id: um identificador exclusivo da pasta no contentor. Por exemplo, hns-bucket/dir1/.
  • kind: o tipo de recurso. Para uma pasta, este 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: a data/hora em que a pasta foi criada. Por exemplo, 2023-05-05T16:32:08.878000+00:00.
  • updated: a data/hora em que a pasta foi atualizada pela última vez. Por exemplo, 2024-05-06T16:32:08.878000+00:00.

Considerações

Ao criar pastas, considere o seguinte:

  • Nomes de objetos e pastas: os contentores com o espaço de nomes hierárquico ativado suportam todos os nomes de objetos válidos, incluindo os que têm barras invertidas no início ou no fim (/) ou barras invertidas consecutivas. Cada barra invertida (/) num nome de objeto representa uma pasta. A tabela seguinte mostra exemplos da relação entre os nomes dos objetos e a respetiva localização na hierarquia de pastas:

    Nome do objeto Localização na hierarquia de pastas
    foo.txt Cada contentor inclui uma pasta raiz. O objeto foo.txt reside na pasta raiz do contentor.
    dir1/foo.txt O objeto foo.txt reside numa pasta de nível superior denominada dir1/. A pasta de nível superior é diferente da pasta raiz.
    dir1/ A barra invertida no final dos nomes de objetos, como dir1/ indica que o objeto reside na pasta. Neste exemplo, o nome do objeto dir1/ é o mesmo que o nome da pasta principal dir1/.
    dir1//foo.txt O objeto foo.txt reside numa pasta de segundo nível denominada dir1//, uma pasta subordinada de dir1/.

  • Profundidade máxima da pasta: os contentores com o espaço de nomes hierárquico ativado suportam uma profundidade máxima da pasta de 50. Como resultado, os nomes dos 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 todas as pastas inexistentes especificadas no caminho do objeto. Por exemplo, se criar um objeto com o nome dir1/foo.txt, a pasta dir1/ é criada automaticamente se ainda não existir.

  • Informações sensíveis ou de identificação pessoal (IIP): os nomes das pastas são mais visíveis do que os metadados das pastas. Por exemplo, os nomes das pastas aparecem nos URLs e quando lista pastas ou objetos num contentor. Não inclua informações confidenciais nem IIP nos nomes das pastas.

O que se segue?