虚拟平台

November 23, 2021About 34 min

虚拟平台

SDK类名:/vp/VirtualizationSupport;

虚拟平台 - 新建

SDK方法名:createVp

URL

//vp/platform

Method

POST

Request

名称类型必选初始值简介Mock规则
commentString说明
config_addrString192.168.72.75Npsvr ip地址
config_portNumber58083Npsvr 端口
os_pwdString12345678平台密码(RSA加密)
os_usrStringroot平台用户名
vp_addrString192.168.88.107平台ip地址
vp_nameStringtest平台名称
vp_typeNumber0平台类型:
0:Vmware;
1:Hyper-V,2:KVM,
3: DRP,
4: 华为云,
5: OpenStack
7: CAS
9: 华为云Stack
bind_lic_listArray绑定的软件许可列表,实时生成,不入库
biz_grp_listArray分组关系, 当前资源绑定的组uuid列表;
use_credentialNumber0是否使用凭据:
0:不使用
1:使用
cred_uuidString可选,使用凭据时,凭据的uuid
is_drillNumber是否配置演练平台,0,否;1,是
drill_configObject演练配置,is_drill为1时,必传
  proxy_nameString代理网关名称
  proxy_ipString代理网关ip
  proxy_maskString代理网关子网掩码
  proxy_gwString代理网关的网关
  new_hostnameString主机名
  new_dsString数据存储
  new_dcString数据中心
  new_dcmorString目标平台数据中心托管对象值
  network_nameString目标平台网卡名称
  network_idString目标平台网卡ID
is_backup_centerNumber是否作为资源池:
0:否;
1:是;
cc_ip_uuidString控制机地址对应的uuid
maintenanceNumber0
connect_portNumber443平台连接端口:
当平台类型为Vmware时 必填
默认443
data_transmission_portNumber902数据传输端口:
当平台类型为Vmware时 必填
默认902
is_sslNumber1是否开启安全连接:
0否,1是
当平台类型为Vmware时 必填
默认 1

Response

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

虚拟平台 - 获取单个

SDK方法名:describeVp

URL

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

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vp_platformObject
    usernameStringadmin
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameString88.107
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    vp_addrString192.168.88.107
    os_usrStringroot
    os_pwdString12345678
    config_addrString192.168.72.75
    config_portString58083
    commentString
    create_timeString1533871285
    random_strStringAB790B28-62D6-7236-612F-65D73C80036F
    vp_typeNumber0
    biz_grp_listArray["C58E71F8-4482-4A71-6E5A-46EAF7C45177","D1008DA9-BFD6-FC6A-E795-B66B74F24CC5","030B0DED-10C8-08C7-1218-5BA30A042527"]分组关系, 当前资源绑定的组uuid列表;
    bind_lic_listArray["C58E71F8-4482-4A71-6E5A-46EAF7C45177","D1008DA9-BFD6-FC6A-E795-B66B74F24CC5","030B0DED-10C8-08C7-1218-5BA30A042527"]
    cred_uuidString上一次添加/编辑,使用凭据的uuid
    is_drillNumber是否配置演练平台,0,否;1,是
    drill_configObject演练配置
      proxy_nameString代理网关名称
      proxy_ipString代理网关ip
      proxy_maskString代理网关子网掩码
      proxy_gwString代理网关的网关
      new_hostnameString主机名
      new_dsString数据存储
      new_dcString数据中心
      new_dcmorString目标平台数据中心托管对象值
      network_nameString目标平台网卡名称
      network_idString目标平台网卡ID
    is_backup_centerNumber@Integer(0,1)是否作为资源池:
0:否;
1:是;

虚拟平台 - 修改

SDK方法名:modifyVp

URL

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

Method

PUT

Request

