查詢桶生命周期配置
更新時間 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
GET /v4/oss/get-bucket-lifecycle-conf
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| rules | Array of Objects | 規則 | 見下級對象 |
表 rules
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| ID | String | 規則ID | rule1 |
| expiration | Object | 用日期或天數指定對象的過期時間 | 見下級對象 |
| status | String | 規則是否啟用,值為 Enabled 或 Disabled | Enabled |
| noncurrentVersionExpiration | Object | 標識歷史版本的過期規則 | 見下級對象 |
| noncurrentVersionTransitions | Array of Objects | 標識歷史版本的轉存儲規則 | 見下級對象 |
| filter | Object | 過濾應用規則的對象 | 見下級對象 |
| prefix | String | 識別規則所適用的一個或多個對象的前綴 | "aa_" |
| abortIncompleteMultipartUpload | Object | 指定自不完整的多部分上傳開始后,在自動永久刪除上傳的所有部分之前將等待的天數 | 見下級對象 |
| transitions | Array of Objects | 指定桶內對象何時過渡到指定的存儲類別 | 見下級對象 |
表 expiration
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| date | String | ISO-8601 格式的日期字符串,精確到天。表示對象在什么日期被移動或刪除 | 2022-10-18T00:00:00Z |
| expiredObjectDeleteMarker | Boolean | 指定是否自動移除過期刪除標記 | false |
| days | Integer | 表示受該規則約束的對象的壽命,以天為單位。該值必須是一個非零的正整數 | 12 |
表 noncurrentVersionExpiration
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| noncurrentDays | Integer | 指定對象在ZOS可以執行關聯操作之前處于非當前狀態的天數。該值必須是一個非零的正整數 | 123 |
表 noncurrentVersionTransitions
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| noncurrentDays | Integer | 指定對象在 ZOS 可以執行關聯操作之前處于非當前狀態的天數 | 123 |
| storageClass | String | 用于存儲對象的存儲類 | STANDARD_IA |
表 filter
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| and | Object | 這在生命周期規則過濾器中用于將邏輯 AND 應用于兩個或多個謂詞。生命周期規則將應用于與 And 運算符中配置的所有謂詞匹配的任何對象 | 見下級對象 |
| prefix | String | 標識規則適用的一個或多個對象的前綴 | aa_ |
| tag | Object | 這個標簽必須存在于對象的標簽集中,以便規則的應用 | 見下級對象 |
表 and
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| prefix | String | 標識規則適用的一個或多個對象的前綴 | "nn_" |
| tags | Array of Objects | 所有這些標簽都必須存在于對象的標簽集中,才能應用規則 | 見下級對象 |
表 tags
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| key | String | 標簽名稱 | tag1 |
| value | String | 標簽值 | value1 |
表 tag
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| key | String | 標簽名稱 | tag1 |
| value | String | 標簽值 | value1 |
表 abortIncompleteMultipartUpload
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| daysAfterInitiation | Integer | 指定ZOS中止未完成分段上傳的天數 | 123 |
表 transitions
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| date | String | 指示對象何時轉換到指定的存儲類。日期值為 ISO 8601 格式,精確到天 | 2022-10-18T00:00:00Z |
| days | Integer | 指示對象在創建后轉換到指定存儲類的天數。該值必須是正整數 | 123 |
| storageClass | String | 該對象過渡到的存儲類 | GLACIER |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/get-bucket-lifecycle-conf?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0
響應示例
{
"returnObj": {
"rules": [
{
"status": "Enabled",
"noncurrentVersionExpiration": {
"noncurrentDays": 123
},
"noncurrentVersionTransitions": [
{
"noncurrentDays": 123,
"storageClass": "STANDARD_IA"
}
],
"filter": {
"and": {
"prefix": "aa_",
"tags": [
{
"key": "tag1",
"value": "value1"
}
]
}
},
"expiration": {
"date": "2022-10-18T00:00:00Z"
},
"abortIncompleteMultipartUpload": {
"daysAfterInitiation": 123
},
"transitions": [
{
"date": "2022-10-18T00:00:00Z",
"storageClass": "GLACIER"
}
],
"ID": "rule1"
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表