Set Lifecycle of Bucket
Last Updated：2021-09-13
Interface Description
This interface is used to create the lifecycle management rules.
Description
Only the bucket owner with the FULL_CONTROL permission can initiate this request.
Request URI
PUT /v1/{bucketName}/?lifecycle
| Parameter Name | Parameter Type | Required | Description | Example Value | Parameter Position |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
Request Body Parameters
Description of Data Structure for Request Body Field
| Parameter Name | Parameter Type | Required | Description | Example Value |
|---|---|---|---|---|
| rule | List |
Yes | List of rules |
Description of Data Structure for Rule Field
| Parameter Name | Parameter Type | Required | Description | Example Value |
|---|---|---|---|---|
| id | String | Yes | Rule ID. | rule-id |
| status | String | Yes | Rule status | enabled |
| resource | List |
Yes | For which resources the rule is effective? | |
| condition | Condition | Yes | Rule dependent conditions | |
| action | Action | Yes | Action performed on the resource |
Description of Data Structure for Condition Field
| Parameter Name | Parameter type | Required | Description | Example value |
|---|---|---|---|---|
| time | Time | No | Time constraint |
Description of Data Structure for Time Field
| Parameter Name | Parameter Type | Required | Description | Example Value |
|---|---|---|---|---|
| dateGreaterThan | String | No | Time relation description | 2016-09-07T00:00:00Z |
Description of Data Structure for Action Field
| Parameter Name | Parameter Type | Required | Description | Example Value |
|---|---|---|---|---|
| name | String | Yes | Name of the action performed | DeleteObject |
| storageClass | String | No | Storage type of the object |
Response Body Parameters
Description of Data Structure for Response Body Field
Request Example
PUT /v1/bucketName_example/?lifecycle
Common Request Header
{
"rule" : [ {
"condition" : {
"time" : {
"dateGreaterThan" : "2016-09-07T00:00:00Z"
}
},
"resource" : [ "bucket/prefix/*" ],
"action" : {
"storageClass" : "storageClass",
"name" : "DeleteObject"
},
"id" : "rule-id",
"status" : "enabled"
} ]
}Response Example
HTTP/1.1 200 OK
<Common response header>
{ }Error Code
Refer to the universal error code.