# 许可

SDK类名:/system/Lic

# 其他 - 获取激活所需信息(组激活,离线激活)

SDK方法名:describeActivateInfo;

获取后调用更新接口进行离线激活,流程:在用户控制机没法联网的情况下,先用这个接口获取激活所需信息,然后用户找个能联网的机器登陆咱许可网站输入这些信息,得到许可网站返回的新许可,粘贴到控制机上,走更新接口更新到控制机,完成离线激活;

# URL

//lic/activate

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
group_sn String 20-4570098558 列表里的 group_sn

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200 @mock=200
data Object
  message String [0] 操作成功 @mock=[0] 操作成功
  secret String F291Lr @mock=F291Lr, 密钥
  url String http://lic-test.info2soft.com/i2soft/i2/activation.php @mock=http://lic-test.info2soft.com/i2soft/i2/activation.php, 激活地址
  code Number 0 @mock=0
  sn String 20-3151269924 @mock=20-3151269924, 序列号
msg String @mock=

# 其他 - 下载lic绑定信息、mac变更记录

类名:/system/Lic

方法名:downloadLicInfo

# URL

//lic/:uuid([A-F0-9-]+)/download_lic_info

# Method

GET

# Request

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

# Response

名称 类型 必选 初始值 简介 Mock规则
msg String @mock=
ret Number 200 @mock=200
data Object
  download_url String E:\ctrlcenter\wwwroot\default\public\download\Collect_mac&license_20180620171548.zip @mock=E:\ctrlcenter\wwwroot\default\public\download\Collect_mac&license_20180620171548.zip
  code Number 0 @mock=0
  message String [0] 操作成功 @mock=[0] 操作成功
  file_name String Collect_mac&license_20180620171548.zip @mock=Collect_mac&license_20180620171548.zip

# 其他 - 获取控制机识别码

略耗时,建议避免经常获取

类名:/system/Lic

方法名:describeLicCcHwCode

# URL

//lic/cc_hw_code

# Method

GET

# Request

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

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200 @mock=200
data Object
  message String [0] 操作成功 @mock=[0] 操作成功
  code Number 0 @mock=0
  hardware_code String C259BEF3D5F76B16D43DFB31C93A2C74 @mock=C259BEF3D5F76B16D43DFB31C93A2C74
msg String @mock=

# 其他 - 获取节点识别码

类名:/system/Lic

方法名:describeLicObjHwCode

# URL

//lic/obj_hw_code

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
obj_uuids Array ["11111111-1111-1111-1111-111111111111"] 节点/vp uuid

# Response

名称 类型 必选 初始值 简介 Mock规则
data Object
  code Number 0 @mock=0
  message String [0] 操作成功 @mock=[0] 操作成功
  info_list Array
    config_port String 26821 @mock=26821
    obj_name String 192.168.25.8 @mock=192.168.25.8
    obj_type Number 0 @mock=0
    obj_subtype Number
    obj_uuid String AE1F69F2-5D60-E5A1-EE7C-037FFE91ECD8 @mock=AE1F69F2-5D60-E5A1-EE7C-037FFE91ECD8
    phy_type String 2 @mock=2
    config_addr String 192.168.25.8 @mock=192.168.25.8
    hardware_code String FFCE3986D94949D32CB649F0D49544A7 @mock=FFCE3986D94949D32CB649F0D49544A7
msg String @mock=
ret Number 200 @mock=200

# 其他 - 在线更新

(激活所有许可并更新,页面下端)

类名:/system/Lic

方法名:activateLicAll

# URL

//lic/activate

# Method

PUT

# Request

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

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200
msg String
data Object
  code Number 0
  message String [0] 操作成功。
  success_list Array
    code Number 0
    message String [0] 操作成功。
    sn String 20-4731954328-03
  fail_list Array
    code String
    message String
    sn String

# Lic - 添加 lic

类名:/system/Lic

方法名:createLic

批量添加参数:

{

"license": {

	"20-111111-3333": {

		"lic": "ce7nmPMrxsPfRn6t4xbnWeW2roARspsBubdiDnEm46R3NGBbtlXas\/x",

		"cat": "09"

	},

	"10-111111-3333": {

		"lic": "fMdsgzYMzelvzqGMzsIMA+5cSBfgSZJarq2gF\/vUODTpxtl2gfmpLzHi3\/IGOSe7rZ",

		"cat": "06"

	}

},

"sn": ["10-111111-3333", "20-111111-3333"],

"key": "fDTpxtl2gfmpLasldkfjklasdjflksjdflkjsajsldfzHi3\/IGOSe",

"num": 2,

"sign": "asldkfjklasdjflksjdflkjsajsldf"

}

# URL

//lic

# Method

POST

# Request

名称 类型 必选 初始值 简介 Mock规则
num Number 1
sn Array ["20-4570098558-01"]
key String 5BrDir
sign String
license Object
  20-4570098558-01 Object
    feature String cdp
    lic String joEsLGQImYbDo2/DSG2RGR7VorckQmnPAAvFgLNCVd78KFDFb0Y0xtShHFyQVF6VXRUcHvyeqJEu1/nuMOyyJiO8RMoU4GHZMrK6iLDRoPZHV87tp0Jd80MfuTHrpBc209IjM+AkSsTM66Wdfy0tvLJMfPqhaYdg7M80X+fhRfeP6kj9ikSVvmJMHJ/ms7lrgz5D+s9jhtzW7tv9cz07bbankTgwyZf6rnjbgOI76tsKzYq8rsBttYSGf+oy1qa2nM7x/pQHE6oRiXVy8+Ju2dzpwvLlMurF75r7lWyMRPSniPHBQGrx4yEEeKVwuWCMRaSJVyId13qyP7gPBqes4jgsiVHvt1okhydrAeoq89KOgnOHPqrpS+qI9dvXFmFRiP9AB0i9ra67tDx5ItYNh/neNgxsNpV3q0Tf9PfoTKiKwcYMg0AiFeKuSpynDIL530Ek8Jm/7LbXU7+mUkeGO7BJo9gxEMJRTHuSRLCLIXWm2LY2S58WccsXkL7GFaamkh6lE1VX3quXavLpHC0ishL4D0ocEdAh507s6GKd59oVErFAyBOifEE9EONR+95wD9MQMc4SdNt4l4Z7ATj67JN86UFZ5xZpGEOnMgCSUuuzX/Nx0HSF6uUf3Zs6HcViudmXcvLwwaFeRScRDwHYVLhiABda/qAp8Ovoc8Aw/3w=

# Response

名称 类型 必选 初始值 简介 Mock规则
msg String
data Object
  code Number 0 如果返回 code 为 10110021,就显示离线绑定控制机识别码的信息
  message String [0] 操作成功 [0] 操作成功
  sn String 20-4185011396 离线绑定控制机识别码的信息
  secret String DarUNa 离线绑定控制机识别码的信息
  url String https://192.168.72.70:58086/lic/i2/activation.php 离线绑定控制机识别码的信息
ret Number 200

# Lic - 更新 lic(批量,离线)

类名:/system/Lic

方法名:updateBatchLic

# URL

//lic/batch

# Method

PUT

# Request

