应用高可用

June 24, 2022About 31 min

应用高可用

SDK类名:/ha/AppHighAvailability

Dashboard - 高可用列表

SDK类名:/dashboard/Dashboard

SDK方法名:ha

URL

/dashboard/ha

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  info_listArray
    usernameStringadmin
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    ha_nameStringtest4
    ha_uuidString128C2F7D-0795-41F3-1274-3FBAA2449BAD
    master_uuidString967760F1-EFA7-16C6-8822-AA7663AD6D22
    node_priorityArray2
      uuidArray["967760F1-EFA7-16C6-8822-AA7663AD6D22","B858FEBE-8C91-021B-2129-55387D376757"]+1
      priorityStringhigh
      node_nameArray["172.20.79.104","172.20.79.105"]+1
      config_addrArray["172.20.79.104","172.20.79.105"]+1
      data_addrArray["172.20.79.104","172.20.79.105"]+1
    rulesNull
    timeNull
    m_statusStringHA_UNKNOWN
    m_roleStringHA_UNKNOWN
    s_statusStringHA_UNKNOWN
    s_roleStringHA_UNKNOWN
  totalNumber2

Dashboard - 高可用列表副本

SDK类名:/dashboard/Dashboard

SDK方法名:ha

URL

/7.1.28/dashboard/ha

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageStringdefault 11
limitStringdefault 3030

Response

名称类型必选简介Mock初始值Mock规则
codeNumber@mock=00
messageString@mock=success update to latest versionsuccess update to latest version
listArray
nodeArray, HA包含的节点信息2
ha_uuidString@mock=@guid, HA规则的uuid@guid
ha_nameString, HA规则名称
usernameString@mock=@name@name
ha_uuidString@mock=@guid, HA规则的uuid,同外面的uuid@guid
node_nameString, 节点名称
node_uuidString@mock=@guid, 节点UUID@guid
data_addrString@mock=@ip, 节点数据接口地址@ip
rep_uuidString@mock=@guid, 节点上复制规则uuid,可能多个节点上都有,也可能都没有@guid
dataObject
  codeNumber0
  messageString
  listArray
    nodeArray2
      ha_uuidString@guid
      node_nameString
      node_uuidString@guid
      data_addrString@ip
      rep_uuidString@guid
    ha_uuidString@guid
    ha_nameString@name
    usernameString@name
    stateObject
      s_statusString@pick(["unknown", "stop", "run"])
      s_roleString@pick(["master", "slave", "unknown"])
      m_statusString@pick(["UNKNOWN", "ONLINE"])
      m_roleString@pick(["master", "slave", "unknown"])
      default_masterString@guid
msgString
retNumber200

------ 高可用 ------

URL

/------ 高可用 ------

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则

高可用 - 节点网卡信息

SDK方法名:listNicInfo

URL

/ha/netif

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
node_uuidArray节点uuid数组["B8566905-411E-B2CD-A742-77B1346D8E84","67E33CDB-D75B-15B3-367D-50C764F5A26F"]
master_uuidString主节点uuid67E33CDB-D75B-15B3-367D-50C764F5A26F

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  netifArray2
    ifconfigArray2
      netifString@mock=000000, 底层返回的netif标识@pick(["eth1","eth2","eth3","eth4"])
      ipsArray网卡上的IP["192.168.22.168","192.168.22.169","192.168.2.168","192.168.22.18"]
      labelString, 网卡名称
    node_uuidString@mock=@guid(), 节点uuid@guid()
  messageString
  codeNumber@mock=00
retNumber@mock=200200
msgString

高可用 - HA脚本目录

SDK方法名:describeHAScriptPath;

存放i2相关脚本根目录, 在打开目录树的时候需要传递这个root_path进行过滤

URL

/ha/script_path

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
master_uuidString节点UUID67E33CDB-D75B-15B3-367D-50C764F5A26F

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  script_pathString@mock=@/foo @/nested/a/b/c, 存放脚本的路径@/foo @/nested/a/b/c
  codeNumber@mock=00
  messageString@mock=success update to latest versionsuccess update to latest version
msgString
retNumber@mock=200200

高可用 - 磁盘信息

SDK方法名:describeVolumeInfo

URL

