设置跨区域复制规则(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 枚举值，见错误码总表
