服务器托管API文档

## 调用方式

**请求地址**

http://您阿帕云引擎域名/api

**请求方法**

POST

Content-Type 类型：application/x-www-form-urlencoded

**公共参数**

说明：公共请求参数与返回数据说明，再具体接口中不再重复列出和说明。

| 参数                | 必选 | 类型/长度 | 示例值                                   | 说明                                                         |
| ------------------- | ---- | --------- | ---------------------------------------- | ------------------------------------------------------------ |
| module              | 是   | string    | idc                                   | 业务类型                                                     |
| action              | 是   | string    | getzones                                 | 操作名称，后续接口中，替换此参数                             |
| userid              | 是   | int       | 1                                        | 会员ID                                                       |
| time                | 是   | int       | 1471331587                               | 当前UNIX时间戳                                               |
| sign                | 是   | string    | ebb198fa8f884f9544b94bb16e8e3af3         | 权限令牌，生成规则如下： sign = md5(module+ 'zkeys.api@2019'+action + userid + API秘钥 + time)，API秘钥请登录控制台，在代理分销>API设置中查看/修改。 |
| taskid              | 是   | int       | 12                                       | 您本地请求的任务编号，异步回调时返回会携带该参数             |
| dataType            | 否   | string    | json                                     | 返回格式，XML/JSON（可选），默认json                         |
| version             | 是   | string    | 6.0.1                                    | 阿帕云引擎版本，如自行对接，可固定：9.9.9                    |
| system_type         | 是   | string    | zkeys_web                                | 阿帕云引擎类型，如自行对接，可固定：zkeys_web                |
| vtime               | 是   | string    | 20220303                                 | 当天日期，格式：YYYYMMDD                                     |

### 获取可用区

**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getzones |接口名称

**返回示例**

{
    	"code": 0,
   	 "message": "success",
   	 "data": {
       	 "zones": [
           	 {
              	  "guid": "1625139389577044",
              	  "name": "Hyper-V 2",
             	   "max_year": "3",
              	  "identityStatus": "1",
             	   "whiteListStatus": "0",
            	    "icp_status": "0"
            	},
				{
              	  "guid": "1650521653823448",
              	  "name": "\u4e2d\u56fd\u5185\u8499",
              	  "max_year": "3",
               	 "identityStatus": "1",
               	 "whiteListStatus": "1",
              	  "icp_status": "1"
           	 }
        	]
    	}
	}
	
	
**返回值**

