文件夹简介

Cloud Storage 提供了多种整理数据的方式，其中文件夹在这一过程中发挥重要作用。了解可用的不同类型的文件夹有助于您选择最适合您具体需求的文件夹。

本页面简要介绍了 Cloud Storage 中不同的文件夹类型，重点介绍了在启用分层命名空间后文件夹在存储桶中的作用。

文件夹类型

Cloud Storage 中有三种主要文件夹：

• 模拟文件夹：典型的 Cloud Storage 存储桶会在平面命名空间中整理对象。使用 Google Cloud 控制台和 Google Cloud CLI，您可以模拟文件夹来模仿文件树，以帮助您整理存储桶中的数据。如需详细了解模拟文件夹，请参阅模拟文件夹。

• 文件夹：在启用了分层命名空间的存储桶中，您可以创建包含对象的实际文件夹或其他文件夹。您还可以执行重命名文件夹和列出文件夹等操作。分层结构和文件夹管理操作可提高文件导向型和数据密集型工作负载的性能、一致性和管理效率。

• 托管式文件夹：借助托管式文件夹，您可以对对象应用精细的访问权限控制，从而增强数据的安全性和控制力。您可以在已启用或未启用分层命名空间的存储桶中使用托管式文件夹。如需详细了解托管式文件夹，请参阅托管式文件夹。

文件夹概览

文件夹作为资源存在于已启用分层命名空间的存储桶中。您可以在类似文件系统的结构中整理文件夹内的对象。Cloud Storage 提供了文件夹管理 API，可用于启用创建、删除、重命名和列出文件夹以及检索文件夹元数据等操作。

文件夹元数据

文件夹的元数据包含有关该文件夹的结构化信息。如需详细了解文件夹元数据，请参阅 Cloud Storage JSON API 参考文档中的 Folder 资源。

文件夹元数据的关键组件如下所示：

• bucket：文件夹所在的存储桶的名称。例如 my-bucket。
• id：存储桶中文件夹的唯一标识符。例如 hns-bucket/dir1/。
• kind：资源类型。对于文件夹，此值始终为 storage#folder。
• name：文件夹的名称。例如 dir1/。
• selfLink：引用 Cloud Storage API 中文件夹的网址。
• timeCreated：创建文件夹时的时间戳。例如 2023-05-05T16:32:08.878000+00:00。
• updated：上次更新文件夹时的时间戳。例如 2024-05-06T16:32:08.878000+00:00。

注意事项

创建文件夹时，请考虑以下事项：

• 对象名称和文件夹名称：启用了分层命名空间的存储桶支持所有有效的对象名称，包括具有前导斜杠、尾随斜杠 (/) 或连续斜杠的对象名称。对象名称中的每个正斜杠 (/) 都代表一个文件夹。下表展示了对象名称与其在文件夹层次结构中对应位置之间的关系示例：

  对象名称	在文件夹层次结构中的位置
  foo.txt	每个存储桶都包含一个根文件夹。对象 foo.txt 位于存储桶的根文件夹下。
  dir1/foo.txt	对象 foo.txt 位于名为 dir1/ 的顶级文件夹中。顶级文件夹不同于根文件夹。
  dir1/	对象名称中的尾部斜杠（如 dir1/）表示对象位于该文件夹中。在此示例中，对象名称 dir1/ 与父文件夹名称 dir1/ 相同。
  dir1//foo.txt	对象 foo.txt 位于名为 dir1// 的二级文件夹中，该文件夹是 dir1/ 的子文件夹。

• 文件夹深度上限：启用了分层命名空间的存储桶支持的文件夹深度上限为 50。因此，对象名称中的正斜线 (/) 不得超过 50 个。

• 文件夹名称大小上限：512 字节（采用 UTF-8 编码）。

• 自动创建文件夹：创建新对象会自动创建对象路径中指定的所有不存在的文件夹。例如，如果创建名为 dir1/foo.txt 的对象，系统会自动创建名为 dir1/ 的文件夹（如果该文件夹尚不存在）。

后续步骤

• 创建和管理文件夹。
• 重命名文件夹。
• 优化文件夹管理。