put_bucket_lifecycle_zh-CN.md

PUT Bucket Lifecycle

请求消息体

名称	类型	描述	是否必要
rule	List	rule 的元素为 Lifecycle 规则。规则为 Dict 类型，有效的键为 “id”、”status”、”filter”、”expiration”、”abort_incomplete_multipart_upload” 和 “transition”。规则总数不能超过 100 条，且每条规则中只允许存在一种类型的操作。同一 bucket, prefix 和 支持操作（ expiration, abort_incomplete_multipart_upload, transition) 不能有重复，否则返回 400 invalid_request 包含重复的规则信息 参见错误信息。	Yes
id	String	规则的标识符。可为任意 UTF-8 编码字符，长度不能超过 255 个字节，在一个 Bucket Lifecycle 中，规则的标识符必须唯一。该字符串可用来描述策略的用途。如果 id 有重复，会返回 400 invalid_request 。	Yes
status	String	该条规则的状态。其值可为 “enabled” (表示生效) 或 “disabled” (表示禁用)。	Yes
filter	Dict	用于匹配 Object 的过滤条件，有效的键为 “prefix”。	Yes
prefix	String	前缀匹配策略，用于匹配 Object 名称，空字符串表示匹配整个 Bucket 中的 Object。默认值为空字符串。	No
expiration	Dict	用于删除 Object 的规则，有效的键为 “days”。”days” 必须是正整数，否则返回 400 invalid_request。对于匹配前缀（prefix) 的对象在最后修改时间的指定天数（days）后删除该对象。	No
abort_incomplete_multipart_upload	Dict	用于取消未完成的分段上传的规则，有效的键为 “days_after_initiation”。”days_after_initiation” 必须是正整数，否则返回 400 invalid_request。	No
transition	Dict	用于变更存储级别的规则，有效的键为 “days”, “storage_class”。days 必须 >= 30, 否则返回 400 invalid_request。对于匹配前缀（prefix) 的对象在最后修改时间的指定天数（days）后变更到低频存储。	No
days	Integer	在对象最后修改时间的指定天数后执行操作。	No
days_after_initiation	Integer	在初始化分段上传的指定天数后执行操作。	Yes
storage_class	Integer	要变更至的 storage_class，支持的值为 "STANDARD"、"STANDARD_IA"。	Yes

访问 API Docs 以查看更多关于请求消息体的信息。

代码片段

使用您的 AccessKeyID 和 SecretAccessKey 初始化 Qingstor 对象。

from qingstor.sdk.service.qingstor import QingStor
from qingstor.sdk.config import Config

config = Config('ACCESS_KEY_ID_EXAMPLE', 'SECRET_ACCESS_KEY_EXAMPLE')
qingstor = QingStor(config)

然后根据要操作的 bucket 信息（zone, bucket name）来初始化 Bucket。

bucket_name = "your-bucket-name"
zone_name = "pek3b"
bucket_srv = qingstor.Bucket(bucket_name, zone_name)

然后您可以 PUT Bucket Lifecycle. 下面的代码设置 bucket 下的日志信息（存放于 logs/ 目录）在 180 天后自动执行删除操作。

rule = [
    {
        "id": "delete-logs",
        "status": "enabled",
        "filter": {
            "prefix": "logs/"
        },
        "expiration": {
            "days": 180
        }
    },
]
resp = bucket_srv.put_lifecycle(rule=rule)
if resp.status_code != 200:
    print("Set lifecycle of bucket(name: %s) failed with given message: %s\n" % (
        bucket_name, str(resp.content, "utf-8")))
else:
    print("Put bucket lifecycle successfully.")