### 获取线路
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getlines |接口名称

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"lines": [
				{
					"line_guid": "1683665299911682",
					"sortId": "12",
					"status": "1",
					"buyStatus": "1",
					"buyStatus1": "1",
					"buyStatus2": "1",
					"buyStatus99": "1",
					"upgradeStatus": "1",
					"renewStatus": "1",
					"defenseStatus": "1",
					"name": "华南1区",
					"code": "GD",
					"ipFreeSize_1": "1",
					"ipFreeSize_2": "1",
					"ipFreeSize_99": "0",
					"ipAllowList_1": "0,1,16,32,64,128,256,512,768",
					"ipAllowList_2": "0,1,16,32,64,128,256,512,768",
					"ipAllowList_99": "0,1,16,32,64,128,256,512,768",
					"bandwidthMinSize_1": "5",
					"bandwidthMinSize_2": "5",
					"bandwidthMinSize_99": "0",
					"bandwidthFreeSize_1": "5",
					"bandwidthFreeSize_2": "5",
					"bandwidthFreeSize_99": "0",
					"bandwidthMaxSize": "1000",
					"bandwidthStep_1": "1",
					"bandwidthStep_2": "1",
					"bandwidthStep_99": "1",
					"defenseFreeSize": "5",
					"defenseAllowList": "5,10,20,30,50,100,200,300",
					"installFreeTimes_1": "1",
					"installFreeTimes_2": "1",
					"installFreeTimes_99": "5",
					"resetFreeTimes_1": "1",
					"resetFreeTimes_2": "1",
					"resetFreeTimes_99": "2",
					"corePrice_1": "550.00",
					"corePrice_2": "650.00",
					"corePrice_99": "4800.00",
					"coreApiPrice_1": "550.00",
					"coreApiPrice_2": "650.00",
					"coreApiPrice_99": "4800.00",
					"ipPrice": "15.00",
					"defensePrice": "700.00",
					"bandwidthPrice_1": "40.00",
					"bandwidthPrice_2": "40.00",
					"bandwidthPrice_99": "30.00",
					"ipApiPrice": "15.00",
					"defenseApiPrice": "700.00",
					"bandwidthApiPrice_1": "40.00",
					"bandwidthApiPrice_2": "40.00",
					"bandwidthApiPrice_99": "30.00",
					"installPrice": "15.00",
					"resetPrice": "5.00",
					"shelvedOverPrice": "5.00",
					"address": "广东省深圳市南山区科技园高新中一道软件大厦4楼互联港湾 小鸟云 0755-86649802",
					"releaseHour": "48",
					"openOverDay": "5",
					"shelvedOverDay": "7",
					"months": "1,2,3,6,12,24,36",
					"lifeTime": "3",
					"descript": "",
					"introUrl": "",
					"temp_upgrade_status": "0",
					"renew_degrade_status": "0",
					"temp_upgrade_times_limit": "0",
					"temp_upgrade_bandwidth_price": "0.00",
					"temp_upgrade_min_hours": "0",
					"portPrice": "10.00",
					"portFreeTimes": "2",
					"portMax": "5",
					"api_url": "",
					"api_pass": null,
					"ipmi_status": "1",
					"ipmi_server_id": "0",
					"switch_bandwid_status": "0",
					"switch_vlan_status": "0",
					"install_api_url": "",
					"install_api_guid": "",
					"is_grant_apply": "1",
					"need_id_image": "0",
					"reservation_degrade_status": "1",
					"reservation_degrade_valid_limit": "30",
					"discount1": "0.20",
					"discount2": "0.10",
					"discount3": "0.80",
					"line_auth": "0",
					"ip_bandwidth_rate": "0.000",
					"id": "5"
				}
			]
		}
}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|	json	|json|	返回的可用区结构体 可能存在多条线路
data.lines|	json	|{}|	线路信息集合 可能存在多个
data.lines.id|	json	|1|	线路特殊id
data.lines.line_guid|	string	|1683665299911682|	线路GUID
data.lines.sortId|	string	|1|	排序数字(数值越小越靠前)
data.lines.status|	enum	|1|	状态：0隐藏，1显示，-1删除
data.lines.buyStatus|	enum	|1|	开放购买：0否,1是
data.lines.buyStatus1|	enum	|1|	1U开放购买：0否，1是
data.lines.buyStatus2|	enum	|1|	2U开放购买：0否，1是
data.lines.buyStatus99|	enum	|1|	整柜开放购买：0否，1是
data.lines.upgradeStatus|	enum	|1|是否允许升级：0否,1是
data.lines.renewStatus|	enum	|1|是否允许续费：0否,1是
data.lines.defenseStatus|	int	|1|防御状态：0关闭 , 1开启 （关闭则线路下无防御选项）
data.lines.name|	string	|华南1区|线路名称
data.lines.code|	string	|GD|线路名称
data.lines.ipFreeSize_1|	string	|1|1U IP赠送值
data.lines.ipFreeSize_2|	string	|1|2U IP赠送值
data.lines.ipFreeSize_99|	string	|0|整柜 IP赠送值
data.lines.ipAllowList_1|	string	|0,1,16,32,64,128,256,512,768|1U可购买IP数
data.lines.ipAllowList_2|	string	|0,1,16,32,64,128,256,512,768|2U可购买IP数
data.lines.ipAllowList_99|	string	|0,1,16,32,64,128,256,512,768|整机柜可购买IP数
data.lines.bandwidthMinSize_1|	string	|5|1U 带宽最小值
data.lines.bandwidthMinSize_2|	string	|5|2U 带宽最小值
data.lines.bandwidthMinSize_99|	string	|0|整柜 带宽最小值
data.lines.bandwidthFreeSize_1|	string	|5|1U 带宽赠送值
data.lines.bandwidthFreeSize_2|	string	|5|2U 带宽赠送值
data.lines.bandwidthFreeSize_99|	string	|0|整柜 带宽赠送值
data.lines.bandwidthMaxSize|	string	|1000|带宽最大值
data.lines.bandwidthStep_1|	string	|1|1U 带宽步长
data.lines.bandwidthStep_2|	string	|1|2U 带宽步长
data.lines.bandwidthStep_99|	string	|1|整柜 带宽步长
data.lines.defenseFreeSize|	string	|5|防御赠送值
data.lines.defenseAllowList|	string	||5,10,20,30,50,100,200,300,允许购买/升级的防御值
data.lines.installFreeTimes_1|	string	|1|1U 每月可免费重装次数
data.lines.installFreeTimes_2|	string	|1|2U 每月可免费重装次数
data.lines.installFreeTimes_99|	string	|5|整柜 每月可免费重装次数
data.lines.resetFreeTimes_1|	string	|1|1U 每月可免费重设密码次数
data.lines.resetFreeTimes_2|	string	|1|2U 每月可免费重设密码次数
data.lines.resetFreeTimes_99|	string	|2|整柜 每月可免费重设密码次数
data.lines.corePrice_1|	string	|550.00|1U托管价格    本级可设置
data.lines.corePrice_2|	string	|650.00|2U托管价格     本级可设置
data.lines.corePrice_99|	string	|4800.00|整柜托管价格   本级可设置
data.lines.coreApiPrice_1|	string	|550.00|1U托管价格（API原价）
data.lines.coreApiPrice_2|	string	|650.00|2U托管价格（API原价）
data.lines.coreApiPrice_99|	string	|4800.00|整柜托管价格（API原价）
data.lines.ipPrice|	string	|15.00|ip单价
data.lines.defensePrice|	string	|15.00|防御价格
data.lines.bandwidthPrice_1|	string	|40.00|1U带宽单价
data.lines.bandwidthPrice_2|	string	|40.00|2U带宽单价
data.lines.bandwidthPrice_99|	string	|30.00|整柜带宽单价
data.lines.ipApiPrice|	string	|30.00|IP单价（API原价）
data.lines.defenseApiPrice|	string	|30.00|防御单价（API原价）
data.lines.bandwidthApiPrice_1|	string	|30.00|带宽1U单价（API原价）
data.lines.bandwidthApiPrice_2|	string	|30.00|带宽2U单价（API原价）
data.lines.bandwidthApiPrice_99|	string	|30.00|带宽整柜单价（API原价）
data.lines.installPrice|	string	|30.00|重装服务费
data.lines.resetPrice|	string	|30.00|重设密码服务费
data.lines.shelvedOverPrice|	string	|30.00|下架超时仓管费，元/台/天
data.lines.address|	string	|30.00|房收件地址，用户托管机器寄送地址（废弃）
data.lines.releaseHour|	string	|48|过期释放时间，业务过期多少小时后释放资源
data.lines.openOverDay|	string	|5|上架超时天数，假如设置的是5天，超过5天后机器还没有寄出，则订单支付5天后开始计费，0则自订单支付开始计费
data.lines.shelvedOverDay|	string	|7|下架超时天数，假如这里设置的是15，则业务过期后15天，若用户仍未安排机器寄回，则开始按天计费，0则超时不计费
data.lines.months|	string	|1,2,3,6,12,24,36|1U可购买时长
data.lines.lifeTime|	string	|3|1U可购买时长
data.lines.descript|	string	||一句话描述
data.lines.introUrl|	string	||机房介绍链接
data.lines.temp_upgrade_status|	string	|0|是否允许临时升级：0否 , 1是（废弃）
data.lines.renew_degrade_status|	string	|0|是否允许续费降配：0否 , 1是
data.lines.temp_upgrade_times_limit|	string	|0|允许临时升级重叠次数：0不允许（废弃）
data.lines.temp_upgrade_bandwidth_price|	string	|0|临时升级带宽单价，单位：元/M/小时（废弃）
data.lines.temp_upgrade_min_hours|	string	|0|临时升级最短时长，0则不限制（废弃）
data.lines.portPrice|	string	|0|新增一个端口价格，元/月
data.lines.portFreeTimes|	string	|0|单台托管免费端口个数
data.lines.portMax|	string	|0|最大允许多少个端口，0则不限
data.lines.api_url|	string	|0|交换机中间价地址（废弃）
data.lines.api_pass|	string	|0|交换机中间件秘钥（废弃）
data.lines.ipmi_status|	string	|1|IPMI状态：0不支持 ， 1支持（废弃）
data.lines.ipmi_server_id|	string	||IPMI机房控制器ID（废弃）
data.lines.switch_bandwid_status|	string	||是否支持交换机调整端口的带宽 0不支持  1支持（废弃）
data.lines.switch_vlan_status|	string	||是否支持交换机调整端口的vlan 0不支持  1支持（废弃）
data.lines.install_api_url|	string	|0|物理机重装 请求接口（废弃）
data.lines.install_api_guid|	string	|0|物理机重装 接口密钥（废弃）
data.lines.is_grant_apply|	string	|1|机房授权申请   1 开启    0不开启
data.lines.need_id_image|	string	|1|是否需要上传身份证  0不需要  1需要
data.lines.reservation_degrade_status|	string	|1|是否支持降配预约 0不支持 1支持
data.lines.reservation_degrade_valid_limit|	string	|30|降配预约默认天数
data.lines.discount1|	string	|1|满一年折扣
data.lines.discount2|	string	|1|满两年折扣
data.lines.discount3|	string	|1|满三年折扣
data.lines.line_auth|	string	|0|线路查看权限：0不限制（默认值）   1仅限本站会员     2仅限下级代理
data.lines.ip_bandwidth_rate|	string	|0|IP与带宽配比，值为 带宽除IP 的结果，0为不开启配比 大于0则需满足业务带宽除IP大于等于这个值

