虚拟化

November 18, 2022About 54 min

虚拟化

SDK类名:/vp/VirtualizationSupport;

Dashboard - 虚机规则 成功率

统计报表

SDK方法名:describeVpRuleRate

URL

/dashboard/vp_rule

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
uuidString可选,用虚机规则过滤
typeString可选,用任务类型过滤,

'VP_BK': 备份规则,
'VP_RC':恢复规则,
'VP_MV':迁移规则,
'VP_PT':复制规则,
'VP_OR':演练规则,
I2VP_BK
wk_uuidString可选,用虚拟平台过滤F28BA5A6-4FF9-E596-4371-1ED203D45143
modeString必传,显示近 week | monthyear 的统计month
group_uuidString可选, 用组规则过滤

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  success_num|1-100Number当前条件下总...23
  failed_num|1-100Number当前条件下总失败数
  total_num|1-100Number当前条件下总...2
  trans_data_numString当前条件下总...1.27MB
  unread_err_num|0-100Number当前条件下总...2
  info_listArray30
    timeString月/日11-26+1
    success_num|0-100Number成功任务数量23
    failed_num|1-100String
    total_num|0-100Number总任务数量2
    trans_data_numString传输数据大小1.27MB
    unread_err_numNumber未查看错误数2
  all_success_num|1-100Number总...
  all_failed_num|1-100Number总失败数
  all_total_num|1-100Number总...
  all_trans_data_numString总...9.00 GB
  all_unread_err_num|0-100Number总...

Dashboard - 虚机 保护率

统计报表

SDK方法名:describeVmProtectRate

URL

/dashboard/vp_vm

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString可选(不传获取所有)F28BA5A6-4FF9-E596-4371-1ED203D45143

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  vm_totalNumber总...21
  vm_protectedNumber总...12
  info_listArray
    vp_nameString虚拟平台名称daaaa
    vm_totalNumber虚机总量21
    vm_protectedNumber虚机总量12
    vp_uuidString虚拟平台uuid1663DD96-C9BE-B49E-6044-3AB3120F4B74

------- 虚机备份 -------

URL

/dash/vp_backup

Method

GET

Request

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

Response

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

虚机备份 - 新建

添加备份规则

SDK方法名:createVpBackup

URL

/vp/backup

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rule_typeNumber规则类型:0:普通规则;10:模板;0
rule_nameString*必填 规则名称vp_bk cky
vp_uuidString虚拟平台uuid(普通任务必填,模板传空串)C6335F62-2565-1957-4BB9-587F2FF46B00
agent_uuidString虚拟平台为openstack时传,虚拟平台代理节点uuid
source_region_idString区域ID(云平台)
source_project_idString项目ID(云平台)
vm_listArray虚机信息(普通任务必填,模板传空数组)
  vm_nameString虚机名称测试5
  vm_refString虚机idvm-10811
  disk_listArray磁盘信息
    idString
    disk_dirString
    disk_nameString
    sizeString
    datastoreString
    is_ignoredNumber选中为0,不选为1
    datastore_typeString存储类型(Fusion storage显示)
  new_vm_nameString新虚机名称虚机名称_2020-04-29
  scripts_typeNumber开启验证时:
(*必填)脚本验证的方式,0表示验证ping方法验证,1表示tcp端口验证测试,2表示脚本验证方式。2表示脚本验证方式目前暂存以后实现。默认值为0
  scriptsString开启验证时:
验证内容
  cpuString开启验证时:
cpu数
  core_per_sockString开启验证时:
单个cpu核数
  mem_mbString开启验证时:
内存大小
  os_typeNumber开启验证时:
操作系统: 0:linux; 1:windows
  vm_uuidString虚机uuid标记,从虚机列表获取,可以为nullnull
  is_setNumber是否设置了自定义设置:
0:否;
1:是;
0
biz_grp_listArray业务分组:组uuid数组
bk_uuidString备机uuid67E33CDB-D75B-15B3-367D-50C764F5A26F
bk_typeNumber备份存储类型:
0:文件系统;
1:对象存储;
0
bk_pathString*必填 备份路径E:\vp_bk5\
sto_uuidString对象存储uuid
bucketString对象桶(name)
bucket_pathString桶路径
quick_backNumber快速备份;1:开;0:关;1
lan_freeNumberlan free 传输;31:开;23:关;23
del_bkup_dataNumber删除备份数据;1:开;0:关;0
quiet_snapNumber静默快照;1:开;0:关;0
mem_snapNumber内存快照;0关1开0
instant_recoveryNumber是否可以瞬时恢复,0关1开
src_trans_modeNumber源平台数据传输模式:
1:nbd;
2:nbdssl;
4:hotadd;
8:san;
31:auto;
31
bkup_policyNumber备份策略,0:一次性(定时),1:周期(循环);1
bkup_one_timeNumber备份策略 - 一次性,执行时间,格式:linux时间戳,非一次型传01546831899
bkup_scheduleArray备份策略 - 周期任务;非周期任务则传空数组;
  limitNumber数据保留期限(天)3
  sched_dayArray备份策略 - 周期任务 - 哪几天,num数组; 【每月】、【每周】专用参数;取值:每月:1-31;每周:0-6(周日-周六)[1, 2, 3]
  sched_timeArray备份策略 - 周期任务 - 运行时间;str数组;取值格式HH:mm["00:00"]
  sched_everyNumber备份策略 - 周期任务 - 策略类型;0:每天;1:每周:2:每月;0
  bkup_typeNumber备份策略 - 周期任务 - 备份方式;0:全备,1:增量,2:差异,3:合成0
band_widthString带宽控制,默认为空不启用 格式: 星期几:时间点-带宽;时间点-带宽,星期几:时间点-带宽;时间点-带宽;星期:0-6:日-六;时间点:0-23(0代表0点-0:59分);带宽:0-1000,单位8k;成品串实例:-1
random_strString新建不传,sdk测试用11111111-1111-1111-1111-111111111111
add_drillNumber是否开启认证:
0:否,
1:是,
默认否
autoNumber开启验证时必传:
自动验证:
自动:1,手动:0;
0
drill_plat_uuidString开启验证时传:
目标平台的vp_uuid
data_ip_uuidString数据地址67E33CDB-D75B-15B3-367D-50C764F5A26F
cred_uuidString凭据uuid
trans_typeString数据传输方式,FTP,SCP
ftp_pathStringtrans_type为FTP时为必填项
data_verifyNumber是否开启数据校验数据校验0
compressNumber备端数据压缩:
0:关;
1:开;
0
encrypt_switchNumber备端数据加密:
0:关;
1:开;
encrypt_typeNumber备端数据加密方式
1:aes,
2:sm4
encrypt_keyString备端加密密钥。
transfer_compressionNumber传输压缩:
0:关;
1:开;
0
transfer_encryptNumber传输加密:
0:关;
1:开;
0
is_limit_backuptimeNumber是否开启指定范围0
backup_timesArray备份窗口时间。不开启时为空
  day_of_weekArray星期日 0 星期一 1 星期二 。。。[]
  begin_timeString备份时间段开始时间 eg. 12:2000:00
  end_timeString备份时间段结束时间 eg. 13:3500:00
