設置桶生命周期配置
更新時間 2025-06-11 14:55:19
最近更新時間: 2025-06-11 14:55:19
分享文章
接口介紹
設置Bucket的生命周期規則。
接口約束
支持的線上資源池 :上海7、南京3、南京5、杭州2、合肥2、九江、廣州6、武漢4、福州25、廈門3、郴州2、海口2、北京5、雄安2、石家莊20、內蒙6、晉中、遼陽1、西安5、烏魯木齊4、烏魯木齊27、中衛5、蘭州2、西寧2、拉薩3、昆明2、重慶2、成都4、貴州3、上海33、寧波邊緣云、華東1、上海36、南昌5、青島20、武漢41、長沙42、長沙37、南寧23、北京行業云20、華北2、西南1、上海32。
URI
POST /v4/oss/put-bucket-lifecycle-conf
請求參數
請求體 JSON Body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| lifecycleConfiguration | 是 | Object | 生命周期配置 | 見下級對象 |
表 lifecycleConfiguration
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| rules | 是 | Array of Objects | 生命周期規則 | 見下級對象 |
表 rules
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| ID | 否 | String | 規則ID | rule1 |
| expiration | 否 | Object | 用日期或天數指定對象的過期時間。若未傳此參數,則參數 transitions、noncurrentVersionExpiration、noncurrentVersionTransitions 至少指定其中一個 | 2022-10-18T00:00:00Z |
| status | 是 | String | 規則是否啟用,值為 Enabled 或 Disabled | Enabled |
| noncurrentVersionExpiration | 否 | Object | 標識歷史版本的過期規則。若未傳此參數,則參數 expiration、transitions、noncurrentVersionTransitions 至少指定其中一個 | 2022-10-18T00:00:00Z |
| noncurrentVersionTransitions | 否 | Array of Objects | 標識歷史版本的轉存儲規則。若未傳此參數,則參數 expiration、transitions、noncurrentVersionExpiration 至少指定其中一個 | 見下級對象 |
| filter | 否 | Object | 過濾應用規則的對象。一個filter必須有Prefix、Tag或And中的一個指定或者 filter 為空 {}。若未傳此參數,則需要指定 prefix 參數 | 見下級對象 |
| prefix | 否 | String | 識別規則所適用的一個或多個對象的前綴,若未傳此參數,需要指定 filter 參數。若此參數與 filter 參數中的 prefix 同時存在,則 filter 中的 prefix 參數生效 | nn_ |
| abortIncompleteMultipartUpload | 否 | Object | 指定自不完整的多部分上傳開始后,在自動永久刪除上傳的所有部分之前將等待的天數 | 見下級對象 |
| transitions | 否 | Array of Objects | 指定桶內對象何時過渡到指定的存儲類別。若未傳此參數,則參數 expiration、noncurrentVersionExpiration、noncurrentVersionTransitions 至少指定其中一個 | 見下級對象 |
表 expiration
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| date | 否 | String | ISO-8601 格式的日期字符串,精確到天。表示對象在什么日期被移動或刪除。且與參數 expiredObjectDeleteMarker 以及 days 不能共存 | 2022-10-18T00:00:00Z |
| expiredObjectDeleteMarker | 否 | Boolean | 指定是否自動移除過期刪除標記。如果設置為true,刪除標記將過期;如果設置為 false,則策略不執行任何操作。且與參數 date 以及 days 不能共存 | false |
| days | 否 | Integer | 表示受該規則約束的對象的壽命,以天為單位。該值必須是一個非零的正整數。且與參數 date 以及 expiredObjectDeleteMarker 不能共存 | 22 |
表 noncurrentVersionExpiration
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| noncurrentDays | 是 | Integer | 指定對象在ZOS可以執行關聯操作之前處于非當前狀態的天數。該值必須是一個非零的正整數 | 123 |
表 noncurrentVersionTransitions
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| noncurrentDays | 是 | Integer | 指定對象在ZOS可以執行關聯操作之前處于非當前狀態的天數 | 123 |
| storageClass | 是 | String | 用于存儲對象的存儲類。僅限于 GLACIER, STANDARD_IA | STANDARD_IA |
表 filter
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| and | 否 | Object | 這在生命周期規則過濾器中用于將邏輯 AND 應用于兩個或多個謂詞。生命周期規則將應用于與 And 運算符中配置的所有謂詞匹配的任何對象。若要同時使用 prefix, tag 參數,請使用此參數。 | 見下級對象 |
| prefix | 否 | String | 標識規則適用的一個或多個對象的前綴。若要與 tag 參數一起使用,請使用 and 參數 | ss_ |
| tag | 否 | Object | 這個標簽必須存在于對象的標簽集中,以便規則的應用。若要與 prefix 參數一起使用,請使用 and 參數 | 見下級對象 |
表 and
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| prefix | 否 | String | 標識規則適用的一個或多個對象的前綴 | cc_ |
| tags | 否 | Array of Objects | 所有這些標簽都必須存在于對象的標簽集中,才能應用規則 | 見下級對象 |
表 tags
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| key | 是 | String | 對象名稱 | key2 |
| value | 是 | String | 標簽值 | value2 |
表 tag
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| key | 是 | String | 對象名稱 | key1 |
| value | 是 | String | 標簽值 | value1 |
表 abortIncompleteMultipartUpload
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| daysAfterInitiation | 是 | Integer | 指定ZOS中止未完成分段上傳的天數。 | 123 |
表 transitions
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| date | 否 | String | 指示對象何時轉換到指定的存儲類,與 days 不能共存。日期值為 ISO 8601 格式,精確到天 | 2022-10-18T00:00:00Z |
| days | 否 | Integer | 指示對象在創建后轉換到指定存儲類的天數,與 date 不能共存。該值必須是正整數 | 123 |
| storageClass | 是 | String | 該對象過渡到的存儲類,可選值為 GLACIER, STANDARD_IA | GLACIER |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
請求示例
{
"bucket": "bucket1",
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"lifecycleConfiguration": {
"rules": [
{
"status": "Enabled",
"noncurrentVersionExpiration": {
"noncurrentDays": 123
},
"noncurrentVersionTransitions": [
{
"noncurrentDays": 123,
"storageClass": "STANDARD_IA"
}
],
"filter": {
"and": {
"prefix": "cc_",
"tags": [
{
"key": "key2",
"value": "value2"
}
]
}
},
"expiration": {
"date": "2022-10-18T00:00:00Z"
},
"abortIncompleteMultipartUpload": {
"daysAfterInitiation": 123
},
"transitions": [
{
"date": "2022-10-18T00:00:00Z",
"storageClass": "GLACIER"
}
],
"ID": "string"
}
]
}
}
響應示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表