### 获取操作系统
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getsystems |接口名称
page_mode | 是| string | 1 |页码
page_length | 是| string | 50 |单页的数量

**返回示例**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|	json	|json|	返回的可用区结构体
data.pages|	int	|1|	页码数
data.items|	int	|116|	总数
data.systems|	array	|[]|操作系统信息
data.systems.distinct_id|	string	|1|	特殊id
data.systems.id|	string	|1|	特殊id
data.systems.guid|	string	|1695196885222115|	操作系统GUID
data.systems.class_guid|	string	|1666193469952094|	操作系统类型GUID
data.systems.name|	string	|6.8 64位|	操作系统名称
data.systems.login_name|	string	|root|	操作系统登陆名称
data.systems.port|	string	|22|	操作系统登陆端口
data.systems.mirror_name|	string	|root|	镜像名称
data.systems.cpu_limit|	string	|0|	cpu限制  购买业务时 会判断购买的业务的配置是否符合操作系统的最低限制 0 限制
data.systems.ram_limit|	string	|0|	内存限制 购买业务时 会判断购买的业务的配置是否符合操作系统的最低限制 0 限制
data.systems.type|	string	|create| 支持的类型	create 创建,install重装
data.systems.system_harddisk|	string	|30|系统盘大小
data.systems.support|	string	|server|支持的业务类型  server 云服务器,idc托管,baremetal裸金属
data.systems.boot_menu_contents|	json	|{"19":"","250":""}|引导菜单内容
data.systems.ghost_url|	json	|{"19":"","250":""}|ghost文件网络存储位置
data.systems.lines|	array	|["1683665299911682"]|线路GUID   操作系统关联的线路

### 获取电源
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getidclinepower |获取电源

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"power": [
					{
					"id": "1650609038736261",
					"sort_id": "2",
					"status": "1",
					"name": "750W"
					},
				],
			"linePower": [
					{
					"id": "1650609122983667",
					"power_id": "1650609038752191",
					"line_id": "5",
					"sort_id": "2",
					"status": "1",
					"size": "1",
					"price": "100.00"
					},
				]
			}
}
	
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|	json	|json|	返回的可用区结构体
data.power|	json	|{}|电源集合
data.power.id|	string	|1650609038736261|电源唯一id
data.power.sort_id|	string	|2|排序 越小越靠前
data.power.status|	string	|2|状态：0禁用 | 1启用 | -1已删除
data.power.name|	string	|750W|电源名称
data.linePower|	json	|{}|电源集合
data.linePower.id|	string	|id|托管线路唯一id
data.linePower.power_id|	string	|1650609038752191|电源唯一id
data.linePower.line_id|	string	|1673552471107177|线路的GUID
data.linePower.sort_id|	string	|1|排序
data.linePower.size|	enum	|1|托管规格(作废)
data.linePower.price|	string	|10|价格

