【TcaplusDB知识库】如何查看按游戏区屏蔽备份
每次允许构造一个zone的表的数据。
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
| 参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 | |
|---|---|---|---|---|---|
| set_id | 整型 | 事务所在的集群的id | 是 | ||
| tableInfoList | 数组 | 构造数据的表,只允许构造一个zone下数据 | 是 | ||
| ipList | 字符串 | 数据的机器上的路径,格式为:ip username password,并且帐号密码中不能含有(\ | ; - 空格),多个用换行分开如:1.1.1.1 tcaplus tcaplus | 是 | |
| backType | 整型 | 数据构造类型,1:冷备时间构造,2:精确时间构造 | 是 | ||
| engineBackupDate | 字符串 | 冷备构造数据日期,格式:xxxx-xx-xx,如2018-03-07 | backType=1时,必填 | ||
| uLogBackupTime | 字符串 | Ulog构造数据时间点,格式:xxxx-xx-xx xx:xx:xx如2018-03-05 16:00:04 | backType=2时,必填 | ||
| maxConcurrentActionNum | 整型 | 事务并行度,范围: [1, 50],默认值:10 | 否 |
Data参数
使用json格式表示记录相关信息,示例如下:
{
"setId": 126,
"tableInfoList": {
"2-3-add_table1": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table1",
"ShardNun": 1,
"ShardList": [
1
]
},
"2-3-add_table2": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table2",
"ShardNum": 1,
"ShardList": [
6
]
} //表的shard全部构造的时候,ShardList = ["All"]
},
"ipList":"1.1.1.1 tcaplus tcaplus",
"engineBackupDate":"2018-03-07",
"backType":1,"maxConcurrentActionNum":10
}
//注:tableInfoList中的key格式为:{app_id}-{zone_id}-{table_name}
返回语法
返回参数说明
-
返回状态码不为200时,表示失败,返回数据为构造表数据失败的信息
-
返回状态码为200,表示表数据构造创建成功,返回的数据结构如下:
| 字段名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
| trans_id | 整型 | 执行的对应的事务的id | |
| set_id | 整型 | 事务所在的集群 |
请求示例
通过 curl 方法发起请求
命令中的红色部分是需要用户自行填写的参数,请参阅
curl -H "Content-type: application/json" -X "POST" -d '{ "setId": 126, "tableInfoList": { "2-3-add_table1": { "AppID": 2, "ZoneID": 3, "TableName": "add_table1", "ShardNun": 1, "ShardList": [ 1 ] }, "2-3-add_table2": { "AppID": 2, "ZoneID": 3, "TableName": "add_table2", "ShardNum": 1, "ShardList": [ 6 ] } //表的shard全部构造的时候,ShardList = ["All"] }, "ipList":"1.1.1.1 tcaplus tcaplus", "engineBackupDate":"2018-03-07", "backType":1,"maxConcurrentActionNum":10 } //注:tableInfoList中的key格式为:{app_id}-{zone_id}-{table_name}' http://omsaddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=
返回示例
成功返回示例
http请求的Status=200
{
"set_id": "126",
"TransId": 108,
"username": "username"
}
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"Error": [
"The Ulog retraction time point must be greater than the cold backup date"
]
}
