文件复制

June 24, 2022About 33 min

文件复制

SDK类名:/rep/RepBackup;

复制规则 - 获取 cdp zfs池列表

SDK方法名:listRepBackupCdpZfs

URL

/rep/backup/cdp_zfs

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_uuidString灾备机uuid

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  listArrayzfs 池名称列表["zpoolname1","zpoolname2","zpoolname3"]

复制规则 - 检查是否挂载盘

SDK方法名:repBackupVerifyDevice;

URL

/rep/backup/verify_device

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
node_uuidString灾备机uuid
dir_nameString某个路径,用来检查这路径是本地磁盘还是挂载盘

Response

名称类型必选简介Mock初始值Mock规则
msgString
retNumber200
dataObject
  codeNumber如果不是返回成功,就说明当前路径是挂载盘,挂载盘不支持CDP0
  messageString

复制规则 - 获取可配置CDP快照数

SDK方法名:getRepBackupCdpSnapNum;

URL

/rep/backup/cdp_snap_num

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_uuidString灾备机uuid
cdp_zfs_poolStringZFS存储池

Response

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

复制规则 - 新建

SDK方法名:createRepBackup

URL

/rep/backup

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rep_backupObject规则表单对象
  rep_uuidString前端生成的规则uuid,接口兼容处理,如果前端不传接口会自己处理B8166905-411E-B2CD-A742-77B1346D8E84
  rep_nameString复制规则名(必传)rep_backup
  rep_typeNumber0: default; 1: cluster; 2: block; 10: template;(必传)0
  wk_uuidString工作机id(必传)B8566905-411E-B2CD-A742-77B1346D8E84
  wk_pathArray工作目录(必传)["E:\test\"]
  bk_uuidString备机(目标节点)的uuid ,云版可不填(block也有)B8566905-411E-B2CD-A742-77B1346D8E84
  bk_pathArray备机(目标节点)路径,备份数据存放路径,云版可不填(block也有)["E:\test2\"]
  excl_pathArray源机排除目录
  auto_startNumber规则自动启动(block也有)1
  compressNumber压缩:0不开启;1,低;2,中;3,高(block也有)0
  encrypt_switchNumber0不开启,1开启(block也有)0
  encryptNumber传输加密类型:0-不加密 1-传输AES加密 2-SM4加密
  secret_keyString加密key(block也有)
  band_widthString带宽控制,格式:303:00-14:002m,202:00-15:0080m(block也有)
  mirr_sched_switchNumber高级设置 - 启用禁止镜像:1;关闭:0;(block也有)0
  mirr_schedString高级设置 - 禁止镜像策略;Eg: 303:00-14:00,202:00-15:00(block也有)
  mirr_open_typeNumber文件打开方式, 0 普通文件, 1 自动选择, 2 MFT0
  mirr_sync_attrNumber文件安全属性, 0 不同步; 1同步1
  mirr_sync_flagNumber错误处理方式, 0 遇到错误停止, 1 写日志0
  mirr_file_checkNumber校验方式,0:md5;1:文件大小和时间校验,不同则严格校验;2: 文件时间校验,不同则覆盖目标文件;3:文件总是覆写;0
  mirr_skipString镜像设置 - 跳过镜像;0:正常镜像;1:直接进入复制状态;2:仅同步目录;0
  snapshot_switchNumber快照开关1
  snapshot_policyNumber快照个数达到上限时策略0
  snapshot_startNumber开始时间,Eg: 15155685661546913351
  snapshot_limitNumber快照数目24
  snapshot_intervalNumber快照间隔1
  file_type_filter_switchNumber包含0排除10
  file_type_filterString文件类型过滤,比如:.doc,.docx
  bkup_one_timeNumber定时任务,执行时间(备份策略) Eg: 15155685661515568566
  bk_path_policyNumber源路径目标路径路径映射关系:0:一对一,1:多对一;1
  disk_limitString该规则最大可用存储空间0
  del_policyNumber删除策略,0:不开启;1:开启;1
  thread_numString并行任务数0
  oph_pathString孤儿文件,移动到指定路径、归档,必填E:\test4\
  oph_policyNumber孤儿文件处理策略:0不处理,1删除,2移动到指定路径;6 归档;2
  latency_thresholdNumber延迟告警毫秒数,默认值0不告警
  cdp_switchNumber0:不启用;1:开启1
  cdp_process_timeStringhh:mm:ss , 默认00:00:0005:07:28
  cdp_path_switchNumbercdp数据目录开关:
0:关;
1:开;
  cdp_pathStringCDP数据目录 : 如开启CDP则必填E:\test3\
  cdp_paramStringCDP参数:是几个参数的合并3,30,0
  cdp_data_inc_switchNumber按数据增量做快照开关0
  cdp_baseline_formatNumberBaseline存储格式: 保持源目录结构 打包0
  cdp_bl_bkup_switchNumber创建baseline副本 0否1是;0
  cdp_bl_sched_switchNumber指定生成Baseline(全备份)的策略1
  cdp_bl_schedStringBaseline(全备份)策略 "2|001,1
  cdp_snap_onNumber使用快照做Baseline;0关1开;0
  cdp_snap_countNumberCDP快照数量,0到9999之间的整数240
  cdp_snap_intervalNumberCDP快照间隔,5,10,15,20,25,30,40,50,60,单位是分钟30
  cdp_zfs_poolStringCDP zfs存储池,选择系统上已有的存储池,仅在cdp页面快照打开且备机是Linux系统时的时候显示.,如果获取的value值为空,则cdp不支持linux快照方式。
  cdp_data_incNumber数据增量的大小,单位为M0
  cdp_data_inc_flagString用来表示数据增量单位 M G T
  ct_name_typeNumber文件名替换,0表示不启用。1加前后缀,原来部分保持不变;2前后缀加小写,3前后缀加大写 4自定义0
  ct_name_str1String文件名转换:prefix string / regex string
  ct_name_str2String文件名转换:suffix string / replace string
  ct_name_str3String文件名转换:restore regex string
  ct_name_str4String文件名转换:restore regex string
  cmp_switchNumber比较计划,0: 关; 1: 开;0
  cmp_file_checkNumber比较计划,校验方式,0:md5;1:文件大小和时间;0
  cmp_scheduleArray比较计划,策略
    sched_everyNumber每,0天,1周,2月;
    sched_timeArray哪几点["@time('HH:mm')"]
    sched_dayArray哪几天["@integer(1, 31)"]
  cmp_limitString比较计划,保留数
  mscs_autostartNumber开关: 集群故障转移到另一节点时,自动启动复制规则
勾选是1
不勾选是0
  mir_detect_scriptString高级设置 - 检测脚本路径
  mir_detect_src_scriptString高级设置 - 源端检测脚本
  mscs_groupObject已选集群组
  filter_deleteNumber过滤删除,1:开;0关0
  data_ip_uuidString数据地址uuidB8166905-411E-B2CD-A742-77B1346D8E84
  bk_file_cryptNumber备端数据加密,1是,0否;默认为00
  bk_crypt_typeNumber备端数据加密类型:
1:aes,
2:sm4
1
  bk_crypt_keyString备端数据加密,密钥''
  traversing_syncNumber遍历时传输: 1-开启 0-不开启
  compress_switchNumber传输压缩开关:0,1

Response

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

复制规则 - 获取单个

SDK方法名:describeRepBackup;以新建接口内容为准

URL

/rep/backup/:uuid([A-F0-9-]+)

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber@mock=00
  messageString
  rep_backupObject, 规则表对象
    cdp_pathString@mock=, CDP数据目录 : 如开启CDP则必填
    disk_limitString@mock=0, 该规则最大可用存储空间0
    policy_operationNumber, 达到上限所做的操作:0,循环;1,停止
    rep_uuidString@mock=EFB53F11-7BA2-2001-3418-85865EA58E47, 复制规则uuidEFB53F11-7BA2-2001-3418-85865EA58E47
    policy_intervalNumber, 定时备份间隔
    mirr_schedString@mock=303:00-14:00,202:00-15:00, 镜像窗口时间控制303:00-14:00,202:00-15:00
    policy_limitNumber, 保留副本的个数
    encrypt_switchNumber@mock=0, 0不开启,1开启0
    random_strString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 用于防止并发修改的随机串0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
    auto_startNumber@mock=1, 规则自动启动1
    del_policyNumber@mock=1, 删除策略1
    cdp_bl_sched_switchNumber@mock=0, 指定生成Baseline(全备份)的策略0
    rep_typeNumber@mock=0, 0: default; 1: cluster; 2: block; 10: template;0
    cdp_bl_bkup_switchNumber@mock=0, 创建baseline副本 0 10
    cdp_paramString@mock=, CDP参数:是几个参数的合并
    rep_nameString@mock=rrrrr, 复制规则名rrrrr
    compressNumber@mock=0, 压缩:0不开启;1,低;2,中;3,高0
    bk_portString@mock=26831, 备机控制端口26831
    mirr_sync_flagNumber@mock=0, 错误处理方式0
    cdp_baseline_formatNumber@mock=, Baseline存储格式: 保持源目录结构 打包0
    file_type_filterString@mock=, 文件类型过滤,比如:.doc,.docx
    snapshot_policyNumber@mock=0, 快照个数达到上限时策略1
    bk_ipString@mock=0.0.0.0, 备机控制地址0.0.0.0
    snapshot_switchNumber@mock=0, 快照开关0
    wk_portString@mock=26821, 控制机控制端口26821
    band_widthString@mock=303:00-14:002m,202:00-15:0080m, 带宽控制,格式:303:00-14:002m,202:00-15:0080m303:00-14:002m,202:00-15:0080m
    group_uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 组id0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
    file_checkNumber, ???
    cdp_process_timeString@mock=, hh:mm:ss , 默认00:00:00
    oph_pathString@mock=, 孤儿文件,移动到指定路径
    create_timeString, 创建时间 unix时间戳
    user_uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 用户id0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
    excl_pathArray@mock=, 源机排除目录
    secret_keyString@mock=, 加密key
    scheduleString@mock=, 定期启动策略
    bk_uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 备机(目标节点)的uuid ,云版可不填C0744ABF-5571-8288-1930-439612B6234A
    bk_path_policyNumber@mock=0, 源路径目标路径路径映射关系:0:一对一,1:多对一;1
    snapshot_startNumber@mock=1515568566, 开始时间1515568566
    cdp_switchNumber@mock=, 0:不启用;1:开启1
    snapshot_intervalNumber@mock=0, 快照间隔1
    wk_ipString@mock=0.0.0.0, 工作机控制地址0.0.0.0
    oph_policyNumber@mock=0, 孤儿文件处理策略:0不处理,1删除,2移动到指定路径;6 归档;0
    mirr_sync_attrNumber@mock=1, 文件安全属性1
    wk_uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 工作机idC0744ABF-5571-8288-1930-439612B6234A
    policy_startNumber, 开始时间,参数只针对普通备份有效,整机备份暂不支持指定开始时间;格式:Unix 时间戳
    file_type_filter_switchNumber@mock=0, 包含0排除10
    bkup_one_timeNumber@mock=1515568566, 定时任务,执行时间(备份策略)1515568566
    mirr_sched_switchNumber@mock=0, 镜像窗口时间控制 开关0
    cdp_bl_schedString@mock=2|001, Baseline(全备份)策略 "2
    mirr_open_typeNumber@mock=0, 文件打开方式0
    snapshot_limitNumber@mock=24, 快照数目23
    wk_pathArray@mock=D:\DataTest\, hidden 路径映射?['D:\DataTest\']
    mirr_file_checkNumber@mock=0, 校验方式0
    mirr_skipString@mock=0, 正常镜像0
    bk_pathArray@mock=D:\DataTest2\, 备机(目标节点)路径,备份数据存放路径,云版可不填['D:\DataTest2\']
    cdp_data_incNumber
    cdp_data_inc_switchNumber
    cdp_data_inc_flagString
    latency_thresholdNumber
    mscs_autostartNumber开关: 集群故障转移到另一节点时,自动启动复制规则
勾选是1
不勾选是0
    mir_detect_scriptString高级设置 - 检测脚本路径
    filter_deleteNumber过滤删除,1:开;0关0
    cmp_limitString比较计划,保留数
    data_ip_uuidString数据地址A7EC7CF9-FCA2-D467-ECD6-E028AA9C8319
retNumber@mock=200200
msgString@mock=

复制规则 - 修改

SDK方法名:modifyRepBackup;以新建接口内容为准

URL

/rep/backup/:uuid([A-F0-9-]+)

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
rep_backupObject, 规则表单对象
  cdp_paramString@mock=, CDP参数:是几个参数的合并
  rep_typeNumber@mock=0, 0: default; 1: cluster; 2: block; 10: template;0
  bkup_one_timeNumber@mock=1515568566, 定时任务,执行时间(备份策略)1515568566
  snapshot_switchNumber@mock=0, 快照开关0
  cdp_baseline_formatString@mock=, Baseline存储格式: 保持源目录结构 打包
  mirr_sync_flagString@mock=0, 错误处理方式0
  mirr_open_typeString@mock=0, 文件打开方式0
  auto_startString@mock=1, 规则自动启动1
  snapshot_policyString@mock=0, 快照个数达到上限时策略0
  cdp_bl_sched_switchNumber@mock=0, 指定生成Baseline(全备份)的策略0
  snapshot_intervalString@mock=0, 快照间隔0
  bk_pathArray@mock=D:\DataTest2, 备机(目标节点)路径,备份数据存放路径,云版可不填D:\DataTest2\
  snapshot_startNumber@mock=1515568566, 开始时间1515568566
  random_strString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 用于防止并发修改的随机串0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
  cdp_pathString@mock=, CDP数据目录 : 如开启CDP则必填
  file_type_filter_switchNumber@mock=0, 包含0排除10
  cmp_scheduleObject, 周期任务(备份策略)
    sched_timeArray@mock=@time('HH:mm'), 哪几点@time('HH:mm')
    sched_dayArray@mock="@integer(1, 31)", 哪几天"@integer(1, 31)"
    sched_everyNumber@mock=2, 0:每天;1:每周:2:每月;3:每隔;2
  snapshot_limitString@mock=24, 快照数目24
  cmp_switchNumber@mock=0, 比较计划,0: off; 1: on;0
  oph_pathString@mock=, 孤儿文件,移动到指定路径
  secret_keyString@mock=, 加密key
  excl_pathArray@mock=, 源机排除目录
  scheduleString@mock=, 定期启动策略
  policy_intervalNumber, 定时备份间隔
  cdp_switchString@mock=, 0:不启用;1:开启
  wk_uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 工作机id0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
  policy_operationNumber, 达到上限所做的操作:0,循环;1,停止
  wk_pathArray@mock=D:\DataTest, hidden 路径映射?D:\DataTest\
  mirr_skipString@mock=0, 正常镜像0
  policy_limitNumber, 保留副本的个数
  cdp_bl_schedString@mock=, Baseline(全备份)策略 "2|001,1
  del_policyString@mock=1, 删除策略1
  mirr_schedString@mock=303:00-14:00,202:00-15:00, 镜像窗口时间控制303:00-14:00,202:00-15:00
  encrypt_switchString@mock=0, 0不开启,1开启0
  band_widthString@mock=303:00-14:002m,202:00-15:0080m, 带宽控制303:00-14:002m,202:00-15:0080m
  compressString@mock=0, 压缩:0不开启;1,低;2,中;3,高0
  mirr_sync_attrString@mock=1, 文件安全属性1
  policy_startNumber, 开始时间,参数只针对普通备份有效,整机备份暂不支持指定开始时间;格式:Unix 时间戳
  cdp_process_timeString@mock=, hh:mm:ss , 默认00:00:00
  bk_path_policyString@mock=0, 源路径目标路径路径映射关系:0:一对一,1:多对一;0
  cdp_bl_bkup_switchNumber@mock=0, 创建baseline副本 0 10
  file_type_filterString@mock=, 文件类型过滤,比如:.doc,.docx
  disk_limitString@mock=0, 该规则最大可用存储空间0
  oph_policyString@mock=0, 孤儿文件处理策略:0不处理,1删除,2移动到指定路径;6 归档;0
  mirr_file_checkString@mock=0, 校验方式0
  cmp_file_checkNumber@mock=0, 校验方式:0: 严格校验; 1: 时间;0
  mirr_sched_switchNumber@mock=0, 镜像窗口时间控制 开关0
  thread_numString并行任务数0
  cdp_data_incNumber数据增量大小
  cdp_data_inc_switchNumber按数据增量做快照开关
  cdp_data_inc_flagStringM G T
  mscs_autostartNumber开关: 集群故障转移到另一节点时,自动启动复制规则
勾选是1
不勾选是0
  mir_detect_scriptString高级设置 - 检测脚本路径
  filter_deleteNumber过滤删除,1:开;0关0
  batch_adv_switchNumber批量修改高级设置开关, 1:开 0:关
  batch_encrypt_switchNumber批量修改压缩加密开关, 1:开 0:关
  batch_mirr_switchString批量修改镜像设置开关, 1:开 0:关
  batch_cdp_switchString批量修改CDP设置开关, 1:开 0:关
  batch_cmp_switchString批量修改比较计划设置开关, 1:开 0:关
  batch_switchNumber批量修改:1, 普通修改:0
  cmp_limitString比较计划,保留数
  data_ip_uuidString数据地址uuid
B8166905-411E-B2CD-A742-77B1346D8E84
  compress_switchNumber传输压缩开关:0,1

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber@mock=00
  messageString@guid
  uuidString@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 复制规则uuid, 批量修改所用0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
retNumber@mock=200200
msgString@mock=

复制规则 - 删除

SDK方法名:deleteRepBackup;

URL

/rep/backup

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rep_uuidsArray*规则数组["11111111-1111-1111-1111-111111111111"]
forceNumber1 - 强制删除
0 - 非强制删除
del_policyNumber是否删除备份数据,0,1;
非必填,默认0
0
recycleNumber是否添加到数据清理:
0:否;
1:是;
0

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  codeNumber11110001
  messageString
  fail_listArray
    codeNumber11110001
    messageString[-1] 离线
    rep_uuidStringBC92C981-D637-AC10-7CB0-450504DF8A3C
    rep_nameStringtest1
  success_listArray
    codeNumber11110001
    messageString[0] success
    rep_uuidStringBA92C981-D637-AC10-7CB0-450504DF8A3C
    rep_nameStringtest2
retNumber200

复制规则 - 操作

SDK方法名:{operate}RepBackup

URL

/rep/backup/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateStringstart:启动;stop:停止start
rep_uuidsArray规则数组

Response

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

复制规则 - 状态

SDK方法名:listRepBackupStatus;

URL

/rep/backup/status

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rep_uuidsArray必传,uuid数组,页面加载第一次获取状态一个一个获取,之后是批量获取;["11111111-1111-1111-1111-111111111111"]
force_refreshNumber点击操作栏刷新按钮必传,下发1,表示从rpc获取;其他情况不传

Response

名称类型必选简介Mock初始值Mock规则
msgString
retNumber200
dataObject
  codeNumber0
  messageString
  statusArray2
    rep_uuidString规则uuid0DD4E727-70AB-62C6-BEB5-D012DFAE46E3
    statusNumber规则状态:
STOP:停止;
M_STOP:手动停止;
REPLICATION:复制;
MIRROR:镜像;
EXCEPTION:异常;
STALE:失效;
SWITCH:切换;
WAITING:等待;
EXECUTING:执行中;
IDLE:就绪;
DEAD:异常;
EXCPT:异常;
STOP
    latencyNumber复制延迟,单位ms10
    latency_thresholdNumber复制规则延时超限告警阈值, ms10
    file_totalString遍历文件总数1
    file_currentString当前遍历数
    progressString执行进度60
    blistString遍历未完成:
0:否;
1:是;

复制规则 - 列表

SDK方法名:listRepBackup;获取列表详细入参说明详见【节点管理-获取节点列表】接口说明;

URL

/rep/backup

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
search_valueString可选,搜索字段对应值(可以模糊)''
limitNumber可选,不传就是全部15
typeNumber0: default; 1: cluster; 10: template;
pageNumber可选,不传就是全部1
search_fieldString可选,搜索字段
statusString可选,总览页面跳转时按照状态过滤时需要
REPLICATION
MAINTAIN
MIRROR
STOP
UNKNOWN

Response

名称类型必选简介Mock初始值Mock规则
msgString@mock=
dataObject
  info_listArray2
    bk_pathArray目标节点路径/
    band_widthString带宽控制,格式:
303:00-14:002m,202:00-15:0080m(block也有)
303:00-14:002m,202:00-15:0080m@mock=303:00-14:002m,202:00-15:0080m,
    bk_node_nameString目标节点名@pick(["kevin", "Jane", "Grey"])@mock=@pick(["kevin", "Jane", "Grey"]),
    wk_pathArray源路径/
    rep_nameString规则名testbak@mock=testbak,
    usernameString用户名@pick(["admin", "user", "super"])@mock=@pick(["admin", "user", "super"]),
    random_strString用于防止并发修改的随机串@pick(["111", "222"])@mock=@pick(["111", "222"]),
    bk_uuidString目标节点UUID7AD64D7A-7D1D-AC51-5DF1-29A58345A288@mock=7AD64D7A-7D1D-AC51-5DF1-29A58345A288,
    rep_uuidString规则UUID@pick(["EFB53F11-7BA2-2001-3418-85865EA58E47", "0DD4E727-70AB-62C6-BEB5-D012DFAE46E3"])@mock=@pick(["EFB53F11-7BA2-2001-3418-85865EA58E47", "0DD4E727-70AB-62C6-BEB5-D012DFAE46E3"]),
    rep_typeNumber0: default 普通;
1: cluster 集群;
2: block ASM;
10: template 模板;
0@mock=0,
    wk_uuidString源节点UUID7AD64D7A-7D1D-AC51-5DF1-29A58345A288@mock=7AD64D7A-7D1D-AC51-5DF1-29A58345A288,
    wk_node_nameString源节点名@pick(["Smith", "Will", "Nary"])
    excl_pathArray排除路径/etc
    bk_path_policyString源路径目标路径路径映射关系:
0:绝对路径(源路径目标路径多对一),
1:相对路径(源路径目标路径一对一);
0@mock=0,
    is_from_haNumber是否属于HA关联规则;1 属于, 默认 0@pick([0, 1])
    mscs_groupObject集群信息
      nameString名称dGVzdA==
      addressString地址172.20.68.13
      object_idStringiddfadsfakjldfjdkfdfjdsfj
    can_upNumber允许更新1
    cmp_switchNumber比较开关,
0:关;
1:开
1
    can_opNumber允许操作1
    can_delNumber允许删除1
    proxy_addrString代理节点地址172.20.1.2
    proxy_portString代理节点端口8080
    proxy_uuidString代理节点uuid749BA2ED-E9A1-D16F-AAC3-07FE8E0AF5C8
  countNumber规则数量10@mock=10,
  totalNumber规则总数100@mock=100,
  messageString接口错误信息(如有)
  codeNumber0@mock=0
retNumber200@mock=200

复制规则 - cdp baseline 列表 获取

SDK方法名:listRepBackupBaseLine;

用途:

1,复制规则-更多-查看cdpbaseline;

2,cdp恢复-先调这个接口得到什么baseline列表-根据用户选择的“CDP恢复时间点”从baseline列表找到当时的路径,显示在页面上;(此时路径表格的“添加”键调dir接口时,需要传rep_uuid和cdp_time)

URL

/rep/backup/cdp_bl_list

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rc_methodNumber恢复方式: 0:按规则来恢复 1:按数据目录来恢复0
rep_uuidString规则uuid,rc_method为1时,可不传
bk_uuidString灾备机uuid,rc_method为0时,可不传
data_pathString恢复数据路径;rc_method为0时,可不传
pageNumber可选,page1
limitNumber可选,limit,这俩必须一起传,单传一个没用10

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  listArray3
    bs_timeStringbaseline时间2018-10-23_13-28-35
    next_bs_timeString上一个baseline时间2018-10-23_13-23-08
    wk_pathArray生成 baseline 当时的工作路径(现在路径可能已经改了)["E:\test\"]
    bk_pathArray生成 baseline 当时的灾备路径(现在路径可能已经改了)["E:\test\"]
    bk_path_policyNumber源路径目标路径路径映射关系:
0:一对一
1:多对一;
    wk_os_typeNumber0: linux, 1: windows0
    bk_os_typeNumber0: linux, 1: windows1
    snapshotNumber0:未使用快照方式 1:使用快照方式1
  codeNumber@mock=00
  messageString@mock=[0] 操作成功[0] 操作成功
  totalNumber
msgString@mock=
retNumber@mock=200200

复制规则 - cdp baseline 列表 删除

SDK方法名:deleteRepBackupBaseline;

URL

/rep/backup/:uuid([A-F0-9-]+)/cdp_bl_list

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
cdp_time_listArraycdp_time 列表2017-11-17 17:24:14

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  success_listArray3
    messageString@mock=[0] 操作成功[0] 操作成功
    codeNumber@mock=00
    cdp_timeString@mock=2017-11-17 17:24:14, CDP时间点2017-11-17 17:24:14
  messageString@mock=[0] 操作成功[0] 操作成功
  codeNumber@mock=00
  totalNumber@mock=33
  fail_listArray3
    cdp_timeString@mock=2017-11-17 17:24:14, CDP时间点2017-11-17 17:24:14
    messageString@mock=[12345678] 操作失败, 原因 xxxxxx[12345678] 操作失败, 原因 xxxxxx
    codeNumber@mock=1234567812345678
msgString@mock=
retNumber@mock=200200

复制规则 - 孤儿文件 列表 获取

SDK方法名:listRepBackupOrphan;入参path只包含子路经 , 后端以规则 oph_path + path 查文件夹 ,

返回文件夹末尾不带分隔符 , 需前端拼接

URL

/rep/backup/:uuid([A-F0-9-]+)/orphan_list

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pathString不包含孤儿文件存放路径的父路径

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  codeNumber0
  messageString操作成功[0] 操作成功
  orphan_listArray
    nameString目录或文件名@word
    timeString创建/修改时间@datetime()
    is_dirBoolean是否为目录@boolean
    sizeNumber文件大小,返回的是"number"@integer(100)
  separatorString用来拼接的路径分隔符 , 正反斜杠/
  rep_oph_pathString复制规则孤儿文件路径/test/oph_path
retNumber200

复制规则 - 孤儿文件 列表 删除

SDK方法名:deleteRepBackupOrphan;

URL

/rep/backup/:uuid([A-F0-9-]+)/orphan_list

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
pathString不包含孤儿文件存放路径的父路径/
orphan_listArray孤儿文件名 列表[""]

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  success_listArray3
    messageString@mock=[0] 操作成功[0] 操作成功
    orphanString@mock=xxxxxx, 孤儿文件xxxxxx
    codeNumber@mock=00
  messageString@mock=[0] 操作成功[0] 操作成功
  fail_listArray3
    codeNumber@mock=1234567812345678
    orphanString@mock=xxxxxx, 孤儿文件xxxxxx
    messageString@mock=[12345678] 操作失败, 原因 xxxxxx[12345678] 操作失败, 原因 xxxxxx
  codeNumber@mock=00
  totalNumber@mock=33
retNumber@mock=200200
msgString@mock=

复制规则 - 孤儿文件 下载

SDK方法名:downloadRepBackupOrphan;

URL

/rep/backup/:uuid([A-F0-9-]+)/orphan_download

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
orphanString孤儿文件名,Eg: test.txt
pathString不包含孤儿文件存放路径的父路径/

Response

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

复制规则 - 快照 列表 获取

SDK方法名:listRepBackupSnapshot;

URL参数为 rep_uuid;如果备机为windows,列表上方显示的【快照总的占用空间】为第一条快照的 snapshot_size

URL

/rep/backup/snapshot_list

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rc_methodString恢复方式:
0:按规则来恢复
1:按数据目录来恢复
rep_uuidString规则uuid,rc_method为1时,可不传
bk_uuidString灾备机uuid,rc_method为0时,可不传
data_pathString恢复数据路径;rc_method为0时,可不传
pageNumber可选,page1
limitNumber可选,limit,这俩必须一起传,单传一个没用10

Response

名称类型必选简介Mock初始值Mock规则
msgString
retNumber200
dataObject
  codeNumber0
  snapshot_listArray
    snapshot_nameString快照名称c5809dd2-e8be-4389-ac0d-0a657ff94da0_snap_2017-11-17_17-24-14
    snapshot_sizeString大小1.34 GB
    snapshot_timeString时间2017-11-17 17:24:14
    wk_pathArray生成快照时的工作路径["E:\test\"]
    bk_pathArray生成快照时的的灾备路径["E:\test\"]
    bk_path_policyNumber源路径目标路径路径映射关系:
0:一对一
1:多对一;
    wk_os_typeNumber0: linux, 1: windows0
    bk_os_typeNumber0: linux, 1: windows0
  os_typeString系统: 0: linux, 1: windows@pick(["1", "2"])
  messageString[0] success
  totalNumber

复制规则 - 快照 创建

SDK方法名:createRepBackupSnapshot;URL参数为 rep_uuid;

URL

/rep/backup/:uuid([A-F0-9-]+)/snapshot_list

Method

POST

Request

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

Response

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

复制规则 - 快照 删除

SDK方法名:deleteRepBackupSnapshot;URL参数为 rep_uuid;

URL

/rep/backup/:uuid([A-F0-9-]+)/snapshot_list

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
snapshot_namesArray快照名称数组[]

Response

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

复制规则 - 获取集群组信息

SDK方法名:listRepBackupMscsGroup;

URL

/rep/backup/mscs_group

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  listArray2
    addressString172.20.0.128
    nameStringXSZ_FILE_test
    object_idStringb153ed13-e55d-4eb9-a88b-9dd6ffd7f6b2

5 Dashboard - 获取规则列表

SDK类名:/dashboard/Dashboard; SDK方法名:repBackup;

URL

/dashboard/rep

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
limitNumber可选,默认 3010
pageNumber可选,默认 11
typeNumber0: default; 1: cluster; 2: block; 10: template;0

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  info_listArray2
    bk_pathArray
    band_widthString303:00-14:002m,202:00-15:0080m
    bk_node_nameString@pick(["kevin", "Jane", "Grey"])
    wk_pathArray
    usernameString@pick(["admin", "user", "super"])
    rep_nameStringtestbak
    random_strString@pick(["111", "222"])
    bk_uuidString7AD64D7A-7D1D-AC51-5DF1-29A58345A288@uuid
    rep_uuidString@uuid
    rep_typeNumber0
    wk_uuidString7AD64D7A-7D1D-AC51-5DF1-29A58345A288@uuid
    wk_node_nameString@pick(["Smith", "Will", "Nary"])
    excl_pathArray
    bk_path_policyString0
    n_statusString@pick(["UNKNOWN", "ONLINE"])
  countNumber10
  totalNumber100
  messageString
  codeNumber0
retNumber200

复制规则 - 批量新建

SDK方法名:batchCreateRepBackup;

URL

/rep/backup/batch

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
base_info_listObject复制规则公共信息部分-跟复制规则一致
  mirr_open_typeString文件打开方式0
  mirr_sync_attrString文件安全属性1
  mirr_sync_flagString错误处理方式0
  mirr_file_checkString校验方式0
  mirr_skipString镜像设置 - 跳过镜像;0:正常镜像;1:直接进入复制状态;2:仅同步目录;0
  snapshot_switchNumber快照开关1
  snapshot_policyString快照个数达到上限时策略0
  snapshot_startNumber开始时间,Eg: 15155685661546913351
  snapshot_limitString快照数目24
  snapshot_intervalString快照间隔1
  file_type_filter_switchNumber包含0排除10
  file_type_filterString文件类型过滤,比如:.doc,.docx
  bkup_one_timeNumber定时任务,执行时间(备份策略) Eg: 15155685661515568566
  bk_path_policyString源路径目标路径路径映射关系:0:一对一,1:多对一;1
  disk_limitString该规则最大可用存储空间0
  del_policyString删除策略,0:不开启;1:开启;1
  thread_numString并行任务数0
  oph_pathString孤儿文件,移动到指定路径、归档,必填E: est4/
  oph_policyString孤儿文件处理策略:0不处理,1删除,2移动到指定路径;6 归档;2
  latency_thresholdNumber延迟告警毫秒数,默认值0不告警1
  cdp_switchString0:不启用;1:开启1
  cdp_process_timeStringhh:mm:ss , 默认00:00:0005:07:28
  cdp_pathStringCDP数据目录 : 如开启CDP则必填E: est3/
  cdp_paramStringCDP参数:是几个参数的合并3,30,0
  cdp_data_inc_switchNumber按数据增量做快照开关0
  cdp_baseline_formatStringBaseline存储格式: 保持源目录结构 打包0
  cdp_bl_bkup_switchNumber创建baseline副本 0否1是;0
  cdp_bl_sched_switchNumber指定生成Baseline(全备份)的策略1
  cdp_bl_schedStringBaseline(全备份)策略 "2|001,1
  cdp_snap_onNumber使用快照做Baseline;0关1开;0
  cdp_snap_countNumberCDP快照数量,0到9999之间的整数240
  cdp_snap_intervalNumberCDP快照间隔,5,10,15,20,25,30,40,50,60,单位是分钟30
  cdp_zfs_poolStringCDP zfs存储池,选择系统上已有的存储池,仅在cdp页面快照打开且备机是Linux系统时的时候显示.,如果获取的value值为空,则cdp不支持linux快照方式。
  cdp_data_incNumber数据增量的大小,单位为M0
  cdp_data_inc_flagString用来表示数据增量单位 M G T
  ct_name_typeNumber文件名替换,0表示不启用。1加前后缀,原来部分保持不变;2前后缀加小写,3前后缀加大写 4自定义0
  ct_name_str1String文件名转换:prefix string / regex string
  ct_name_str2String文件名转换:suffix string / replace string
  ct_name_str3String文件名转换:restore regex string
  ct_name_str4String文件名转换:restore regex string
  cmp_switchNumber比较计划,0: 关; 1: 开;0
  cmp_file_checkNumber比较计划,校验方式,0:md5;1:文件大小和时间;0
  cmp_scheduleArray比较计划,策略
    sched_everyNumber每,0天,1周,2月;1
    sched_timeArray哪几点["@time('HH:mm')"]
    sched_dayArray哪几天["@integer(1, 31)"]
  mscs_autostartNumber开关: 集群故障转移到另一节点时,自动启动复制规则 勾选是1 不勾选是01
  encrypt_switchString0不开启,1开启(block也有)0
  compress_switchNumber传输压缩开关:0,10
  compressString压缩:0不开启;1,低;2,中;3,高(block也有)0
  secret_keyString加密key(block也有)
  rep_prefixString复制规则前缀bk_
  batch_nameString批量任务:用于批量创建的规则名称
  rep_sufixString批量任务:复制规则后缀
  variable_typeNumber批量任务:
变量名,
0,节点名称;1,节点ip;2,虚机名称
node
  auto_startString规则自动启动(block也有)1
  band_widthString带宽控制,格式:303:00-14:002m,202:00-15:0080m(block也有)
  rep_typeNumber0: default; 1: cluster; 2: block; 10: template;(必传)0
  mirr_schedString高级设置 - 禁止镜像策略;Eg: 303:00-14:00,202:00-15:00(block也有)
  mirr_sched_switchNumber高级设置 - 启用禁止镜像:1;关闭:0;(block也有)0
  mir_detect_scriptString高级设置 - 检测脚本路径
  mscs_groupObject已选集群组
rep_backupArray节点及路径信息
  wk_uuidString工作机UUID
  bk_uuidString灾备机UUID
  wk_pathArray工作机路径
  bk_pathArray灾备机路径
  excl_pathArray工作机排除目录

Response

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

复制规则 - 检查目标路径

SDK方法名:checkBkPath;

URL

/rep/backup/check_bk_path

Method

GET

Request

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

Response

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

复制规则 - 提交前检查

SDK方法名:chkRules;

URL

/rep/backup/rules_chk

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
wk_uuidString【可选】源备机关联规则检查、源路径检查时传
bk_uuidString【可选】目标路径检查、源备及管理规则检查时传
bk_pathArray【可选】目标路径检查时传
wk_pathArray【可选】源路径检查时传
chk_listArray检查项:
bk_path: 目标路径检查
rules: 源备机关联规则检查
wk_path: 源路径检查
["bk_path", "rules", "wk_path"]
has_reverseNumber【可选】高可用勾选反向同步规则
0-不勾选
1-勾选
rep_typeNumber【可选】规则类型:0、1、2、10
源路径检查时传

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString操作成功。
  wk_pathObject
    codeNumber11119506
    messageStringRPC方法未定义
  bk_pathObject
    codeNumber11119506
    messageStringRPC方法未定义
  rulesObject
    codeNumber0
    messageString操作成功。
    info_listArray
      rep_nameStringcp02
      rep_uuidString140D8DEB-64C5-5B4C-A0C6-018FC15C03D2
      wk_pathArray["C:\TEST\b21"]
      bk_pathArray["C:TESTb21-1"]
      excl_pathArray
      is_from_haNumber0
    totalNumber1
Last update: 11/3/2023, 3:54:28 PM
Contributors: ganl