### 创建
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | create |购买
lineid | 是| string | 6 |线路唯一id
size | 是| string | 1 |尺寸  1 1U  2 2u  99 整柜
linePowerId | 是| string | 1685024959472262 |线路电源的唯一id
ipnum | 是| string | 1 |ip数量
bandwidth | 是| string | 1 |带宽
defense | 是| string |0 |防御
months | 是| string |1 |购买的月份数
num | 是| string |1 |数量 台数
arpStatus | 是| string |1 |arp状态  1开启  0 不开启
clientUserID | 是| string |1100199 |客户端的用户id
clientOrderNo | 是| string |490682790550753199 |客户端订单
agent_order_no | 是| string |490682790550753199|客户端订单

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"idcs": [
				{
					"guid": "1708598562849469",
					"lineId": "6",
					"size": "1",
					"bandwidth": "1",
					"defense": "0",
					"port": "30",
					"ipnum": "1",
					"iplist": [
						{
							"ip": "88.66.55.203",
							"mask": "255.255.255.0",
							"gateway": "88.66.55.1"
						}
					],
					"buyTime": "2021-08-20 16:02:46",
					"endTime": "2021-09-25 16:02:46"
				}
			]
		}
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|	json	|json|	返回的可用区结构体
data.idcs|	json	|{}|业务信息集合
data.idcs.guid|	string	|1708598562849469|业务生成的唯一id
data.idcs.lineId|	string	|6|线路id  可忽略上级数据
data.idcs.size|	string	|1|尺寸  1 1U  2 2U 99 整柜
data.idcs.bandwidth|	string	|1|带宽
data.idcs.defense|	string	|0|防御
data.idcs.port|	string	|30|端口
data.idcs.ipnum|	string	|1|端口数量
data.idcs.iplist|	json	|{}|ip列表 可能有多个
data.idcs.iplist.ip|	string	|88.66.55.203|ip
data.idcs.iplist.mask|	string	|255.255.255.0|mask地址
data.idcs.iplist.gateway|	string	|88.66.55.1|网关
data.idcs.buyTime|	string	|2021-08-20 16:02:46|业务购买时间
data.idcs.endTime|	string	|2021-09-25 16:02:46|业务结束时间

### 获取多个业务
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getidcs |获取多个业务
page | 是| string | 1 |页码数 单页50条

**返回示例**

{
		"code":0,
		"message":"success",
		"data":[{
		 	"pages":3,
       		"items":"106",
			"idc":{
				"guid":"1708598562849469",
				"userId":"1100134",
				"lineId":"1623153153846762",
				"size":"1",
				"linePowerId":"1693202236354353",
				"bandwidth":"2",
				"defense":"5",
				"ipnum":"2",
				"port":"30",
				"serverNum":"1",
				"buyTime":"2021-08-20 16:02:46",
				"startTime":"2021-08-25 16:02:46",
				"endTime":"2021-10-25 16:02:46",
				"orderStatus":"1",
				"runStatus":"0",
				"actStatus":"0",
				"blockStatus":"0",
				"remark":"",
				"arpStatus":"1",
				"ips":[
					{
						"idcIp":"88.66.55.204",
						"mask":"255.255.255.0",
						"gateway":"88.66.55.1",
						"status":"1"
					},
					{
						"idcIp":"88.66.55.203",
						"mask":"255.255.255.0",
						"gateway":"88.66.55.1",
						"status":"1"
					}
				],
				"devices":[
					{
						"guid":"1708600766583144",
						"name":"托管",
						"cabinet_code":"ZHzy001",
						"seat_code":"45",
						"size":"1",
						"type":"server",
						"ip":"88.66.55.203",
						"system_id":"1671072370276278",
						"macaddr":"",
						"content":"上架托管服务器",
						"send_type":"1",
						"express_name":"",
						"express_num":"",
						"contact_name":"",
						"contact_tel":"",
						"run_status":"2",
						"power_status":"1",
						"offshelf_info":"",
						"onshelf_time":"2021-09-01 09:18:59",
						"offshelf_time":null,
						"ipmi_status":"0",
						"ipmi_url":"",
						"create_time":"2021-08-20 16:37:48"
					}
				],
				"service":[
					{
						"guid":"1709668383929011",
						"type":"upgrade",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 11:38:43"
					},
					{
						"guid":"1709664168898432",
						"type":"install",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 10:32:29"
					},
					{
						"guid":"1709662675419834",
						"type":"setpsw",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 10:15:51"
					},
					{
						"guid":"1709662094872946",
						"type":"restart",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:54:07"
					},
					{
						"guid":"1709661758293373",
						"type":"start",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:44:25"
					},
					{
						"guid":"1709660451124821",
						"type":"stop",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:39:08"
					},
					{
						"guid":"1708954967762348",
						"type":"install",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:38:12"
					},
					{
						"guid":"1708600766577845",
						"type":"onshelf",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:18:59"
					}
				]
			}
		}]
	}

