接口介绍
为存储桶指定数据复制规则。媒体存储支持跨区域复制和同区域复制。
接口约束
无
请求URI
POST /v1/crossRegionReplication/create
路径参数
无
Query参数
无
请求参数
请求header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| content-type | 是 | String | 创建复制规则请求header参数，默认为applicatin/json | applicatin/json |
请求体 body 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| ruleName | 是 | String | 规则名称 | testrule | |
| bucket | 是 | String | 桶名 | testBucketName | |
| regionCode | 是 | String | 区域编码 | 0001 | |
| dstBucket | 是 | String | 复制到目的桶 | testDstBucketName | |
| dstRegionCode | 是 | String | 复制到目的区域编码 | 0001 | |
| syncRule | 是 | String | 同步规则，CU代表增改同步，CUD代表增删改同步 | CU | |
| status | 是 | String | 是否开启同步规则，F0A代表开启，F0X代表关闭 | F0A | |
| isSynchronized | 是 | String | 是否同步历史数据，F0A代表是，F0X代表否 | F0X |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 本次请求的结果码 | 0 | |
| error | 是 | String | 错误码，创建成功时，不返回该字段 | ||
| message | 是 | String | 错误文本信息，创建成功时，为空字符串 | ||
| returnObj | 是 | String of Object | 返回结果 | returnObj |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 业务返回码，0表示业务成功 | 0 | |
| data | 是 | String | 业务返回数据 | data | |
| message | 是 | String | 业务消息 |
表 data
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| userName | 是 | String | 用户名 | test | |
| ruleName | 是 | String | 规则名称 | rule1 | |
| templateId | 是 | Integer | 规则在后端的id | 123 | |
| bucket | 是 | String | 桶名称 | bucket2 | |
| regionCode | 是 | String | 区域编码 | 00002 | |
| dstBucket | 是 | String | 目标桶名称 | bucket1 | |
| dstRegionCode | 是 | String | 目标存储区域 | 00001 | |
| syncRule | 是 | String | 同步策略，CU: 增/改同步，CUD: 增/改/删同步 | CUD | |
| status | 是 | String | 规则状态, F0A:开启; F0X:关闭 | F0A | |
| isSynchronized | 是 | String | 是否同步历史数据, F0A:同步; F0X:不同步 | F0A | |
| dstRegionName | 是 | String | 目标存储区域名称 | 广东资源池1区 | |
| storageClass | 是 | String | 存储类型 | STANDARD | |
| createTime | 是 | Long | 创建时间 | 1681896531000 | |
| updateTime | 是 | Long | 更新时间 | 1681896531000 | |
| id | 是 | Long | 规则在中台的id | 1 | |
| isSystem | 是 | Integer | 是否是系统模板，0否，1是 | 0 |
请求示例
POST /v1/crossRegionReplication/create
请求头header
content-type:applicatin/json
请求体示例
{
"ruleName": "testrule",
"bucket": "testbucket1",
"regionCode": "0001",
"dstBucket": "testbucket2",
"dstRegionCode": "0001",
"syncRule": "CU",
"isSynchronized": "F0A",
"status": "F0A"
}
响应示例
{
"statusCode": "0",
"message": "",
"returnObj": {
"code": "0",
"message": "",
"data": {
"bucket": "lan1",
"createTime": 1697525097271,
"dstBucket": "lan2",
"dstRegionCode": "0891001",
"dstRegionName": "西藏资源池1区",
"id": 100000000577,
"isSynchronized": "F0A",
"isSystem": 0,
"regionCode": "0891001",
"ruleName": "wwww",
"status": "F0A",
"storageClass": "STANDARD",
"syncRule": "CU",
"templateId": "6",
"updateTime": 1697525097271,
"userName": "chenyang-est"
}
}
}
状态码
| 状态码 | 描述 |
|---|---|
| 0 | 表示业务成功 |
| 400 | 请求参数有误 |
| 403 | 用户鉴权失败，用户无操作权限 |
| 404 | 请求的资源不存在，输入错误的URL |
| 500 | 业务执行异常 |
