对接魔方云平台

本文整理智简魔方财务系统中“对接魔方云平台”相关的配置、操作或问题处理内容，供管理员和运维人员按原文步骤查阅与执行。

一、功能支持

二、API接口添加

一、功能支持

智简魔方系统支持对接魔方云，实现自动化管理，自动开通小鸡，删除，开机关机重装等管理。

二、API 接口添加

魔方云创建 API 账户

在魔方云面板中创建 API 账户步骤如下：

①系统设置-管理员-添加管理员

①系统设置-管理员-添加管理员界面截图

②管理员账号权限（建议直接添加为超级管理员分组）权限不足会导致财务的自动操作失败，如自动开通，配置升降级等

魔方财务添加接口

前往魔方财务系统，在【商品-自动化接口-魔方云】中，点击【新增接口】

注：添加成功后，列表页状态会显示绿色，若是灰色则代表连接失败，需检查以下信息是否填写正确

注：添加成功后，列表页状态会显示绿色界面截图

**名称：**自定义填写，建议填写魔方云配置
**地址：**填写魔方云的域名或 ip 地址+端口+后台管理员路径端口一般为 8443（如需使用 VNC，请务必配置为域名并确保证书正常）
**账号：**登录魔方云的用户名 https://www.idcsmart.com/home.php?m=wiki&a=helpaddList&action=edit&id=338#2.1.1.1
**密码：**登录魔方云的密码

添加产品

在【产品配置-魔方云-产品设置】中，点击新增产品。

**产品名称：**自定义
**产品类型：**魔方云
**产品组：**自定义选择（如没有创建产品组，请先创建产品组）

产品组：自定义选择（如没有创建产品组，请先创建产品组）界面截图

模块设置

（1）**服务器组：**选择与魔方云对接的接口 >>添加的接口

（2）**开通方式：**根据需求自定义选择

（2）开通方式：根据需求自定义选择界面截图

魔方云支持开通指定端口

自定义字段

（1）、字段名称添加“port”字段或者“端口”字段

（2）、输入规则以及显示规则需符合以下正则表达式（端口号在 20000-30000）：

^(2[0-9]{4}|30000)$

（3）、购买商品后，端口号在产品内页中进行显示，购买时输入的端口进行显示

订单显示输入端口

产品内页中显示端口

可配置选项

添加产品后系统会根据魔方云设置自动创建可配置选项，支持以下参数传递，您只需手动修改参数即可。

注：1.只有在每次添加产品时，系统才会自动拉取魔方云信息并创建可配置项

必选项需正确添加只配置项中，否则会影响产品开通
系统盘传递支持多种传递方式

①30,1|系统盘 30是指需要为该云主机分配的系统盘大小 1指区域节点-存储管理中的存储 ID,选择系统盘开在那个存储下，也可不传递，默认随机

②lin:30,win:50,1|系统盘 lin30指云主机如果是 Linux 系统或重装为 Linux 时，系统盘为 30G。win:50指云主机如果是 Windows 系统或重装为 Windows 时,系统盘为 50G 1 指区域节点-存储管理中的存储 ID，选择系统盘开在那个存储下，也可不传递，默认随机

③lin:30,win:50|系统盘 lin30指云主机如果是 Linux 系统或重装为 Linux 时，系统盘为 30G。win:50指云主机如果是 Windows 系统或重装为 Windows 时,系统盘为 50G