**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|json | {} |返回信息体
data.pages|string | 3 | 总页数
data.items|string | 106 | 总条数
data.idc|array | []] |业务信息 可能存在多个
data.idc.guid|string | 1708598562849469 |业务guid
data.idc.userId|string | 1100134 |合作商id
data.idc.lineId|string | 1623153153846762 |线路guid
data.idc.size|string | 1 |尺寸  1 1U  2 2U 99 整柜
data.idc.linePowerId|string | 1693202236354353 |电源guid
data.idc.bandwidth|string | 2 |业务带宽
data.idc.defense|string | 2 |防御
data.idc.ipnum|string | 5 |ip数量
data.idc.port|string |30 |端口，多个端口用英文逗号隔开
data.idc.serverNum|string |30 |业务下机器数量
data.idc.buyTime|string |2021-08-20 16:02:46 |业务的购买时间
data.idc.startTime|string |2021-08-25 16:02:46 |业务的开始时间
data.idc.endTime|string |2021-10-25 16:02:46 |业务的结束时间
data.idc.orderStatus|string |1 |订单状态：0开通中， 1正常 ， 3已过期 , -2已删除
data.idc.runStatus|string |1 |（已取消）运行状态（ 0  开通中（业务开通，等待客户寄送机器）；1  待上架（机房签收机器，业务已开通，开始计费）；2  运行中（机器上架并正常运行）；3  已回收（暂保留，回收的机器48小时内可还原）；4  已过期（到期业务48小时后释放资源）；5  已删除（资源已释放，待下架）；6  已下架（机器已寄回客户）；7  重新开通中（到期后续费了）
data.idc.actStatus|string |0 |操作状态：0  无操作；4  升级中
data.idc.blockStatus|string |0 |操作状态：0  无操作；4  升级中
data.idc.remark|string | |备注
data.idc.arpStatus|string | 1|备是否开启ARP防护，0不开启， 1开启
data.idc.ips|array | []|ip信息  可能存在多个
data.idc.ips.idcIp|string |88.66.55.204|ip
data.idc.ips.mask|string |255.255.255.0|mask地址
data.idc.ips.gateway|string |88.66.55.1|网关
data.idc.ips.status|string |1|状态 1 正常 ， -1 已释放
data.idc.devices|json |1|设备信息 可能存在多个
data.idc.devices.guid|json |1|设备guid
data.idc.devices.name|string |托管|设备名称
data.idc.devices.cabinet_code|string |ZHzy001|机柜编号
data.idc.devices.seat_code|string |45|机位编号
data.idc.devices.size|string |1|尺寸
data.idc.devices.type|string |server|枚举类型 设备设备类型：server服务器 , switch交换机 ,firewall 防火墙 , router路由器
data.idc.devices.ip|string |88.66.55.203|设备主IP，只能填写1个
data.idc.devices.system_id|string |1671072370276278|操作系统guid
data.idc.devices.macaddr|string ||外网网卡MAC
data.idc.devices.content|string |上架托管服务器|内容
data.idc.devices.send_type|string |0|寄送方式：0快递 ， 1自行配送
data.idc.devices.express_name|string ||快递名称
data.idc.devices.express_num|string ||快递单号
data.idc.devices.contact_name|string ||联系姓名
data.idc.devices.contact_tel|string ||联系电话
data.idc.devices.run_status|string |2|运行状态：1待上架 ， 2运行中 ，3重启中 , 4重装中， 5重设密码中 , 6联网中 , 7已断网 ， 8已下架  ， 9 IPMI开通中, 10 重设IPMI密码中 , 11 关机中 ，12 开机中 ,-1已删除
data.idc.devices.power_status|string |1|电源状态：0已关机 1运行中
data.idc.devices.offshelf_info|string ||下架信息
data.idc.devices.onshelf_time|string |2021-09-01 09:18:59|上架时间
data.idc.devices.ipmi_status|string |0|IPMI状态：0未申请 ， 1已开通 ， 2不支持
data.idc.devices.ipmi_url|string ||IPMI URL
data.idc.devices.create_time|string |2021-08-20 16:37:48|创建时间
data.idc.service|json |{}|服务信息
data.idc.service.guid|string |1709668383929011|服务guid
data.idc.service.type|string |upgrade|类型：restart重启、setpsw重设密码、install重装、upgrade升级、onshelf上架、offshelf下架、expirerenew过期续费、expired过期
data.idc.service.status|string |2|枚举类型 完成状态，0未完成 1处理中 2 处理完成  3处理失败
data.idc.service.respondTime|string ||响应时间
data.idc.service.finishTime|string |2021-09-01 11:38:43|完成时间
data.idc.service.finishTime|string |2021-09-01 11:38:43|完成时间

### 获取单个业务
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getidc |获取单个业务

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
			"idc":{
				"guid":"1708598562849469",
				"userId":"1100134",
				"lineId":"1623153153846762",
				"size":"1",
				"linePowerId":"1693202236354353",
				"bandwidth":"2",
				"defense":"5",
				"ipnum":"2",
				"port":"30",
				"serverNum":"1",
				"buyTime":"2021-08-20 16:02:46",
				"startTime":"2021-08-25 16:02:46",
				"endTime":"2021-10-25 16:02:46",
				"orderStatus":"1",
				"runStatus":"0",
				"actStatus":"0",
				"blockStatus":"0",
				"remark":"",
				"arpStatus":"1",
				"ips":[
					{
						"idcIp":"88.66.55.204",
						"mask":"255.255.255.0",
						"gateway":"88.66.55.1",
						"status":"1"
					},
					{
						"idcIp":"88.66.55.203",
						"mask":"255.255.255.0",
						"gateway":"88.66.55.1",
						"status":"1"
					}
				],
				"devices":[
					{
						"guid":"1708600766583144",
						"name":"托管",
						"cabinet_code":"ZHzy001",
						"seat_code":"45",
						"size":"1",
						"type":"server",
						"ip":"88.66.55.203",
						"system_id":"1671072370276278",
						"macaddr":"",
						"content":"上架托管服务器",
						"send_type":"1",
						"express_name":"",
						"express_num":"",
						"contact_name":"",
						"contact_tel":"",
						"run_status":"2",
						"power_status":"1",
						"offshelf_info":"",
						"onshelf_time":"2021-09-01 09:18:59",
						"offshelf_time":null,
						"ipmi_status":"0",
						"ipmi_url":"",
						"create_time":"2021-08-20 16:37:48"
					}
				],
				"service":[
					{
						"guid":"1709668383929011",
						"type":"upgrade",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 11:38:43"
					},
					{
						"guid":"1709664168898432",
						"type":"install",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 10:32:29"
					},
					{
						"guid":"1709662675419834",
						"type":"setpsw",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 10:15:51"
					},
					{
						"guid":"1709662094872946",
						"type":"restart",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:54:07"
					},
					{
						"guid":"1709661758293373",
						"type":"start",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:44:25"
					},
					{
						"guid":"1709660451124821",
						"type":"stop",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:39:08"
					},
					{
						"guid":"1708954967762348",
						"type":"install",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:38:12"
					},
					{
						"guid":"1708600766577845",
						"type":"onshelf",
						"status":"2",
						"respondTime":null,
						"finishTime":"2021-09-01 09:18:59"
					}
				]
			}
		}
	}