/ha/volume_info

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
master_uuidString
slave_uuidString

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  disk_infoArray2
    master_nodeObject
      mnt_nameString
      disk_nameString
      labelString
      flagsString
    sub_nodeObject
      mnt_nameString
      disk_nameString
      labelString
      flagsString
    sizeString
    uuidString
    fs_typeString
    offsetString
    os_typeString
    disk_idString
  drive_letter_infoObject
    master_nodeArray
    sub_nodeArray

高可用 - 检查是否重名

SDK方法名:haVerifyName;

URL

/ha/verify_name

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
ha_nameStringtestfdsa
ha_typeString0-规则 10-模板0

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString

高可用 - 新建

SDK方法名:createHA

URL

/ha

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
ha_nameString规则名称sdk_ha
master_uuidString主节点uuid67E33CDB-D75B-15B3-367D-50C764F5A26F
ha_typeNumber0 - 表示规则
10 - 表示模板
auto_switchString勾选 为 1, 自动切换1
reboot_takeoverNumber重启接管0
ctrl_switchNumber用于控制多规则保护情况下是否切换0
node_priorityArray目前放开的是两个节点, 节点uuid、初始优先级数组2
  uuidString, 节点uuid@order(["67E33CDB-D75B-15B3-367D-50C764F5A26F","B8566905-411E-B2CD-A742-77B1346D8E84"])
  priorityString高中低对应: high,middle,low, 默认优先级high
heartbeatArray可以有多个, 心跳线对象
  intervalNumber, 检测间隔2
  maxfailNumber, 最大失败次数5
  protocolStringtcp,udp,ping, 心跳类型tcp
  ifconfigArray, IP对象2
    uuidString节点uuid@order(["67E33CDB-D75B-15B3-367D-50C764F5A26F","B8566905-411E-B2CD-A742-77B1346D8E84"])
    netifNumber网卡标识@order(["{AB1E4EFF-14FE-441E-8A1F-EE59BDA12D6F}","{5C3A44A0-EF11-4705-A9A3-2F3ACEED4798}"])
    labelString网络适配器名称
    ipStringip地址@order(["192.168.72.75","192.168.72.82"])
  portNumber默认26850, 端口26850
