創建復制規則
更新時間 2023-12-14 17:42:19
最近更新時間: 2023-12-14 17:42:19
分享文章
接口介紹
為存儲桶指定數據復制規則。媒體存儲支持跨區域復制和同區域復制。
接口約束
無
請求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 | 業務執行異常 |