名称 类型 必选 初始值 简介 Mock规则
num Number 1
sn Array ["20-4570098558-01"]
key String 5BrDir
sign String
license Object
  20-4570098558-01 Object
    feature String cdp
    lic String joEsLGQImYbDo2/DSG2RGR7VorckQmnPAAvFgLNCVd78KFDFb0Y0xtShHFyQVF6VXRUcHvyeqJEu1/nuMOyyJiO8RMoU4GHZMrK6iLDRoPZHV87tp0Jd80MfuTHrpBc209IjM+AkSsTM66Wdfy0tvLJMfPqhaYdg7M80X+fhRfeP6kj9ikSVvmJMHJ/ms7lrgz5D+s9jhtzW7tv9cz07bbankTgwyZf6rnjbgOI76tsKzYq8rsBttYSGf+oy1qa2nM7x/pQHE6oRiXVy8+Ju2dzpwvLlMurF75r7lWyMRPSniPHBQGrx4yEEeKVwuWCMRaSJVyId13qyP7gPBqes4jgsiVHvt1okhydrAeoq89KOgnOHPqrpS+qI9dvXFmFRiP9AB0i9ra67tDx5ItYNh/neNgxsNpV3q0Tf9PfoTKiKwcYMg0AiFeKuSpynDIL530Ek8Jm/7LbXU7+mUkeGO7BJo9gxEMJRTHuSRLCLIXWm2LY2S58WccsXkL7GFaamkh6lE1VX3quXavLpHC0ishL4D0ocEdAh507s6GKd59oVErFAyBOifEE9EONR+95wD9MQMc4SdNt4l4Z7ATj67JN86UFZ5xZpGEOnMgCSUuuzX/Nx0HSF6uUf3Zs6HcViudmXcvLwwaFeRScRDwHYVLhiABda/qAp8Ovoc8Aw/3w=
is_trial Number 试用更新正式(换绑),0,1

# Response

名称 类型 必选 初始值 简介 Mock规则
data Object
  code Number 0 @mock=0
  message String [0] 操作成功 @mock=[0] 操作成功
ret Number 200 @mock=200
msg String @mock=

# Lic - 获取单个 lic

类名:/system/Lic

方法名:describeLic

# URL

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

# Method

GET

# Request

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

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200 @mock=200
msg String @mock=
data Object
  lic Object
    expire String 2018-03-01 @mock=2018-03-01, 维保或者试用到期时间: 2018-12-31
    ctrl_type String STD @mock=STD, 控制机的类型
    client_num String 0 @mock=0, 客户端/用户数量
    time_limit String 1 @mock=1, 为1,表示有时间限制;为0, 表示无时间限制;先忽略该项
    inst_date Number 1519833600 @mock=1519833600, 维保或者试用到期时间: 时间戳
    phy_num String 100 @mock=100, 许可包含的物理节点数量
    hardware String DA6B3E68A3727531DA3160B2C2C7749F @mock=DA6B3E68A3727531DA3160B2C2C7749F, 硬件识别码
    move_num String 0 @mock=0, 迁移工作机数
    type String 1 @mock=1, 许可类型; 1: 试用; 2: 授权; 3: 安装版;
    lic_uuid String C23BD84A-3895-0F06-4478-2312E022F8F0 @mock=C23BD84A-3895-0F06-4478-2312E022F8F0, 许可uuid
    product String 0101 @mock=0101, 产品类型,内部category code
    move_type String 0 @mock=0, move类型授权方式:1,需要联网授权;2,工作机识别码授权、无需联网
    sn String 20-3807064507 @mock=20-3807064507, 序列号
    version String 3 @mock=3, license版本
    vp_vm_num String 0 @mock=0, 无代理保护的虚机数
    show_label String i2soft @mock=i2soft, 产品显示名称,为了便于灵活销售,页面上默认显示这个字段
    user_uuid String 1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC @mock=1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC, 用户uuid
    storage_num String 0 @mock=0, 存储容量/数据传输量
    vm_num String 100 @mock=100, 许可包含的虚拟节点数量
    capacity String 0000000000000001 @mock=0000000000000001, 功能位code, 64bit
    secret String vJkdap @mock=vJkdap, 自助激活需要的key
    create_time Number 1528708638 @mock=1528708638, 添加许可的时间
    company String I2SOFT @mock=I2SOFT, 公司/注册名称
  code Number 0 @mock=0
  message String [0] 操作成功 @mock=[0] 操作成功

# Lic - 获取 lic 列表

类名:/system/Lic

方法名:listLic

可以搜索的字段:user_uuid, sn, create_time, inst_date

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

# URL

