简介

您可以通过 对象存储控制台，为您的存储桶开通清单功能。开通清单功能可以实现定期每天或每周为您的存储桶输出一份关于对象属性、配置详情等清单报告。关于清单的更多详情，请参见 清单功能概述。下面将为您详细介绍如何开通存储桶清单功能。

注意：

• 用户可以在一个存储桶中配置多个清单任务。
• 清单任务执行过程中并不会直接读取对象内容，仅扫描对象元数据等属性信息。
• 清单功能目前暂不支持金融云地域。

前提条件

已创建存储桶，详情请参见 创建存储桶 文档。

操作步骤

1. 登录 对象存储控制台。
2. 在左侧导航栏中，单击【存储桶列表】，然后单击进入想要开通清单功能的存储桶（源存储桶）。
3. 单击左侧【基础配置】>【清单设置】，单击【添加清单】。
   
4. 在添加清单页面您可以进行以下配置：
   • 清单名称：输入您的输出清单名称。
   • 目标存储桶：是指存储清单的存储桶，初始默认目标存储桶即源存储桶，目标存储桶必须与源存储桶处于同一地域。
   • 清单报告前缀（选填）：输入为目标存储桶选择的前缀，可对公共位置的清单文件进行分组，初始为默认值。
   • 状态：您可以选择开启/关闭清单。
   • 【高级设置】：在高级设置中您可以配置更多的清单信息，若不进行高级设置，则全部为默认设置：
   • 输出格式：默认以 CSV 格式输出。
   • 对象版本：选择清单要包含对象的所有版本还是仅当前版本。如不选择，默认只保留当前版本。
   • 生成周期：选择清单是每日/每周进行导出，默认每日导出；例如当天下午15点添加了清单，通常最晚于次日的6点生成清单文件并投递至目标存储桶。
   • 筛选前缀（选填）：通过筛选将相同对象键前缀的对象列入清单。若不填写，默认不筛选。
   • 筛选时间（选填）：通过筛选将修改时间为某时间点后或某时间段内的对象列入清单。若不设置，默认不筛选。
   • 清单加密：选择清单是否需要服务端加密，您可选择：
     • 不加密：不加密清单，此项为默认项。
     • SSE-COS：使用 COS 托管密钥的服务端加密来加密报告，有关更多信息，请参见对象存储开发者指南中的 SSE-COS 加密。
   • 清单信息：选择清单报告需要包含的对象的相应信息，可选项有：对象大小、存储类别、ETag、存储桶复制状态、分块上传状态、最新更新日期。若不选择，默认全选。
     

注意：

ETag（实体标签）是对象的哈希，ETag 仅反映对对象内容的更改，而不反映对其元数据的更改。ETag 不一定是对象数据的 MD5 摘要，这取决于对象的创建方式和加密方式。

5. 确认配置信息无误后，最后单击【保存】即可。此后 COS 将每日或每周自动生成清单文件并投递到您所设置的目标存储桶。

   说明：

   如需了解清单功能生成的清单报告格式和内容详情，请参见 清单功能概述。