对象存储OSS支持存储空间(Bucket)清单功能,可定期将您Bucket内文件(Object)的信息导出到指定Bucket,帮助您了解Object的状态,简化并加速工作流和大数据作业任务等。

背景信息

Bucket清单功能以周为单位您Bucket内的Object进行扫描,扫描完成后会生成CSV格式的清单报告,并存储到您指定的Bucket内。在清单报告中,您可以有选择地导出指定对象的元数据信息,如文件大小、加密状态等。清单文件的存储位置及每一列对应的含义请参见存储空间清单

说明
  • 通过控制台最多可配置和展示10条清单规则。
  • 使用Bucket清单功能会产生一定的费用,公测期间仅收取API请求费用和清单文件存储费用,暂不收取功能使用费用。
若使用子账号配置清单任务,需要具备以下权限:
  • 配置清单时,需调用PutBucketInventory、GetBucketInventory、ListBucketInventory、DeleteBucketInventory接口,所以需要有对应接口的调用权限。
  • 若主账号没有AliyunOSSRole的RAM角色,配置清单任务时需要生成该角色,因此子账号需要有CreateRole权限。
  • 若主账号已有AliyunOSSRole的RAM角色,配置清单任务时需要调用该角色,因此子账号需要有GetRole权限。

操作步骤

  1. 登录OSS管理控制台
  2. 单击Bucket列表,之后单击目标Bucket名称。
  3. 单击基础设置 > Bucket清单,之后单击设置
  4. 单击创建清单,在设置清单报告规则页面设置清单规则:
    参数 说明
    状态 设置清单任务的状态,可选择启动禁用
    规则名称 设置清单任务的名称。只允许小写字母、数字、短划线(-),且不能以短划线开头或结尾。
    目标Bucket 设置存储清单文件的Bucket,只能选择和源Bucket相同地域的Bucket。
    清单报告名前缀 设置清单报告名的前缀,可指定清单报告存储的目录。例如设置为test,OSS会将生成的清单文件存储在目标Bucket的根目录下test目录中。
    清单报告导出周期 设置清单报告的生成周期,可选择每周,系统将按照指定周期生成清单文件。
    注意
    • 目前,每天选项还未开放,将在后续版本发布,敬请期待。
    • 若Object的数量超过100亿,建议以周为单位,针对不同的文件前缀设置不同的清单任务,保证每个清单任务针对的文件不超过100亿个。
    • 为避免清单文件大量占用您的存储空间,请及时清理不再需要的清单文件。
    清单报告加密选项 选择清单文件的加密方式。
    • :不加密。
    • AES256:使用AES256加密清单文件。
    • KMS:使用KMS密钥加密清单文件。您需要提前在KMS平台创建一个与目标Bucket相同地域的KMS密钥。配置步骤请参见管理密钥
      说明 使用KMS密钥功能时会产生少量的KMS密钥API调用费用,费用详情请参考KMS计费标准
    对象版本 选择清单扫描针对的文件版本。
    • 当前版本:导出目标文件当前版本的信息。
    • 所有版本:导出目标文件所有版本的信息。

    版本功能介绍请参见版本控制介绍

    过滤前缀 设置目标文件前缀。设置后,清单规则仅扫描指定前缀的文件;置空则扫描整个Bucket内的文件。
    说明 若设置了前缀,但该前缀没有匹配到任何Object,则不会生成清单文件。
    清单内容可选信息 选择您希望导出的文件信息,包括Object大小存储类型最后更新时间ETag分片上传状态加密状态
  5. 选中我知晓并同意授予阿里云OSS服务访问Bucket资源的权限后,单击确定