//lic

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
search_value String 可选,搜索字段对应值(可以模糊)
search_field String 可选,搜索字段
direction String ASC : 正向; DESC: 反向; RANDOM: 随机;
page Number 可选,不传就是全部
limit Number 可选,不传就是全部
order_by String 用哪个字段排序

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200 @mock=200
msg String @mock=
data Object
  message String [0] 操作成功 @mock=[0] 操作成功
  info_list Array
    ctrl_type String STD 控制机的类型
    type String 1 许可类型; 1: 试用; 2: 授权; 4: 服务版;
    capacity String 0000000000000001 功能位code, 64bit
    product String 0101 产品类型,内部category code
    move_type String 0 move类型授权方式:1,需要联网授权;2,工作机识别码授权、无需联网
    secret String vJkdap 自助激活需要的key
    sn String 20-3807064507-01 序列号
    client_num String 0 客户端/用户数量
    inst_date Number 1519833600 维保或者试用到期时间: 时间戳
    vm_num String 100 许可包含的虚拟节点数量
    vm_num_used Number 100 已使用的虚拟节点数量
    phy_num String 100 许可包含的物理节点数量
    phy_num_used Number 100 已使用的物理节点数量
    move_num String 迁移数
    move_num_used Number 已迁移数
    vp_vm_num String 0 无代理保护的虚机数
    vp_vm_num_used Number 已用虚机数
    create_time Number 1528708638 添加许可的时间
    time_limit String 1 为1,表示有时间限制;为0, 表示无时间限制;先忽略该项
    expire String 2018-03-01 维保(激活了的授权版)或者试用(试用版)到期时间: 2018-12-31
    act_period String 2018-12-31 激活期限(没激活的授权版): 激活:2018-12-31
    state String 授权版是否激活,0否1是;
    company String I2SOFT 公司/注册名称
    user_uuid String 1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC 用户uuid
    hardware String DA6B3E68A3727531DA3160B2C2C7749F 硬件识别码
    lic_uuid String C23BD84A-3895-0F06-4478-2312E022F8F0 许可uuid
    show_label String i2soft 产品显示名称,为了便于灵活销售,页面上默认显示这个字段
    storage_num String 0 存储容量/数据传输量
    move_num String 0 迁移工作机数
    version String 3 license版本
    ext Object
      wk String F77B7CC38FD9476DFAF119544305ECA0 70B642D8A0F6811CF41ED6E1CEAA6599 FFO/MOVE 绑定的工作机识别码
    group_sn String 20-3807064507 13位序列号,没有sn 后面的 -01 这种后缀,每组一样
    feature String active
    db_num String 10 oracle
    db_num_used String 1 oracle使用数
    mysql_num String 10 mysql
    mysql_num_used String 1 mysql 使用量
    sqlserver_num String 100 sql server
    sqlserver_num_used String 3 sql server 使用数
    db2_num String 10 db2 数量
    db2_num_used String 3 db2使用书
    gaussdb_num_used String 10 gauss使用数
    gaussdb_num String 10 gauss
    kafka_num String 10 kafka
    kafka_num_used String 3 kafka 使用
    postgresql_num String 100 postgre
    postgresql_num_used String 10 postgre 使用
    dm_num String 0 达梦
    dm_num_used String 0 达梦 使用
    hive_num String 0 hive
    hive_num_used String 0 hive使用
    hbase_num String 0 hbase
    hbase_num_used String 0 hbase使用
    kudu_num String 10 kudu
    kudu_num_used String 0 kudu 使用
    hana_num String 0 hana
    hana_num_used String 0 hana使用
  total Number 1 @mock=1
  code Number 0 @mock=0

# Lic-7 删除 lic

类名:/system/Lic

方法名:deleteLic

# URL

//lic

# Method

DELETE

# Request

名称 类型 必选 初始值 简介 Mock规则
lic_uuids Array ["11111111-1111-1111-1111-111111111111"]

# Response

名称 类型 必选 初始值 简介 Mock规则
msg String @mock=
ret Number 200 @mock=200
data Object
  code Number 0 @mock=0
  message String [0] 操作成功 @mock=[0] 操作成功

# 绑定 - 获取资源绑的许可(节点/VP管理)

类名:/system/Lic

方法名:listLicObjBind