配置项名称	配置项参数	参数说明	必选	未传递默认值
area\|数据中心	1\|CN^香港CN2	1指魔方云系统-区域管理-区域ID 注：数据中心和节点id必传一个	✔
node\|节点id	1\| CN^香港CN2^一区	1指魔方云系统-节点管理-节点ID 注：数据中心和节点id必传一个		不传递系统将自动分配
os\|操作系统	1\|Windows^windows2008	1 指魔方云系统-镜像管理-操作系统 ID	✔
cpu\|CPU	2\|2 核心	2 指需要为该云主机分配的 cpu 核心数	✔
memory\|内存	1024\|1G	1024 指需要为该云主机分配的内存大小,单位 M	✔
system_disk_size\|系统盘	30,1\|系统盘 lin:30,win:50,1\|系统盘 lin:30,win:50\|系统盘	30指需要为该云主机分配的系统盘大小 1指区域节点-存储管理中的存储ID,选择系统盘开在那个存储下，也可不传递，默认随机 lin:30指云主机如果是Linux系统或重装为Linux时，系统盘为30G win:50指云主机如果是Windows系统或重装为Windows时,系统盘为50G		不传递默认50G, Windows系统盘最小30G
network_type\|网络类型	normal\|经典网络 vpc\|VPC网络	normal是指分配的ip地址可直接配置在机器里 vpc是指支持浮动ip，机器内不再配置公网ip	✔
bw\|带宽	10\|10Mbps	10 指需要为该云主机分配的上下行带宽		不传递默认为 0Mbps
in_bw\|流入带宽	100\|100Mbps	100指需要为该云主机分配的进带宽如果配置 in_bw 优先使用该参数		不传递默认为0Mbps
flow_limit\|流量	1024\|1T	1024 指需要为该云主机分配的流量大小，单位 G		不传递默认为不限量
flow_way\|流量方向	in\|进方向 out\|出方向 all\|进出汇总方向	in 指进方向的流量，out 指出方向的流量，all 指进出方向汇总的流量		不传递默认为 all
ip_num\|IP 数量	2\|2 个	2 指需要为该云主机分配的 ip 数量	✔
data_disk_size\|数据盘	30,1\|30G	30指需要为该云主机分配的数据盘大小，传参单位G，右边的文字30G为自定义文字内容 1指区域节点-存储管理中的存储ID,选择数据盘开在那个存储下，也可不传递，默认随机		不传递默认无数据盘
snap_num\|快照数量	-1\|不开通，0\|不限量，5\|5 个	-1 指该云主机不能创建快照,0 指可以不限量创建快照,5 指只能创建 5 个快照		不传递默认 2 个
backup_num\|备份数量	-1\|不开通，0\|不限量，5\|5 个	-1 指该云主机不能创建备份,0 指可以不限量创建备份,5 指只能创建 5 个备份		不传递默认 2 个
nat_acl_limit\|NAT 转发	-1\|不支持, 0\|不限制, 5\|5 个	-1 指该云主机不能设置 nat 转发,0 指可以不限量 nat 转发,5 指只能创建 5 个 nat 转发		不传递默认不支持
nat_web_limit\|共享建站	-1\|不支持, 0\|不限制, 5\|5 个	-1 指该云主机不能 nat 建站,0 指可以不限量 nat 建站,5 指只能创建 5 个 nat 建站		不传递默认不支持
system_disk_io_limit\|系统盘性能	0,0,0,0\|不限制性能，500,500,2000,2000\|500 持续 2000IOPS	0,0,0,0 指不限制系统盘性能，500,500,2000,2000 读取限制 500MB/s，写入限制 500MB/s，读取限制 2000ops/s，写入限制 2000ops/s		不传递默认不限制
data_disk_io_limit\|数据盘性能	0,0,0,0\|不限制性能，500,500,2000,2000\|500 持续 2000IOPS	0,0,0,0 指不限制数据盘性能，500,500,2000,2000 读取限制 500MB/s，写入限制 500MB/s，读取限制 2000ops/s，写入限制 2000ops/s		不传递默认不限制
ip_group\|IP 分组	1\|电信,2\|联通	1 指魔方云系统-ip 管理-ip 分组中的 ID
node_group\|节点分组	1\|台湾,2\|香港	1 指魔方云系统-区域管理-节点管理-节点分组的 ID
node_priority\|节点选择优先级(1数量平均,2负载最低,3内存最低,4填满一个)	1\|数量平均,2\|负载最低,3\|内存最低,4\|填满一个	1指在创建实例时，会优先分在节点实例最少的。2指会优化分给节点cpu负载最低的。3指会优先分给节点内存最低的。 4指根据节点id从小到大填满一个的方式创建实例，当节点资源达到限制后，就在其他节点开通实例		不传递默认数量平均
IP_MACBond\|嵌套虚拟化	0\|关闭绑定,1\|开启绑定	0 指关闭 IP-MAC 绑定，1 指开启 IP-MAC 绑定		不传递默认开启绑定
cpu_limit\|CPU 限制	50\|50%	50 指开通实例设置 CPU 限制为 50%		不传递默认以魔方云系统设置为准
traffic_bill_type\|流量计费周期	month\|自然月， last_30days\|订购日至下月	month 是指每月 1 日流量进行清零，last_30days\|是指产品开通日至下月进行清零		不传递默认每月 1 日清零
type\|云节点类型	host\|KVM 加强版，lightHost\|KVM 轻量版，hyperv\|Hyper-V ,adsl\|拨号云	host 是指 KVM 加强版节点类型，lightHost 是指 KVM 轻量版节点类型，hyperv 是指 Hyper-V 节点类型，adsl 是指拨号云		不传递默认 KVM 加强版
advanced_cpu\|智能 CPU	1\|降至 50%	1 指在魔方云系统-监控-智能规则-智能 CPU 的 ID
advanced_bw\|智能带宽	1\|降至 30%	1 指在魔方云系统-监控-智能规则-智能带宽的 ID
port\|端口	auto\|随机端口 1234\|指定端口	auto指随机端口 1234是指定端口为1234		不传递默认不支持
ipv6_num\|ipv6 数量	2\|2 个	2 指 ipv6 地址数量为 2 个
resource_package\|资源包	1\|资源包名称	1 指魔方云那边的资源包 id，后面这个名称可以自定义		不传递默认不支持
gpu_num\|GPU 数量	1\|1 个 GPU	1 指 GPU 显卡的数量		不传递默认不支持
niccard\|网卡驱动	1\|Realtek 8139 2\|Intel PRO/1000 3\|Virtio	1 指 Realtek 8139 ，2 指 Intel PRO/1000，3 指 Virtio		不传递默认不支持