名称类型必选初始值简介Mock规则
commentString说明
config_addrString192.168.72.75Npsvr ip地址
config_portNumber58083Npsvr 端口
os_pwdString12345678平台密码(RSA加密)
os_usrStringroot平台用户名
vp_addrString192.168.88.107平台ip地址
vp_nameStringtest1平台名称
vp_typeNumber0平台类型:0:Vmware;1:Hyper-V,2:FusionShpere
bind_lic_listArray绑定的软件许可列表,实时生成,不入库
biz_grp_listArray分组关系, 当前资源绑定的组uuid列表;
random_strString11111111-1111-1111-1111-111111111111
use_credentialNumber0是否使用凭据:
0:不使用
1:使用
cred_uuidString可选,使用凭据时,凭据的uuid
is_drillNumber是否配置演练平台,0,否;1,是
drill_configObject演练配置
  proxy_nameString代理网关名称
  proxy_ipString代理网关ip
  proxy_maskString代理网关子网掩码
  proxy_gwString代理网关的网关
  new_hostnameString主机名
  new_dsString数据存储
  new_dcString数据中心
  new_dcmorString目标平台数据中心托管对象值
  network_nameString目标平台网卡名称
  network_idString目标平台网卡ID
maintenanceNumber0
is_backup_centerNumber0是否作为资源池:
0:否;
1:是;

Response

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

虚拟平台 - 列表

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

SDK方法名:listVp

URL

//vp/platform

Method

GET

Request

名称类型必选初始值简介Mock规则
pageNumber1可选
limitNumber10可选
search_fieldString要搜索的字段:
vp_addr: 平台地址;
config_addr: 管理地址;
search_valueString要搜索的字段值
where_args[vp_type]String平台类型:
0:VMWARE;
1:HYPER-V;
2:KVM;(暂时不支持)
3:容灾平台;
7:CAS;

Response

名称类型必选初始值简介Mock规则
retNumber200@mock=200, http code
msgString提示信息
dataObjectapi content
  codeNumber0@mock=0
  totalNumber总量数量
  info_listArray
    os_usrString@name平台用户名
    vp_typeNumber3平台类型:0:Vmware;1:h3c;2:openstack0-3
    vp_uuidStringC0744ABF-5571-8288-1930-439612B6234A平台uuid
    usernameString@name所有者
    config_addrString@ip管理地址
    config_portNumber58083端口
    os_pwdString!@#QWEASD平台密码
    commentString@word备注
    vp_nameString@word平台名称
    vp_addrString@ip平台地址
    random_strString@guid随机字符串,修改锁,修改则原样传回即可
    create_timeNumber1515568566创建时间
    user_uuidString@guid
    is_drillNumber是否配置演练平台,0,否;1,是
    can_upNumber1
    can_opNumber1
    can_delNumber1
  messageString错误信息提示

虚拟平台 - 状态

获取平台规则状态

SDK方法名:listVpStatus

URL

//vp/platform/status

Method

GET

Request

名称类型必选初始值简介Mock规则
vp_uuidsArray["11111111-1111-1111-1111-111111111111"]vp_uuid 数组

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  statusArray
    statusString@pick(["ONLINE", "OFFLINE", "NUKNOW", "ERR_TKN"])ONLINE:在线;OFFLINE:离线;UNKOWN:未知;ERR_TKN:RPC 调用失败;
    vp_uuidString@guid
    data_agent_versionString数据代理版本
    drill_statusNumber演练状态,“0”为部署完成,“1”为未部署,“2”为部署中2
    npsvr_versionStringnpsvr版本

虚拟平台 - 操作

SDK方法名:updateDataAgentVp;

URL

//vp/platform/operate

Method

POST

Request

名称类型必选初始值简介Mock规则
operateStringupdate_data_agentupdate_data_agent:更新数据代理版本;maintain:维护模式
vp_uuidsArray["11111111-1111-1111-1111-111111111111"]
switchNumber0切换维护模式,0关,1开

Response

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

虚拟平台 - 删除

删除虚拟平台,支持批量删除

SDK方法名:deleteVp

URL

//vp/platform

Method

DELETE

Request

名称类型必选初始值简介Mock规则
vp_uuidsArray["11111111-1111-1111-1111-111111111111"]要删的平台uuid数组

Response

名称类型必选初始值简介Mock规则
msgString, 提示
dataObject, api content
  codeNumber0@mock=0
  messageString, 错误信息提示
  success_listArray
    codeNumber
    messageString
    vp_uuidString
    vp_nameString
  fail_listArray
    codeNumber
    messageString
    vp_uuidString
    vp_nameString
