【TcaplusDB知識庫】如何生成機器資料構造的事務
阿新 • • 發佈:2022-04-12
請求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/machine-data/make?cmd=10012&ip-type=webservicerest&access-token=AccessTokenVal
POST請求引數說明
引數名稱 | 資料型別 | 說明 | 是否必填欄位 | 備註 | |
---|---|---|---|---|---|
set_id | 整型 | 事務所在的叢集的id | 是 | ||
svrIdList | 陣列 | 構造資料的svr列表格式:svr id、ip、 username、 password,用空格隔開,賬號密碼中不能含有(\ |
; - 空格))如:126.2.2.3 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,
"svrIdList": [
"126.2.2.3 1.1.1.1 tcaplus tcaplus"
],
"engineBackupDate": "2018-03-07",
"backType": 1,
"maxConcurrentActionNum": 10
}
返回語法
返回引數說明
-
返回狀態碼不為200時,表示失敗,返回資料為構造表資料失敗的資訊
-
返回狀態碼為200,表示表資料構造建立成功,返回的資料結構如下:
欄位名稱 | 資料型別 |
說明 | 備註 |
---|---|---|---|
trans_id | 整型 | 執行的對應的事務的id | |
set_id | 整型 | 事務所在的叢集 |
請求示例
通過 curl 方法發起請求
命令中的紅色部分是需要使用者自行填寫的引數,請參閱
curl -H "Content-type: application/json" -X "POST" -d '{ "setId": 126, "svrIdList": [ "126.2.2.3 1.1.1.1 tcaplus tcaplus" ], "engineBackupDate": "2018-03-07", "backType": 1, "maxConcurrentActionNum": 10 }' http://omsaddress/app/newoms.php/webservice/oamp/machine-data/make?cmd=10012&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http請求的Status=200
{
"SetId": "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"
]
}