设置存储空间清单

概述

存储空间清单是一种帮助用户管理存储桶中对象的功能。BOS 可根据用户的清单任务配置，定期每天或者每周扫描用户 Bucket 中指定对象并输出一份清单报告，以 CSV 格式文件的形式存储到用户指定的 Bucket 中。CSV 文件中会列出对象及其对应的元数据，并根据用户的配置信息，记录用户所需的对象属性信息。

说明：

• 当前该功能在华东-苏州区域全量开放，其他地域目前需要先开通白名单。若需使用，请提交工单联系我们。

使用场景

清单是一种帮助用户管理存储桶中对象的功能，可以有计划地取代对象存储的 List API 操作。您可以使用清单功能实现包括但不限于以下基本用途：

• 定期审核并输出文件列表及文件相关属性。
• 通过定期扫描简化并加快业务工作流，无需通过脚本实现，简单配置即可定期输出文件报告。

设置存储空间清单

1. 登录 对象存储 BOS 管理控制台。
2. 在左侧 Bucket 列表中，选择需要设置权限的 Bucket，点击 Bucket 名称进入 Bucket 管理目录。
3. 在上方导航栏选择 配置管理 页签。
4. 在 配置管理 页面中选择 高级配置，在 清单配置 区域点击 新增配置，创建清单规则。

5.设置清单规则

配置名称	配置描述
清单状态	开启：清单规则创建后立即生效，BOS 根据规则配置定期扫描并输出报告 关闭：仅创建清单规则创建但不开启规则，后续可自行开启
清单名称	输入清单规则名称，只能包含大小写字母，数字和-_ .；必须以字母开头,长度1-64
清单存储位置	输出清单报告的存储位置，需为当前地域下的其他 Bucket，不支持存放到当前 Bucket
报告清单前缀	输入清单前缀名称。您可自定义一个名称，作为该策略下生成的清单报告前缀。
包含文件范围	可设置对整个 Bucket 文件生效或者仅对前缀文件生效
清单导出周期	您可以设置每三天或者每周导出一次清单
清单导出格式	当前支持导出 CSV 格式清单报告

说明：

• 每个 Bucket 最多同时创建 20 条清单规则。当超过规则数量上限后，您需要删除已有规则后重新创建；
• BOS 的清单功能目前免费提供。

6.编辑或者删除清单规则

您可以对已创建的清单规则进行编辑，如将关闭的清单规则设置为开启状态。您也可以将已创建的清单规则删除。规则删除后，BOS 将不会按照该规则继续为您输入清单报告。

清单报告内容

输出的清单报告中包含如下内容：

字段说明	说明
Bucket	Bucket 名称
Key	文件名称
Size	文件数据长度
Etag	对象的哈希。可能是对象数据 base64 编码的 MD5 摘要，这取决于对象的创建方式
StorageClass	文件的存储类型
CreateTime	文件的创建时间。时间格式为：yyyy-mm-ddThh:mm:ssZ 。如：2016-09-07T00:00:00Z（UTC）