虚拟平台

June 24, 2022About 39 min

虚拟平台

SDK类名:/resource/VirtualizationSupport;

虚拟平台 - 新建

SDK方法名:createVp

URL

/vp/platform

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
commentString说明
config_addrStringNpsvr ip地址192.168.72.75
config_portNumberNpsvr 端口58083
os_pwdString平台密码(RSA加密)12345678
os_usrString平台用户名root
vp_addrString平台ip地址192.168.88.107
vp_nameString平台名称test
vp_typeNumber平台类型:
0:Vmware;
1:Hyper-V,2:KVM,
3: DRP,
4: 华为云,
5: OpenStack
7: CAS
9: 华为云Stack;
10:Fusion;
11:Winstack;
0
bind_lic_listArray绑定的软件许可列表,实时生成,不入库
biz_grp_listArray分组关系, 当前资源绑定的组uuid列表;
use_credentialNumber是否使用凭据:
0:不使用
1:使用
0
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
  rpc_portString目标主机节点端口
  orch_vm_network_nameString演练虚机网卡名称
  orch_vm_network_idString演练虚机网卡id
is_backup_centerNumber是否作为资源池:
0:否;
1:是;
cc_ip_uuidString控制机地址对应的uuid
maintenanceNumber0
connect_portNumber平台连接端口:
当平台类型为Vmware时 必填
默认443
443
data_transmission_portNumber数据传输端口:
当平台类型为Vmware时 必填
默认902
902
is_sslNumber是否开启安全连接:
0否,1是
当平台类型为Vmware时 必填
默认 1
1

Response

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

虚拟平台 - 获取单个

SDK方法名:describeVp

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值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分组关系, 当前资源绑定的组uuid列表;["C58E71F8-4482-4A71-6E5A-46EAF7C45177","D1008DA9-BFD6-FC6A-E795-B66B74F24CC5","030B0DED-10C8-08C7-1218-5BA30A042527"]
    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是否作为资源池:
0:否;
1:是;
@Integer(0,1)

虚拟平台 - 修改

SDK方法名:modifyVp

URL

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

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
commentString说明
config_addrStringNpsvr ip地址192.168.72.75
config_portNumberNpsvr 端口58083
os_pwdString平台密码(RSA加密)12345678
os_usrString平台用户名root
vp_addrString平台ip地址192.168.88.107
vp_nameString平台名称test1
vp_typeNumber平台类型:0:Vmware;1:Hyper-V,2:FusionShpere0
bind_lic_listArray绑定的软件许可列表,实时生成,不入库
biz_grp_listArray分组关系, 当前资源绑定的组uuid列表;
random_strString11111111-1111-1111-1111-111111111111
use_credentialNumber是否使用凭据:
0:不使用
1:使用
0
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_centerNumber是否作为资源池:
0:否;
1:是;
0

Response

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

虚拟平台 - 列表

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

SDK方法名:listVp

URL

/vp/platform

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber可选1
limitNumber可选10
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初始值Mock规则
retNumber@mock=200, http code200
msgString提示信息
dataObjectapi content
  codeNumber@mock=00
  totalNumber总量数量
  info_listArray3
    os_usrString平台用户名@name
    vp_typeNumber平台类型:0:Vmware;1:h3c;2:openstack30-3
    vp_uuidString平台uuidC0744ABF-5571-8288-1930-439612B6234A
    usernameString所有者@name
    config_addrString管理地址@ip
    config_portNumber端口58083
    os_pwdString平台密码!@#QWEASD
    commentString备注@word
    vp_nameString平台名称@word
    vp_addrString平台地址@ip
    random_strString随机字符串,修改锁,修改则原样传回即可@guid
    create_timeNumber创建时间1515568566
    user_uuidString@guid
    is_drillNumber是否配置演练平台,0,否;1,是
    can_upNumber1
    can_opNumber1
    can_delNumber1
  messageString错误信息提示

虚拟平台 - 状态

获取平台规则状态

SDK方法名:listVpStatus

URL

/vp/platform/status

Method

GET

Request

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

Response

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

虚拟平台 - 操作

SDK方法名:updateDataAgentVp;

URL

/vp/platform/operate

Method

POST

Request

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

Response

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

虚拟平台 - 删除

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

SDK方法名:deleteVp

URL

/vp/platform

Method

DELETE

Request

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

Response

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

虚拟平台 - 查 虚机列表

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

SDK方法名:listVM

URL

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

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
view_typeString主机视图:hostView;
虚机视图:vmView;
typeString需要展开的目录类型(顶级不用传);
具体值同相应字段type
idString需要展开的目录id(顶级不用传)
search_nameString搜索内容(名称/ip)
force_rpcString是否强制刷新,1是,0否
show_vmString是否返回vm。如果是false,则列表中不返回vm。
region_idString区域ID
project_idString项目ID

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  vm_listArray这个是以前返回的12
    nameString虚机名称或目录名称Fedora 64bit_crosscompile
    typeString数据中心:Datacenter;
