設置跨區域復制規則(2022.12.15后開放使用)
更新時間 2025-06-11 14:55:21
最近更新時間: 2025-06-11 14:55:21
分享文章
接口介紹
設置跨區域復制,將對象從源桶復制到不同區域中的目標桶。
接口約束
支持的線上資源池:上海32<->杭州2、上海7<->杭州2
URI
POST /v4/oss/put-bucket-replication
請求參數
請求體 JSON Body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| targetBucket | 是 | String | 目標桶名 | bucket2 |
| targetRegionID | 是 | String | 目標區域 ID | 3a585beb-63aa-465e-9028-52e5123866f0 |
| prefixes | 否 | Array of String | 桶內對象前綴,默認為空數組,即同步所有。空數組:[] | ["nn_", "kk_"] |
| plot | 否 | Boolean | 同步策略, 同步時是否允許刪除。默認為 false | true |
| history | 否 | Boolean | 是否同步歷史數據, 默認為 true | true |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| 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",
"targetBucket": "bucket2",
"targetRegionID": "3a585beb-63aa-465e-9028-52e5123866f0",
"prefixes": [
"nn_",
"kk_"
],
"plot": true,
"history": true
}
響應示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表