consolidate_switchNumber磁盘整合开关:
0:关;
1:开
0
consolidate_disks_timeString磁盘整合时间
fail_retryNumber失败重试开关:
0:关;1:开
retry_timesNumber失败重试次数。0-5的整数。默认0,不进行重试;
retry_intervalNumber失败重试的间隔,单位分钟。默认0,无间隔;0-30的整数。
concurrent_disk_threadsNumber磁盘传输并发数 默认值 2
值为 1 2 3 4
backup_methodNumber备份方式:
平台类型为cas(vp_type=7)时必传:
0 : 基于平台接口
1:基于平台主机代理
0
auto_discoveryNumber是否开启自动发现0否1是0
match_policyObject虚机自动发现,匹配规则
  vm_nameArray虚机名称
    typeString前缀:prefix;
后缀:suffix;
    valueString前/后缀值
    labelString
  locationArray物理位置
    typeString数据中心:Datacenter
集群:ClusterComputeResource
主机:HostSystem
数据存储:Datastore
    valueString值(id标识)
    labelString名称等
  folderArray逻辑位置
    typeString文件夹:Folder;(默认)
    valueString值(路径)
    labelString
is_fusion_storageNumber是否fusion storage:
0:否;
1:是;
0
winstack_pool_idStringwinstack池ID
winstack_host_idStringwinstack主机ID

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString, 错误信息提示
  codeNumber@mock=00
  success_listArray内容类似 fail_list
  fail_listArray
    codeString成功返回0,规则冲突返回6077
    messageString
    rule_uuidString规则的uuid
    vm_nameString虚机名称
    conflict_rule_nameString冲突的规则名称
    conflict_vm_nameString冲突的虚机名称
    conflict_usernameString冲突用户名
msgString, 错误信息
retNumber@mock=200, http code200

虚机备份 - 修改

添加备份规则;URL参数为 group_uuid;

接口入参和新建一样,修改规则为新建完整规则参数,模板则去掉 vp_uuid 和 vm_list;

SDK方法名:modifyVpBackup

URL

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

Method

PUT

Request

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

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber0
msgString, 错误信息
retNumber@mock=200, http code200

虚机备份 - 获取单个

查看备份规则,URL参数为 rule_uuid

SDK方法名:describeVpBackup

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber0
  vp_backupObject
    del_bkup_dataNumber1
    quiet_snapNumber1
    quick_backNumber1
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameStringvp_name
    vp_typeNumber
    bk_pathStringC:\test\
    bk_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    agent_uuidString代理节点uuid
    source_region_idString区域ID(云平台)
    source_project_idString项目ID(云平台)
    lan_freeNumber1
    rule_nameStringtemp
    bkup_policyNumber0
    bkup_one_timeNumber1515568566
    bkup_scheduleArray
      limitNumber3
      sched_dayArray[1,2,3]
      sched_timeArray["00:00"]
      sched_everyNumber0
      bkup_typeNumber0
    create_timeString1515568566
    rule_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    random_strStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    usernameStringJoseph Johnson
    user_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    bk_node_nameString
    vm_nameString
    vm_refString
    data_ip_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7461
    backup_methodNumbercas平台备份方式0
  totalNumber1
retNumber200
msgString

虚机备份 - 获取单个(组)

查看备份规则,URL参数为 group_uuid

SDK方法名:describeVpBackupGroup

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber0
  vp_backupObject
    del_bkup_dataNumber1
    quiet_snapNumber1
    quick_backNumber1
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameString平台名称vp_name
    vp_typeNumber
    bk_pathStringC:\test\
    bk_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    lan_freeNumber1
    rule_nameStringtemp
    bkup_policyNumber1
    bkup_one_timeNumber1515568566
    bkup_scheduleArray
      limitNumber3
      sched_dayArray[1,2,3]
      sched_timeArray["00:00"]
      sched_everyNumber0
      bkup_typeNumber0
    create_timeString1515568566
    rule_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    random_strStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    usernameStringJoseph Johnson
    user_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    bk_node_nameString备机名
    group_uuidString@guid
    vm_listArray
      rule_uuidString虚机对应单个规则uuid
      vm_nameString@name
      vm_refString110
      drill_uuidString存在演练时返回:
演练规则uuid
      new_vm_nameString存在对应演练规则时返回:
新虚机名称
      scriptsString存在对应演练规则时返回
      scripts_typeNumber存在对应演练规则时返回:
脚本验证的方式,0表示验证ping方法验证,1表示tcp端口验证测试,2表示脚本验证方式。2表示脚本验证方式目前暂存以后实现。默认值为0
      cpuString存在对应演练规则时返回:
cpu数
      core_per_sockString存在对应演练规则时返回:
单个cpu核数
      mem_mbString存在对应演练规则时返回:
内存大小
      os_typeNumber存在对应演练规则时返回:
操作系统: 0:linux; 1:windows
    band_widthString-1
    add_drillNumber是否开启验证,0否,1是
    autoNumber存在对应演练规则时返回:
自动演练:自动:1,手动:0;默认为0
    drill_plat_uuidString开启验证时:演练平台uuid
    agent_uuidString代理节点uuid
    source_region_idString区域ID(云平台)
    source_project_idString项目ID(云平台)
    source_node_region_idString节点连表查到的字段,防止旧规则不存在source_region_id
    source_node_project_idString节点连表查到的字段,防止旧规则不存在source_project_id
  totalNumber1
retNumber200
msgString

虚机备份 - 列表

获取备份规则列表;获取列表详细入参说明详见【节点管理-获取节点列表】接口说明;

SDK方法名:listVpBackup

URL

/vp/backup

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber可选1
limitNumber可选10
typeNumber规则类型:0:普通规则;10:模板;0

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber0
  info_listArray3
    bk_node_nameString备机名称@name
    group_uuidString@guid
    usernameString@name
    rule_nameString@name
    rule_uuidString@guid
    vp_uuidString@guid
    vp_typeString
    vp_nameString平台名称@name
    vm_nameString@name
    bk_uuidString@guid
    bk_typeNumber0
    bk_pathString/temp/
    sto_uuidString
    bucketString
    bucket_pathString
    last_resultObject上次执行结果详情,内容同统计报表
    last_success_resultObject上次执行成功结果详情,内容同统计报表
    vp_config_addrString源平台管理地址
    vp_config_portString源平台管理端口
    can_mBoolean是否支持合成备份false
    auto_discoveryNumber是否开启自动发现0否1是0
    can_delNumber1
    can_opNumber1
  messageString
  totalNumber1
retNumber200
msgString

虚机备份 - 列表(组)

获取备份规则组列表;

逻辑:是在【获取列表】基础上,融合同组规则,在规则上加入vm_list 数组,其中有 rule_uuid;

获取列表详细入参说明详见【节点管理-获取节点列表】接口说明;

SDK方法名:listVpBackupGroup

URL