**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|json | {} |返回信息体
data.idc|json | {} |业务信息
data.idc.guid|string | 1708598562849469 |业务guid
data.idc.userId|string | 1100134 |合作商id
data.idc.lineId|string | 1623153153846762 |线路guid
data.idc.size|string | 1 |尺寸  1 1U  2 2U 99 整柜
data.idc.linePowerId|string | 1693202236354353 |电源guid
data.idc.bandwidth|string | 2 |业务带宽
data.idc.defense|string | 2 |防御
data.idc.ipnum|string | 5 |ip数量
data.idc.port|string |30 |端口，多个端口用英文逗号隔开
data.idc.serverNum|string |30 |业务下机器数量
data.idc.buyTime|string |2021-08-20 16:02:46 |业务的购买时间
data.idc.startTime|string |2021-08-25 16:02:46 |业务的开始时间
data.idc.endTime|string |2021-10-25 16:02:46 |业务的结束时间
data.idc.orderStatus|string |1 |订单状态：0开通中， 1正常 ， 3已过期 , -2已删除
data.idc.runStatus|string |1 |（已取消）运行状态（ 0  开通中（业务开通，等待客户寄送机器）；1  待上架（机房签收机器，业务已开通，开始计费）；2  运行中（机器上架并正常运行）；3  已回收（暂保留，回收的机器48小时内可还原）；4  已过期（到期业务48小时后释放资源）；5  已删除（资源已释放，待下架）；6  已下架（机器已寄回客户）；7  重新开通中（到期后续费了）
data.idc.actStatus|string |0 |操作状态：0  无操作；4  升级中
data.idc.blockStatus|string |0 |操作状态：0  无操作；4  升级中
data.idc.remark|string | |备注
data.idc.arpStatus|string | 1|备是否开启ARP防护，0不开启， 1开启
data.idc.ips|array | []|ip信息  可能存在多个
data.idc.ips.idcIp|string |88.66.55.204|ip
data.idc.ips.mask|string |255.255.255.0|mask地址
data.idc.ips.gateway|string |88.66.55.1|网关
data.idc.ips.status|string |1|状态 1 正常 ， -1 已释放
data.idc.devices|json |1|设备信息 可能存在多个
data.idc.devices.guid|json |1|设备guid
data.idc.devices.name|string |托管|设备名称
data.idc.devices.cabinet_code|string |ZHzy001|机柜编号
data.idc.devices.seat_code|string |45|机位编号
data.idc.devices.size|string |1|尺寸
data.idc.devices.type|string |server|枚举类型 设备设备类型：server服务器 , switch交换机 ,firewall 防火墙 , router路由器
data.idc.devices.ip|string |88.66.55.203|设备主IP，只能填写1个
data.idc.devices.system_id|string |1671072370276278|操作系统guid
data.idc.devices.macaddr|string ||外网网卡MAC
data.idc.devices.content|string |上架托管服务器|内容
data.idc.devices.send_type|string |0|寄送方式：0快递 ， 1自行配送
data.idc.devices.express_name|string ||快递名称
data.idc.devices.express_num|string ||快递单号
data.idc.devices.contact_name|string ||联系姓名
data.idc.devices.contact_tel|string ||联系电话
data.idc.devices.run_status|string |2|运行状态：1待上架 ， 2运行中 ，3重启中 , 4重装中， 5重设密码中 , 6联网中 , 7已断网 ， 8已下架  ， 9 IPMI开通中, 10 重设IPMI密码中 , 11 关机中 ，12 开机中 ,-1已删除
data.idc.devices.power_status|string |1|电源状态：0已关机 1运行中
data.idc.devices.offshelf_info|string ||下架信息
data.idc.devices.onshelf_time|string |2021-09-01 09:18:59|上架时间
data.idc.devices.ipmi_status|string |0|IPMI状态：0未申请 ， 1已开通 ， 2不支持
data.idc.devices.ipmi_url|string ||IPMI URL
data.idc.devices.create_time|string |2021-08-20 16:37:48|创建时间
data.idc.service|json |{}|服务信息
data.idc.service.guid|string |1709668383929011|服务guid
data.idc.service.type|string |upgrade|类型：restart重启、setpsw重设密码、install重装、upgrade升级、onshelf上架、offshelf下架、expirerenew过期续费、expired过期
data.idc.service.status|string |2|枚举类型 完成状态，0未完成 1处理中 2 处理完成  3处理失败
data.idc.service.respondTime|string ||响应时间
data.idc.service.finishTime|string |2021-09-01 11:38:43|完成时间
data.idc.service.finishTime|string |2021-09-01 11:38:43|完成时间

### 上架
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | onshelf |购买
lineid | 是| string | create |线路唯一id
size | 是| string | 1 |尺寸  1 1U  2 2u  99 整柜
linePowerId | 是| string | 1685024959472262 |线路电源的唯一id
ipnum | 是| string | 1 |ip数量
bandwidth | 是| string | 1 |带宽
defense | 是| string |0 |防御
months | 是| string |1 |购买的月份数
num | 是| string |1 |数量 台数
arpStatus | 是| string |1 |arp状态  1开启  0 不开启
clientUserID | 是| string |1100199 |客户端的用户id
clientOrderNo | 是| string |490682790550753199 |客户端订单
agent_order_no | 是| string |490682790550753199|客户端订单

**返回示例**

### 关机
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | stop |关机
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
clientUserID | 是| string | 1100199 |本地用户id

**返回示例**