retNumber200@mock=200, http code

虚拟平台 - 查 虚机列表

获取虚机列表,URL 参数为 vp_uuid

SDK方法名:listVM

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
view_typeString主机视图:hostView;
虚机视图:vmView;
typeString需要展开的目录类型(顶级不用传);
具体值同相应字段type
idString需要展开的目录id(顶级不用传)
search_nameString搜索内容(名称/ip)
force_rpcString是否强制刷新,1是,0否

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vm_listArray这个是以前返回的12
    nameStringFedora 64bit_crosscompile虚机名称或目录名称
    typeStringVirtualMachine数据中心:Datacenter;
目录:Folder;
集群:ClusterComputeResource
主机:HostSystem;
虚拟机:VirtualMachine;
    timeString保留字段
    sizeString保留字段
    morvalString20对象id
    host_ipString192.168.88.107主机IP
    power_stateNumber虚机状态 -1:查询失败 1:开机状态 4:挂起状态 5:关机状态
    support_cbtStringCBT是否支持 0:不支持 1:支持 -1:查询失败
    exist_rule_typeNumber@int(0,3)规则类型 1:备份;2:迁移;3:复制;4:恢复;
    is_dirString00:虚机名 1:目录
    cpuStringcpu数
    core_per_sockString单个cpu核数
    mem_mbString内存大小
    os_typeNumber操作系统:
0:linux;
1:windows
    ipString导入的虚机ip
    uuidString虚机uuid标识
    ruleObject虚机已添加的备份规则
      rule_nameString规则名称
      rule_typeString规则类型:
虚机复制:rep
虚机迁移:move
虚机备份:backup
      statusStringUNKNOW规则状态
  listArray这个是最新返回的
    idString虚机id或目录id
    morvalString同id
    parent_idString父级的id
    nameString数据中心名称
    typeNumber1本层节点类型
(Datacenter表示数据中心,Folder表示目录,ClusterComputeResource表示集群,HostSystem表示主机,VirtualMachine表示虚拟机)
    childrenArray下层节点信息(VirtualMachine为最末节点)
    timeString
    sizeString
    host_ipString
    power_stateString
    support_cbtString
    exist_rule_typeString
    is_dirNumber0是否目录:
1:是;
0:否;
    cpuString
    core_per_sockString
    mem_mbString
    os_typeString
    uuidString
    ipString控制机导入的ip
    support_agentStringcas是否支持代理模式:
0:不支持
1:支持
    summaryObject
      nameString虚机名称或目录名称
      mor_typeStringDatacenter表示数据中心,Folder表示目录,ClusterComputeResource表示集群,HostSystem表示主机,VirtualMachine表示虚拟机
      timeString保留字段
      sizeString保留字段
      mor_valueString虚机id
      host_ipString主机IP
      power_stateString虚机状态
-1:查询失败
1:开机状态
4:挂起状态
5:关机状态
      support_cbtStringCBT是否支持
0:不支持
1:支持
-1:查询失败
      exist_rule_typeString规则类型
1:备份
2:迁移
3:复制
      is_dirString0:虚机名
1:目录
      cpu_numString虚拟机cpu个数
      cores_per_cpuString单个cpu核数
      memory_in_mbString虚拟机内存大小
      guest_os_typeString客户机操作系统
      uuidString虚机uuid
      support_agentString0cas是否支持代理模式:
0:不支持
1:支持
    ruleObject虚机已存在的规则
      rule_nameString规则名称
      rule_typeString规则类型:
虚机复制:rep
虚机迁移:move
虚机备份:backup
      statusStringUNKNOW规则状态

获取不带层级结构的虚机列表

