使用场景

媒体存储提供桶清单功能，可以通过桶清单获得Bucket中指定对象的数量、大小、存储类型、最新更新时间以及ETag等。配置清单规则后，媒体存储将根据规则，每周生成桶清单文件。

适用区域

本功能目前仅部分资源池支持，具体可参考：资源池与区域节点。

如需使用，可联系客户经理或提交工单申请。

使用说明

• 每个存储桶最多设置10个清单。

• 生成周期：用户设置完成后，根据创建时间，按T+1生成第一份清单报告，T+1+7生成第二份，以此类推。

• 桶清单配置的源桶和目标桶必须归属同一个帐号、在同一个区域。

• 桶清单将根据所填前缀筛选对象或者列出所有对象。

清单报告存储路径

清单报告及其相关文件会上传至目标存储桶中，具体路径如下：

<dest-bucket-name>/（目标存储桶桶名）
└── <dest-prefix>/（清单报告目录，如无则省略）
    └── <source-bucket-name>/（源桶同名）
        └── <inventory-id>/（清单任务名称）
            ├── YYYY-MM-DDTHH/  (扫描开始的日期)
                  ├── manifest.json   (清单任务的元数据文件)
                  └── manifest.checksum (manifest.json 文件的 MD5)
                  └── inventoryFile/（清单文件）
                       └── timestamp-task-1.csv（timastamp为清单任务开始的时间戳）
                       └── timestamp-task-2.csv

清单文件

清单报告

清单报告中包含清单任务的各项信息，以下为清单内容：

• 源桶名

• 对象名

• 对象大小（以字节byte为单位）

• 最新更新时间

• 存储类型

• ETag

生成的清单文件首行为表头，从第二行开始为实际的清单内容，元数据之间以逗号分隔，示例如下：

源桶名,对象名,对象大小(byte),最新更新时间,存储类型,ETag
bucket01,obj1.txt,3, 2023-06-14 15:58:23,低频型,d022646351048ac0ba397d12dfafa304-1
bucket01,obj2.txt,4, 2023-06-14 15:58:33,低频型,00e4595eafdabb56b49cbf810aadd5aa-1

manifest文件

manifest文件提供相关清单报告的元数据和基本信息，具体样例如下：

{
  "fileFormat": "CSV",
  "version": "v2.0",
  "fileSchema": "源桶名，对象名，对象大小（byte）,最新更新时间，存储类型，Etag",
  "creationTimestamp": 1765872112934,
  "sourceBucket": "sourceBucketName",
  "destinationBucket": "destinationBucketName",
  "files": [
    {
      "Key": "dest-prefix/sourceBucketName/inventory-id/date/inventoryFile/1765872112934-317-00001.csv",
      "Size": 220,
      "MD5checksum": "55faae10a294f68c16cabdf6********"
    }
  ]
}

各字段说明如下：

使用方式