创建 S3 生命周期配置
您可以创建 S3 生命周期配置,以控制何时从 StorageGRID 系统中删除特定对象。
本节中的简单示例说明了 S3 生命周期配置如何控制从特定 S3 存储分段中删除(过期)某些对象的时间。本节中的示例仅供说明。有关创建 S3 生命周期配置的完整详细信息,请参见 "《 Amazon Simple Storage Service 开发人员指南:对象生命周期管理》"。请注意, StorageGRID 仅支持到期操作,不支持过渡操作。
什么是生命周期配置
生命周期配置是一组应用于特定 S3 分段中的对象的规则。每个规则都指定受影响的对象以及这些对象的到期时间(在特定日期或一定天数后)。
StorageGRID 在一个生命周期配置中最多支持 1 , 000 条生命周期规则。每个规则可以包含以下 XML 元素:
-
到期日期:从对象载入开始,在达到指定日期或达到指定天数时删除对象。
-
NoncurrentVersionExpiration :从对象变为非最新状态开始,在达到指定天数时删除对象。
-
筛选器(前缀,标记)
-
Status
-
ID
如果将生命周期配置应用于某个存储分段,则存储分段的生命周期设置始终会覆盖 StorageGRID ILM 设置。StorageGRID 使用存储分段的 " 到期 " 设置(而不是 ILM )来确定是删除还是保留特定对象。
因此,即使 ILM 规则中的放置说明仍适用于某个对象,该对象也可能会从网格中删除。或者,即使对象的任何 ILM 放置指令已失效,该对象也可能会保留在网格中。有关详细信息,请参见 ILM 如何在对象的整个生命周期内运行。
存储分段生命周期配置可用于启用了 S3 对象锁定的存储分段,但旧版合规存储分段不支持存储分段生命周期配置。 |
StorageGRID 支持使用以下存储分段操作来管理生命周期配置:
-
删除存储分段生命周期
-
获取存储分段生命周期
-
PUT 存储分段生命周期
创建生命周期配置
作为创建生命周期配置的第一步,您需要创建一个包含一个或多个规则的 JSON 文件。例如,此 JSON 文件包含三个规则,如下所示:
-
规则 1 仅适用于与前缀
category1
/ 匹配且key2
值为ag2
的对象。Expiration
参数指定与筛选器匹配的对象将在 2020 年 8 月 22 日午夜到期。 -
规则 2 仅适用于与前缀
category2
/ 匹配的对象。Expiration
参数指定与筛选器匹配的对象将在载入后 100 天后过期。指定天数的规则与对象的载入时间相关。如果当前日期超过载入日期加上天数,则在应用生命周期配置后,可能会立即从存储分段中删除某些对象。 -
规则 3 仅适用于与前缀
category3
/ 匹配的对象。Expiration
参数指定任何非最新版本的匹配对象将在其变为非最新状态 50 天后过期。
{ "Rules": [ { "ID": "rule1", "Filter": { "And": { "Prefix": "category1/", "Tags": [ { "Key": "key2", "Value": "tag2" } ] } }, "Expiration": { "Date": "2020-08-22T00:00:00Z" }, "Status": "Enabled" }, { "ID": "rule2", "Filter": { "Prefix": "category2/" }, "Expiration": { "Days": 100 }, "Status": "Enabled" }, { "ID": "rule3", "Filter": { "Prefix": "category3/" }, "NoncurrentVersionExpiration": { "NoncurrentDays": 50 }, "Status": "Enabled" } ] }
将生命周期配置应用于存储分段
创建生命周期配置文件后,您可以通过发出 PUT 存储分段生命周期请求将其应用于存储分段。
此请求会将示例文件中的生命周期配置应用于名为 testbucket
的存储分段中的对象。
aws s3api --endpoint-url <StorageGRID endpoint> put-bucket-lifecycle-configuration --bucket testbucket --lifecycle-configuration file://bktjson.json
要验证是否已成功将生命周期配置应用于存储分段,请发送问题描述 获取存储分段生命周期请求。例如:
aws s3api --endpoint-url <StorageGRID endpoint> get-bucket-lifecycle-configuration --bucket testbucket
成功的响应将列出您刚刚应用的生命周期配置。
验证存储分段生命周期到期适用场景 对象
在发出 PUT 对象, HEAD 对象或 GET 对象请求时,您可以确定生命周期配置适用场景 中的到期规则是否为特定对象。如果适用某条规则,响应将包含一个 Expiration
参数,用于指示对象何时到期以及匹配的到期规则。
由于存储分段生命周期会覆盖 ILM ,因此显示的 expiry-date 是删除对象的实际日期。有关详细信息,请参见 如何确定对象保留。
|
例如,此 PUT 对象请求是在 2020 年 6 月 22 日发出的,并将一个对象放置在 testbucket
存储分段中。
aws s3api --endpoint-url <StorageGRID endpoint> put-object --bucket testbucket --key obj2test2 --body bktjson.json
成功响应表示此对象将在 100 天后( 2020 年 10 月 1 日)过期,并且与生命周期配置的规则 2 匹配。
{
*"Expiration": "expiry-date=\"Thu, 01 Oct 2020 09:07:49 GMT\", rule-id=\"rule2\"",
"ETag": "\"9762f8a803bc34f5340579d4446076f7\""
}
例如,此 head Object 请求用于获取测试分段中同一对象的元数据。
aws s3api --endpoint-url <StorageGRID endpoint> head-object --bucket testbucket --key obj2test2
成功响应包括对象的元数据,并指示对象将在 100 天后过期,并且与规则 2 匹配。
{
"AcceptRanges": "bytes",
*"Expiration": "expiry-date=\"Thu, 01 Oct 2020 09:07:48 GMT\", rule-id=\"rule2\"",
"LastModified": "2020-06-23T09:07:48+00:00",
"ContentLength": 921,
"ETag": "\"9762f8a803bc34f5340579d4446076f7\""
"ContentType": "binary/octet-stream",
"Metadata": {}
}