目录:Folder;
集群:ClusterComputeResource
主机:HostSystem;
虚拟机:VirtualMachine;

Winstack:
pool:主机池;
cluster:集群;
host:主机;
VirtualMachine:虚拟机;
VirtualMachine
    timeString保留字段
    sizeString保留字段
    morvalString对象id20
    host_ipString主机IP192.168.88.107
    power_stateNumber虚机状态 -1:查询失败 1:开机状态 4:挂起状态 5:关机状态
    support_cbtStringCBT是否支持 0:不支持 1:支持 -1:查询失败
    exist_rule_typeNumber规则类型 1:备份;2:迁移;3:复制;4:恢复;@int(0,3)
    is_dirString0:虚机名 1:目录0
    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
      statusString规则状态UNKNOW
  listArray这个是最新返回的
    idString虚机id或目录id
    morvalString同id
    parent_idString父级的id
    nameString数据中心名称
    typeNumber本层节点类型
(Datacenter表示数据中心,Folder表示目录,ClusterComputeResource表示集群,HostSystem表示主机,VirtualMachine表示虚拟机)
1
    childrenArray下层节点信息(VirtualMachine为最末节点)
    timeString
    sizeString
    host_ipString
    power_stateString
    support_cbtString
    exist_rule_typeString
    is_dirNumber是否目录:
1:是;
0:否;
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_agentStringcas是否支持代理模式:
0:不支持
1:支持
0
    ruleObject虚机已存在的规则
      rule_nameString规则名称
      rule_typeString规则类型:
虚机复制:rep
虚机迁移:move
虚机备份:backup
      statusString规则状态UNKNOW
      user_uuidString规则创建者user_uuid
      usernameString规则创建者username
    region_idString区域ID
    project_idString项目ID

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

SDK方法名:listVmNoHierarchy

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值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初始值Mock规则
vp_uuidString虚拟平台uuid
vm_idString虚机id
region_idString区域ID
project_idString项目ID

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  infoObject
    mem_mbString内存1024
    cpuStringcpu8
    core_per_sockString核心数8
    flavor_idString
    os_versionStringFC,源机os_version
    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初始值Mock规则

Response

名称类型必选简介Mock初始值Mock规则
retNumber@mock=200, http code200
msgString错误信息
dataObject
  messageString错误信息提示
  codeNumber@mock=00
  api_versionStringAPI版本,如6.05.5
  ipString虚拟平台IP@ip
  api_typeStringAPI类型,如HostAgentHostAgent

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

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

URL

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

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidString优先使用rule_uuid。
如果为空,则下方字段必传
bk_uuidString备机节点uuid67E33CDB-D75B-15B3-367D-50C764F5A26F
bk_pathString路径(文件系统传)H:\vp_bk5\test2_BAK_vm-11880_192.168.88.22\
sto_uuidString对象存储uuid(对象存储传)
bucketString对象桶(name)(对象存储传)
bucket_pathString桶路径(对象存储传)

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
dataObject
  listArray2
    sizeNumber18446744073709551493
    timeString备份时间点2018-09-04_14-26-22
    backup_rule_uuidString备份点uuid@guid()
    is_rootString
    data_typeString备份数据类型:o:全备,i:增量,d:差异,f:整盘,n:获取类型失败
    orch_resultNumber备份点是否演练,0 表示演练过,并且成功;1表示演练过并且失败。 空值表示未验证
    can_delBoolean为true时,可以删除;
为false时,按钮置灰,不可删除
    inuse_rulesArray显示当前使用此备份点的规则
      rule_nameString规则名称
  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初始值Mock规则
bk_uuidString(*必填)备机ID67E33CDB-D75B-15B3-367D-50C764F5A26F
bk_pathString(备份存储为文件系统时必填)备机规则备份路径H:\vp_bk5\testRC1_BAK_99_192.168.85.139
sto_uuidString(备份存储为对象存储时必填)对象存储uuid
bucketString(备份存储为对象存储时必填) 对象桶(name)
bucket_pathString(备份存储为对象存储时必填) 桶路径
group_uuidString可选,获取组时必传,用来获取组,备份规则group_uuid,获取此组下所有vm的list
timeString可选,获取单个时必传,用来获取单个,用户选择的时间点,格式 2018-10-25_16-08-122019-01-07_13-10-45
ver_sigString可选,获取单个时必传,用来获取单个,配置信息ID;备份列表返回的 backup_rule_uuidA59DB76E-E33D-4E22-BB08-59723B1FC539

Response

名称类型必选简介Mock初始值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
      formatString