获取所有 lic 并用 is_bound 标记是否与该 obj 绑定,并用 disabled 标记是否用完了;

对于节点:修改的时候,是有obj_uuid的,只传obj_uuid就行;新建的时候,由于没有uuid,用户填完ip port,认证完,再获取许可列表,传那三个参数;

对于VP:进新建/修改页面时调就行,新建传obj_type固定值2,修改传obj_uuid;

# URL

//lic/obj_bind

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
obj_uuid String 11111111-1111-1111-1111-111111111111 修改节点/VP页面,用uuid获取所有许可列表
obj_type Number 0 新建节点/VP页面,传这三个,取值同隔壁【 获取 Obj 列表】接口;

obj类型;0:节点;1:VP | obj_subtype | Number | 否 | | 新建节点/VP页面,传这三个,取值同隔壁【 获取 Obj 列表】接口;

子类型, 节点则:0:node,1:集群, VP则:0:vmware,1:hyperv; | proxy_switch | Number | 否 | | 认证类型,0,普通;1,云版(用认证码添加) | i2id | String | 否 | | 认证码,用认证码添加时传 | config_addr | String | 否 | 192.168.72.76 | 批量新建节点情况,不传,此时则 move ffo 的识别码检查判否,会用剩余数量判断;这个move ffo 识别码检查逻辑是,如果能获取到识别码且节点识别码在许可中,则直接允许绑定,不在其中就用剩余数量判断; | config_port | String | 否 | 26821 | 说明同 config_addr |

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200
msg String
data Object
  code Number 0
  message String [0] 操作成功。
  info_list Array 13
    sn String 20-4167184371-01
    lic_uuid String CBAA5927-A2AE-30F7-C0A9-4C45B29EC75E
    user_uuid String 1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    create_time Number 1546824170
    inst_date Number 1581091200
    group_sn String 20-4167184371
    company String info2soft
    type String 2
    expire String 2020-02-08
    hardware String 8FAABA79F27E2FBF06D6F0B61729A1A3
    vm_num String 10
    phy_num String 10
    ctrl_type String STD
    show_label String nas-01
    move_num String 0
    client_num String 0
    storage_num String 0
    vp_vm_num String 0
    state String 1
    feature String active nas
    phy_num_used Number 0
    vm_num_used Number 2
    is_bound Number 0
    is_expire String 0 是否过期
    disabled Number 0
    db_num String 111
    db_num_used String 0
    mysql_num String 100
    mysql_num_used String 9
    kafka_num String 100
    kafka_num_used String 7
    postgresql_num String 10
    postgresql_num_used String 0
    gaussdb_num String 13
    gaussdb_num_used String 4
    db2_num String 10
    db2_num_used String 0
    dm_num String 10
    dm_num_used String 0
    gaussdb_num String 12
    gaussdb_num_used String 0
    hana_num String 10
    hana_num_used String 0
    hbase_num String 10
    hbase_num_used String 1
    hive_num String 10
    hive_num_used String 5
    kudu_num String 10
    kudu_num_used String 4
    sqlserver_num String 10
    sqlserver_num_used String 1

# 绑定 - 获取许可绑的资源(许可管理)

类名:/system/Lic

方法名:listLicBind

lic管理页面修改绑定关系 传 lic_uuid,获取所有 obj 并用 is_bound 标记是否与该 lic_uuid 绑定

# URL

//lic/lic_bind

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
lic_uuid String 11111111-1111-1111-1111-111111111111 用许可uuid获取所有obj列表

# Response

名称 类型 必选 初始值 简介 Mock规则
data Object
  info_list Array 10
    is_bound Number @pick([0, 1]) 是否已绑定到当前 lic; 0: 否; 1: 是;
    phy_type String 2 1: phy; 2: vm;
    obj_name String N4_72.76
    obj_uuid String 2272C065-C2EB-F7EB-B8B8-2D37F2EF3388
    config_port String 26821
    obj_type String 1 obj类型;7.1版本控制机:0:节点;1:集群;2:VP;允许传整形数组;