/vp/backup/group

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber可选1
limitNumber可选10
typeNumber规则类型:0:普通规则;10:模板;0
where_args[bk_path]String(RC) 获取 bk_path 为 H:\tmp\ 的规则组;H:\vp_bk5\

Response

名称类型必选简介Mock初始值Mock规则
dataObject
retNumber200
msgString
dataObject
  messageString
  codeNumber0
  info_listArray2
    del_bkup_dataNumber1
    quiet_snapNumber1
    quick_backNumber1
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameStringvp_name
    vp_typeString
    bk_pathStringC:\test\
    bk_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    lan_freeNumber1
    rule_nameStringtemp
    bkup_policyNumber0
    bkup_one_timeNumber1515568566
    bkup_scheduleArray
      limitNumber3
      sched_dayArray[1,2,3]
      sched_timeArray["00:00"]
      sched_everyNumber0
      bkup_typeNumber0
    create_timeString1515568566
    rule_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    random_strStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    usernameStringJoseph Johnson
    user_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    bk_node_nameString
    group_uuidStringcCBEC2D3-B6FE-853F-33db-d292b2D62De1
    vm_listArray
      vm_nameStringChristopher Jackson
      vm_refString110
  totalNumber1
retNumber200
msgString

虚机备份 - 状态

获取备份规则的状态

SDK方法名:listVpBackupStatus

URL

/vp/backup/status

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  countString1
  messageString
  codeNumber0
  statusArray2
    statusStringstop,executing,idle,dead,finish,switch,unknown,@pick(["STOP","EXECUTING","IDLE","DEAD","FINISH","SWITCH","UNKNOWN","VP_START","VP_CHECK","VP_CFG","VP_CBT"])
    progressNumber0-100
    rule_uuidString@guid
    last_resultObject上次执行结果详情,内容同统计报表
    last_success_resultObject上次执行成功结果详情,内容同统计报表
retNumber200

虚机备份 - 操作 启停

SDK方法名:

启动:startVpBackup;

停止:stopVpBackup;

URL

/vp/backup/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString"start", "stop","start_immediately", 'auto_discovery',
rule_uuidsArray规则uuid列表[C6335F62-2565-1957-4BB9-587F2FF46B00]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
bkup_typeString立即执行操作(start_immediately)必传,取值为,备份策略 - 周期任务 - 备份方式;0:全备,1:增量,2:差异,3:合成
forceNumber“自动发现”参数,许可剩余数量不足时,是否强制添加:
0:否;
1:是;
0

Response

名称类型必选简介Mock初始值Mock规则
dataObject, api content
  messageString, 错误信息提示
  codeNumber@mock=010110035
  success_listArray
    {$prefix}_uuidStringrule_uuid、group_uuidaaa
    codeString0
    messageStringdsaf
    rule_nameString规则名称adsf
    vm_nameString(单个规则,非文件恢复)虚机名称fadsf
  fail_listArray
    {$prefix}_uuidStringrule_uuid、group_uuidfads
    codeStringfasfd
    messageString错误讯息asfda
    rule_nameString规则名称fssa
    vm_nameString(单个规则,非文件恢复)虚机名称fdsaf
retNumber@mock=200, http code200
msgString, 提示信息

虚机备份 - 删除

删除备份规则

SDK方法名:deleteVpBackup

URL

/vp/backup

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray["11111111-1111-1111-1111-111111111111"]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
forceNumber1 - 强制删除 0 - 非强制删除
delete_bk_dataNumber是否删除备份数据0,10
recycleNumber是否添加到数据清理:
0:否;
1:是;
0

Response

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

虚机备份 - 删除备份点

SDK方法名:deleteVpBackupPoint;

URL

/vp/backup/backup_data

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidString备份规则uuid
version_listArray备份点uuid列表(目前只支持单个删除)

Response

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

------- 虚机恢复 -------

URL

/dash/vp_recovery

Method

GET

Request

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

Response

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

虚机恢复 - 新建

新建恢复规则

SDK方法名:createVpRecovery

URL