{
		"code":0,
		"message":"success"
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 开机
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | start |开机
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
clientUserID | 是| string | 1100199 |本地用户id

**返回示例**

{
		"code":0,
		"message":"success"
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 重启
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | restart |重启
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
clientUserID | 是| string | 1100199 |本地用户id

**返回示例**

{
		"code":0,
		"message":"success"
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 设置密码
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | setpsw |重设密码
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
clientUserID | 是| string | 1100199 |本地用户id
password | 是| string | YTUzNTAyOTI3OSE= |密码 base64之后的字段
name | 是| string | root |用户名

**返回示例**

{
		"code":0,
		"message":"success"
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 重装系统
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | install |重装系统
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
clientUserID | 是| string | 1100199 |本地用户id
password | 是| string | YTUzNTAyOTI3OSE= |密码 base64之后的字段
systemID | 是| string | 1671072370276278 |操作系统guid
formatDiskette | 是| string | 1 |1是 0否 是否格式化磁盘
partition| 是| string |  |默认分区 不填。按照默认分区

**返回示例**

{
		"code":0,
		"message":"success"
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 续费
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | renew |续费
guid | 是| string | 1708598562849469 |托管业务guid
device_guid | 是| string | 1708600766583144 |设备guid ,多台设备用逗号隔开
service_guid | 是| string | 1709660451124821 |服务guid，生成方法base_convert(uniqid(), 16, 10)
months | 是| string | 1 |续费月份数
clientUserID | 是| string | 1100199 |本地用户id
clientOrderNo | 是| string | 360683807950290199 |本地订单号 18位
agent_order_no | 是| string | 360683807950290199 |本地订单号 18位
clientEndTime | 是| string | 2021-09-25 16:02:46 |本地业务结束时间

**返回示例**

{
		"request_id":"61834bc6c86a9-1kbgwl-jmm1jmmo-1064405944",
		"code":0,
		"message":"success",
		"data":[
			
		]
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 升级
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | upgrade |升级
guid | 是| string | 1708598562849469 |托管业务guid
ipnum | 是| string | 1 |升级ip数量
bandwidth | 是| string | 2 |升级的带宽
defense | 是| string | 5 |防御
linePowerId | 是| string | 1693202236354353 |电源guid
portnum | 是| string | 0 |端口数量
clientUserID | 是| string | 1100199 |本地用户id
clientOrderNo | 是| string | 250683810397896199 |本地订单号 18位
agent_order_no | 是| string | 250683810397896199 |本地订单号 18位

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
			"ips":[
				{
					"ip":"88.66.55.204",
					"gateway":"88.66.55.1",
					"mask":"255.255.255.0"
				}
			]
		}
	}
	
**返回值**

### 预约降配
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | degrade |预约降配
guid | 是| string | 1708598562849469 |托管业务guid
param | 是| json | {} |降配的参数集合 可能存在多个降配项
param.item | 是| json | {} |降配项目   power 电源 ,bandwidth 带宽，ip降配ip
param.value | 是| string |1685024959472262|降配项目  电源guid,带宽降配的值，降配ip的值
param.date | 是| string |2021-10-01 11:39:00|降配的日期
clientUserID | 是| string | 1100199 |本地用户id

{
		"userid":"1100134",
		"action":"degrade",
		"dataType":"json",
		"sign":"efa3e98c6fd6672237aa4b95e9c3784f",
		"module":"idc",
		"time":1630467611,
		"taskid":"734439",
		"guid":"1708598562849469",
		"param":"[{"item":"power","value":"1685024959472262","date":"2021-10-01 11:39:00"},{"item":"bandwidth","value":"1","date":"2021-10-01 11:39:00"},{"item":"ip","value":"88.66.55.204","date":"2021-10-01 11:39:00"}]",
		"clientUserID":"1100199",
		"notifyUrl":null,
		"__version__":"9.9.9",
		"__system_type__":"zkeys_agent_multi",
		"vtime":"20210713"
	}

**返回示例**

{
		"code":0,
		"message":"success",
		"data":[
			{
				"guid":"1709676792837904",
				"idc_id":"816",
				"item":"bandwidth",
				"value":"1",
				"date":"2021-10-02 11:39:00"
			},
			{
				"guid":"1709676792837905",
				"idc_id":"816",
				"item":"power",
				"value":"1685024959472262",
				"date":"2021-10-02 11:39:00"
			},
			{
				"guid":"1709676792838598",
				"idc_id":"816",
				"item":"ip",
				"value":"88.66.55.204",
				"date":"2021-10-02 11:39:00"
			}
		]
	}
	
**返回值**

### 取消降配
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | cancel_degrade |取消降配
guid | 是| string | 1708598562849469 |托管业务guid
degrade_guid | 是| string | 1709676792838598 |预约降配guid
clientUserID | 是| string | 1100199 |本地用户id

**返回示例**

{
		"code":0,
		"message":"success",

}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 申请机房授权
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | grant_apply |申请机房授权
device_guid | 是| string | 1708600766583144,1707128335401228 |设备guid,多个业务有逗号隔开
line_id | 是| string | 1623153153846762|线路guid
apply_time| 是| string |2021-09-01 18:00:00|申请日期
grant_apply_user | 是| array |[]|申请的用户信息，可能存在多个
grant_apply_user.name | 是| string |特使申请机房授权|用户名称
grant_apply_user.tel | 是| string |13794481688|手机号
grant_apply_user.idnum | 是| string |360189890055555555|证件号
grant_apply_user.attachment_id | 是| string |id|附件id
grant_apply_user.attachment_api_guid | 是| string |id|附件guid （查看托管机房授权上传接口）
grant_apply_user.attachment_password | 是| string |$2y$10$1Gtsl7UCYqK2r|附件密码（查看托管机房授权上传接口）
clientUserID | 是| string | 1100199 |本地用户id

{
			"userid":"1100134",
			"action":"grant_apply",
			"dataType":"json",
			"sign":"5a04f6de48b8168a8c2541e8efe1cea7",
			"module":"idc",
			"time":1630487384,
			"device_guid":"1708600766583144,1707128335401228",
			"content":"申请机房授权测试api接口",
			"line_id":"1623153153846762",
			"apply_time":"2021-09-01 18:00:00",
			"grant_apply_user":"[{"name":"\u7532\u4e59","tel":"13794481688","idnum":"360189890055555555","attachment_id":"14494","attachment_api_guid":"612f430f-0861-0190-ff34-2401d4542f6b","attachment_password":"$2y$10$1Gtsl7UCYqK2rksS0PWaVenVMS4FD6G1KBU9OnD0.NvBuT.CVbnPC"}]",
			"__version__":"9.9.9",
			"__system_type__":"zkeys_agent_multi",
			"vtime":"20210713"
		}

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
				"guid":"1709689939291129",
				}
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|json | data |放回数据的结构体
data.guid|string| 1709689939291129 |机房授权的guid

### 修改机房授权
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | grant_apply |申请机房授权
device_guid | 是| string | 1708600766583144,1707128335401228 |设备guid,多个业务有逗号隔开
line_id | 是| string | 1623153153846762|线路guid
apply_time| 是| string |2021-09-01 18:00:00|申请日期
grant_apply_user | 是| array |[]|申请的用户信息，可能存在多个
grant_apply_user.name | 是| string |特使申请机房授权|用户名称
grant_apply_user.tel | 是| string |13794481688|手机号
grant_apply_user.idnum | 是| string |360189890055555555|证件号
grant_apply_user.attachment_id | 是| string |id|附件id
grant_apply_user.attachment_api_guid | 是| string |id|附件guid （查看托管机房授权上传接口）
grant_apply_user.attachment_password | 是| string |$2y$10$1Gtsl7UCYqK2r|附件密码（查看托管机房授权上传接口）
grant_apply_guid | 是| string | 1709689939291129 |机房授权的guid(申请时返回)

{
			"userid":"1100134",
			"action":"grant_apply",
			"dataType":"json",
			"sign":"5a04f6de48b8168a8c2541e8efe1cea7",
			"module":"idc",
			"time":1630487384,
			"device_guid":"1708600766583144,1707128335401228",
			"content":"申请机房授权测试api接口",
			"line_id":"1623153153846762",
			"apply_time":"2021-09-01 18:00:00",
			"grant_apply_user":"[{"name":"\u7532\u4e59","tel":"13794481688","idnum":"360189890055555555","attachment_id":"14494","attachment_api_guid":"612f430f-0861-0190-ff34-2401d4542f6b","attachment_password":"$2y$10$1Gtsl7UCYqK2rksS0PWaVenVMS4FD6G1KBU9OnD0.NvBuT.CVbnPC"}]",
			 "grant_apply_guid":"1709689939291129",
			"__version__":"9.9.9",
			"__system_type__":"zkeys_agent_multi",
			"vtime":"20210713"
		}

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
				"guid":"1709756571608731",
				}
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|json | data |放回数据的结构体
data.guid|string| 1709756571608731 |修改时，忽略

### 获取单个机房授权
  
**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getidcgrantapply |获取机房授权信息
guid | 是| string | 1709689939291129 |机房授权guid (新增是返回的guid)

**返回示例**

{
		"code":0,
		"data":{
			"pages":1,
			"items":1,
			"grant_apply_list":[
				{
					"guid":"1709689939291129",
					"line_id":"1623153153846762",
					"device_guid":"1707128335401228,1708600766583144",
					"status":"0",
					"content":"申请机房授权测试api接口",
					"create_time":"2021-09-01 17:09:44",
					"apply_time":"2021-09-03 18:00:00",
					"handle_time":null,
					"handle_text":null,
					"grant_apply_user":[
						{
							"name":"甲乙",
							"idnum":"360189890055555555",
							"tel":"13794481688"
						}
					]
				}
			]
		}
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息
data|json | data |放回数据的结构体
data.pages|string| 1 |页码数
data.items|string| 1 |总数
data.grant_apply_list|json| {} |机房信息
data.grant_apply_list.guid|string| 1709689939291129 |机房授权guid
data.grant_apply_list.line_id|string| 1623153153846762 |线路guid
data.grant_apply_list.line_id|device_guid| 1707128335401228,1708600766583144 |设备guid,多个用逗号隔开
data.grant_apply_list.status|string| 0 |状态，0申请中 ， 1通过,2拒绝
data.grant_apply_list.content|string|申请机房授权测试api接口 |申请的内容
data.grant_apply_list.create_time|string|2021-09-01 17:09:44 |创建时间
data.grant_apply_list.apply_time|string|2021-09-03 18:00:00 |申请时间
data.grant_apply_list.handle_time|string|null |处理时间
data.grant_apply_list.handle_text|string|null |处理内容
data.grant_apply_list.grant_apply_user|array|[] |申请的用户信息 可能存在多个
data.grant_apply_list.grant_apply_user.name|string|阿帕云 |用户名
data.grant_apply_list.grant_apply_user.idnum|string|360189890055555555 |身份证号
data.grant_apply_list.grant_apply_user.tel|string|13794481688 |手机号

### 获取多个机房授权

**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | getidcgrantapply |获取机房授权信息
page | 是| string | 1 |页码数

**返回示例**

### 下架

**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | offshelf |下架
guid | 是| string | 1708598562849469 |业务guid
device_guid | 是| string | 1708600766583144 |设备guid
expressName | 是| string | 顺丰 |快递名称
receiverName | 是| string | 阿帕云 |收件人名称
receiverTel | 是| string | 13794481688 |收件人手机号
receiverProvince | 是| string | 广东省 |省
receiverCity | 是| string | 深圳市 |市
receiverArea | 是| string | 南山区 |区
receiverAddress | 是| string | 科技湾生态园B5栋 |地址
packType | 是| string | carton |打包类型 carton 纸箱打包   wooden 木架 
isInsured | 是| string | 1 |是否保价  1保价 0不保价
insuredPrice | 是| string | 100 |保价价格
clientUserID | 是| string | 1100199 |本机用户id

**返回示例**

{
		"code":0,
		"message":"success",
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

### 退款

**请求参数**

参数 |必选| 类型| 示例值 | 说明
 -   |- | - |  - |- 
action | 是| string | refund |退款
guid | 是| string | 1708598562849469 |业务guid
module | 是| string | common |替换公共参数中的module
productType | 是| string | idc |托管

**返回示例**

{
		"code":0,
		"message":"success",
	}
	
**返回值**

参数 | 类型/长度 | 示例值 | 说明
 -   | - |  - |- 
code| 	int |  	0 |返回状态 0:成功 , 1:失败
message|string | success |反馈信息

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎开放API

文档首页

云业务管理系统（国内版）

18+

1000+

30+

5+