本页介绍了已启用分层命名空间的存储分区中的文件夹。
概览
文件夹作为资源存在于已启用分层命名空间的存储分区中。您可以在类似文件系统的结构中整理文件夹内的对象。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/的文件夹（如果该文件夹尚不存在）。
后续步骤
自行试用
如果您是 Google Cloud 新手，请创建一个账号来评估 Cloud Storage 在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。
免费试用 Cloud Storage