/vp/recovery

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rule_nameString规则名称testRC cky
rule_typeNumber恢复类型:0:普通;1:瞬时;0
api_typeStringAPI类型,如HostAgent、vcenter、Hyper-VHostAgent
bk_typeNumber备份存储类型:
0:文件系统;
1:对象存储;
0
bk_path_viewString数据存放目录(与vm_list当中的bk_path所区分,仅用于页面展示)H:\vp_bk5\testRC1_BAK_99_192.168.85.139
sto_uuidString对象存储uuid
bucketString对象桶(name)
bucket_pathString桶路径
new_dsString存储名称、Hyper-V:路径如 E:\hp\datastore1
new_hostnameString新主机名称localhost.localdomain
new_dcString数据中心ha-datacenter
locationStringFusionCompute平台必选
恢复虚拟机所在的计算资源位置
is_createNumber
是否创建虚拟机 是 :1 否:0
0
vp_uuidString虚拟平台的uuid(源虚拟平台)928B88A6-CDBA-6F55-ADCB-15A8A935C9C2
bk_uuidString备机节点uuid67E33CDB-D75B-15B3-367D-50C764F5A26F
new_vp_uuidString目标平台928B88A6-CDBA-6F55-ADCB-15A8A935C9C2
agent_uuidString目标平台为openstack,目标平台代理节点
agent_data_ip_uuidString目标平台代理节点数据地址
target_region_idString区域ID(云平台)
target_project_idString项目ID(云平台)
lan_freeNumber传输方式23
dest_trans_modeNumber目标平台数据传输模式:
1:nbd;
2:nbdssl;
4:hotadd;
8:san;
31:auto;
31
auto_startupNumber自动开启虚机:0:关;1:开;0
new_dc_morString数据中心标识ha-datacenter
new_ds_pathString工作目录:虚机平台是 hostagent 则为用户输入的目录,若虚拟平台是vcenter 则传 /,Hyper-V平台不用传/
vm_listArray虚拟机的数组
  vm_nameString测试5
  new_vm_nameString测试5
  vm_refString99
  bk_pathString(组恢复时传)备份点信息列表返回的bk_path
  ver_sigString备份点idA59DB76E-E33D-4E22-BB08-59723B1FC539
  ver_timeString备份时间
  disk_listArray
    idString
    disk_pathString/
    disk_nameStringproxy gateway1.vmdk
    is_sameNumber1
    new_dsStringdatastore1
    boot_indexNumber仅限源平台为vmware时使用1
    disk_typeString磁盘类型,仅限openstack、hcs,默认为''''
    datastore_typeString存储类型(fusionstorage 显示)
  networksArray自定义 - 网卡
    source_network_nameString源端network_name
    source_network_idString源端network_id
    mac_addressString源端mac地址
    keep_macNumber1
    network_nameString
    network_idString
    ip_addressString云平台固定ip地址
  cpuNumber处理器个数
  core_per_sockNumber处理器核心数
  mem_mbNumber内存
  dynamic_memNumber是否动态内存,1表示动态内存,0表示非动态内存。
  flavor_idString自定义 - 主机规格
  common_customNumber是否开启自定义设置 - 通用0
  disk_customNumber是否开启自定义设置 - 磁盘0
  encrypt_typeNumber备端数据加密方式
0:不加密,
1:aes,
2:sm4
0
  encrypt_keyString当选择备份数据加密方式为aes加密时,密钥值。
  start_orderNumber启动顺序,未开启时默认下发00
biz_grp_listArray业务分组,组uuid
group_recoveryNumber是否组恢复;1:是;0:否0
backup_rule_nameString对应备份规则的规则名称testRC1
band_widthString带宽-1
for_vp_file_rcNumber0否1是,是否用于VP文件级恢复1
del_vmNumber是否删除虚机,默认为0;0:不删除,1:删除1
network_idString全局 - 网卡id
network_nameString全局 - 网卡name
ip_addressString云平台固定ip地址
data_ip_uuidString数据地址928B88A6-CDBA-6F55-ADCB-15A8A935C9C1
trans_typeString数据传输方式,FTP,SCP
cred_uuidString凭据uuid
parent_flavor_idString全局 - 主机规则
concurrent_disk_threadsNumber磁盘传输并发数 默认值 2
值为 1 2 3 4
backup_methodNumbercas备份方式:
0:基于平台接口
1:基于平台主机代理
0
is_start_orderNumber是否设置开机启动顺序:
0:否;
1:是;
0
transfer_compressionNumber传输压缩:
0:关;
1:开;
0
transfer_encryptNumber传输加密:
0:关;
1:开;
0
is_fusion_storageNumber是否fusion store:
0:否;
1:是;
winstack_pool_idString
winstack_host_idString

Response

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

虚机恢复 - 获取单个 组

查看组规则信息;URL 参数:恢复规则组uuid;

SDK方法名:describeVpRecoveryGroup

URL

/vp/recovery/group/:uuid([A-F0-9-]+)

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vp_recoveryObject
    backup_rule_nameString9_21
    bk_node_nameStringN3_72.75
    group_uuidStringF6FCFC4D-EE04-946B-56F2-A52E91AFD5A8
    rule_uuidString8264AEDC-815B-0FA1-1FEE-F8B4FD15E1F1
    rule_nameString2221
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    bk_uuidStringC02B76DB-EBE8-E029-B645-072B2E1A7460
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameString88.107
    vp_typeNumber
    new_vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    new_vp_nameString88.107
    new_vp_typeNumber
    new_dcStringha-datacenter
    new_dsStringdatastore107(1)
    new_dc_morStringha-datacenter
    bk_pathStringH:\vp_bk\111_BAK_119_192.168.88.107\
    new_ds_pathString/
    new_hostnameStringdev-esxi.6.6.6
    new_vm_nameStringchenky_vp_test
    cpuNumber2
    core_per_sockNumber1
    mem_mbNumber3972
    macString3,00:50:56:96:73:51,5,4000,100,7,1,VM Network
    automateNumber0
    api_typeStringHostAgent
    is_createNumber0
    lan_freeNumber23
    create_timeNumber1537341291
    rule_typeNumber1
    group_recoveryNumber0
    random_strStringF6FCFC4D-EE04-946B-56F2-A52E91AFD5A8
    mem_snapNumber0
    del_vmNumber
    vm_listArray
      vm_nameStringchenky_vp_test
      vm_refString119
      ver_sigString199EDA68-3512-480A-8355-A0E9C2DA1587
      disk_listArray
        disk_nameStringchenky_vp_test.vmdk
        disk_pathString/
        is_sameNumber0
        new_dsStringdatastore107(1)
      ver_timeString备份点时间
    data_ip_uuidStringF1FCFC4D-EE04-946B-56F2-A52E91AFD5A8
    locationStringFusionCompute平台必选
恢复虚拟机所在的计算资源位置
    agent_uuidString
    agent_data_ip_uuidString
    target_region_idString
    target_project_idString
    target_node_region_idString
    target_node_project_idString

虚机恢复 - 获取列表

获取规则列表

SDK方法名:listVpRecovery

URL

/vp/recovery

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
typeNumber恢复类型:0:普通;1:瞬时;0
limitNumber可选10
pageNumber可选1
where_args[rule_type]Number0:普通恢复;
1:瞬时恢复;
0

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  info_listArray
    backup_rule_nameString9_21
    vp_nameString88.107
    bk_node_nameStringN3_72.75
    usernameStringadmin
    create_timeNumber1537341291
    rule_nameString2221
    rule_typeNumber1
    ver_sigString199EDA68-3512-480A-8355-A0E9C2DA1587
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vm_nameStringchenky_vp_test
    vp_typeNumber
    new_vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    new_vp_nameString88.107
    new_vp_typeNumber
    group_uuidStringF6FCFC4D-EE04-946B-56F2-A52E91AFD5A8
    rule_uuidString8264AEDC-815B-0FA1-1FEE-F8B4FD15E1F1
    bk_ipString192.168.72.75
    bk_uuidString8264AEDC-815B-0FA1-1FEE-F8B4FD15E1F1
    can_delNumber11
  totalNumber1

虚机恢复 - 状态

获取规则状态

SDK方法名:listVpRecoveryStatus

URL

/vp/recovery/status

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  statusArray
    rule_uuidString8264AEDC-815B-0FA1-1FEE-F8B4FD15E1F1
    statusStringstop,executing,idle,dead,finish,switch,unknown,FINISH
    progressString-6089.0

虚机恢复 - 操作

启动和停止恢复规则

SDK方法名:

启动:startVpRecovery;

停止:stopVpRecovery;

清除已完成:clearFinishVpRecovery;

URL

/vp/recovery/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString启动 : start; 停止 : stop; 清除已完成 : clear_finishstart
rule_uuidsArray规则uuid数组, (仅在清除已完成操作时不传)641A27BB-B4D1-F482-1FB8-E856898626DA
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
rule_typeNumberclear_finish的恢复类型:0:普通;1:瞬时;(仅在清除已完成操作时传)0

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber@mock=00
  messageString错误信息提示
retNumber@mock=200, http code200
msgString错误信息

虚机恢复 - 删除

删除恢复规则

SDK方法名:deleteVpRecovery

URL

/vp/recovery

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray规则uuid数组["11111111-1111-1111-1111-111111111111"]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
delete_tgtvmNumber删除规则时,判断是否删除目标虚拟机。 1:删除 0:不删除。

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber@mock=00
  messageString错误信息提示
retNumber@mock=200, http code200
msgString错误信息

---- 虚机迁移/复制 ----

URL

/dash/vp_move_rep

Method

GET

Request

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

Response

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

虚机迁移/复制 - 新建

time_window字段说明:

格式:星期:时间1,时间2;星期:时间1,时间2,时间3

[0]星期:0-6,周日-周六

[1]时间:0(0:00-0:59),1(1:00-1:59),……,23(23:00-23:59)

SDK方法名:createVpMove/createVpRep

URL

/vp/(move|rep)

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rule_typeNumber规则类型:
0: rep;
1: move;
10: rep temp;
11: move temp
1
rule_nameString规则名称testMove1 cky
src_uuidString源平台uuid7F16E670-1A61-D565-6905-9C68B9520907
agent_uuidString源平台为openstack时传,源平台代理节点uuid
source_region_idString源平台区域ID
source_project_idString源平台项目ID
vm_listArray
  vm_nameString新建虚拟机1
  vm_refStringvm-11877
  shd_nameString复制/迁移 新虚机名称新建虚拟机1_move
  disk_listArray虚机磁盘配置
    idStringhyper-v有,磁盘uuid
    disk_dirString
    disk_nameString
    sizeString
    datastoreString源机存储
    new_dsString选择一个存储datastore2
    is_ignoredNumber
选中为0,不选为1
    boot_indexNumber仅限源平台为vmware时使用1
    disk_provision_typeNumber磁盘置备类型(仅限目标平台为vmware):
0:源机磁盘配置;
1:为精简置备;
2:为厚置备延迟置零;
3:为厚置备置零;
0
    disk_typeString
  dynamic_memNumber
  networksArray
    source_network_nameString源机network_name
    source_network_idString源机network_id
    mac_addressString源机mac地址
    keep_macNumber是否保留mac,默认为保留,传11
    network_idString没有勾选“自定义磁盘”时,将全局设置的网卡信息填进来
    network_nameString没有勾选“自定义磁盘”时,将全局设置的网卡信息填进来
    ip_addressString
  new_vm_nameString演练虚机名称
  scripts_typeString开启验证时: (*必填)脚本验证的方式,0表示验证ping方法验证,1表示tcp端口验证测试,2表示脚本验证方式。2表示脚本验证方式目前暂存以后实现。默认值为0
  scriptsString开启验证时: 验证内容
  cpuString开启验证时: cpu数
  core_per_sockString开启验证时: 单个cpu核数
  mem_mbString开启验证时: 内存大小
  os_typeNumber开启验证时: 操作系统: 0:linux; 1:windows
  flavor_idString虚机迁移,目标平台是云平台时,目标机规格id
  vm_uuidString虚机uuid标识
  sync_downBoolean向下同步标记false
  is_setNumber是否设置了自定义设置:
0:否;
1:是;
0
  orch_disksArray演练虚机磁盘配置,具体参数请参照vm_list.disk_list字段(暂时废弃)
    idString
    disk_dirString
    disk_nameString
    sizeString
    datastoreString
    new_dsString
    ignoredString
    boot_indexString
    disk_provision_typeString
    disk_typeString
  orch_networksArray
    source_network_nameString源机network_name
    source_network_idString源机network_id
    mac_addressString源机mac地址
    keep_macString是否保留mac,默认为保留,传1
    network_idString目标平台演练虚机网卡名称(不允许修改)
    network_nameString目标平台演练虚机网卡id(不允许修改)
    ip_addressString
  orch_cpu_numString演练虚机cpu数
  orch_cores_per_cpu_numString演练虚机核心数
  orch_memory_mbString演练虚机内存
biz_grp_listArray业务分组:组uuid数组
bk_uuidString备机 uuid(目标平台openstack,目标平台代理节点uuid)67E33CDB-D75B-15B3-367D-50C764F5A26F
target_region_idString目标平台区域ID
target_project_idString目标平台项目ID
bk_pathString备份路径(临时目录)H:\vp_rep\
tgt_uuidString目标平台uuid7F16E670-1A61-D565-6905-9C68B9520907
new_dcString数据中心 (openstack不传)i2test
new_dc_morString数据中心标识 (openstack不传)datacenter-2
new_hostString主机名称 (openstack不传)192.168.88.103
new_dsString存储 (openstack不传)103-数据盘
bkup_policyNumber自动同步开关:0:不开启自动同步;1:开启自动同步;0
backup_typeString默认传 ii
bkup_scheduleObject同步策略
  sched_time_startString复制:
自动同步不开启:传 0;
每小时,对应页面上开始时间,格式:2018-09-14 15:38:00;
每天,传 “”空串;
每周/月,传 当前日期(前端生成,如 2018-09-03) + 运行时间(页面输入 08:00:00),格式:2018-09-03 08:00:00;
迁移:空;
0
  limitNumber备份数据保留个数:整数;不开自动同步是0;0
  sched_dayArray某几天,“每周/每月”循环专用参数,取值(整型):每周:0-6 对应 周日-周六;每月:1-31 对应 第1-31号;"@integer(1, 31)"
  sched_everyNumber0:每天;1:每周:2:每月;3:每隔(每小时);0
  sched_timeArray某几点:“每天”循环专用参数,取值:为 HH:mm 的数组;
  sched_gap_minNumber复制:有用到间隔时间填间隔时间>=10,不需要这个值则默认0,迁移: 00
quick_backNumber快速传输 选中为1,不选中为01
quiet_snapNumber静默快照:0:开;1:关;1 |@mock=0
lan_freeNumber选中:31 不选中:2323
src_trans_modeNumber源平台数据传输模式:
1:nbd;
2:nbdssl;
4:hotadd;
8:san;
31:auto;
31
dest_trans_modeNumber目标平台数据传输模式:
1:nbd;
2:nbdssl;
4:hotadd;
8:san;
31:auto;
31
mem_snapNumber是否开启内存快照,0关1开(迁移时才有)
band_widthString-1
automateNumber复制,默认:1;迁移:勾选自动迁移 1,不勾选0;0
auto_shutdownNumber迁移完成关闭源机,0否1是,默认0;
auto_startupString迁移完成开启备机,0否1是,默认0;
overwriteNumber是否覆盖虚机:1:是;0:否;(由原先的单独配置,变为全局配置)
network_idString
network_nameString
ip_addressString
add_drillNumber是否开启认证: 0:否, 1:是, 默认否
autoString开启验证时必传: 自动验证: 自动:1,手动:0;
drill_plat_uuidString开启验证时传: 目标平台的vp_uuid
data_ip_uuidString数据地址7F16E670-1A61-D565-6905-9C68B9520901
transfer_compressionNumber传输压缩:
0:关;
1:开;
0
transfer_encryptNumber传输加密:
0:关;
1:开;
0
consolidate_switchNumber磁盘整合开关:
0:关;
1:开
0
consolidate_disks_timeString磁盘整合时间
concurrent_disk_threadsNumber磁盘传输并发数 默认值 2
值为 1 2 3 4

Response

名称类型必选简介Mock初始值Mock规则
retNumber@mock=200, http code200
msgString错误信息
dataObject
  codeNumber@mock=00
  messageString错误信息提示
  success_listArray
  fail_listArray
    codeString
    messageString
    vm_nameString
    rule_uuidString
    conflict_rule_nameString
    conflict_vm_nameString
    conflict_usernameString

虚机复制 - 批量创建

SDK方法名:batchCreateVpRep

URL

/vp/rep/batch

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
base_info_listObject
  tgt_uuidString目标平台uuid
  new_dcString
  new_dc_morString
  new_hostString
  new_dsString
  rule_typeNumber规则类型0
  biz_grp_listString
  quick_backNumber1
  quiet_snapNumber1
  lan_freeNumber23
  mem_snapNumber1
  band_widthString-1
  auto_shutdownNumber1
  auto_startupNumber0
  overwriteNumber1
  bkup_scheduleObject
    sched_time_startString
    limitNumber
    sched_dayString
    sched_everyNumber
    sched_timeArray
    sched_gap_minNumber0
  bkup_policyNumber
  backup_typeStringi
  automateNumber0
  network_idString全局网卡id
  network_nameString全集网卡name
vm_listArray
  vm_uuidString虚机uuid
  vm_nameString新建虚拟机1
  vm_refStringvm-11877
  shd_nameString新建虚拟机1_move
  disk_listArray
    disk_pathString
    disk_nameString[datastore1 (1)] 测试11_临时测试11/测试11_临时测试11_5-000002.vmdk
    new_dsStringdatastore2
    idString
    is_ignoredNumber1
  dynamic_memNumber1
  networksArray
    network_idString
    network_nameString
    keep_macNumber1
    source_network_nameString
    source_network_idString
    mac_addressString
  bk_uuidString
  bk_pathString
  new_vm_nameString验证参数
  scripts_typeString验证参数
  scriptsString验证参数
  cpuString
  core_per_sockString
  mem_mbString
  os_typeNumber验证参数1
  add_drillNumber验证总开关
  autoNumber是否自动验证
common_paramsObject
  batch_nameString批量新建任务名称
  rep_prefixString名称前缀
  rep_sufixString名称后缀
  variable_typeNumber批量任务: 变量名,0,节点名称;1,节点ip,虚机复制固定传2,表示虚机名称

Response

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

虚机复制 - 修改

URL参数为 group_uuid;

接口入参和新建一样,修改规则为新建完整规则参数;

SDK方法名:modifyVpRepGroup;

URL

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

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
new_dsString103-数据盘
support_cbtNumber1
tgt_uuidString7F16E670-1A61-D565-6905-9C68B9520907
del_bkup_swapNumber0
src_uuidString7F16E670-1A61-D565-6905-9C68B9520907
bk_uuidString67E33CDB-D75B-15B3-367D-50C764F5A26F
automateNumber0
rule_nameStringtestMove1 cky
new_dcStringi2test
bk_pathStringH:\vp_rep\
backup_typeStringi
new_hostString192.168.88.103
quiet_snapNumber1
bkup_scheduleObject
  sched_time_startString0
  limitNumber0
  sched_dayNumber21
  sched_everyNumber0
  sched_timeArray
  sched_gap_minNumber0
quick_backNumber1
del_bkup_dataNumber0
lan_freeNumber23
vm_listArray
  vm_nameString新建虚拟机1
  vm_refStringvm-11877
  shd_nameString新建虚拟机1_move
  overwriteNumber0
  disk_listArray
    disk_pathString
    disk_nameString[datastore1 (1)] 测试11_临时测试11/测试11_临时测试11_5-000002.vmdk
    new_dsStringdatastore2
    idString
time_windowString
new_dc_morStringdatacenter-2
bkup_policyNumber0
band_widthString-1
rule_typeNumber1
auto_shutdownNumber1
data_ip_uuidString灾备机数据地址

Response

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

虚机迁移/复制 - 获取单个

查看规则

SDK方法名:describeVpMove/describeVpRep

URL

/vp/(move|rep)/:uuid([A-F0-9-]+)

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  vp_repObject
    new_dsString
    support_cbtNumber1
    tgt_uuidString@guid()
    del_bkup_swapNumber1
    src_uuidString83EAde4d-52C8-9D4d-2BDF-52165B83fDAe
    bk_uuidString@guid()
    automateNumber1
    rule_nameString@name
    new_dcString
    bk_pathString
    backup_typeString
    new_hostString
    quiet_snapNumber1
    bkup_scheduleObject
      sched_time_startString
      limitNumber1
      sched_dayNumber24
      sched_everyNumber1
      sched_timeArray
      sched_gap_minNumber1
    quick_backNumber1
    del_bkup_dataNumber1
    lan_freeNumber1
    vm_listArray2
      vm_nameString@name
      vm_refString1
      shd_nameString@name
      overwriteNumber1
      cpuString存在对应演练规则时返回: cpu数
      core_per_sockString存在对应演练规则时返回: 单个cpu核数
      mem_mbString存在对应演练规则时返回: 内存大小
      os_typeNumber存在对应演练规则时返回: 操作系统: 0:linux; 1:windows
    time_windowString
    new_dcmorString
    src_nameString
    tgt_nameString
    usernameString
    user_uuidString@guid()
    rule_uuidString@guid()
    group_uuidString@guid()
    create_timeString
    bkup_policyNumber1
    data_ip_uuidString81EAde4d-52C8-9D4d-2BDF-52165B83fDAe

虚机迁移/复制 - 修改模板

time_window字段说明:

格式:星期:时间1,时间2;星期:时间1,时间2,时间3

[0]星期:0-6,周日-周六

[1]时间:0(0:00-0:59),1(1:00-1:59),……,23(23:00-23:59)

SDK方法名:modifyVpMove/modifyVpRep

URL

/vp/(move|rep)/:uuid([A-F0-9-]+)

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
rule_nameString规则名称
src_uuidString源平台uuid@guid()
tgt_uuidString目标平台uuid
bk_uuidString备机 uuid
bk_pathString备份路径(临时目录)
new_dcString数据中心
new_dc_morString数据中心标识
new_hostString主机名称
new_dsString存储
quiet_snapNumber静默快照:0:开;1:关;1 |@mock=0
support_cbtNumber支持cbt:1 不支持 cbt :0
del_bkup_swapNumber复制:勾选删除临时目录 传1 ,不勾选传0,迁移默认为0
automateNumber复制,默认:1;迁移:勾选自动迁移 1,不勾选0;
backup_typeString默认传 i
vm_listArray2
bkup_policyNumber自动同步开关:0:不开启自动同步;1:开启自动同步;
bkup_scheduleObject同步策略
quick_backNumber快速传输 选中为1,不选中为0
del_bkup_dataNumber删除虚拟机 勾选 1 不勾选 0
lan_freeNumber选中:31 不选中:23
time_windowString勾选时间窗口时候需要下发,格式见说明

Response

名称类型必选简介Mock初始值Mock规则
retNumber@mock=200, http code200
msgString错误信息
dataObject
  codeNumber0
  messageString

虚机迁移/复制 - 获取列表

SDK方法名:listVpMove/listVpRep

URL

/vp/(move|rep)

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
typeString规则类型:
0: rep;
1: move;
10: rep temp;
11: move temp
pageNumber1
limitNumber10

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  codeNumber0
  messageString
  info_listArray2
    rule_nameString规则名称@word
    src_nameString源平台名称@word
    group_uuidString@guid
    tgt_nameString目标虚拟平台@word
    bk_node_nameString备机名称@name
    usernameString所有者@name
    rule_uuidString单个规则uuid@guid
    vm_nameString虚机名称@word
    can_delNumber11
    can_drillNumber目标平台是否开启演练,0否;1是
    src_typeNumber源平台类型
    tgt_typeNumber目标平台类型
    automateNumber是否自动迁移,1;迁移:勾选自动迁移 1,不勾选0;
    new_dcString目标平台数据中心
    new_hostString目标平台主机
retNumber200
msgString

虚机迁移/复制 - 状态

SDK方法名:listVpMoveStatus/listVpRepStatus

URL

/vp/(move|rep)/status

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  statusArray2
    rule_uuidString规则uuid@guid()
    progressNumber进度@int(1,100)
    statusStringstop,executing,idle,dead,finish,switch,unknown@pick(["STOP","EXECUTING","IDLE","DEAD","FINISH","SWITCH","UNKNOWN","VP_START","VP_CHECK","VP_CFG","VP_CBT","VP_PREPARE_MV","VP_PREPARE_PT","CREATING"])
  codeNumber0
  messageString
retNumber200

虚机迁移/复制 - 操作

SDK方法名:

停止:stopVpMove/stopVpRep

开始:startVpMove/startVpRep

开始迁移: moveVpMove

切换: failoverVpRep

回切: failbackVpRep

创建目标主机:createTargeVm

URL

/vp/(move|rep)/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString开:start;停:stop;迁移:move; 切换:failover;回切:failback;

虚机复制: 立即启动 - start_immediately

虚机迁移:
(目标平台为openstack,规则没有开启自动迁移时)创建目标主机:create_target_vm;
(迁移就绪状态时)迁移完成:finish

start
rule_uuidsArray1C89A121-6B03-24B2-9273-D4B93C0687AD
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
snap_pointString切换专用参数:选择需要切换到的时间点
op_codeString切换专用参数:0表示临时切换;1表示永久切换
power_onNumber切换专用参数:1为自动开机。默认不传为0
power_offNumber(非必填)1:关闭目标机 0:不关闭 (备份中心分支使用)
bkup_typeString立即执行操作(start_immediately)必传,取值为,备份策略 - 周期任务 - 备份方式;0:全备,1:增量,2:差异,3:合成

Response

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

虚机迁移/复制 - 删除

删除规则

SDK方法名:deleteVpMove/deleteVpRep

URL

/vp/(move|rep)

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray规则uuid["11111111-1111-1111-1111-111111111111"]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
delete_tgtvmNumber删除规则时,判断是否删除目标虚拟机。
1:删除
0:不删除。

Response

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

虚机迁移/复制 - 获取快照

URL中uuid为rule_uuid:

切换操作前,获取快照列表信息;流程:新建个带策略的复制,【已完成】时,点击切换,获取时间点列表,有内容的话,选择一个时间点,选择永久切换还是临时切换,确定;

SDK方法名:

复制:listVpRepPointList;

迁移:listMovePointList;

URL

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

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
typeString规则类型。
默认不用传为虚机复制;
如果需要获取整机备份的备份点列表,传'fsp'
allNumber仅备份中心分支使用
0:只获取演练成功的备份点
1:所有
1

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  listArray快照时间点列表,已经时间点对应的目标机配置信息
    snap_nameString快照时间点2018-10-24 16:55:09
    memory_in_mbString内存
    cpu_numStringcpu
    cores_per_cpuString核心数
    networksArray
      network_idString网络ID
      network_nameString网络名称
      mac_addressString网卡MAC地址
    disksArray
      idString磁盘ID
      disk_nameString磁盘名称
      sizeString磁盘大小
      disk_dirString磁盘所在目录
      datastoreString磁盘所在的存储,只在vmware平台上有,其他平台为空。
      boot_indexString(选填) 磁盘启动顺序,openstack云平台下0:启动盘;1或者其他数字表示非启动盘。vmware,cas,hyperv平台,因为npsvr无法判断磁盘是否为启动盘,所以由页面按磁盘顺序依次递增。
    os_typeString虚拟机操作系统类型
  bk_pathString复制规则的目录
  os_typeString操作系统类型1

------ 虚机演练 ------

URL

/vp/vp_drill

Method

GET

Request

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

Response

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

演练规则 - 列表

获取规则列表;获取列表详细入参说明详见【节点管理-获取节点列表】接口说明;

SDK方法名:listVpDrill

URL

/vp/drill

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber可选1
limitNumber可选10

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  info_listArray
    group_uuidStringf3fE9a51-2466-3EaE-aCe6-e3d18CA33ece
    rule_nameStringDonna Smith
    rule_uuidStringE3EdA75B-Db84-c4EF-75d7-DfbaacdCB5eF
    vp_uuidStringDcDd4A7d-2Ae3-bFd7-d346-14F0A9Fad77C
    vp_nameStringMary Jackson
    vp_typeNumber0
    vp_addrString
    bk_uuidString4b72eF52-e9a6-bfAd-e22B-5F79ffbe4B72
    bk_node_nameStringAnna Anderson
    bk_pathString/temp/
    vm_nameStringPaul Perez
    usernameStringDaniel Smith
    autoString
    vm_refString
    can_delNumber1
  totalNumber1

演练规则 - 新建

SDK方法名:createVpDrill

URL

/vp/drill

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rule_typeNumber对应规则类型:备份:0;复制:1;整机备份:2 ;整机复制:30
rule_nameString规则名称(备份规则任务和复制规则任务的名称)
vp_uuidString演练平台对应 虚拟平台的ID
autoNumber自动演练:自动:1,手动:0;0
vm_listArray
  vm_nameString虚机(工作机)名称
  wk_uuidString工作机uuid (整机备份类型,必传)
  vm_refString虚机ID (整机备份类型,不传)99
  new_vm_nameString新虚机名称
  cpuNumber处理器数量1
  core_per_sockNumber处理器核心数量1
  mem_mbNumber内存大小1024
  scriptsString演练脚本
  scripts_typeNumber(*必填)脚本验证的方式,0表示验证ping方法验证,1表示tcp端口验证测试,2表示脚本验证方式。2表示脚本验证方式目前暂存以后实现。默认值为0
  bk_uuidString源规则 bk_uuid
  bk_typeNumber备份存储类型:
0:文件系统;
1:对象存储;
0
  bk_pathString源规则 bk_path
  sto_uuidString对象存储uuid
  bucket_String对象桶(name)
  bucket_pathString桶路径
  original_rule_uuidString原始规则uuid
  os_typeNumber(新加)虚拟机操作系统: 0:linux; 1:windows
  ver_sigString信息ID
  timeString选择的时间点,RPC不用
  src_uuidString源规则的源平台uuid,获取导入的虚机信息时需要用到
  data_ip_uuidString灾备机数据地址
  disk_listArray
    idStringhyper-v,磁盘uuid
    disk_dirString
    disk_nameString磁盘名称
    datastoreString源机存储
    new_dsString选择的存储
    is_ignoredNumber是否忽略:
0:否;
1:是
    sizeString磁盘大小
    boot_indexNumber引导顺序
  networksArray
    source_network_nameString源机网卡名称
    source_network_idString源机网卡id
    mac_addressStringmac地址
    keep_macString保留mac
    network_idString目标平台演练虚机网卡ID,不可以修改
    network_nameString目标平台演练虚机网卡名称,不可以修改
    ip_addressString
quick_backNumber1
backup_typeStringi
lan_freeNumber23
del_bkup_dataNumber0
automateNumber隐藏开关,默认传0,页面不显示0
auto_shutdownNumber1
bkup_policyNumber0
bkup_scheduleObject
  sched_time_startString0
  limitNumber0
  sched_dayNumber6
  sched_everyNumber0
  sched_timeArray
  sched_gap_minNumber0

Response

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

演练规则 - 获取单个(组)

查看规则,URL参数为 group_uuid

SDK方法名:describeVpDrill

URL

/vp/drill/group/:uuid([A-F0-9-]+)

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vp_drill_ruleObject
    rule_nameString
    rule_typeNumber0
    vp_uuidString
    bk_uuidString
    bk_pathString
    datacenterString
    hostnameString
    datastoreString
    autoNumber0
    scriptsString
    vm_listArray
      vm_nameString
      new_vm_nameString
      vm_refString99
      macString
      cpuNumber1
      ver_sigString
      core_per_sockNumber1
      mem_mbNumber1024
      overwriteNumber0
    quick_backNumber1
    backup_typeStringi
    lan_freeNumber23
    del_bkup_dataNumber0
    del_bkup_swapNumber0
    automateNumber0
    auto_shutdownNumber1
    bkup_policyNumber0
    bkup_scheduleObject
      sched_time_startString0
      limitNumber0
      sched_dayNumber6
      sched_everyNumber0
      sched_timeArray
      sched_gap_minNumber0
    rule_uuidString
    group_uuidString
    vp_nameString88.107
    vp_typeNumber0
    bk_node_nameString88.107
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    usernameStringadmin
    create_timeString1533871285
    random_strStringAB790B28-62D6-7236-612F-65D73C80036F
    biz_grp_listArray
    data_ip_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC

演练规则 - 删除

删除规则

SDK方法名:deleteVpDrill

URL

/vp/drill

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray["11111111-1111-1111-1111-111111111111"]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
delete_tgtvmNumber是否删除演练虚机,0,10

Response

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

演练规则 - 状态

获取规则的状态

SDK方法名:listVpDrillStatus

URL

/vp/drill/status

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  countString1
  messageString
  codeNumber0
  statusArray2
    statusStringSUCCESS FAILEDVP_START
    progressNumber71
    rule_uuidStringAc2F4EFC-14FE-b2Ab-7988-7AD4f44979E3
retNumber200

演练规则 - 获取控制台地址

SDK方法名:getConsoleUrl;

URL

/vp/drill/console_url

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
msgString
retNumber200
dataObject
  messageString
  codeNumber0
  console_urlString演练机控制台地址

演练规则 - 操作

SDK方法名:

停止:stopVpDrill

开始:startVpDrill

设置状态: setStatusVpDrill

URL

/vp/drill/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString"start", "stop", "set_status":启动、停止、设置状态(仅运行状态可以)
rule_uuidsArray规则uuid列表[C6335F62-2565-1957-4BB9-587F2FF46B00]
group_uuidsArray组操作,有这个就先用这个,没有就用规则uuid
statusString仅设置状态传:状态码,0成功,-1失败
msgString仅设置状态传:用户上传的信息

Response

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

----- 虚机文件恢复 -----

URL

/dash/vp_file_recovery

Method

GET

Request

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

Response

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

文件恢复 - 新建

SDK方法名:createVpFileRecovery

URL

/vp/file_recovery

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
rule_nameString规则名称
config_addrString管理地址
config_portString管理端口
attach_dirString挂载点
bk_uuidString灾备机uuid
bk_typeNumber备份存储类型:
0:文件系统;
1:对象存储;
0
bk_pathString灾备路径
sto_uuidString对象存储uuid
bucketString对象桶(name)
bucket_pathString桶路径
vm_nameString虚机名称
version_idString备份点id
version_timeString备份点时间
tgt_uuidString目标机uuid(新建传'')
tgt_pathString目标路径(新建传'')
filesArray文件列表(新建传'')

Response

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

文件恢复 - 修改

SDK方法名:modifyVpFileRecovery

URL

/vp/file_recovery/:uuid([A-F0-9-]+)

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidString
rule_nameString
config_addrString
config_portString
attach_dirString
attach_pathString实际挂载路径
bk_uuidString
bk_pathString
vm_nameString
version_idString
version_timeString
tgt_uuidString
tgt_pathString
filesArray
random_strString

Response

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

文件恢复 - 列表

SDK方法名:listVpFileRecovery

URL

/vp/file_recovery

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  info_listArray
    rule_uuidString规则uuid111
    vm_nameString虚机名称
    bk_uuidString灾备机uuid
    bk_node_nameString灾备机名称
    attach_pathString底层返回的实际挂载路径
    tgt_uuidString目标机uuid
    tgt_node_nameString目标机名称
  totalNumber1

文件恢复 - 获取单个

SDK方法名:describeVpFileRecovery

URL

/vp/file_recovery/:uuid([A-F0-9-]+)

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vp_file_recoveryObject
    rule_uuidString规则uuid
    rule_nameString规则名称
    attach_dirString挂载点
    attach_pathString实际挂载路径
    bk_uuidString灾备机uuid
    bk_pathString数据存放路径
    vm_nameString虚机名称
    version_idString备份点id
    version_timeString
    tgt_uuidString目标机uuid
    tgt_pathString目标路径
    filesArray文件列表
      String
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    create_timeString1533871285
    random_strStringAB790B28-62D6-7236-612F-65D73C80036F

文件恢复 - 操作

SDK方法名:

挂载:attachVpFileRecovery

卸载:detachVpFileRecovery

URL

/vp/file_recovery/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString挂载:attach
卸载:detach
启动:start
停止:stop
rule_uuidsArray

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber-1
  success_listArray成功的列表
    codeString
    messageString
    rule_uuidString
    rule_nameString
  fail_listArray失败的列表
    codeString
    messageString
    rule_uuidString
    rule_nameString
retNumber200
msgString

文件恢复 - 状态

SDK方法名:listVpFileRecoveryStatus

URL

/vp/file_recovery/status

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray
force_refreshNumber点击操作栏刷新按钮必传,下发1,表示从rpc获取;其他情况不传

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  countString1
  messageString
  codeNumber0
  statusArray
    rule_uuidString111
    statusString挂载中:VP_ATTACHING;
卸载中:VP_DETACHING;
未挂载:VP_NOT_ATTACHED;
(空闲就是已挂载)
STOP
retNumber200

文件恢复 - 删除

SDK方法名:deleteVpFileRecovery

URL

/vp/file_recovery

Method

DELETE

Request

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

Response

名称类型必选简介Mock初始值Mock规则
String
dataObject
  messageString
  codeNumber0
  success_listArray
    rule_nameString
    rule_uuidString
    codeString
    messageString
  fail_listArray
    rule_nameString
    rule_uuidString
    messageString
    codeString
retNumber200
msgString
Last update: 11/18/2022, 3:56:21 PM
Contributors: ganl