磁盘格式
qcow2
      boot_indexString启动顺序0
    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
      formatString磁盘格式qcow2
      boot_indexString启动顺序0
    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_typeString'ftp', 'scp'cas备份点传输类型
    encrypt_typeNumber备端数据加密方式
0:不加密,
1:aes,
2:sm4
    backup_methodNumbercas备份方式:
0:基于平台接口;
1:基于平台主机代理
0
    instant_recoveryNumber是否支持瞬时恢复
0:不支持
1:支持
0
  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
      formatString磁盘格式qcow2
      boot_indexString启动顺序0
    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
      formatString磁盘格式qcow2
      boot_indexString启动顺序0
    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_methodNumbercas备份方式:
0:基于平台接口;
1:基于平台主机代理
0
    instant_recoveryNumber是否支持瞬时恢复
0:不支持
1:支持
0

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

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

SDK方法名:listDatastoreFile

URL

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

Method

GET

Request

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

Response

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

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

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

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

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值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初始值Mock规则
dc_nameString可选,VMware传, 数据中心ha-datacenter
dc_morString可选,VMware传, 数据中心标识ha-datacenter

Response

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

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

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

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

URL

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

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
host_nameString未传scope时必传,主机名dev-esxi.6.6.6
pathString可选,Hyper-V 传,首次传 //
scopeString[Fusion Compute]
(选填)存储所在的域
可以是站点/集群/主机ID

Response

名称类型必选简介Mock初始值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初始值Mock规则
ds_nameString, 存储名称datastore107(1)

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  messageString
  totalString总共大小924,00
  store_typeString存储类型VMFS
  codeNumber0
  freeString剩余空间大小21.00

虚拟平台 - 创建存储目录

SDK方法名:createDatastore;

URL

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

Method

POST

Request

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

Response

名称类型必选简介Mock初始值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初始值Mock规则
vm_refString虚机IDvm-1376
region_idString区域ID
project_idString项目ID

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  listArray
    idStringuuid
    disk_dirString磁盘所在目录。/测试11_临时测试11/
    disk_nameString切下来的磁盘名称测试11_临时测试11_5-000002.vmdk
    sizeString格式化后的大小2GB
    datastoreString磁盘所在的存储,只在vmware平台上有,其他平台为空。
    boot_indexNumber磁盘启动顺序,openstack、hcs下0:启动盘;1或者其他数字表示非启动盘。vmware,cas,hyperv平台,因为npsvr无法判断磁盘是否为启动盘,所以由页面按磁盘顺序依次递增。0
    datastore_typeString存储类型。
* local : 本地硬盘
* san: san存储
* advanceSan: advanceSan存储
* DSWARE: Fusion Storage Block
* NAS: NAS存储
* LOCALPOME: 虚拟化本地硬盘
* LUNPOME: 虚拟化san存储
* LUN: 裸设备共享存储
* iotailor: 本地内存盘

虚拟平台 - 查 平台网卡

URL中参数:vp_uuid;

SDK方法名:listNetwork;

URL

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

Method

GET

Request

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

Response

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

虚拟平台 - 演练配置

SDK方法名:drilConfigInfo;

URL

/vp/platform/drill_config

Method

GET

Request

名称类型必选简介Mock初始值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初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  datacentersArray
    dcmorString
    dcnameString
    hostsArray
      nameString
      hostIdString
      datastoresArray
        nameString
        typeString
        totalString
        freeString
      networksArray
        network_nameString
        network_idString
      orch_networksArray
        orch_network_nameString隔离网卡信息名称
        orch_network_idString隔离网卡id

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

SDK方法名:dl

URL

/dl

Method

GET

Request

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

Response

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

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

SDK方法名:importVmIpMapping;

URL

/vp/platform/batch_vm_ip_mapping

Method

POST

Request

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

Response

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

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

SDK方法名:listNetworkInfo;

URL

/vp/platform/network_info_list

Method

GET

Request

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

Response

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

虚拟平台 - 获取指定操作系统的信息

URL

/vp/platform/os_version

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString(*必填)虚拟平台ID
os_versionsArray被查询机器的os_version

Response

名称类型必选简介Mock初始值Mock规则
retString
messageString
dataObject
  messageString
  codeString
  listArray
    os_versionString操作系统版本标识
    cpu_quantity_limitString该操作系统支持的最大CPU核数
    cpu_socket_limitString该操作系统支持的最大CPU插槽数
    mem_quantity_limitString该操作系统支持的最大内存容量,单位为MB

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

SDK方法名:tgtVmStatusInfo;

URL

/vp/platform/tgt_vm_status

Method

GET

Request

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

Response

名称类型必选简介Mock初始值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初始值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初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功

获取演练配置(废弃)

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值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初始值Mock规则

Response

名称类型必选简介Mock初始值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初始值Mock规则
lab_uuidsArraylab_uuid 数组["11111111-1111-1111-1111-111111111111"]