SDK方法名:listVmNoHierarchy

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
search_nameString搜索内容(名称/ip)
force_rpcString是否强制刷新,1是,0否

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vm_listArray
    morvalString976
    sizeString
    nameStringFedora 64bit_crosscompile
    timeString
    exist_rule_typeString@int(0,3)
    host_ipString172.20.67.91
    is_dirString0
    cpuString1
    core_per_sockString1
    mem_mbString2048
    os_typeNumber1
    power_stateNumber1
    typeStringVirtualMachine
    support_cbtString
    uuidString
    networksArray
      network_idStringHaNetwork-I2 Isolated VM Network
      network_nameStringI2 Isolated VM Network
      mac_addressString00:50:56:98:b2:e4
    ipString172.20.16.77,fe80::4fe2:de0d:fa55:f3fc

虚拟平台 - 查 单个虚机的详细信息

SDK方法名:getVmInfo;

URL

//vp/platform/vm_info

Method

GET

Request

名称类型必选初始值简介Mock规则
vp_uuidString虚拟平台uuid
vm_idString虚机id

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  infoObject
    mem_mbString1024内存
    cpuString8cpu
    core_per_sockString8核心数
    flavor_idString
    networksArray网卡列表
      network_idString
      network_nameString
      mac_addressString
    disksArray磁盘列表
      sizeString
      idString
      disk_nameString
      disk_dirString
      datastoreString
      boot_indexString

虚拟平台 - 查 平台属性

URL中参数:vp_uuid

SDK方法名:describeVpAttribute

URL

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

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200@mock=200, http code
msgString错误信息
dataObject
  messageString错误信息提示
  codeNumber0@mock=0
  api_versionString5.5API版本,如6.0
  ipString@ip虚拟平台IP
  api_typeStringHostAgentAPI类型,如HostAgent

虚拟平台 - 查 备机上备份列表(RC)1

SDK方法名:listBakVer;URL中参数:vp_uuid;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
bk_pathStringH:\vp_bk5\test2_BAK_vm-11880_192.168.88.22\路径
bk_uuidString67E33CDB-D75B-15B3-367D-50C764F5A26F备机节点uuid
rule_uuidString优先使用rule_uuid,如果为空,则bk_字段必传

Response

名称类型必选初始值简介Mock规则
retNumber200
dataObject
  listArray2
    sizeNumber18446744073709551493
    timeString2018-09-04_14-26-22备份时间点
    backup_rule_uuidString@guid()备份点uuid
    is_rootString
    data_typeString备份数据类型:o:全备,i:增量,d:差异,f:整盘,n:获取类型失败
    orch_resultNumber备份点是否演练,0 表示演练过,并且成功;1表示演练过并且失败。 空值表示未验证
  codeNumber0
  messageString
  vp_typeNumber
  instant_recoveryNumber
  bk_pathString备份路径
msgString

虚拟平台 - 查 备份点信息(RC)2

获取备份点信息;URL中参数:vp_uuid;

返回字段详细说明参考:https://apiref.info2soft.com/organization/repository/editor?id=22&mod=102&itf=671;

SDK方法名:listBakVerInfo

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
bk_uuidString67E33CDB-D75B-15B3-367D-50C764F5A26F(*必填)备机ID
bk_pathStringH:\vp_bk5\testRC1_BAK_99_192.168.85.139(*必填)备机规则备份路径
group_uuidString可选,获取组时必传,用来获取组,备份规则group_uuid,获取此组下所有vm的list
timeString2019-01-07_13-10-45可选,获取单个时必传,用来获取单个,用户选择的时间点,格式 2018-10-25_16-08-12
ver_sigStringA59DB76E-E33D-4E22-BB08-59723B1FC539可选,获取单个时必传,用来获取单个,配置信息ID;备份列表返回的 backup_rule_uuid

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber11113561
  messageString[11113561] 无法读取该文件,请检查路径是否正确;
  success_listArray
    ver_sigString
    timeString
    bk_pathString
    vm_nameString
    vm_idString
    alt_nameString
    annotationString
    vm_versionString
    guest_os_idString
    num_cpusNumber1
    core_per_sockNumber1
    memory_mbNumber1
    host_nameString
    datacenterString
    datastoreString
    cpu_virtualizationBoolean0
    cpu_hot_addBoolean0
    memory_hot_addNumber0
    firmwareString
    disk_listArray
      idString
      disk_pathString
      disk_nameString
      totalString
      formatStringqcow2
