生命周期设置

POST

/v4/oss/put-bucket-lifecycle-conf

1、规则启用时，expiration、noncurrentVersionExpiration、noncurrentVersionTransitions、transitions四个参数必传一项；
2、transitions字段 -- 公有云有该字段，混合云v1不支持=》混合云v2兼容
3、由于混合云v2控制台限制，expiration和transitions中选择days或date需要保持一致，要么都是days，要么都是date；
4、newerNoncurrentVersions、objectSizeGreaterThan和objectSizeLessThan，公有云未有该参数，兼容V1处理。此外注意：公有云文档、底层文档和aws官网文档都没有给出该值的范围限制。目前V2就只做了大于等于0的限制处理，不允许负数的情况。其余情况的错误信息由底层错误信息透传返回。

请求参数

Authorization

在 header 添加参数

userID

示例：

userID: ********************

Header 参数

Body 参数application/json

示例

{
    "bucket": "ztces-230404-create",
    "regionID": "nm8",
    "lifecycleConfiguration": {
        "rules": [
            {
                "status": "Enabled",
                "noncurrentVersionExpiration": {
                    "noncurrentDays": 123,
                    "newerNoncurrentVersions": 123
                },
                "noncurrentVersionTransitions": [
                    {
                        "noncurrentDays": 123,
                        "storageClass": "STANDARD_IA",
                        "newerNoncurrentVersions": 123
                    }
                ],
                "filter": {
                    "objectSizeGreaterThan": 123,
                    "and": {
                        "objectSizeGreaterThan": 123,
                        "prefix": "string",
                        "objectSizeLessThan": 123,
                        "tags": [
                            {
                                "key": "key1",
                                "value": "value1"
                            }
                        ]
                    },
                    "prefix": "prefix1",
                    "tag": {
                        "key": "tagkey",
                        "value": "tagvalue"
                    },
                    "objectSizeLessThan": 123
                },
                "prefix": "string",
                "expiration": {
                    "date": "2022-10-18T02:24:40Z",
                    "expiredObjectDeleteMarker": true,
                    "days": 123
                },
                "abortIncompleteMultipartUpload": {
                    "daysAfterInitiation": 123
                },
                "transitions": [
                    {
                        "date": "2022-10-18T02:24:40Z",
                        "days": 123,
                        "storageClass": "GLACIER"
                    }
                ],
                "ID": "e0e83f36de2b5318e9958eb581defa16"
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/oss/put-bucket-lifecycle-conf' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bucket": "ztces-230404-create",
    "regionID": "nm8",
    "lifecycleConfiguration": {
        "rules": [
            {
                "status": "Enabled",
                "noncurrentVersionExpiration": {
                    "noncurrentDays": 123,
                    "newerNoncurrentVersions": 123
                },
                "noncurrentVersionTransitions": [
                    {
                        "noncurrentDays": 123,
                        "storageClass": "STANDARD_IA",
                        "newerNoncurrentVersions": 123
                    }
                ],
                "filter": {
                    "objectSizeGreaterThan": 123,
                    "and": {
                        "objectSizeGreaterThan": 123,
                        "prefix": "string",
                        "objectSizeLessThan": 123,
                        "tags": [
                            {
                                "key": "key1",
                                "value": "value1"
                            }
                        ]
                    },
                    "prefix": "prefix1",
                    "tag": {
                        "key": "tagkey",
                        "value": "tagvalue"
                    },
                    "objectSizeLessThan": 123
                },
                "prefix": "string",
                "expiration": {
                    "date": "2022-10-18T02:24:40Z",
                    "expiredObjectDeleteMarker": true,
                    "days": 123
                },
                "abortIncompleteMultipartUpload": {
                    "daysAfterInitiation": 123
                },
                "transitions": [
                    {
                        "date": "2022-10-18T02:24:40Z",
                        "days": 123,
                        "storageClass": "GLACIER"
                    }
                ],
                "ID": "e0e83f36de2b5318e9958eb581defa16"
            }
        ]
    }
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "description": "成功",
    "error": "Success",
    "errorCode": "Success",
    "message": "success",
    "statusCode": 800,
    "returnObj": []
}

修改于 2025-08-07 08:24:18

生命周期查询

生命周期删除