Response

名称类型必选简介Mock初始值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初始值Mock规则
vp_uuidString

Response

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

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

URL

/dash/vp_storage

Method

GET

Request

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

Response

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

单个平台存储列表

SDK方法名:listPlatformStorage;

URL

/vp/storage/platform_storage_list

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  totalNumber1
  info_listArray
    uuidString存储uuidFC151595-EB90-86F5-B659-CA787753CA5D
    nameString存储namestorage_name
    typeString存储类型localfs
    usedString已使用容量(GB)2
    capacityString授权容量(GB)10
    enabledNumber是否启用,1:是;0否;1
  messageString

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

SDK方法名:platformAuthorize;

URL

/vp/storage/platform_authorize

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString虚拟平台uuidDC151595-EB90-86F5-B659-CA787751CA5D
vp_storageArray
  uuidString存储uuidFC151595-EB90-86F5-B659-CA787753CA5D
  enabledNumber启用状态,1:是;0;否0
  capacityString授权容量(GB)10

Response

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

存储列表

SDK方法名:listVpStorage;

URL

/vp/storage

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  totalNumber1
  info_listArray
    uuidString存储uuidC0744ABF-5571-8288-1930-439612B6234A
    vp_uuidString虚拟平台uuidC0744ABF-5571-8288-1930-439612B6234A
    nameString存储名称storage
    typeString存储类型localFs
    pathString/path
    totalString存储大小102400
    usedString已使用容量byte10240
    create_timeString
    storage_idStringC0744ABF-5571-8288-1930-439612B6234A
  messageString

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

SDK方法名:listBakVerByIp

URL

/vp/platform/bk_ver_by_ip

Method

GET

Request

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

Response

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

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

SDK方法名:listBakVerInfoByIp

URL

/vp/platform/bk_ver_info_by_ip

Method

GET

Request

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

Response

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

测试连接节点

SDK方法名:testNode

URL

/vp/platform/test_node

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString备份:源平台uuid
恢复:目标平台uuid
6765E77A-C658-9AF1-83D0-1897B8A5850E
node_uuidString节点uuid5765E77A-C658-9AF1-83D0-1897B8A5850E
cred_uuidString凭据uuid4165E77A-C658-9AF1-83D0-1897B8A5850E
trans_typeStringFTP,SCPFTP

Response

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

获取规则目标机信息

SDK方法名:getTargetVmInfo;

URL

/vp/platform/target_vm_info

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
dataObject
  messageString
  codeNumber10110035
  listArray
    rule_uuidString规则uuidC6335F62-2565-1957-4BB9-587F2FF46B00
    rule_nameString规则名称''
    nameString目标虚机名称''
    statusStringUNKNOWN:未知;
UP:运行中;
HALT:挂起;
DOWN:关机;
EXCEPTION: 异常;
UNKNOWN
retNumber200
msgString

获取平台卷类型列表

SDK方法名:listDiskType;

URL

/vp/platform/disk_type

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString
region_idString区域ID
project_idString项目ID

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  messageString
  codeNumber10110035
  disk_typeArray卷类型列表

发现虚机

SDK方法名:discoveryVm;

URL

/vp/platform/discovery_vm

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString虚拟平台uuid
match_policyObject匹配规则(同新建虚机备份)
  vm_nameArray
    typeString
    valueString
  locationArray
    typeString
    valueString
  folderArray
    typeString
    valueString
region_idString云平台 - 区域ID
project_idString云平台 - 项目ID

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  listArray
    childrenArray
    nameString
    typeNumber1
    idString
    parent_idString
    summaryObject
      nameString
      mor_typeString
      timeString
      sizeString
      mor_valueString
      host_ipString
      power_stateString
      support_cbtString
      exist_rule_typeString
      is_dirString
      cpu_numString
      cores_per_cpuString
      memory_in_mbString
      guest_os_typeString
      uuidString
      support_agentString0
    ruleObject
      rule_nameString
      rule_typeString
      statusStringUNKNOW
      user_uuidString
      usernameString
    is_dirNumber0
    morvalString
    timeString
    sizeString
    host_ipString
    power_stateString
    support_cbtString
    exist_rule_typeString
    cpuString
    core_per_sockString
    mem_mbString
    os_typeString
    uuidString
    ipString
    support_agentString
    region_idString
    project_idString

Winstack - 获取主机池列表

SDK方法名:listPools;

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
msgString
retNumber200
dataObject
  messageString
  codeNumber0
  listArray
    pool_nameString池名称
    pool_idString池id

Winstack - 获取主机池主机列表

SDK方法名:listPoolHosts;

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  messageString
  codeNumber0
  listArray
    host_nameString主机名
    host_idString主机id
Last update: 11/18/2022, 3:56:21 PM
Contributors: ganl