磁盘格式
      boot_indexString0启动顺序
    controllersArray
      dev_typeNumber1
      keyNumber1
      cKeyNumber1
      unit_numNumber1
      typeNumber1
      shareStringnoSharing
      hot_add_removeBoolean0
      bus_numNumber1
    disksArray
      dev_typeNumber2
      file_nameString[datastore1] mini0-12-30_move/mini01-000001.vmdk
      modeStringpersistent
      typeNumber1
      size_mbNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
      change_idString
      thinBoolean0
      eager_thickBoolean0
      formatStringqcow2磁盘格式
      boot_indexString0启动顺序
    cdromsArray
      dev_typeNumber4
      dev_nameStringCdrom
      typeNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
    floppysArray
      dev_typeNumber5
      typeNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
      dev_nameString
    nicsArray
      dev_typeNumber3
      mac_addressString
      network_typeNumber1
      network_keyNumber1
      network_ctrl_keyNumber1
      unit_numNumber1
      adapter_typeNumber1
      network_nameString
      network_idString
    os_typeNumber源机操作系统类型,0,linux;1,windows
    trans_typeStringcas备份点传输类型'ftp', 'scp'
    encrypt_typeNumber备端数据加密方式
0:不加密,
1:aes,
2:sm4
    backup_methodNumber0cas备份方式:
0:基于平台接口;
1:基于平台主机代理
  fail_listArray
    codeNumber11113561
    messageString[11113561] 无法读取该文件,请检查路径是否正确;
    vmNameString
    vmIdString
  infoObject
    ver_sigString
    timeString
    bk_pathString
    vm_nameString
    vm_idString
    alt_nameString
    annotationString
    vm_versionString
    guest_os_idString
    num_cpusNumber1
    core_per_sockNumber1
    memory_mbNumber1
    host_nameString
    data_centerString
    data_storeString
    cpu_virtualizationBoolean0
    cpu_hot_addBoolean0
    memory_hot_addNumber0
    firmwareString
    disk_listArray
      idString
      disk_pathString
      disk_nameString
      totalString
      formatStringqcow2磁盘格式
      boot_indexString0启动顺序
    controllersArray
      dev_typeNumber1
      keyNumber1
      cKeyNumber1
      unit_numNumber1
      typeNumber1
      shareStringnoSharing
      hot_add_removeBoolean0
      bus_numNumber1
    disksArray
      dev_typeNumber2
      file_nameString[datastore1] mini0-12-30_move/mini01-000001.vmdk
      modeStringpersistent
      typeNumber1
      size_mbNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
      change_idString
      thinBoolean0
      eager_thickBoolean0
      formatStringqcow2磁盘格式
      boot_indexString0启动顺序
    cdromsArray
      dev_typeNumber4
      dev_nameStringCdrom
      typeNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
    floppysArray
      dev_typeNumber5
      typeNumber1
      keyNumber1
      c_keyNumber1
      unit_numNumber1
      dev_nameString
    nicsArray
      dev_typeNumber3
      mac_addressString
      network_typeNumber1
      network_keyNumber1
      network_ctrl_keyNumber1
      unit_numNumber1
      adapter_typeNumber1
      network_nameString
      network_idString
    os_typeNumber
    trans_typeString'ftp', 'scp'
    encrypt_typeNumber备端数据加密方式
0:不加密,
1:aes,
2:sm4
    backup_methodNumber0cas备份方式:
0:基于平台接口;
1:基于平台主机代理

虚拟平台 - 查 数据存储下文件列表(RC)3

对应页面:工作目录;URL中参数:vp_uuid

SDK方法名:listDatastoreFile

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
dir_fileString/文件路径("/":查询根目录所有文件),传空返回/
ds_nameStringdatastore107(1)(*必填)数据存储名称
dc_nameStringha-datacenter(*必填)数据中心名称

Response

名称类型必选初始值简介Mock规则
dataObject
  messageString错误信息提示
  codeNumber0
  listArray2
    pathString/temp文件路径
    nameStringDatacenter_@int(10,50)文件名称
