1. 程式人生 > 其它 >【TcaplusDB知識庫】如何生成機器資料構造的事務

【TcaplusDB知識庫】如何生成機器資料構造的事務

【TcaplusDB知識庫】如何生成機器資料構造的事務

請求地址

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
}

返回語法

返回引數說明

  1. 返回狀態碼不為200時,表示失敗,返回資料為構造表資料失敗的資訊

  2. 返回狀態碼為200,表示表資料構造建立成功,返回的資料結構如下:

欄位名稱 資料型別
說明 備註
trans_id 整型 執行的對應的事務的id  
set_id 整型 事務所在的叢集  

 

請求示例

通過 curl 方法發起請求

命令中的紅色部分是需要使用者自行填寫的引數,請參閱url中GET引數說明

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"
  ]
}

 

TcaplusDB是騰訊出品的分散式NoSQL資料庫,儲存和排程的程式碼完全自研。具備快取+落地融合架構、PB級儲存、毫秒級時延、無損水平擴充套件和複雜資料結構等特性。同時具備豐富的生態、便捷的遷移、極低的運維成本和五個九高可用等特點。客戶覆蓋遊戲、網際網路、政務、金融、製造和物聯網等領域。