Set Lifecycle for a Bucket
Updated at：2025-11-03
API description
This API is intended to create lifecycle management rules.
Description
Only the bucket owner with FULL_CONTROL permission can make this request.
Request URI
PUT /v1/{bucketName}/?lifecycle
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
Parameters of request body
Description of the data structure of request body fields
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| rule | List |
Yes | Rule list |
Description of Rule field data structure
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| id | String | Yes | Rule identifier | rule-id |
| status | String | Yes | Status of the rule. | enabled |
| resource | List |
Yes | The resources to which the rules will apply. | |
| condition | Condition | Yes | The condition on which the rule depends | |
| action | Action | Yes | Actions executed on the specified resource. |
Description of Condition field data structure
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| time | Time | No | Time-related constraints. |
Description of Time field data structure
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| dateGreaterThan | String | No | Describe relationships related to time. | 2016-09-07T00:00:00Z |
Description of Action field data structure
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| name | String | Yes | The name of the operation being executed. | DeleteObject |
| storageClass | String | No | Storage class of the object |
Response body parameters
Description of the data structure of response body fields
Request example
JSON
1PUT /v1/bucketName_example/?lifecycle
2 <Common request headers>
3{
4 "rule" : [ {
5 "condition" : {
6 "time" : {
7 "dateGreaterThan" : "2016-09-07T00:00:00Z"
8 }
9 },
10 "resource" : [ "bucket/prefix/*" ],
11 "action" : {
12 "storageClass" : "storageClass",
13 "name" : "DeleteObject"
14 },
15 "id" : "rule-id",
16 "status" : "enabled"
17 } ]
18}Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{ }Error code
Please refer to the general error codes