msgString错误信息
retNumber200@mock=200, http code

虚拟平台 - 查 数据中心列表(MOVE/REP)1

获取数据中心列表,dcmor 数据中心标识再此npsvr 中返回

SDK方法名:listDatacenter;URL中参数:vp_uuid;

URL

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

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  listArray
    dc_morString@guid()数据中心标识
    dc_nameString@name数据中心

虚拟平台 - 查 数据中心主机列表 (MOVE/REP)2

通过数据中心获取主机列表

SDK方法名:listDatacenterHost;URL中参数:vp_uuid;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
dc_nameStringha-datacenter可选,VMware传, 数据中心
dc_morStringha-datacenter可选,VMware传, 数据中心标识

Response

名称类型必选初始值简介Mock规则
dataObject
  listArray['@name']主机列表,如"list":["localhost.localdomain"]
  messageString, 错误信息提示
  codeNumber0@mock=0
msgString, 错误信息
retNumber200@mock=200, http code

虚拟平台 - 查 存储列表 (MOVE/REP/RC)3

根据主机名称获取存储信息

SDK方法名:listDatastore;URL中参数:vp_uuid;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
host_nameStringdev-esxi.6.6.6必传,主机名
pathString/可选,Hyper-V 传,首次传 /

Response

名称类型必选初始值简介Mock规则
msgString
dataObject
  codeNumber0
  messageString
  listArrayVMware数据存储列表
    nameString存储名称
    totalString总大小
    freeString可用空间
    typeString存储类型
  dir_listArrayHyper-V, 数据存储列表
    nameString@word分区名称
    volume_total_sizeString@integer(100)分区容量
    volume_free_sizeString@integer(100)分区剩余容量
retNumber200

虚拟平台 - 查 存储信息 (MOVE/REP/RC)4

通过存储名称获取存储信息

SDK方法名:listDatastoreInfo;URL中参数:vp_uuid;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
ds_nameStringdatastore107(1), 存储名称

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  messageString
  totalString924,00总共大小
  store_typeStringVMFS存储类型
  codeNumber0
  freeString21.00剩余空间大小

虚拟平台 - 创建存储目录

SDK方法名:createDatastore;

URL

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

Method

POST

Request

名称类型必选初始值简介Mock规则
host_nameStringdev-esxi.6.6.6主机名称
pathStringC:\abc\需要创建的目录路径。如果是HyperV平台,则为一般的windows目录路径,如C:\abc\。如果是vmware平台,则需要带上数据存储,如 [datastore1] vmname/newfolder。

Response

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

虚拟平台 - 查 虚机磁盘

通过虚机ID获取虚机上的磁盘列表,URL中参数:vp_uuid;

SDK方法名:listVmDisk;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
vm_refStringvm-1376虚机ID

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  listArray
    idStringuuid
    disk_dirString/测试11_临时测试11/磁盘所在目录。
    disk_nameString测试11_临时测试11_5-000002.vmdk切下来的磁盘名称
    sizeString2GB格式化后的大小
    datastoreString磁盘所在的存储,只在vmware平台上有,其他平台为空。
    boot_indexNumber0磁盘启动顺序,openstack、hcs下0:启动盘;1或者其他数字表示非启动盘。vmware,cas,hyperv平台,因为npsvr无法判断磁盘是否为启动盘,所以由页面按磁盘顺序依次递增。

虚拟平台 - 查 平台网卡

URL中参数:vp_uuid;

SDK方法名:listNetwork;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
host_nameString(选填) host名称

Response

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

虚拟平台 - 演练配置

SDK方法名:drilConfigInfo;

URL

//vp/platform/drill_config

Method

GET

Request

名称类型必选初始值简介Mock规则
config_addrString管理地址
config_portNumber管理地址通讯端口
vp_addrString虚拟平台IP
vp_typeString平台类型 0:VMware 1:Hyper-V 2:FusionSphere ...
响应内容
use_credentialString
cred_uuidString
os_usrString
os_pwdString(RSA加密)
vp_uuidString虚拟平台uuid,新建时传null

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  datacentersArray
    dcmorString
    dcnameString
    hostsArray
      nameString
      hostIdString
      datastoresArray
        nameString
        typeString
        totalString
        freeString
      networksArray
        network_nameString
        network_idString