③lin:30界面截图

重装系统时格式化数据盘

仅对接的魔方云是专业版时，用户重装系统时可以选择格式化数据盘。

在产品中设置自定义字段，‘format_data_disk/格式化数据盘’ 用引号里面的英文或者中文都可以的

在产品中设置自定义字段界面截图在产品中设置自定义字段界面截图（二）

三、购买产品测试开通

产品添加完成后，即可前往购买产品，测试是否开通成功，若失败，请前往【其他选项-日志记录-系统日志】中查看具体开通失败的原因并解决。

产品添加完成后，即可前往购买产品界面截图

产品开通后，若想将产品删除或暂停，需点击模块命令中的删除或暂停才会执行接口，否则无效。

产品开通后，若想将产品删除或暂停界面截图

配置项名称	配置项参数	参数说明	必选	未传递默认值
area\|数据中心	1\|CN^香港CN2	1指魔方云系统-区域管理-区域ID 注：数据中心和节点id必传一个	✔
node\|节点id	1\| CN^香港CN2^一区	1指魔方云系统-节点管理-节点ID 注：数据中心和节点id必传一个		不传递系统将自动分配
os\|操作系统	1\|Windows^windows2008	1 指魔方云系统-镜像管理-操作系统 ID	✔
cpu\|CPU	2\|2 核心	2 指需要为该云主机分配的 cpu 核心数	✔
memory\|内存	1024\|1G	1024 指需要为该云主机分配的内存大小,单位 M	✔
system_disk_size\|系统盘	30,1\|系统盘 lin:30,win:50,1\|系统盘 lin:30,win:50\|系统盘	30指需要为该云主机分配的系统盘大小 1指区域节点-存储管理中的存储ID,选择系统盘开在那个存储下，也可不传递，默认随机 lin:30指云主机如果是Linux系统或重装为Linux时，系统盘为30G win:50指云主机如果是Windows系统或重装为Windows时,系统盘为50G		不传递默认50G, Windows系统盘最小30G
network_type\|网络类型	normal\|经典网络 vpc\|VPC网络	normal是指分配的ip地址可直接配置在机器里 vpc是指支持浮动ip，机器内不再配置公网ip	✔
bw\|带宽	10\|10Mbps	10 指需要为该云主机分配的上下行带宽		不传递默认为 0Mbps
in_bw\|流入带宽	100\|100Mbps	100指需要为该云主机分配的进带宽如果配置 in_bw 优先使用该参数		不传递默认为0Mbps
flow_limit\|流量	1024\|1T	1024 指需要为该云主机分配的流量大小，单位 G		不传递默认为不限量
flow_way\|流量方向	in\|进方向 out\|出方向 all\|进出汇总方向	in 指进方向的流量，out 指出方向的流量，all 指进出方向汇总的流量		不传递默认为 all
ip_num\|IP 数量	2\|2 个	2 指需要为该云主机分配的 ip 数量	✔
data_disk_size\|数据盘	30,1\|30G	30指需要为该云主机分配的数据盘大小，传参单位G，右边的文字30G为自定义文字内容 1指区域节点-存储管理中的存储ID,选择数据盘开在那个存储下，也可不传递，默认随机		不传递默认无数据盘
snap_num\|快照数量	-1\|不开通，0\|不限量，5\|5 个	-1 指该云主机不能创建快照,0 指可以不限量创建快照,5 指只能创建 5 个快照		不传递默认 2 个
backup_num\|备份数量	-1\|不开通，0\|不限量，5\|5 个	-1 指该云主机不能创建备份,0 指可以不限量创建备份,5 指只能创建 5 个备份		不传递默认 2 个
nat_acl_limit\|NAT 转发	-1\|不支持, 0\|不限制, 5\|5 个	-1 指该云主机不能设置 nat 转发,0 指可以不限量 nat 转发,5 指只能创建 5 个 nat 转发		不传递默认不支持
nat_web_limit\|共享建站	-1\|不支持, 0\|不限制, 5\|5 个	-1 指该云主机不能 nat 建站,0 指可以不限量 nat 建站,5 指只能创建 5 个 nat 建站		不传递默认不支持
system_disk_io_limit\|系统盘性能	0,0,0,0\|不限制性能，500,500,2000,2000\|500 持续 2000IOPS	0,0,0,0 指不限制系统盘性能，500,500,2000,2000 读取限制 500MB/s，写入限制 500MB/s，读取限制 2000ops/s，写入限制 2000ops/s		不传递默认不限制
data_disk_io_limit\|数据盘性能	0,0,0,0\|不限制性能，500,500,2000,2000\|500 持续 2000IOPS	0,0,0,0 指不限制数据盘性能，500,500,2000,2000 读取限制 500MB/s，写入限制 500MB/s，读取限制 2000ops/s，写入限制 2000ops/s		不传递默认不限制
ip_group\|IP 分组	1\|电信,2\|联通	1 指魔方云系统-ip 管理-ip 分组中的 ID
node_group\|节点分组	1\|台湾,2\|香港	1 指魔方云系统-区域管理-节点管理-节点分组的 ID
node_priority\|节点选择优先级(1数量平均,2负载最低,3内存最低,4填满一个)	1\|数量平均,2\|负载最低,3\|内存最低,4\|填满一个	1指在创建实例时，会优先分在节点实例最少的。2指会优化分给节点cpu负载最低的。3指会优先分给节点内存最低的。 4指根据节点id从小到大填满一个的方式创建实例，当节点资源达到限制后，就在其他节点开通实例		不传递默认数量平均
IP_MACBond\|嵌套虚拟化	0\|关闭绑定,1\|开启绑定	0 指关闭 IP-MAC 绑定，1 指开启 IP-MAC 绑定		不传递默认开启绑定
cpu_limit\|CPU 限制	50\|50%	50 指开通实例设置 CPU 限制为 50%		不传递默认以魔方云系统设置为准
traffic_bill_type\|流量计费周期	month\|自然月， last_30days\|订购日至下月	month 是指每月 1 日流量进行清零，last_30days\|是指产品开通日至下月进行清零		不传递默认每月 1 日清零
type\|云节点类型	host\|KVM 加强版，lightHost\|KVM 轻量版，hyperv\|Hyper-V ,adsl\|拨号云	host 是指 KVM 加强版节点类型，lightHost 是指 KVM 轻量版节点类型，hyperv 是指 Hyper-V 节点类型，adsl 是指拨号云		不传递默认 KVM 加强版
advanced_cpu\|智能 CPU	1\|降至 50%	1 指在魔方云系统-监控-智能规则-智能 CPU 的 ID
advanced_bw\|智能带宽	1\|降至 30%	1 指在魔方云系统-监控-智能规则-智能带宽的 ID
port\|端口	auto\|随机端口 1234\|指定端口	auto指随机端口 1234是指定端口为1234		不传递默认不支持
ipv6_num\|ipv6 数量	2\|2 个	2 指 ipv6 地址数量为 2 个
resource_package\|资源包	1\|资源包名称	1 指魔方云那边的资源包 id，后面这个名称可以自定义		不传递默认不支持
gpu_num\|GPU 数量	1\|1 个 GPU	1 指 GPU 显卡的数量		不传递默认不支持
niccard\|网卡驱动	1\|Realtek 8139 2\|Intel PRO/1000 3\|Virtio	1 指 Realtek 8139 ，2 指 Intel PRO/1000，3 指 Virtio		不传递默认不支持

本页目录