【TcaplusDB知识库】事务操作—如何申请数据按表备份
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/backup-svr-data/apply?cmd=10009&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
| 参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
|---|---|---|---|---|
| set_id | 整型 | 备份数据所在的集群id | 是 | |
| app_id | 整型 | 备份数据所在集群所在的业务id | 是 | |
| zone_id | 整型 | 备份数据所在的游戏区id | 否 | 如果此区没有表会返回错误信息 |
| table_name | string | 备份指定表的数据 | 否 | |
| svr_ids | 数组或0 | Server ID | 否 | 如果是非slavej进程的会返回错误,填0表示按所有app下的svr来备份，此时的zone_id，table_name应填空字符串 |
| auto_approve | 整型（0或1） | 是否自动审核清理表（表所在集群允许自动审核表清理申请） | 否，默认不自动审核 |
Data参数
使用json格式表示记录相关信息，示例如下：
{
"set_id": "126",
"app_id": "2",
"zone_id": "0",
"svr_ids": [
"126.2.2.2",
"126.2.2.3"
],
"auto_approve": "0"
}
拒绝审核（数据备份）的单据
版本要求：3.55.1
{
"apply_id": "100",
"memo":"test"
}
返回语法
返回参数说明
| 参数名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
| apply | json | ret：表示是否申请成功，0表示成功；其他表示失败 msg：表示ret不等于0时的错误信息 id：申请成功的数据备份单据，表示单据id，审核数据备份申请时需要此值 | |
| check | json | ret：表示是否审核成功，0表示成功；其他表示失败 msg：表示ret不等于0时的错误信息 trans_id：表示生成的数据备份的事务id |
请求示例
通过 curl 方法发起请求
命令中的红色部分是需要用户自行填写的参数，请参阅
curl -H "Content-type: application/json" -X "POST" -d '{ "set_id": "126", "app_id": "2", "zone_id": "0", "svr_ids": [ "126.2.2.2", "126.2.2.3" ], "auto_approve": "0" }' http://omsaddress/app/newoms.php/webservice/business/backup-svr-data/apply?cmd=10009&ip-type=webservicerest&access-token=
返回示例
成功返回示例
http请求的Status=200
成功的示例1 根据指定的svr_id备份
{
"apply": {
"ret": 0,
"msg": "success to apply backup svr table",
"id": 558
}
}
成功的示例2 备份所有set_id,app_id下的所有表的slave
{
"apply": {
"ret": 0,
"msg": "success to apply backup svr table",
"id": 559
},
"check": {
"ret": 0,
"msg": "",
"trans_id": 260
}
}
拒绝审核（数据备份）的单据
true
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"source_ip": "ip:10.29.89.51 not in whitelist"
}
拒绝审核（数据备份）的单据
{
"apply_id": [
"can't find apply_list(apply_id=100)"
]
}