虚拟平台 -导入虚机 IP映射,模板下载

SDK方法名:dl

URL

//dl

Method

GET

Request

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

Response

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

虚拟平台 - 导入虚机 IP映射

SDK方法名:importVmIpMapping;

URL

//vp/platform/batch_vm_ip_mapping

Method

POST

Request

名称类型必选初始值简介Mock规则
vp_uuidString虚拟平台uuid

Response

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

虚拟平台 - 获取虚机网卡信息列表

SDK方法名:listNetworkInfo;

URL

//vp/platform/network_info_list

Method

GET

Request

名称类型必选初始值简介Mock规则
vp_uuidString虚拟平台uuid
vm_idString所要查询的虚机的id

Response

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

获取 虚机复制/整机备份 目标机状态信息

SDK方法名:tgtVmStatusInfo;

URL

//vp/platform/tgt_vm_status

Method

GET

Request

名称类型必选初始值简介Mock规则
rule_uuidsString规则uuid数组

Response

名称类型必选初始值简介Mock规则
msgString
dataObject
  messageString
  codeNumber0
  statusArray
    rule_uuidString规则uuid
    statusString目标机状态ONLINE, OFFLINE
    codeString
    stateString
    nameString虚机名称
    morvalString托管对象ID
    power_stateString虚机状态 -1:查询失败 1:开机状态 4:挂起状态 5:关机状态
    cpu_numString
    cores_per_cpuString
    memoryString
    hostipString
    rule_statusString规则状态
retNumber200

添加演练配置(废弃)

URL

//vp/platform/drill

Method

POST

Request

名称类型必选初始值简介Mock规则
vp_uuidString虚拟平台ID
configObject
  proxy_nameString代理网关名称
  proxy_ipString代理网关ip
  proxy_maskString代理网关子网掩码
  proxy_gwString代理网关的网关
  new_hostnameString主机名
  new_dsString数据存储
  new_dcString数据中心
  new_dc_morString数据中心托管对象值
  network_idString代理网关id
  network_nameString代理网关名称

Response

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

获取演练配置(废弃)

URL

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

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vp_drill_platformObject
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameString88.107
    vp_typeNumber0
    vp_addrString192.168.88.107
    config_addrString192.168.72.75
    config_portString58083
    os_usrStringroot
    os_pwdString12345678
    commentString
    create_timeString1533871285
    random_strStringAB790B28-62D6-7236-612F-65D73C80036F
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    usernameStringadmin
    lab_uuidString
    configObject
      network_idString
      network_nameString
      new_dcString
      new_dc_morString
      new_dsString
      new_hostnameString
      proxy_nameString
      proxy_ipString
      proxy_maskString
      proxy_gwString

演练平台 - 获取列表(废弃)

URL

//vp/drill_plat

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  totalNumber3
  info_listArray
    vp_uuidString1663DD96-C9BE-B49E-6044-3AB3120F4B74
    vp_nameString88.107
    vp_typeNumber0
    vp_addrString192.168.88.107
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    usernameStringadmin
    lab_nameString
    lab_uuidString
    configObject
      proxy_nameString
      proxy_ipString
      proxy_maskString
      proxy_gwString
      npsvr_vipString
      npsvr_vmaskString
      npsvr_vgwString
      product_ipString
      product_maskString
      product_gwString
      isolate_ipString
      isolate_maskString
      isolate_gwString
      new_hostnameString
      new_dsString
      new_dcString

演练平台 - 状态(废弃)

URL

//vp/drill_plat/status

Method

GET

Request

名称类型必选初始值简介Mock规则
lab_uuidsArray["11111111-1111-1111-1111-111111111111"]lab_uuid 数组

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  statusArray
    lab_uuidString4Ce6Bc6d-B84F-AfBC-39cA-F77fe5dcA1Be
    statusStringDEPLOYED:部署完成;STALE:失效;DEPLOYING:部署中;

删除演练配置(废弃)