开发版控制机(obj_type-obj_subtype):0-0:节点,0-1:集群,0-3:Dtrack节点;1-0:VP(Vmware),1-1:VP(Hyper-V);
    obj_subtype Number 开发版控制机专有,配合obj_type做判断,如上述
    config_addr String 192.168.81.145
    dtrack_switch Number 0 是否用作块复制节点,0否1是;
    storages Array 容灾平台下的存储及绑定情况,仅在cdm时返回
      obj_uuid String 存储的uuid
      name String 存储名称
      type String Local, NFS, GlusterFS
      total String 总的容量单位byte
      is_bound String 是否已绑定
      vp_uuid String 父级平台uuid
  code Number 0
  message String [0] 操作成功
ret Number 200
msg String

# 绑定 - 更新许可绑的资源(许可管理)

类名:/system/Lic

方法名:updateLicBind

传 lic_uuid + obj_uuids:

更新 某个许可绑定的 obj;

# URL

//lic/lic_bind

# Method

PUT

# Request

名称 类型 必选 初始值 简介 Mock规则
lic_uuid String 11111111-1111-1111-1111-111111111111
obj_uuids Array ["11111111-1111-1111-1111-111111111111"]

# Response

名称 类型 必选 初始值 简介 Mock规则
data Object
  message String [0] 操作成功
  code Number 0
msg String
ret Number 200

# Obj - 获取 Obj 列表

类名:/system/Lic

方法名:listLicObj

# URL

//lic/obj

# Method

GET

# Request

名称 类型 必选 初始值 简介 Mock规则
feature String coopy 可选,许可类型:"asm_coopy","coopy",

"cdp", "ha", "move", "ffo", "vp", "backup", "active", "nas", "dto", "track", "cld_backup", | obj_type | Number | 否 | 0 | number或Array,可选,obj类型; 0:节点; 1:VP; 2:active; 3:vp_storage | obj_subtype | Number | 否 | | 可选,子类型, 节点则:0:node,1:集群; VP则:0:vmware,1:hyperv; | where_args[obj_uuid] | String | 否 | 11111111-1111-1111-1111-111111111111 | 可选,组过滤,组uuid,可以加多个 | where_args[os_type] | String | 否 | | 可选,限制系统类型,0:linux,1:windows | filter_by_biz_grp | String | 否 | 1 | 可选,组过滤,开关 | order_by | String | 否 | | 排序,默认create_time;is_bkup_center,是否备份中心 | direction | String | 否 | | 排序方向,ASC, DESC, RANDOM,默认DESC |

# Response

名称 类型 必选 初始值 简介 Mock规则
ret Number 200
msg String
data Object
  code Number 0
  message String [0] 操作成功。 虚拟平台这个字段可能非空数组,节点这个字段是空数组,虚机平台下的演练平台列表,内容与演练平台新建的参数一样
  vp_drill_plat_list Array
  obj_list Array 8
    username String admin
    obj_uuid String 28A5AA3B-CF61-3793-2D81-70F9BDCFA2B7
    obj_name String move 3 2.75
    obj_type Number 0
    obj_subtype Number 0
    config_addr String 172.20.2.75
    config_port String 26821
    data_addr String 172.20.2.75
    phy_type Number 2
    os_type Number 1
    proxy_switch String 0
    i2id String 3D09745AEB48C4D2B24A16A86E71CD4F
    dtrack_switch String 0
    rep_path Array ["/"]
    npsvr_uuid String 虚拟平台npsvr_uuid
    create_time Number 1562577632
    user_uuid String 1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    vp_drill_plat_list Array 为内层同名字段的交集
    node_type String 1111111 数据库的机械节点类型
    db_type String kafka 数据库类型
    db_uuid String @guid 数据库的uuid
    db_name String @name
    storages Array feature为cdm时返回该数组,容灾平台下已经绑定cdm许可的存储
      uuid String
      vp_uuid String
      name String
      type String
      path String
      total String
      used String
      create_tme String
Last Updated: 5/13/2020, 3:56:32 AM