sync_dataArray, 数据同步项
  back_ruleNumber1,勾选, 反向规则0
  need_rep_statusNumber1,勾选, 进入复制状态才允许切换1
  create_startNumber1,勾选, 创建时启动复制规则0
  wait_cacheNumber1,勾选,页面已经隐藏, 等待缓存1
  rule_relationArray至少两个对象,如果没有勾选反向复制规则,append_name,rep_name以及autostart_rep只会出现在主节点所在的对象里, 规则相关参数2
    rep_nameString默认生成的是 haname-nodename-nodename, 规则名称sdk_ha-N3_72.75-N4_72.76
    autostart_repNumber1,启动, 自动启动复制规则0
    pathArray直观上看到是 隶属于 mapping表的一侧路径, 节点包含的路径,["E:\test\"]
    uuidString, 节点uuid@order(["67E33CDB-D75B-15B3-367D-50C764F5A26F","B8566905-411E-B2CD-A742-77B1346D8E84"])
    append_nameNumber1,需要,如果用户手动修改了rep_name则需要, 是否需要再次拼接HAname0
  excludesArray传递路径数组, 排除路径[]
arbitrationObject仲裁
  radioNumber开关:0 关闭;1,2开启, 1 节点仲裁; 2 磁盘仲裁1
  nodeArray如果radio为1,目前版本中需要传nodeObject, 节点仲裁
    arbit_protocolStringTCP,UDP;目前版本底层只实现了TCP, 通信方式TCP
    arbit_addrString仲裁IP地址192.168.72.82
    arbit_portNumber默认26868, 通讯端口26868
  diskObject磁盘仲裁对象
    pathString仲裁磁盘
res_switchArray资源切换对象
  scriptObjecttype为script时有该项, 脚本切换资源配置项
    after_failoverString获取资源执行的脚本
    before_failoverString留空
    before_switchString释放资源执行的脚本
    after_switchString, 留空
    switch_timeoutString设置切换超时, 单位:秒
  vipObjecttype为ip时有该项, 虚IP 配置项
    topNumber1,勾选, 首选IP0
    delNumber删除规则释放虚IP; 默认1 , 勾选删除释放0
    ipString, ip地址192.168.72.82
    maskString, 子网掩码255.255.255.0
    seq_executeNumber1,勾选, 顺序执行
    try_numberNumber尝试次数选项
    ifconfigArray2
      uuidString, 节点的uuid@order(["67E33CDB-D75B-15B3-367D-50C764F5A26F","B8566905-411E-B2CD-A742-77B1346D8E84"])
      netifString, 底层返回的netif标识@order(["{AB1E4EFF-14FE-441E-8A1F-EE59BDA12D6F}","{5C3A44A0-EF11-4705-A9A3-2F3ACEED4798}"])
      labelString显示名称, 网卡名称Ethernet0
  diskObjecttype为disk时有此项,卷组切换
    mnt_nameString挂载点或指定盘符
    try_timeString尝试次数
    disk_infoObject对象 选择的主从节点磁盘信息
      master_nodeObject
        mnt_nameString
        disk_nameString
        labelString
        flagsString
      sub_nodeObject
        mnt_nameString
        disk_nameString
        labelString
        flagsString
      sizeString
      uuidString
      fs_typeString
      offsetString
      os_typeString
      disk_idString磁盘ID
  typeStringip,process, service, system, script, hostname;目前底层只支持ip和script,其余的隐藏了, 资源切换类型ip
monitorArray, 监控对象
  thresholdNumbertype为memory或cpu有该项,传数值即可,不用加%, 阈值,CPU、内存使用百分比90
  intervalNumber, 检测间隔2
  nameStringtype为service或process有该项, 服务名称或者进程名称
  scriptStringtype为script有该项, 脚本文件
  access_methodStringtype为disk有该项,WR 写,RD 读,RDWR读写, 监控方式(读、写)
  typeStringservice,linux没有这一项; process,memory,cpu,ipPing 目前版本隐藏了,script,disk, 监控对象的类型cpu
  greatStringtype为memory或cpu有该项,可忽略,传no, 可忽略
  useidStringtype为process有该值,始终传yes,可忽略, 可忽略
  maxfailNumber, 最大失败次数5
  actionStringswitch,warn,elect;默认switch,页面上对应“失败后仅做告警”, 失败后动作warn
  residualNumbertype为disk有该项, 磁盘使用百分比1
  roleStringmaster,slave,all, 监控角色master
  pathStringtype为disk有该项, 磁盘盘符
  monitor_fileStringtype为script有该项, 监控结果输出文件
dynamic_nodeString动态节点开关
cluster_idString集群ID
service_labelNumber标签号
key_file_pathArray定时同步目录
switch_sync_dataNumber同步数据开关
cron_expressionString间隔时间
local_takeoverString本机有限接管
force_switch_centerString固定中心节点
band_widthString带宽控制

Response

名称类型必选简介Mock初始值Mock规则
retNumber@mock=200200
dataObject
  codeNumber@mock=00
  messageString
msgString

高可用 - 修改

SDK方法名:modifyHA

URL

/ha

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
ha_uuidString, HA规则uuid
ha_nameString, 规则名称
master_uuidString, 主节点uuid
auto_switchNumber勾选 为 1, 自动切换1
reboot_takeoverNumber重启接管0
node_priorityArray目前放开的是两个节点, 节点uuid、初始优先级数组
  uuidString, 节点uuid
  priorityString高中低对应: high,middle,low, 默认优先级
heartbeatArray可以有多个, 心跳线对象
  intervalNumber, 检测间隔1
  maxfailNumber, 最大失败次数1
  portNumber默认26850, 端口1
  ifconfigArray, IP对象2
    uuidString, 节点uuid
    labelString网络适配器名称
    netifNumber, 网卡标识1
    ipString, ip地址
  protocolStringtcp,udp,ping, 心跳类型
arbitrationObject, 仲裁
  nodeObject如果radio为1,目前版本中需要传nodeObject, 节点仲裁
    arbit_portNumber默认26868, 通讯端口1
    arbit_addrString, 仲裁IP地址
    arbit_protocolStringTCP,UDP;目前版本底层只实现了TCP, 通信方式
  diskObject目前底层未实现, 磁盘仲裁
  radioNumber1,开启, 开关1
sync_dataObject, 数据同步项
  create_startNumber1,勾选, 创建时启动复制规则1
  rule_relationArray至少两个对象,如果没有勾选反向复制规则,append_name,rep_name以及autostart_rep只会出现在主节点所在的对象里, 规则相关参数2
    rep_nameString默认生成的是 haname-nodename-nodename, 规则名称
    pathArray直观上看到是 隶属于 mapping表的一侧路径, 节点包含的路径,
    append_nameNumber1,需要,如果用户手动修改了rep_name则需要, 是否需要再次拼接HAname1
    autostart_repNumber1,启动, 自动启动复制规则1
    uuidString, 节点uuid
  wait_cacheNumber1,勾选,页面已经隐藏, 等待缓存1
  need_rep_statusNumber1,勾选, 进入复制状态才允许切换1
  back_ruleNumber1,勾选, 反向规则1
  excludesArray传递路径数组, 排除路径
monitorArray, 监控对象
  greatStringtype为memory或cpu有该项,可忽略,传no, 可忽略
  intervalNumber, 检测间隔1
  typeStringservice,linux没有这一项; process,memory,cpu,ipPing 目前版本隐藏了,script,disk, 监控对象的类型
  useidStringtype为process有该值,始终传yes,可忽略, 可忽略
  scriptStringtype为script有该项, 脚本文件
  residualNumbertype为disk有该项, 磁盘使用百分比1
  thresholdNumbertype为memory或cpu有该项,传数值即可,不用加%, 阈值,CPU、内存使用百分比1
  actionStringswitch,warn,elect;默认switch,页面上对应“失败后仅做告警”, 失败后动作
  roleStringmaster,slave,all, 监控角色
  monitor_fileStringtype为script有该项, 监控结果输出文件
  pathStringtype为disk有该项, 磁盘盘符
  nameStringtype为service或process有该项, 服务名称或者进程名称
  access_methodStringtype为disk有该项,WR 写,RD 读,RDWR读写, 监控方式(读、写)
  maxfailNumber, 最大失败次数1
res_switchArray, 资源切换对象
  typeStringip,process, service, system, script, hostname;目前底层只支持ip和script,其余的隐藏了, 资源切换类型
  scriptObjecttype为script时有该项, 脚本切换资源配置项
    before_failoverString, 留空
    after_failoverString获取资源执行的脚本
    before_switchString释放资源执行的脚本
    after_switchString, 留空
    switch_timeoutString设置切换超时,单位:秒20
  vipObjecttype为ip时有该项, 虚IP 配置项
    ipString, ip地址
    maskString, 子网掩码
    ifconfigArray2
      uuidString, 节点的uuid
      labelString显示名称, 网卡名称
      netifString, 底层返回的netif标识
    topNumber1,勾选, 首选IP1
    delNumber删除规则释放虚IP; 默认1 , 勾选删除释放1

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber@mock=00
msgString
retNumber@mock=200200

高可用 - 查看详细信息

SDK方法名:describeHA

URL

/ha/:uuid([A-F-0-9]+)

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  ha_infoObject
    ha_nameString, 规则名称
    sync_dataArray, 数据同步项1
      need_rep_statusNumber1,勾选, 进入复制状态才允许切换
      create_startNumber1,勾选, 创建时启动复制规则
      rule_relationArray至少两个对象,如果没有勾选反向复制规则,append_name,rep_name以及autostart_rep只会出现在主节点所在的对象里, 规则相关参数2
        append_nameNumber1,需要,如果用户手动修改了rep_name则需要, 是否需要再次拼接HAname
        uuidString, 节点uuid
        pathArray@mock=['aaaa','bbb'], 节点包含的路径,['aaaa','bbb']
        rep_nameString默认生成的是 haname-nodename-nodename, 规则名称
        autostart_repNumber1,启动, 自动启动复制规则
      excludesArray传递路径数组, 排除路径
      wait_cacheNumber1,勾选,页面已经隐藏, 等待缓存
      back_ruleNumber1,勾选, 反向规则
    auto_switchNumber@mock=1, 自动切换1
    reboot_takeoverNumber重启接管0
    master_uuidString, 主节点uuid
    res_switchArray, 资源切换对象2
      scriptObjecttype为script时有该项, 脚本切换资源配置项
        after_switchString, 留空
        after_failoverString, 释放资源执行的脚本
        before_switchString, 获取资源时执行的脚本
        before_failoverString, 留空
        switch_timeoutString设置切换超时
      vipObjecttype为ip时有该项, 虚IP 配置项
        ipString, ip地址
        ifconfigArray2
          netifString, 底层返回的netif标识
          labelString显示名称, 网卡名称
          uuidString, 节点的uuid
        maskString, 子网掩码
        topNumber1,勾选, 首选IP
        delNumber删除规则释放虚IP; 默认1 , 勾选删除释放
1
      typeString@mock=ip, 资源切换类型ip
    monitorArray, 监控对象2
      typeString@mock=service, 监控对象的类型service
      scriptStringtype为script有该项, 脚本文件
      greatStringtype为memory或cpu有该项,可忽略,传no, 可忽略
      actionStringswitch,warn,elect;默认switch,页面上对应“失败后仅做告警”, 失败后动作
      nameStringtype为service或process有该项, 服务名称或者进程名称
      residualNumbertype为disk有该项, 磁盘使用百分比
      access_methodStringtype为disk有该项,WR 写,RD 读,RDWR读写, 监控方式(读、写)
      pathStringtype为disk有该项, 磁盘盘符
      intervalNumber, 检测间隔
      thresholdNumbertype为memory或cpu有该项,传数值即可,不用加%, 阈值,CPU、内存使用百分比
      monitor_fileStringtype为script有该项, 监控结果输出文件
      maxfailNumber, 最大失败次数
      roleStringmaster,slave,all, 监控角色
      useidStringtype为process有该值,始终传yes,可忽略, 可忽略
    node_priorityArray目前放开的是两个节点, 节点uuid、初始优先级数组2
      uuidString, 节点uuid
      priorityString高中低对应: high,middle,low, 默认优先级
    arbitrationObject, 仲裁
      nodeObject如果radio为1,目前版本中需要传nodeObject, 节点仲裁
        arbit_protocolStringTCP,UDP;目前版本底层只实现了TCP, 通信方式
        arbit_addrString, 仲裁IP地址
        arbit_portNumber默认26868, 通讯端口
      diskObject目前底层未实现, 磁盘仲裁
      radioNumber@mock=1, 开关1
    heartbeatArray可以有多个, 心跳线对象2
      maxfailNumber, 最大失败次数
      protocolStringtcp,udp,ping, 心跳类型
      ifconfigArray, IP对象2
        uuidString, 节点uuid
        ipString, ip地址
        netifNumber, 网卡标识
      intervalNumber, 检测间隔
      portNumber默认26850, 端口
    rulesObject键值对应复制规则的 uuid,内部属性和单条复制规则一致
  codeNumber@mock=00
  messageString@mock=success update to latest versionsuccess update to latest version
retNumber@mock=200200

高可用 - 列表

SDK方法名:listHA

URL

/ha

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
search_fieldString, 过滤查询条件

增加通过服务器池过滤: cluster_id
''
search_valueString, 过滤查询值''
pageString, default 11
limitString, default 1010
typeBoolean0 - 规则
10 - 模板
0
statusString可选,总览页面跳转时按照状态过滤时需要
RUN MAINTAIN SWITCH WARN STOP UNKNOWN

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  info_listArray
    usernameString用户名admin
    ha_nameString规则名称example
    ha_uuidString规则uuidDE1DB434-F07C-BC31-B0B4-C189EFA9CB3C
    can_delNumber允许删除1
    can_opNumber允许操作0
    can_upNumber允许更新1
    nodeArray节点2
      data_addrString节点数据地址127.0.0.1
      ha_uuidString规则uuid93AF0C9F-14C8-41A2-31CB-AAA0F65193FA
      node_nameString节点名称test
      node_uuidString节点uuid93AF0C9F-14C8-41A2-31CB-AAA0F65193FA
      rep_uuidString复制规则uuid93AF0C9F-14C8-41A2-31CB-AAA0F65193FA
      sys_nameString应用系统名称sys_name
  totalNumber

高可用 - 状态

SDK方法名:listHAStatus

URL

/ha/status

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
ha_uuidArray数组, ha规则uuid["11111111-1111-1111-1111-111111111111"]
force_refreshNumber点击操作栏刷新按钮必传,下发1,表示从rpc获取;其他情况不传

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  countNumber@mock=44
  codeNumber@mock=00
  messageString@mock=success querysuccess query
  statusArray2
    ha_uuidString@mock=@guid, HA规则的uuid@guid()
    node_ha_uuidString@mock=@guid()_@guid()@guid()_@guid()
    node_uuidString, 节点uuid@guid()
    node_roleString@mock=@pick(["MASTER","SLAVE","UNJOIN","UNKNOWN"]), 当前节点角色@pick(["MASTER","SLAVE","UNJOIN","UNKNOWN"])
    statusString@mock=@pick(["STOP","HASTA_RUN","DEAD","FINISH","SWITCH","UNKNOWN","VP_START","VP_CHECK","VP_CFG","VP_CBT"]), HA规则状态@pick(["STOP","HASTA_RUN","DEAD","FINISH","SWITCH","UNKNOWN","VP_START","VP_CHECK","VP_CFG","VP_CBT"])
    durationString状态持续时间,SWITCH状态时使用
    heartbeat_statusString心跳线状态
HEARTBEAT_CONNECT 连接
HEARTBEAT_EXCEPTION 断开
HEARTBEAT_CONNECT
    arbitrate_statusString仲裁状态
ARBITRATE_NOT_CONF 未配置
ARBITRATE_CONNECT 通讯正常
ARBITRATE_EXCEPTION 通讯断开
ARBITRATE_CONNECT
retNumber@mock=200200
msgString

高可用 - 操作

启动、停止、强制切换

SDK方法名:

启动:startHA

停止:stopHA

强制切换: forceSwitchHA

URL

/ha/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
ha_uuidArrayHA规则 uuid
node_uuidString节点uuid, 批量操作或者对HA整理操作时,不传节点uuid,
typeStringstart,stop,force_switch, stop_script, save_to_template;目前四种操作类型, 操作类型
ha_nameString保存为模板时传,表示模板名称
forceNumber强制操作:
0:否;
1:是;
默认不传或传0
0

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber0
  success_listArray
    codeString
    messageString
    ha_uuidString规则uuid
    ha_nameString规则名称
    node_nameString节点名称(启动停止时返回)
    node_uuidString节点uuid(启动停止时返回)
  fail_listArray
    codeString
    messageString
    ha_uuidString规则uuid
    ha_nameString规则名称
    node_nameString节点名称(启动停止时返回)
    node_uuidString节点uuid(启动停止时返回)
retNumber200
msgString

高可用 - 删除

SDK方法名:deleteHA

URL

/ha

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
uuidArrayuuid数组, HA规则uuid["11111111-1111-1111-1111-111111111111"]
forceNumber1 - 强制删除 0 - 非强制删除

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  codeNumber11110001
  messageString
  fail_listArray
    codeNumber11110001
    messageString[-1] 离线
    ha_uuidString@guid
    ha_nameStringtest2
  success_listArray
    codeNumber11110001
    messageString[0] success
    ha_uuidString@guid
    ha_nameStringtest1
retNumber200

------ 高可用组 ------

URL

/dash/ha_group

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则

高可用组 - 阶段选项

SDK类名:/ha/AppHighAvailability

SDK方法名:listStageOptions

HA分组切换阶段可设置的选项

URL

/ha/group/stage_options

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  totalNumber2
  listArray2
    ha_nameArray高可用规则名["tst","test4"]+1
    ha_uuidArray对应HA规则uuid["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]+1

高可用组-新建

SDK方法名:createHAGroup

URL

/ha/group

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
group_nameString名称111
error_confirmNumber错误处理,0 忽略, 1 停止1
switch_confirmNumber切换确认,1开启, 0关闭1
ha_rulesArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD","214E0B0C-6BFA-B1D7-1AFC-C11E3B5874C0","2FD74EEE-CFDB-FB01-8E11-B6560B6D20F8"]
stageObject分组的阶段
  step_1Objectstep_n , n 阶段的序号,从1开始
    ha_ruleArray当前阶段内的HA规则uuid["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]
    failover_serialNumber切换序号,同阶段step_n中的n1
    failback_serialNumber-切换序号-1
    haListArray2
      ha_nameArrayHA规则名["tst","test4"]+1
      ha_uuidArrayHA规则对应uuid["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]+1
  step_2Object
    ha_ruleArray["214E0B0C-6BFA-B1D7-1AFC-C11E3B5874C0","2FD74EEE-CFDB-FB01-8E11-B6560B6D20F8"]
    failover_serialNumber2
    failback_serialNumber-2
    haListArray2
      ha_nameArray["test3","test2"]+1
      ha_uuidArray["214E0B0C-6BFA-B1D7-1AFC-C11E3B5874C0","2FD74EEE-CFDB-FB01-8E11-B6560B6D20F8"]+1
      disabledBoolean1

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  group_uuidString组uuidCFCEDC75-F48E-22B0-8A67-DE1FCA51C4C7

高可用组 - 列表

SDK方法名:listHAGroup

URL

/ha/group

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber
limitNumber
search_fieldString名称,当前只支持名称group_name
search_valueString搜索的内容

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  info_listArray2
    usernameStringadmin
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    group_uuidArray组uuid["B8205B32-B6AD-323D-7E27-815D17E4E90D","DC169AD6-33C0-ADD7-8AA4-8ED297F471EF"]+1
    group_nameArray组名称["23","134"]+1
    switch_confirmNumber切换确认,1开启, 0关闭1
    error_confirmNumber错误处理,0 忽略, 1 停止0+1
    stageObject
      step_1Object
        ha_ruleArray阶段内HA规则uuid["B95DB026-AEDF-737A-0442-B5134660D204"]
        failover_serialNumber1
        failback_serialNumber-1
        haListArray阶段内规则列表
          ha_nameStringtst
          ha_uuidStringB95DB026-AEDF-737A-0442-B5134660D204
          disabledBoolean1
      step_2Object
        ha_ruleArray阶段内HA规则uuid["065AA560-4B36-6623-1218-EEAAE0D3EBB3"]
        failover_serialArray[2,null]+1
        failback_serialArray[-2,null]+1
        haListArray阶段内规则列表
          ha_nameStringtest1
          ha_uuidString065AA560-4B36-6623-1218-EEAAE0D3EBB3
          disabledBoolean1
    ha_rulesArray当前组内HA规则uuid["B95DB026-AEDF-737A-0442-B5134660D204","065AA560-4B36-6623-1218-EEAAE0D3EBB3"]
    created_atNumber1600080101+1
    is_biz_adminNumber1
    can_delNumber1
    can_opNumber1
    can_upNumber1
  totalNumber2
  ha_listObject系统内ha规则uuid,可忽略
    68F1F4C0-1CA0-A748-E6CA-4A0457FFAED2String双主节点
    4DF33AE3-5204-9C9A-86B4-8000AFC37C6BStringtest-动态6

高可用组 - 删除

SDK方法名:deleteHAGroup

URL

/ha/group

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
uuidsArray要删除组的uuid["CFCEDC75-F48E-22B0-8A67-DE1FCA51C4C7"]

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  codeNumber0
  messageString
  fail_listArray
    codeNumber1
    messageString
    group_uuidString
    group_nameString
  success_listArray
    codeNumber1
    messageString
    group_uuidString
    group_nameString
retNumber200

高可用组 - 修改

SDK方法名:modifyHAGroup

URL

/ha/group/:uuid([A-F-0-9]+)

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
group_uuidString分组uuidCFCEDC75-F48E-22B0-8A67-DE1FCA51C4C7
group_nameString111
error_confirmNumber1
switch_confirmNumber1
ha_rulesArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]
  String
stageObject
  step_1Object
    ha_ruleArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]
    failover_serialNumber1
    failback_serialNumber-1
    haListArray2
      ha_nameArray["tst","test4"]+1
      ha_uuidArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]+1

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。

高可用组 - 单个详细信息

SDK方法名:describeHAGroup

URL

/ha/group/:uuid([A-F-0-9]+)

Method

GET

Request

名称类型必选简介Mock初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  group_uuidString组uuidCFCEDC75-F48E-22B0-8A67-DE1FCA51C4C7
  group_nameString组名称111
  switch_confirmNumber切换确认,1开启1
  error_confirmNumber错误处理,0 忽略, 1 停止1
  stageObject分组阶段设置对象
    step_1Object阶段n对象
      ha_ruleArray当前step所包含HA规则的uuid["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]
      failover_serialNumber1
      failback_serialNumber-1
      haListArray包含的HA规则列表2
        ha_nameArray["tst","test4"]+1
        ha_uuidArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]+1
        disabledBoolean1
  ha_rulesArray整个组包含的HA规则["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]
  created_atNumber创建时间1600076447

高可用组 - 组强制切换

SDK方法名:forceSwitchHAGroup

URL

/ha/group/:uuid([A-F-0-9]+)/task

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
ha_uuidsArray["B95DB026-AEDF-737A-0442-B5134660D204","128C2F7D-0795-41F3-1274-3FBAA2449BAD"]

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  task_uuidString产生切换任务的uuid,上个任务已经完成会新产生任务B4971C2E-B8F3-E4BC-AAF2-A7D6149A4167
  group_uuidStringCFCEDC75-F48E-22B0-8A67-DE1FCA51C4C7
  statusNumber切换任务状态:0 停止;1 初始化完成;2 运行中;3 错误;4 已取消;10 完成;11 无效1
  task_typeNumber1 切换;2 回切1
  user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
  created_atNumber1600078294
  ha_rules_infoObject关联ha规则信息
    B95DB026-AEDF-737A-0442-B5134660D204Objectha规则uuid
      ha_nameStringtst
      ha_uuidStringB95DB026-AEDF-737A-0442-B5134660D204
      master_uuidString初始主节点D0C977EC-1425-72B5-7300-C56826B63512
      usernameStringadmin
      nodeArrayHA规则关联节点2
        ha_uuidStringB95DB026-AEDF-737A-0442-B5134660D204
        ha_nameStringtst
        nameArray["78.15","78.16"]+1
        node_uuidArray节点uuid["D0C977EC-1425-72B5-7300-C56826B63512","54C1047B-8182-22C9-0740-8341B0165774"]+1
        s_uuidArrayha_uuid_node_uuid["B95DB026-AEDF-737A-0442-B5134660D204_D0C977EC-1425-72B5-7300-C56826B63512","B95DB026-AEDF-737A-0442-B5134660D204_54C1047B-8182-22C9-0740-8341B0165774"]+1
        rep_uuidString关联复制规则
    128C2F7D-0795-41F3-1274-3FBAA2449BADObject
      ha_nameStringtest4
      ha_uuidString128C2F7D-0795-41F3-1274-3FBAA2449BAD
      master_uuidString967760F1-EFA7-16C6-8822-AA7663AD6D22
      usernameStringadmin
      nodeArray2
        ha_uuidString128C2F7D-0795-41F3-1274-3FBAA2449BAD
        ha_nameStringtest4
        nameArray["172.20.79.104","172.20.79.105"]+1
        node_uuidArray["967760F1-EFA7-16C6-8822-AA7663AD6D22","B858FEBE-8C91-021B-2129-55387D376757"]+1
        s_uuidArray["128C2F7D-0795-41F3-1274-3FBAA2449BAD_967760F1-EFA7-16C6-8822-AA7663AD6D22","128C2F7D-0795-41F3-1274-3FBAA2449BAD_B858FEBE-8C91-021B-2129-55387D376757"]+1
        rep_uuidString

高可用组 - 切换状态

SDK方法名:listHASwitchTaskStatus

URL

/ha/group/:uuid([A-F-0-9]+)/task/status

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
task_uuidString组强制切换接口返回的task_uuidF696DC12-6727-B799-93D4-8B2213086F5A

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  progressObjectconst PROGRESS_DONE = 'DONE'; const PROGRESS_SWITCHING = 'PROCESSING'; const PROGRESS_ERROR = 'PROCESS_ERROR'; const PROGRESS_STOP = 'STOP'; const PROGRESS_ERROR_STOP = 'ERROR_STOP'; const PROGRESS_WAITING = 'WAITING';
    B95DB026-AEDF-737A-0442-B5134660D204StringERROR_STOP
    128C2F7D-0795-41F3-1274-3FBAA2449BADStringWAITING
  statusArray同“組强制切換”status
  stageNumber当前阶段,-1 , 已取消 ; -2 遇到错误停止; 其他step-2
  err_stepString遇到错误的stepstep_1

高可用组 - 操作强制切换任务

暂停(取消)、恢复(重新启动)

SDK方法名:

恢复:resumeHAGroupSwitch

暂停:pauseHAGroupSwitch

URL

/ha/group/:uuid([A-F-0-9]+)/task

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateStringresume,恢复(重启启动);pause,暂停(取消)resume
task_uuidStringF696DC12-6727-B799-93D4-8B2213086F5A

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
Last update: 11/18/2022, 3:56:21 PM
Contributors: ganl