URL

//vp/platform/drill

Method

DELETE

Request

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

Response

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

------ 虚拟平台存储 ------

URL

//dash/vp_storage

Method

GET

Request

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

Response

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

单个平台存储列表

SDK方法名:listPlatformStorage;

URL

//vp/storage/platform_storage_list

Method

GET

Request

名称类型必选初始值简介Mock规则
vp_uuidStringFC151595-EB90-86F5-B659-CA787753CA5D虚拟平台uuid

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  totalNumber1
  info_listArray
    uuidStringFC151595-EB90-86F5-B659-CA787753CA5D存储uuid
    nameStringstorage_name存储name
    typeStringlocalfs存储类型
    usedString2已使用容量(GB)
    capacityString10授权容量(GB)
    enabledNumber1是否启用,1:是;0否;
  messageString

修改存储授权容量、启用状态

SDK方法名:platformAuthorize;

URL

//vp/storage/platform_authorize

Method

POST

Request

名称类型必选初始值简介Mock规则
vp_uuidStringDC151595-EB90-86F5-B659-CA787751CA5D虚拟平台uuid
vp_storageArray
  uuidStringFC151595-EB90-86F5-B659-CA787753CA5D存储uuid
  enabledNumber0启用状态,1:是;0;否
  capacityString10授权容量(GB)

Response

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

存储列表

SDK方法名:listVpStorage;

URL

//vp/storage

Method

GET

Request

名称类型必选初始值简介Mock规则
where_args['enabled']String1

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  totalNumber1
  info_listArray
    uuidStringC0744ABF-5571-8288-1930-439612B6234A存储uuid
    vp_uuidStringC0744ABF-5571-8288-1930-439612B6234A虚拟平台uuid
    nameStringstorage存储名称
    typeStringlocalFs存储类型
    pathString/path
    totalString102400存储大小
    usedString10240已使用容量byte
    create_timeString
    storage_idStringC0744ABF-5571-8288-1930-439612B6234A
  messageString

通过ip和port,获取备份点列表

SDK方法名:listBakVerByIp

URL

//vp/platform/bk_ver_by_ip

Method

GET

Request

名称类型必选初始值简介Mock规则
config_addrString管理地址
config_portString管理端口
bk_uuidString备机uuid
bk_pathString备份路径

Response

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

通过ip和port,获取备份点信息

SDK方法名:listBakVerInfoByIp

URL

//vp/platform/bk_ver_info_by_ip

Method

GET

Request

名称类型必选初始值简介Mock规则
config_addrString管理地址
config_portString管理端口
timeString备份点时间
ver_sigString备份点id
bk_uuidString
bk_pathString

Response

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

测试连接节点

SDK方法名:testNode

URL

//vp/platform/test_node

Method

POST

Request

名称类型必选初始值简介Mock规则
vp_uuidString6765E77A-C658-9AF1-83D0-1897B8A5850E备份:源平台uuid
恢复:目标平台uuid
node_uuidString5765E77A-C658-9AF1-83D0-1897B8A5850E节点uuid
cred_uuidString4165E77A-C658-9AF1-83D0-1897B8A5850E凭据uuid
trans_typeStringFTPFTP,SCP

Response

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

获取规则目标机信息

SDK方法名:getTargetVmInfo;

URL

//vp/platform/target_vm_info

Method

GET

Request

名称类型必选初始值简介Mock规则
rule_uuidsArray规则uuid
group_uuidString组uuid,组删除时可用
rule_typeString规则类型:
move:迁移;
rep:复制;
recovery:恢复;
drill:演练;

Response

名称类型必选初始值简介Mock规则
dataObject
  messageString
  codeNumber10110035
  listArray
    rule_uuidStringC6335F62-2565-1957-4BB9-587F2FF46B00规则uuid
    rule_nameString''规则名称
    nameString''目标虚机名称
    statusStringUNKNOWNUNKNOWN:未知;
UP:运行中;
HALT:挂起;
DOWN:关机;
EXCEPTION: 异常;
retNumber200
msgString
Last update: 6/25/2022, 9:23:18 PM
Contributors: ganl