欢乐颂小说结局,完美世界txt下载,有声

## 調(diào)用方式

**請(qǐng)求地址**

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

**請(qǐng)求方法**

請(qǐng)求方法：POST
Content-Type 類型：application/x-www-form-urlencoded

**公共參數(shù)**

說(shuō)明：公共請(qǐng)求參數(shù)與返回?cái)?shù)據(jù)說(shuō)明，再具體接口中不再重復(fù)列出和說(shuō)明。

| 參數(shù)                | 必選 | 類型/長(zhǎng)度 | 示例值                                   | 說(shuō)明                                                         |
| ------------------- | ---- | --------- | ---------------------------------------- | ------------------------------------------------------------ |
| module              | 是   | string    | server                                   | 業(yè)務(wù)類型                                                     |
| action              | 是   | string    | getzones                                 | 操作名稱，后續(xù)接口中，替換此參數(shù)                             |
| userid              | 是   | int       | 1                                        | 會(huì)員ID                                                       |
| time                | 是   | int       | 1471331587                               | 當(dāng)前UNIX時(shí)間戳                                               |
| sign                | 是   | string    | ebb198fa8f884f9544b94bb16e8e3af3         | 權(quán)限令牌，生成規(guī)則如下： sign（大陸版） = md5(module+ 'zkeys.api@2019'+action + userid + 接口密鑰 + time) |
| taskid              | 是   | int       | 12                                       | 您本地請(qǐng)求的任務(wù)編號(hào)，異步回調(diào)時(shí)返回會(huì)攜帶該參數(shù)             |
| dataType            | 否   | string    | json                                     | 返回格式，XML/JSON（可選），默認(rèn)json                         |
| version             | 是   | string    | 6.0.1                                    | 阿帕云引擎版本，如自行對(duì)接，可固定：9.9.9                    |
| system_type         | 是   | string    | zkeys_web                                | 阿帕云引擎類型，如自行對(duì)接，可固定：zkeys_web                |
| vtime               | 是   | string    | 20220303                                 | 當(dāng)天日期，格式：YYYYMMDD                                     |
| auth_name           | 是   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶實(shí)名姓名       | 張三                                                         |
| auth_mobile         | 是   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶實(shí)名手機(jī)號(hào)碼   | 13111111111                                                  |
| auth_idnum          | 是   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶實(shí)名身份證號(hào)碼 | 430111199002122222                                           |
| auth_bank_account   | 否   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶實(shí)名銀行卡號(hào)   | 411211199104151214                                           |
| auth_from_ip        | 是   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶最后登錄IP     | 192.168.1.1                                                  |
| auth_client_user_id | 是   | string    | 業(yè)務(wù)操作接口傳遞，終端客戶用戶id         | 1                                                            |

##  同步數(shù)據(jù)

### 同步可用區(qū)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型   | 示例值   | 說(shuō)明     |
| ------ | ---- | ------ | -------- | -------- |
| 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"
	       	 }
	    	]
		}
	}

**返回值**

| 參數(shù)                       | 類型/長(zhǎng)度 | 示例值           | 說(shuō)明                                |
| -------------------------- | --------- | ---------------- | ----------------------------------- |
| code                       | int       | 0                | 返回狀態(tài) 0:成功 , 1:失敗            |
| message                    | string    | success          | 反饋信息                            |
| data                       | json      | json             | 返回的可用區(qū)結(jié)構(gòu)體                  |
| data.zones                 | array     | 可用區(qū)數(shù)據(jù)       | 可用區(qū)數(shù)據(jù)                          |
| data.zones.guid            | string    | 1625139389577044 | 可用區(qū)GUID                          |
| data.zones.name            | string    | 深圳一區(qū)         | 可用區(qū)名稱                          |
| data.zones.max_year        | string    | 3                | 可用區(qū)下業(yè)務(wù)最大購(gòu)買時(shí)長(zhǎng)            |
| data.zones.identityStatus  | string    | 1                | 本可用區(qū)強(qiáng)制實(shí)名認(rèn)證 1：是 0：否    |
| data.zones.whiteListStatus | string    | 1                | 本可用區(qū)強(qiáng)制提交白名單  1：是 0：否 |
| data.zones.icp_status      | string    | 1                | 本可用區(qū)支持提交備案  1：是 0：否   |

### 同步線路

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型   | 示例值      | 說(shuō)明          |
| ------ | ---- | ------ | ----------- | ------------- |
| action | 是   | string | getlines    | 接口名稱      |
| type   | 是   | string | server_line | 類型 獲取線路 |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"lines": [
				{
					"guid": "1628966421344185",
					"line_guid": "1625139389577044",
					"line_type": "local",
					"line_auth": "0",
					"name": "Hyper-V\u7ebf\u8def2-150",
					"descript": "190\u5bbf\u4e3b\u673a",
					"introUrl": "http:\/\/www.baidu.com",
					"buyStatus": "1",
					"upgradeStatus": "1",
					"renewStatus": "1",
					"harddiskMinNum": "1",
					"harddiskMaxNum": "5",
					"harddiskMinSize": "10",
					"harddiskMaxSize": "1000",
					"harddiskStep": "10",
					"harddiskPrice": 10,
					"bandwidthMinSize": "30",
					"bandwidthMaxSize": "300",
					"bandwidth_free_size": "0",
					"bandwidth_in_type": "2",
					"bandwidth_in_value": "10",
					"bandwidth1Price": 1,
					"bandwidth2Price": 2,
					"bandwidth3Price": 3,
					"bandwidth4Price": 5,
					"bandwidth5Price": 6,
					"bandwidth6Price": 9,
					"defenseMinSize": "5",
					"defenseMaxSize": "300",
					"defenseFreeSize": "0",
					"defensePrice": 10,
					"defense_size": "5,10,20,30,50,100,200,300",
					"lifeTime": null,
					"months": "1,2,3,4,5,6,7,8,9,12,24,36",
					"functions": "createsnapshot,revertsnapshot,removesnapshot,renewsnapshot,setvnc,resource_display,reset_vnc_password,security_policy",
					"sortID": "22",
					"snap_price_type": "0",
					"snap_price_buy_day": "-1.00",
					"snap_price_buy_month": "1.00",
					"snap_open_max": "0",
					"snap_open_days": "",
					"backup_price_type": "0",
					"backup_price_buy_day": "-1.00",
					"backup_price_buy_month": "-1.00",
					"backup_open_days": "",
					"day_for_month": "1",
					"remark": "150",
					"temp_upgrade_status": "0",
					"renew_degrade_status": "1",
					"temp_upgrade_times_limit": "0",
					"temp_upgrade_bandwidth_price": "0.00",
					"temp_upgrade_min_hours": "0",
					"vnc_status": "0",
					"auto_dns": "114.114.114.114",
					"api_migration_status": "0",
					"api_migration_line_id": "0",
					"move_status": "0",
					"vnc_url": "",
					"retention_days": "3",
					"max_open_num": "20",
					"append_ip_status": "1",
					"append_ip_price": "1.11",
					"resources_type": "0",
					"win_linux_switch": "1",
					"sync_buy_status": "1",
					"core_price_data": [
						{
							"name": "1H1G",
							"cpu": "1",
							"ram": "1",
							"price": 95,
							"windows_price": 95,
							"recommend_status": "0",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":10,\"defense\":10}"
						},
						{
							"name": "2H2G",
							"cpu": "2",
							"ram": "2",
							"price": 190,
							"windows_price": 190,
							"recommend_status": "0",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":10,\"defense\":5}"
						},
						{
							"name": "3",
							"cpu": "3",
							"ram": "3",
							"price": 30,
							"windows_price": 30,
							"recommend_status": "0",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "4H4G",
							"cpu": "4",
							"ram": "4",
							"price": 380,
							"windows_price": 380,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "8484",
							"cpu": "8",
							"ram": "4",
							"price": 21,
							"windows_price": 21,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "128H128G",
							"cpu": "50",
							"ram": "50",
							"price": 100,
							"windows_price": 100,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "99H1024G",
							"cpu": "99",
							"ram": "1024",
							"price": 3000,
							"windows_price": 2900,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "3",
							"cpu": "64",
							"ram": "64",
							"price": 2000,
							"windows_price": 1900,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "4",
							"cpu": "64",
							"ram": "100",
							"price": 2100,
							"windows_price": 2000,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "5",
							"cpu": "64",
							"ram": "156",
							"price": 2200,
							"windows_price": 2100,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "6",
							"cpu": "64",
							"ram": "180",
							"price": 2300,
							"windows_price": 2200,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						},
						{
							"name": "7",
							"cpu": "64",
							"ram": "200",
							"price": 2500,
							"windows_price": 2400,
							"recommend_status": "1",
							"recommend_content": "{\"harddisk\":10,\"bandwidth\":1,\"defense\":5}"
						}
					]
				}
			],
			"version": 1
		}
	}

**返回值**

| 參數(shù)                                         | 類型/長(zhǎng)度 | 示例值                    | 說(shuō)明                                                         |
| -------------------------------------------- | --------- | ------------------------- | ------------------------------------------------------------ |
| code                                         | int       | 0                         | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                                      | string    | success                   | 反饋信息                                                     |
| data                                         | json      | json                      | 返回的可用區(qū)結(jié)構(gòu)體                                           |
| data.lines                                   | array     | 可用區(qū)數(shù)據(jù)                | 可用區(qū)數(shù)據(jù)                                                   |
| data.lines.guid                              | string    | 1628966421344185          | 線路GUID                                                     |
| data.lines.line_type                         | string    | local                     | 線路類型  local自產(chǎn)線路，zkeys 大陸線路，niaoyun鳥云線路，zkeys_intl 國(guó)際線路 |
| data.lines.line_auth                         | string    | 0                         | 線路權(quán)限 0 不限制，1 僅本站會(huì)員使用 2 僅代理用戶使用         |
| data.lines.name                              | string    | 深圳一區(qū)                  | 線路名稱                                                     |
| data.lines.descript                          | string    | 深圳一區(qū)                  | 線路描述                                                     |
| data.lines.introUrl                          | string    | www.zkeys.com             | 機(jī)房介紹鏈接                                                 |
| data.lines.buyStatus                         | string    | 1                         | 購(gòu)買狀態(tài)  1：開放購(gòu)買 0：關(guān)閉購(gòu)買                            |
| data.lines.upgradeStatus                     | string    | 1                         | 升級(jí)狀態(tài)  1：開放升級(jí) 0：關(guān)閉升級(jí)                            |
| data.lines.renewStatus                       | string    | 1                         | 續(xù)費(fèi)狀態(tài)  1：開放續(xù)費(fèi) 0：關(guān)閉續(xù)費(fèi)                            |
| data.lines.harddiskMinNum                    | string    | 1                         | 磁盤可掛載數(shù)量的最小值                                       |
| data.lines.harddiskMaxNum                    | string    | 5                         | 磁盤可掛載數(shù)量的最大值                                       |
| data.lines.harddiskMinSize                   | string    | 10                        | 磁盤最小容量 10G                                             |
| data.lines.harddiskMaxSize                   | string    | 1000                      | 磁盤最大容量 1000G                                           |
| data.lines.harddiskStep                      | string    | 10                        | 磁盤容量步長(zhǎng)                                                 |
| data.lines.harddiskPrice                     | string    | 10                        | 磁盤單價(jià) 1G 10 RMB                                           |
| data.lines.bandwidthMinSize                  | string    | 10                        | 帶寬最小值 10M                                               |
| data.lines.bandwidthMaxSize                  | string    | 300                       | 帶寬最大值 300M                                              |
| data.lines.bandwidth_free_size               | string    | 0                         | 贈(zèng)送帶寬 0M                                                  |
| data.lines.bandwidth_in_type                 | string    | 1                         | 帶寬下行限制類型 1，固定值 2，對(duì)等閾值 說(shuō)明： 選擇固定值時(shí)，根據(jù)帶寬下行限制設(shè)置的值限制最大下行，如設(shè)置10M，則業(yè)務(wù)購(gòu)買1M帶寬或20M帶寬，帶寬下行最大都為10M；選擇對(duì)等筏值時(shí)，會(huì)根據(jù)帶寬下行限制值去限制下行，如限制值為10，則該線路下的業(yè)務(wù)帶寬低于10M時(shí)，最大下行為10M，高于10M帶寬時(shí)，下行與上行帶寬值對(duì)等，注：Hyper-V不支持下行限制 |
| data.lines.bandwidth_in_value                | string    | 10                        | 帶寬下行限制值 10M                                           |
| data.lines.bandwidth1Price                   | string    | 1                         | 設(shè)置 0-1M 帶寬的價(jià)格，單位：元/月  帶寬階梯計(jì)算價(jià)格          |
| data.lines.bandwidth2Price                   | string    | 2                         | 設(shè)置 1-2M 帶寬的價(jià)格，單位：元/月                            |
| data.lines.bandwidth3Price                   | string    | 3                         | 設(shè)置 2-3M 帶寬的價(jià)格，單位：元/月                            |
| data.lines.bandwidth4Price                   | string    | 4                         | 設(shè)置 3-4M 帶寬的價(jià)格，單位：元/月                            |
| data.lines.bandwidth5Price                   | string    | 5                         | 設(shè)置 4-5M 帶寬的價(jià)格，單位：元/月                            |
| data.lines.bandwidth6Price                   | string    | 6                         | 設(shè)置 5-6M 帶寬的價(jià)格，單位：元/月                            |
| data.lines.defenseMinSize                    | string    | 5                         | 防御最小值 5G                                                |
| data.lines.defenseMaxSize                    | string    | 300                       | 防御最大值 300G                                              |
| data.lines.defenseFreeSize                   | string    | 0                         | 免費(fèi)防御值 0G                                                |
| data.lines.defensePrice                      | string    | 0                         | 防御的價(jià)格                                                   |
| data.lines.defense_size                      | string    | 5,10,20,30,50,100,200,300 | 防御值可選集合                                               |
| data.lines.lifeTime                          | string    | 10                        | 存活時(shí)長(zhǎng)  單位年                                             |
| data.lines.months                            | string    | 1                         | 可購(gòu)買月份數(shù) 1,2,3,4,5,6,7,8,9,12,24,36  單位月              |
| data.lines.functions                         | string    | setvnc                    | 線路開放的功能 createsnapshot,revertsnapshot,removesnapshot,renewsnapshot,setvnc,resource_display,reset_vnc_password,security_policy |
| data.lines.sortID                            | string    | 1                         | 排序數(shù)字(數(shù)值越小越靠前)                                     |
| data.lines.snap_price_type                   | string    | 0                         | 快照開放狀態(tài)：0全開放                                        |
| data.lines.snap_price_buy_day                | string    | 0                         | 快照按天計(jì)費(fèi)單價(jià)，單位：元/天/G                              |
| data.lines.snap_price_buy_month              | string    | 0                         | 快照按月計(jì)費(fèi)單價(jià)，單位：元/月/G                              |
| data.lines.snap_open_max                     | string    | 5                         | 單臺(tái)機(jī)器最大可開通快照數(shù)量                                   |
| data.lines.snap_open_days                    | string    | 5                         | 快照支持按天購(gòu)買的天數(shù)                                       |
| data.lines.backup_price_type                 | string    | 5                         | 備份開放狀態(tài)：0全開放                                        |
| data.lines.backup_price_buy_day              | string    | 5                         | 備份按天計(jì)費(fèi)單價(jià)，單位：元/天/G                              |
| data.lines.backup_price_buy_month            | string    | 5                         | 備份按月計(jì)費(fèi)單價(jià)，單位：元/月/G                              |
| data.lines.backup_open_days                  | string    | 5                         | 備份支持按天購(gòu)買的天數(shù)                                       |
| data.lines.day_for_month                     | string    | 25                        | 每月天數(shù)（月計(jì)費(fèi)天數(shù)）                                       |
| data.lines.remark                            | string    | 深圳一區(qū)                  | 線路備注                                                     |
| data.lines.temp_upgrade_status               | string    | 0                         | 是否允許臨時(shí)升級(jí)：0否                                        |
| data.lines.renew_degrade_status              | string    | 0                         | 是否允許續(xù)費(fèi)降配：0否                                        |
| data.lines.temp_upgrade_times_limit          | string    | 0                         | 允許臨時(shí)升級(jí)重疊次數(shù)：0不允許                                |
| data.lines.temp_upgrade_bandwidth_price      | string    | 1                         | 臨時(shí)升級(jí)帶寬單價(jià)，單位：元/M/小時(shí)                            |
| data.lines.temp_upgrade_min_hours            | string    | 0                         | 臨時(shí)升級(jí)最短時(shí)長(zhǎng)，0則不限制                                  |
| data.lines.vnc_status                        | string    | 0                         | 是否支持VNC：0不支持 1支持                                   |
| data.lines.auto_dns                          | string    | 0                         | 客戶機(jī)DNS                                                    |
| data.lines.api_migration_status              | string    | 0                         | 當(dāng)前線路是否支持API申請(qǐng)遷移，0不支持                         |
| data.lines.api_migration_line_id             | string    | 0                         | 當(dāng)前線路允許遷移到哪些線路，多個(gè)用半角逗號(hào)隔開               |
| data.lines.move_status                       | string    | 0                         | 是否已遷移                                                   |
| data.lines.vnc_url                           | string    | http://www.vnc.com        | VNC地址                                                      |
| data.lines.retention_days                    | string    | 5                         | 到期候保留時(shí)長(zhǎng)                                               |
| data.lines.max_open_num                      | string    | 20                        | 單次可開通的機(jī)器數(shù)量最大值                                   |
| data.lines.append_ip_status                  | string    | 0                         | 彈性IP開關(guān)：  0關(guān)閉  1開啟                                   |
| data.lines.append_ip_price                   | string    | 10                        | 增加彈性IP價(jià)格：?jiǎn)挝?元/個(gè)/月                                |
| data.lines.resources_type                    | string    | 0                         | 資源類型：0ZKEYS、1小鳥云、2百度云、3騰訊云、4華為云、5京東云 |
| data.lines.win_linux_switch                  | string    | 0                         | 是否允許win linux互相切換：0否、1是                          |
| data.lines.sync_buy_status                   | string    | 0                         | 同步上級(jí)狀態(tài)                                                 |
| data.lines.core_price_data                   | array     | []                        | 核心配置                                                     |
| data.lines.core_price_data.name              | string    | 1H1G                      | 核心配置名稱 1H1G                                            |
| data.lines.core_price_data.cpu               | string    | 1                         | CPU  1核                                                     |
| data.lines.core_price_data.ram               | string    | 1                         | 內(nèi)存  1G                                                     |
| data.lines.core_price_data.price             | string    | 1                         | linux價(jià)格  元                                                |
| data.lines.core_price_data.windows_price     | string    | 1                         | windows價(jià)格 元                                               |
| data.lines.core_price_data.recommend_status  | string    | 1                         | 是否推薦 0不推薦（默認(rèn)）  1推薦                              |
| data.lines.core_price_data.recommend_content | string    | 1                         | 推薦配置，為json結(jié)構(gòu) ，如{"bandwidth":1,"harddisk":10,"defense":0} |
| version                                      | string    | 1                         | 版本                                                         |

### 同步操作系統(tǒng)

**請(qǐng)求參數(shù)**

| 參數(shù)        | 必選 | 類型   | 示例值     | 說(shuō)明       |
| ----------- | ---- | ------ | ---------- | ---------- |
| action      | 是   | string | getsystems | 接口名稱   |
| page_mode   | 是   | string | 1          | 頁(yè)碼       |
| page_length | 是   | string | 50         | 單頁(yè)的數(shù)量 |

**返回示例**

{
		"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"
	       	 }
	    	]
		}
	}

**返回值**

| 參數(shù)                            | 類型/長(zhǎng)度 | 示例值               | 說(shuō)明                                                         |
| ------------------------------- | --------- | -------------------- | ------------------------------------------------------------ |
| code                            | int       | 0                    | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                         | string    | success              | 反饋信息                                                     |
| data                            | json      | json                 | 返回的可用區(qū)結(jié)構(gòu)體                                           |
| data.pages                      | int       | 1                    | 頁(yè)碼數(shù)                                                       |
| data.items                      | int       | 116                  | 總數(shù)                                                         |
| data.systems                    | array     | []                   | 操作系統(tǒng)信息                                                 |
| data.systems.distinct_id        | string    | 1                    | 特殊id                                                       |
| data.systems.id                 | string    | 1                    | 特殊id                                                       |
| data.systems.guid               | string    | 1695196885222115     | 操作系統(tǒng)GUID                                                 |
| data.systems.class_guid         | string    | 1666193469952094     | 操作系統(tǒng)類型GUID                                             |
| data.systems.name               | string    | 6.8 64位             | 操作系統(tǒng)名稱                                                 |
| data.systems.login_name         | string    | root                 | 操作系統(tǒng)登陸名稱                                             |
| data.systems.port               | string    | 22                   | 操作系統(tǒng)登陸端口                                             |
| data.systems.mirror_name        | string    | root                 | 鏡像名稱                                                     |
| data.systems.cpu_limit          | string    | 0                    | cpu限制  購(gòu)買業(yè)務(wù)時(shí) 會(huì)判斷購(gòu)買的業(yè)務(wù)的配置是否符合操作系統(tǒng)的最低限制 0 限制 |
| data.systems.ram_limit          | string    | 0                    | 內(nèi)存限制 購(gòu)買業(yè)務(wù)時(shí) 會(huì)判斷購(gòu)買的業(yè)務(wù)的配置是否符合操作系統(tǒng)的最低限制 0 限制 |
| data.systems.type               | string    | create               | 支持的類型	create 創(chuàng)建,install重裝                        |
| data.systems.system_harddisk    | string    | 30                   | 系統(tǒng)盤大小                                                   |
| data.systems.support            | string    | server               | 支持的業(yè)務(wù)類型  server 云服務(wù)器,idc托管,baremetal裸金屬      |
| data.systems.boot_menu_contents | json      | {"19":"","250":""}   | 引導(dǎo)菜單內(nèi)容                                                 |
| data.systems.ghost_url          | json      | {"19":"","250":""}   | ghost文件網(wǎng)絡(luò)存儲(chǔ)位置                                        |
| data.systems.lines              | array     | ["1683665299911682"] | 線路GUID   操作系統(tǒng)關(guān)聯(lián)的線路                                |

### 同步單個(gè)業(yè)務(wù)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值    | 說(shuō)明         |
| ------ | ---- | ---------------- | --------- | ------------ |
| action | 是   | string           | getserver | 獲取單個(gè)業(yè)務(wù) |
| guid   | 是   | 1708217536092719 | 1         | 業(yè)務(wù)GUID     |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"need_reset_vnc": "0",
			"line_guid": "1652433150648938",
			"lineID": "1060",
			"systemID": "1693649208369344",
			"ip": "11.23.35.3",
			"cpu": "1",
			"memory": "1",
			"harddisks": "10",
			"bandwidth": "1",
			"defense": "10",
			"loginName": "root",
			"buyTime": "2021-08-16 11:06:30",
			"endTime": "2021-09-16 11:06:30",
			"orderStatus": "1",
			"runStatus": "1",
			"actStatus": "0",
			"syncStatus": "1",
			"snapStatus": "0",
			"backStatus": "0",
			"backSystem": "0",
			"backDisk": "0",
			"backSystemTime": null,
			"backSystemID": null,
			"backDiskTime": null,
			"isInstallMonitor": "1",
			"blackHoleStatus": "0",
			"blockStatus": "0",
			"vps_guid": null,
			"vnc_port": "59003",
			"share_type": "0",
			"login_port": "80",
			"in_bandwidth": "10",
			"guid": "1708217536092719",
			"master_id": "83",
			"is_cdn_bind": "0",
			"cdn_cname_domain": null,
			"cdn_domain_max_num": "0",
			"pppoe_account": null,
			"share_ip": "11.23.35.3:80",
			"system_guid": "1693649208369344",
			"back_system_guid": "",
			"sid": "9527",
			"localIP": "10.23.35.3",
			"append_ip": [],
			"securityPolicyList": [],
			"port":[
				  {
					"id":"1032",
					"public_ip":"172.23.8.151",
					"public_port":"10031",
					"local_ip":"152.152.1.3",
					"local_port":"22",
					"protocol":"tcp,udp",
					"create_time":"2021-08-11 14:35:35",
					"is_deleted":"0",
					"is_used":"1",
					"guid":"d1424916-613d-43a9-9754-1029e74975ad",
					"service_id":"9519",
					"service_type":"1",
					"controller_guid":"1695712043844187",
					"remark":"\u8fdc\u7a0b\u767b\u9646\u7aef\u53e3"
				 }
	  		],
		}
	}

?	
**返回值**

| 參數(shù)                                       | 類型/長(zhǎng)度 | 示例值                               | 說(shuō)明                                                         |
| ------------------------------------------ | --------- | ------------------------------------ | ------------------------------------------------------------ |
| code                                       | int       | 0                                    | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                                    | string    | success                              | 反饋信息                                                     |
| data                                       | json      | json                                 | 返回的可用區(qū)結(jié)構(gòu)體                                           |
| data.need_reset_vnc                        | string    | 0                                    | 是否需要重置vnc                                              |
| data.line_guid                             | string    | 1652433150648938                     | 線路guid                                                     |
| data.lineID                                | string    | 1000                                 | 特殊線路id                                                   |
| data.systemID                              | string    | 1693649208369344                     | 操作系統(tǒng)GUID                                                 |
| data.ip                                    | string    | 11.23.35.3                           | 業(yè)務(wù)ip                                                       |
| data.cpu                                   | string    | 1                                    | 業(yè)務(wù)CPU  1核                                                 |
| data.memory                                | string    | 1                                    | 內(nèi)存 1G                                                      |
| data.harddisks                             | string    | 10                                   | 磁盤大小                                                     |
| data.bandwidth                             | string    | 1                                    | 帶寬1M                                                       |
| data.defense                               | string    | 10                                   | 防御 10G                                                     |
| data.loginName                             | string    | root                                 | 遠(yuǎn)程登陸用戶名稱                                             |
| data.buyTime                               | string    | 2021-08-16 11:06:30                  | 購(gòu)買日期                                                     |
| data.endTime                               | string    | 2021-09-16 11:06:30                  | 業(yè)務(wù)結(jié)束日期                                                 |
| data.orderStatus                           | string    | 1                                    | 業(yè)務(wù)狀態(tài)：-2 已刪除；-1 已回收;0  開通中；1  正常；2  過(guò)戶中（針對(duì)代理平臺(tái)，過(guò)戶中的機(jī)器不可以做任何操作）；3  已過(guò)期 ；4  已退款（針對(duì)代理平臺(tái)） |
| data.runStatus                             | string    | 1                                    | 運(yùn)行狀態(tài)：-2 已鎖定（關(guān)機(jī)狀態(tài)，不能自行啟動(dòng)，用于過(guò)期、管理員鎖定，可設(shè)置幾天后自動(dòng)解鎖）；-1 已關(guān)機(jī)；1  運(yùn)行中 |
| data.actStatus                             | string    | 0                                    | 操作狀態(tài)：-9 密碼重設(shè)失??；-5 重啟失?。ㄜ浿貑ⅲ?；-4 關(guān)機(jī)失敗（軟關(guān)機(jī)）；-3 啟動(dòng)失敗；-2 VNC重設(shè)失敗；0  正常；2  VNC重設(shè)中;3  啟動(dòng)中;4  關(guān)機(jī)中；5  重啟中;6  升級(jí)中；7  續(xù)費(fèi)中;8  重裝中；9  密碼重設(shè)中；11 降配中 |
| data.syncStatus                            | string    | 1                                    | 同步狀態(tài)  0未同步  1已同步                                   |
| data.snapStatus                            | string    | 0                                    | 快照狀態(tài) 快照狀態(tài)  0正常  1快照中  2恢復(fù)中  3刪除中          |
| data.blackHoleStatus                       | string    | 1                                    | IP異常狀態(tài)：0正常 ， 1異常                                   |
| data.blockStatus                           | string    | 1                                    | 黑洞狀態(tài)：0 正常 ， 1黑洞中                                  |
| data.vps_guid                              | string    | 6d59fe47-2e8c-4228-893c-9a02c2eb7b82 | 宿主機(jī)中唯一性的id，hyper為標(biāo)準(zhǔn)36位guid格式                  |
| data.vnc_port                              | string    | 59003                                | vnc端口                                                      |
| data.share_type                            | string    | 0                                    | 共享類型 1共享 0 獨(dú)享                                        |
| data.login_port                            | string    | 80                                   | 遠(yuǎn)程登陸端口                                                 |
| data.in_bandwidth                          | string    | 10                                   | 下行帶寬值 10M                                               |
| data.guid                                  | string    | 10                                   | 業(yè)務(wù)GUID                                                     |
| data.master_id                             | string    | 83                                   | 內(nèi)部特殊id                                                   |
| data.is_cdn_bind                           | string    | 0                                    | 是否支持cdn控制器綁定域名 0.不支持 1.支持'                   |
| data.cdn_cname_domain                      | string    | www.zkeys.com                        | cdn綁定域名的名稱                                            |
| data.cdn_domain_max_num                    | string    | 1                                    | 最多可綁定域名個(gè)數(shù)                                           |
| data.pppoe_account                         | string    | zkeys_pppoe                          | 撥號(hào)用戶名稱（共享業(yè)務(wù)專用）                                 |
| data.share_ip                              | string    | 11.23.35.3:80                        | 下級(jí)IP使用 如果線路開啟別稱或者為共享時(shí) 則使用該字段顯示公網(wǎng)ip |
| data.system_guid                           | string    | 1693649208369344                     | 操作系統(tǒng)GUID                                                 |
| data.sid                                   | string    | 9527                                 | 別稱id                                                       |
| data.localIP                               | string    | 10.23.35.3                           | 內(nèi)網(wǎng)ip                                                       |
| data.append_ip                             | array     | []                                   | 附加ip 可能存在多個(gè)                                          |
| data.append_ip.ip                          | string    | 192.168.1.75                         | 附加ip                                                       |
| data.append_ip.create_time                 | string    | 192.168.1.75                         | 附加ip創(chuàng)建時(shí)間                                               |
| data.append_ip.delete_time                 | string    | 192.168.1.75                         | 附加ip刪除時(shí)間                                               |
| data.securityPolicyList                    | array     | []                                   | 安全策略信息 可能存在多個(gè)                                    |
| data.securityPolicyList.id                 | string    | 1                                    | 特殊id                                                       |
| data.securityPolicyList.name               | string    | 流入80端口                           | 自定義規(guī)則名稱                                               |
| data.securityPolicyList.guid               | string    | 1707763642659694                     | guid  單條記錄的唯一表示                                     |
| data.securityPolicyList.weight             | string    | 7                                    | 權(quán)重優(yōu)先級(jí),必須數(shù)字,數(shù)字大的優(yōu)先執(zhí)行，不可重復(fù)               |
| data.securityPolicyList.direction          | enum      | Both                                 | 方向:[入方向 Inbound/出方向 Outbound/雙方向 Both]            |
| data.securityPolicyList.action             | enum      | Allow                                | 行為: [拒絕 Deny/允許 Allow]                                 |
| data.securityPolicyList.protocol           | string    | tcp                                  | 協(xié)議類型 TCP、UDP、ICMP、自定義 (不限制大小寫)               |
| data.securityPolicyList.remote_ip          | string    | 155.25.2.0/24                        | 遠(yuǎn)程IP地址 默認(rèn)為空可以為單個(gè)IP也可以為IP網(wǎng)段                |
| data.securityPolicyList.local_port         | string    | 0                                    | 本地端口 默認(rèn)值為0 ，0表示所有，也可以 5-15的格式            |
| data.securityPolicyList.switch_name        | string    | 0                                    | 網(wǎng)卡名稱 默認(rèn)為空                                            |
| data.securityPolicyList.service_type       | string    | server                               | 服務(wù)類型  server云服務(wù)器                                     |
| data.securityPolicyList.service_id         | string    | 9461                                 | 服務(wù)器id                                                     |
| data.securityPolicyList.create_time        | string    | 2021-08-11 10:52:04                  | 規(guī)則創(chuàng)建日期                                                 |
| data.securityPolicyList.status             | string    | 1                                    | 狀態(tài)值 1 正常 0 異常 -1刪除                                  |
| data.securityPolicyList.strategy_type      | string    | 1                                    | 策略類型：1，普通策略；2，預(yù)設(shè)策略'                          |
| data.securityPolicyList.master_strategy_id | string    | 1                                    | 預(yù)設(shè)策略id                                                   |
| data.securityPolicyList.message            | string    |                                      | 策略創(chuàng)建信息時(shí)返回的信息 默認(rèn)為空                            |
| data.securityPolicyList.is_agent           | string    | 1                                    | 是否api創(chuàng)建  1 是  0 不是                                    |
| data.port                                  | array     | []                                   | 共享業(yè)務(wù)的端口轉(zhuǎn)發(fā)記錄 可能存在多個(gè)                          |
| data.port.id                               | string    | 123                                  | 端口轉(zhuǎn)發(fā)的特殊id                                             |
| data.port.public_ip                        | string    | 172.23.8.151                         | 公網(wǎng)ip                                                       |
| data.port.public_port                      | string    | 10031                                | 公網(wǎng)端口                                                     |
| data.port.local_ip                         | string    | 152.152.1.3                          | 內(nèi)網(wǎng)ip                                                       |
| data.port.local_ip                         | string    | 152.152.1.3                          | 內(nèi)網(wǎng)ip                                                       |
| data.port.local_port                       | string    | 8080                                 | 內(nèi)網(wǎng)開放端口                                                 |
| data.port.protocol                         | string    | tcp,udp                              | 端口協(xié)議                                                     |
| data.port.create_time                      | string    | 2021-08-16 17:42:04                  | 端口創(chuàng)建時(shí)間                                                 |
| data.port.is_deleted                       | string    | 0                                    | 是否被刪除  1，刪除 0 未刪除                                 |
| data.port.is_used                          | string    | 1                                    | 是否被使用 1，被使用 0，未被使用                             |
| data.port.guid                             | string    | 3045ac3d-3cd8-480e-872f-778900c46dad | 端口轉(zhuǎn)發(fā)記錄的唯一Guid                                       |
| data.port.remark                           | string    | 端口80                               | 備注                                                         |
| data.port.service_id                       | string    | 9519                                 | 服務(wù)特殊id                                                   |

### 批量同步業(yè)務(wù)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型   | 示例值     | 說(shuō)明                     |
| ------ | ---- | ------ | ---------- | ------------------------ |
| action | 是   | string | getservers | 獲取單個(gè)業(yè)務(wù)             |
| page   | 是   | int    | 1          | 頁(yè)碼數(shù)  默認(rèn)單頁(yè)50條數(shù)據(jù) |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"pages": 1,
			"items": "338",
			"servers": {
				"0": {
					"need_reset_vnc": "0",
					"lineID": "1060",
					"guid": "1703155535615617",
					"ip": "198.168.0.57",
					"id": "9406",
					"share_type": "0",
					"master_id": "14",
					"cpu": "1",
					"memory": "1",
					"harddisks": "10",
					"bandwidth": "1",
					"defense": "5",
					"systemID": "744",
					"loginName": "administrator",
					"buyTime": "2021-06-21 14:08:11",
					"endTime": "2021-07-21 14:08:11",
					"orderStatus": "-2",
					"runStatus": "-1",
					"actStatus": "0",
					"apiLockStatus": "0",
					"snapStatus": "0",
					"snapId": "0",
					"backStatus": "0",
					"backSystem": "0",
					"backDisk": "0",
					"backSystemTime": null,
					"backDiskTime": null,
					"backSystemID": null,
					"blockStatus": "0",
					"isInstallMonitor": "1",
					"apiLockReason": "",
					"apiUnLockTime": null,
					"vnc_port": "59057",
					"login_port": "7798",
					"in_bandwidth": "10",
					"pppoe_account": null,
					"share_ip": null,
					"is_cdn_bind": "0",
					"cdn_cname_domain": null,
					"cdn_domain_max_num": "0",
					"line_guid": "1652433150648938",
					"localIP": "10.168.0.57",
					"system_guid": "1656209674537609",
					"system_back_guid": "",
					"append_ip": [],
					"securityPolicyList": [
						{
							"id": "756",
							"name": "\u9884\u8bbe\u4e0d\u53ef\u5220\u96642",
							"guid": "1703156006669390",
							"weight": "7",
							"direction": "Outbound",
							"action": "Deny",
							"protocol": "icmp",
							"remote_ip": "",
							"local_port": "",
							"switch_name": "public_net",
							"service_type": "server",
							"service_id": "9406",
							"create_time": "2021-06-21 14:15:40",
							"status": "1",
							"strategy_type": "2",
							"master_strategy_id": "66",
							"message": "\u88ab\u63a7\u6570\u636e\u683c\u5f0f\u5f02\u5e38",
							"is_agent": "0"
						}
					],
				"port":[
					  {
						"id":"1032",
						"public_ip":"172.23.8.151",
						"public_port":"10031",
						"local_ip":"152.152.1.3",
						"local_port":"22",
						"protocol":"tcp,udp",
						"create_time":"2021-08-11 14:35:35",
						"is_deleted":"0",
						"is_used":"1",
						"guid":"d1424916-613d-43a9-9754-1029e74975ad",
						"service_id":"9519",
						"service_type":"1",
						"controller_guid":"1695712043844187",
						"remark":"\u8fdc\u7a0b\u767b\u9646\u7aef\u53e3"
					 }
	  				]
				}
			}
		}
	}

?	
**返回值**

| 參數(shù)                                               | 類型/長(zhǎng)度 | 示例值                               | 說(shuō)明                                                         |
| -------------------------------------------------- | --------- | ------------------------------------ | ------------------------------------------------------------ |
| code                                               | int       | 0                                    | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                                            | string    | success                              | 反饋信息                                                     |
| data                                               | json      | json                                 | 返回的可用區(qū)結(jié)構(gòu)體                                           |
| data.pages                                         | string    | 1                                    | 頁(yè)碼數(shù)                                                       |
| data.items                                         | string    | 300                                  | 總條數(shù)                                                       |
| data.servers                                       | json      | {}                                   | 業(yè)務(wù)信息的集合  可能存在多個(gè)數(shù)據(jù)，下標(biāo)從0開始                |
| data.servers.line_guid                             | string    | 1652433150648938                     | 線路guid                                                     |
| data.servers.lineID                                | string    | 1000                                 | 特殊線路id                                                   |
| data.servers.systemID                              | string    | 1693649208369344                     | 操作系統(tǒng)GUID                                                 |
| data.servers.ip                                    | string    | 11.23.35.3                           | 業(yè)務(wù)ip                                                       |
| data.servers.cpu                                   | string    | 1                                    | 業(yè)務(wù)CPU  1核                                                 |
| data.servers.memory                                | string    | 1                                    | 內(nèi)存 1G                                                      |
| data.servers.harddisks                             | string    | 10                                   | 磁盤大小                                                     |
| data.servers.bandwidth                             | string    | 1                                    | 帶寬1M                                                       |
| data.servers.defense                               | string    | 10                                   | 防御 10G                                                     |
| data.servers.loginName                             | string    | root                                 | 遠(yuǎn)程登陸用戶名稱                                             |
| data.servers.buyTime                               | string    | 2021-08-16 11:06:30                  | 購(gòu)買日期                                                     |
| data.servers.endTime                               | string    | 2021-09-16 11:06:30                  | 業(yè)務(wù)結(jié)束日期                                                 |
| data.servers.orderStatus                           | string    | 1                                    | 業(yè)務(wù)狀態(tài)：-2 已刪除；-1 已回收;0  開通中；1  正常；2  過(guò)戶中（針對(duì)代理平臺(tái)，過(guò)戶中的機(jī)器不可以做任何操作）；3  已過(guò)期 ；4  已退款（針對(duì)代理平臺(tái)） |
| data.servers.runStatus                             | string    | 1                                    | 運(yùn)行狀態(tài)：-2 已鎖定（關(guān)機(jī)狀態(tài)，不能自行啟動(dòng)，用于過(guò)期、管理員鎖定，可設(shè)置幾天后自動(dòng)解鎖）；-1 已關(guān)機(jī)；1  運(yùn)行中 |
| data.servers.actStatus                             | string    | 0                                    | 操作狀態(tài)：-9 密碼重設(shè)失??；-5 重啟失?。ㄜ浿貑ⅲ?；-4 關(guān)機(jī)失敗（軟關(guān)機(jī)）；-3 啟動(dòng)失??；-2 VNC重設(shè)失??；0  正常；2  VNC重設(shè)中;3  啟動(dòng)中;4  關(guān)機(jī)中；5  重啟中;6  升級(jí)中；7  續(xù)費(fèi)中;8  重裝中；9  密碼重設(shè)中；11 降配中 |
| data.servers.syncStatus                            | string    | 1                                    | 同步狀態(tài)  0未同步  1已同步                                   |
| data.servers.snapStatus                            | string    | 0                                    | 快照狀態(tài) 快照狀態(tài)  0正常  1快照中  2恢復(fù)中  3刪除中          |
| data.servers.blackHoleStatus                       | string    | 1                                    | IP異常狀態(tài)：0正常 ， 1異常                                   |
| data.servers.blockStatus                           | string    | 1                                    | 黑洞狀態(tài)：0 正常 ， 1黑洞中                                  |
| data.servers.vps_guid                              | string    | 6d59fe47-2e8c-4228-893c-9a02c2eb7b82 | 宿主機(jī)中唯一性的id，hyper為標(biāo)準(zhǔn)36位guid格式                  |
| data.servers.vnc_port                              | string    | 59003                                | vnc端口                                                      |
| data.servers.share_type                            | string    | 0                                    | 共享類型 1共享 0 獨(dú)享                                        |
| data.servers.login_port                            | string    | 80                                   | 遠(yuǎn)程登陸端口                                                 |
| data.servers.in_bandwidth                          | string    | 10                                   | 下行帶寬值 10M                                               |
| data.servers.guid                                  | string    | 10                                   | 業(yè)務(wù)GUID                                                     |
| data.servers.master_id                             | string    | 83                                   | 內(nèi)部特殊id                                                   |
| data.servers.is_cdn_bind                           | string    | 0                                    | 是否支持cdn控制器綁定域名 0.不支持 1.支持'                   |
| data.servers.cdn_cname_domain                      | string    | www.zkeys.com                        | cdn綁定域名的名稱                                            |
| data.servers.cdn_domain_max_num                    | string    | 1                                    | 最多可綁定域名個(gè)數(shù)                                           |
| data.servers.pppoe_account                         | string    | zkeys_pppoe                          | 撥號(hào)用戶名稱（共享業(yè)務(wù)專用）                                 |
| data.servers.share_ip                              | string    | 11.23.35.3:80                        | 下級(jí)IP使用 如果線路開啟別稱或者為共享時(shí) 則使用該字段顯示公網(wǎng)ip |
| data.servers.system_guid                           | string    | 1693649208369344                     | 操作系統(tǒng)GUID                                                 |
| data.servers.sid                                   | string    | 9527                                 | 別稱id                                                       |
| data.servers.localIP                               | string    | 10.23.35.3                           | 內(nèi)網(wǎng)ip                                                       |
| data.servers.append_ip                             | array     | []                                   | 附加ip 可能存在多個(gè)                                          |
| data.servers.append_ip.ip                          | string    | 192.168.1.75                         | 附加ip                                                       |
| data.servers.append_ip.create_time                 | string    | 192.168.1.75                         | 附加ip創(chuàng)建時(shí)間                                               |
| data.servers.append_ip.delete_time                 | string    | 192.168.1.75                         | 附加ip刪除時(shí)間                                               |
| data.servers.securityPolicyList                    | array     | []                                   | 安全策略信息 可能存在多個(gè)                                    |
| data.servers.securityPolicyList.id                 | string    | 1                                    | 特殊id                                                       |
| data.servers.securityPolicyList.name               | string    | 流入80端口                           | 自定義規(guī)則名稱                                               |
| data.servers.securityPolicyList.guid               | string    | 1707763642659694                     | guid  單條記錄的唯一表示                                     |
| data.servers.securityPolicyList.weight             | string    | 7                                    | 權(quán)重優(yōu)先級(jí),必須數(shù)字,數(shù)字大的優(yōu)先執(zhí)行，不可重復(fù)               |
| data.servers.securityPolicyList.direction          | enum      | Both                                 | 方向:[入方向 Inbound/出方向 Outbound/雙方向 Both]            |
| data.servers.securityPolicyList.action             | enum      | Allow                                | 行為: [拒絕 Deny/允許 Allow]                                 |
| data.servers.securityPolicyList.protocol           | string    | tcp                                  | 協(xié)議類型 TCP、UDP、ICMP、自定義 (不限制大小寫)               |
| data.servers.securityPolicyList.remote_ip          | string    | 155.25.2.0/24                        | 遠(yuǎn)程IP地址 默認(rèn)為空可以為單個(gè)IP也可以為IP網(wǎng)段                |
| data.servers.securityPolicyList.local_port         | string    | 0                                    | 本地端口 默認(rèn)值為0 ，0表示所有，也可以 5-15的格式            |
| data.servers.securityPolicyList.switch_name        | string    | 0                                    | 網(wǎng)卡名稱 默認(rèn)為空                                            |
| data.servers.securityPolicyList.service_type       | string    | server                               | 服務(wù)類型  server云服務(wù)器                                     |
| data.servers.securityPolicyList.service_id         | string    | 9461                                 | 服務(wù)器id                                                     |
| data.servers.securityPolicyList.create_time        | string    | 2021-08-11 10:52:04                  | 規(guī)則創(chuàng)建日期                                                 |
| data.servers.securityPolicyList.status             | string    | 1                                    | 狀態(tài)值 1 正常 0 異常 -1刪除                                  |
| data.servers.securityPolicyList.strategy_type      | string    | 1                                    | 策略類型：1，普通策略；2，預(yù)設(shè)策略'                          |
| data.servers.securityPolicyList.master_strategy_id | string    | 1                                    | 預(yù)設(shè)策略id                                                   |
| data.servers.securityPolicyList.message            | string    |                                      | 策略創(chuàng)建信息時(shí)返回的信息 默認(rèn)為空                            |
| data.servers.securityPolicyList.is_agent           | string    | 1                                    | 是否api創(chuàng)建  1 是  0 不是                                    |
| data.servers.port                                  | array     | []                                   | 共享業(yè)務(wù)的端口轉(zhuǎn)發(fā)記錄                                       |
| data.servers.port.id                               | string    | 123                                  | 端口轉(zhuǎn)發(fā)的特殊id                                             |
| data.servers.port.public_ip                        | string    | 172.23.8.151                         | 公網(wǎng)ip                                                       |
| data.servers.port.public_port                      | string    | 10031                                | 公網(wǎng)端口                                                     |
| data.servers.port.local_ip                         | string    | 152.152.1.3                          | 內(nèi)網(wǎng)ip                                                       |
| data.servers.port.local_ip                         | string    | 152.152.1.3                          | 內(nèi)網(wǎng)ip                                                       |
| data.servers.port.local_port                       | string    | 8080                                 | 內(nèi)網(wǎng)開放端口                                                 |
| data.servers.port.protocol                         | string    | tcp,udp                              | 端口協(xié)議                                                     |
| data.servers.port.create_time                      | string    | 2021-08-16 17:42:04                  | 端口創(chuàng)建時(shí)間                                                 |
| data.servers.port.is_deleted                       | string    | 0                                    | 是否被刪除  1，刪除 0 未刪除                                 |
| data.servers.port.is_used                          | string    | 1                                    | 是否被使用 1，被使用 0，未被使用                             |
| data.servers.port.guid                             | string    | 3045ac3d-3cd8-480e-872f-778900c46dad | 端口轉(zhuǎn)發(fā)記錄的唯一Guid                                       |
| data.servers.port.remark                           | string    | 端口80                               | 備注                                                         |
| data.servers.port.service_id                       | string    | 9519                                 | 服務(wù)特殊id                                                   |

## 業(yè)務(wù)操作

### 創(chuàng)建

**請(qǐng)求參數(shù)**

| 參數(shù)          | 必選 | 類型   | 示例值               | 說(shuō)明                                                         |
| ------------- | ---- | ------ | -------------------- | ------------------------------------------------------------ |
| action        | 是   | string | create_new           | 接口名稱                                                     |
| lineid        | 是   | string | 28                   | 線路GID  可以在獲取線路接口得到                              |
| cpu           | 是   | string | 4                    | CPU大小，單位核，共5個(gè)值可選：1/2/4/8/16                     |
| memory        | 是   | string | 8                    | 內(nèi)存大小，單位GB，根據(jù)CPU值不同可選值不同，1/2/4/8/16/32/64  |
| harddisks     | 是   | string | 10,20                | 磁盤大小，多個(gè)磁盤用半角逗號(hào)分隔。                           |
| bandwidth     | 是   | string | 2                    | 帶寬大小，單位M                                              |
| defense       | 是   | string | 20                   | 防御大小，單位G                                              |
| systemID      | 是   | string | 1665904693989817     | 操作系統(tǒng)的GUID,可以在同步操作系統(tǒng)接口中獲取，16位字符串      |
| password      | 否   | string | d3d3Lm5pYW95dW4uY29t | 由BASE64編碼 1，(zkeys與niaoyun線路)必須包含字母及數(shù)字，長(zhǎng)度為8-30位，可包含特殊字符_()\`~!@#$%^*-+={}[]:;,.?/;2,(baidu下線路)密碼長(zhǎng)度8-15位，由英文字母、數(shù)字和特殊符號(hào)組成，且必須包含字母、數(shù)字及特殊符號(hào)，特殊符號(hào)支持如下：!@#$%^*()；3，（騰訊云線路）密碼長(zhǎng)度12-30位，由英文字母、數(shù)字和特殊符號(hào)組成，且必須包含大小寫字母、數(shù)字及特殊符號(hào)，特殊符號(hào)支持如下：()\`~!@#$%^&*-+=_ |
| months        | 是   | string | 12                   | 購(gòu)買月數(shù)，1/2/3/4/5/6/7/8/9/12/24/36                         |
| num           | 是   | string | 1                    | 購(gòu)買數(shù)量                                                     |
| clientUserID  | 是   | string | 10                   | 終端用戶ID                                                   |
| clientOrderNo | 是   | string | 790528221561598011   | 合作訂單號(hào)，小于等于20位                                     |
| clientPrice   | 否   | string | 11                   | （可選）終端用戶的購(gòu)買價(jià)格，當(dāng)此價(jià)格低于API結(jié)算價(jià)格時(shí)返回錯(cuò)誤 |

**返回示例**

{
			"code": 0,
			"message": "success",
			"data": {
				"servers": [
					{
						"guid": "1708214641590230",
						"ip": "192.23.18.15",
						"localIP": "10.23.18.15",
						"cpu": 1,
						"memory": 1,
						"harddisks": "10",
						"bandwidth": "1",
						"defense": "0",
						"buyTime": "2021-08-16 10:20:29",
						"endTime": "2021-09-16 10:20:29",
						"pppoe_account": "",
						"pppoe_password": "",
						"share_type": 0,
						"login_port": "22",
						"is_cdn_bind": 0,
						"cdn_cname_domain": "",
						"cdn_domain_max_num": 0,
						"share_ip": "",
						"c_path": "dm9sdW1lcy1wb29sL2t2bTU5NS5yYXc=",
						"c_maxiops": "0",
						"disks_path": "dm9sdW1lcy1wb29sL2t2bTU5NS0yLnJhdw==",
						"disks_maxiops": "0",
						"cpu_limit": "100",
						"ram_start": "0",
						"memory_dynamic": "0"
					}
				]
			}
		}

**返回值**

| 參數(shù)                            | 類型/長(zhǎng)度 | 示例值                               | 說(shuō)明                                                         |
| ------------------------------- | --------- | ------------------------------------ | ------------------------------------------------------------ |
| code                            | int       | 0                                    | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                         | string    | success                              | 反饋信息                                                     |
| data                            | json      | json                                 | 返回的可用區(qū)結(jié)構(gòu)體                                           |
| data.servers                    | array     | []                                   | 業(yè)務(wù)實(shí)例對(duì)象，同時(shí)開通多個(gè)業(yè)務(wù)時(shí)，返回多個(gè)對(duì)象               |
| data.servers.guid               | string    | 1708214641590230                     | 業(yè)務(wù)GUID                                                     |
| data.servers.ip                 | string    | 192.23.18.15                         | 業(yè)務(wù)ip                                                       |
| data.servers.cpu                | int       | 1                                    | cpu 1核                                                      |
| data.servers.memory             | int       | 1                                    | 內(nèi)存 1G                                                      |
| data.servers.harddisks          | string    | 10                                   | 磁盤10G ，多塊磁盤用逗號(hào)隔開                                 |
| data.servers.bandwidth          | string    | 1                                    | 帶寬 1M                                                      |
| data.servers.defense            | string    | 0                                    | 防御  單位G                                                  |
| data.servers.buyTime            | string    | 2021-08-16 10:20:29                  | 購(gòu)買日期                                                     |
| data.servers.endTime            | string    | 2021-09-16 10:20:29                  | 業(yè)務(wù)到期日期                                                 |
| data.servers.pppoe_account      | string    | zkeys_pppoe                          | 撥號(hào)用戶名稱（共享業(yè)務(wù)專用）                                 |
| data.servers.pppoe_password     | string    | a123456                              | 撥號(hào)用戶密碼（共享業(yè)務(wù)專用）                                 |
| data.servers.share_type         | string    | 0                                    | 共享類型  0 獨(dú)享  1共享                                      |
| data.servers.login_port         | string    | 22                                   | 業(yè)務(wù)的遠(yuǎn)程登陸端口                                           |
| data.servers.is_cdn_bind        | string    | 0                                    | 是否支持cdn控制器綁定域名 0.不支持 1.支持'                   |
| data.servers.cdn_cname_domain   | string    | www.zkeys.com                        | cdn綁定域名的名稱                                            |
| data.servers.cdn_domain_max_num | string    | 1                                    | 最多可綁定域名個(gè)數(shù)                                           |
| data.servers.share_ip           | string    | www.zkeys.com:8888                   | 共享業(yè)務(wù)時(shí)，使用的公網(wǎng)ip:端口                                |
| data.servers.c_path             | string    | dm9sdW1lcy1wb29sL2t2bTU5NS5yYXc=     | 系統(tǒng)盤的路徑，返回base64之后數(shù)據(jù)                             |
| data.servers.c_maxiops          | string    | 0                                    | 系統(tǒng)磁盤的IOPS最大值，無(wú)需單位，0為不限制                    |
| data.servers.disks_path         | string    | dm9sdW1lcy1wb29sL2t2bTU5NS0yLnJhdw== | 系統(tǒng)盤路徑，多個(gè)用逗號(hào)隔開，返回base64之后數(shù)據(jù)               |
| data.servers.disks_maxiops      | string    | 0                                    | 數(shù)據(jù)盤磁盤的IOPS設(shè)置,0為不限制,多個(gè)磁盤用半角逗號(hào)隔開，數(shù)量與harddisks對(duì)應(yīng) |
| data.servers.cpu_limit          | string    | 100                                  | CPU限制  0或100為不限制                                      |
| data.servers.ram_start          | string    | 100                                  | 內(nèi)存限制  0或100為不限制                                     |
| data.servers.memory_dynamic     | string    | 0                                    | 動(dòng)態(tài)內(nèi)存 0否 1是                                             |

### 關(guān)機(jī)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值 | 說(shuō)明                                                         |
| ------ | ---- | ---------------- | ------ | ------------------------------------------------------------ |
| action | 是   | string           | stop   | 軟關(guān)機(jī)  處于關(guān)機(jī)中時(shí)，禁止其它操作； 關(guān)機(jī)狀態(tài)下 禁止關(guān)機(jī)，重啟，過(guò)戶操作 |
| guid   | 是   | 1708217536092719 | 1      | 業(yè)務(wù)GUID                                                     |

**返回示例**

{
			"code": 0,
			"message": "success",
			"data": []
		}

**返回值**

| 參數(shù)    | 類型/長(zhǎng)度 | 示例值  | 說(shuō)明                     |
| ------- | --------- | ------- | ------------------------ |
| code    | int       | 0       | 返回狀態(tài) 0:成功 , 1:失敗 |
| message | string    | success | 反饋信息                 |
| data    | array     | array   | 一般為空                 |

### 硬關(guān)機(jī)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值 | 說(shuō)明                                                         |
| ------ | ---- | ---------------- | ------ | ------------------------------------------------------------ |
| action | 是   | string           | stop_h | 強(qiáng)制關(guān)機(jī)  處于關(guān)機(jī)中時(shí)，禁止其它操作；關(guān)機(jī)狀態(tài)下 禁止關(guān)機(jī)，重啟，過(guò)戶操作 |
| guid   | 是   | 1708217536092719 | 1      | 業(yè)務(wù)GUID                                                     |

**返回示例**

{
			"code": 0,
			"message": "success",
			"data": []
		}

**返回值**

### 啟動(dòng)

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值 | 說(shuō)明                             |
| ------ | ---- | ---------------- | ------ | -------------------------------- |
| action | 是   | string           | start  | 啟動(dòng)  處于啟動(dòng)中時(shí)，禁止其它操作 |
| guid   | 是   | 1708217536092719 | 1      | 業(yè)務(wù)GUID                         |

**返回示例**

{
			"code": 0,
			"message": "success",
			"data": []
		}

**返回值**

### 重啟

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值  | 說(shuō)明                               |
| ------ | ---- | ---------------- | ------- | ---------------------------------- |
| action | 是   | string           | restart | 軟啟動(dòng)  處于啟動(dòng)中時(shí)，禁止其它操作 |
| guid   | 是   | 1708217536092719 | 1       | 業(yè)務(wù)GUID                           |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 硬重啟

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值    | 說(shuō)明                                  |
| ------ | ---- | ---------------- | --------- | ------------------------------------- |
| action | 是   | string           | restart_h | 強(qiáng)制啟動(dòng)   處于啟動(dòng)中時(shí)，禁止其它操作 |
| guid   | 是   | 1708217536092719 | 1         | 業(yè)務(wù)GUID                              |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 獲取VNC地址

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型             | 示例值    | 說(shuō)明                          |
| ------ | ---- | ---------------- | --------- | ----------------------------- |
| action | 是   | string           | getvncurl | 獲取vnc地址，可以遠(yuǎn)程登陸使用 |
| guid   | 是   | 1708217536092719 | 1         | 業(yè)務(wù)GUID                      |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
		"url": "https://vnc.zkeys.com/vnc.php?sign=xxxxxxxxx"
		}
	}

**返回值**

| 參數(shù)     | 類型/長(zhǎng)度 | 示例值                                       | 說(shuō)明                     |
| -------- | --------- | -------------------------------------------- | ------------------------ |
| code     | int       | 0                                            | 返回狀態(tài) 0:成功 , 1:失敗 |
| message  | string    | success                                      | 反饋信息                 |
| data     | array     | array                                        | 一般為空                 |
| data.url | string    | https://vnc.zkeys.com/vnc.php?sign=xxxxxxxxx | vnc地址，可直接使用      |

### 重置密碼

**請(qǐng)求參數(shù)**

| 參數(shù)     | 必選 | 類型             | 示例值 | 說(shuō)明                                                        |
| -------- | ---- | ---------------- | ------ | ----------------------------------------------------------- |
| action   | 是   | string           | setpsw | 設(shè)置遠(yuǎn)程登陸密碼                                            |
| password | 是   | string           | setpsw | base64_encode 之后的數(shù)據(jù) 密碼規(guī)則參考【創(chuàng)建】的password參數(shù) |
| guid     | 是   | 1708217536092719 | 1      | 業(yè)務(wù)GUID                                                    |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 重置VNC密碼

**特殊說(shuō)明**

-  1，只有鳥云線路和zkeys線路允許該操作； 通過(guò)線路表中的 resources_type判斷屬于什么線路
-  2，查看當(dāng)前線路是否開放改操作   reset_vnc_password；
-  3，orderstatus狀態(tài)正常，才允許操作；
-  4，actstatus狀態(tài)正常，才允許操作；
-   5，runstatus狀態(tài)非鎖定，才允許操作；
-	6，snapstatus快照狀態(tài)正常，才允許操作；

**請(qǐng)求參數(shù)**

| 參數(shù)     | 必選 | 類型             | 示例值 | 說(shuō)明                                                        |
| -------- | ---- | ---------------- | ------ | ----------------------------------------------------------- |
| action   | 是   | string           | setvnc | 設(shè)置vnc密碼                                                 |
| password | 是   | string           | setpsw | base64_encode 之后的數(shù)據(jù) 密碼規(guī)則參考【創(chuàng)建】的password參數(shù) |
| guid     | 是   | 1708217536092719 | 1      | 業(yè)務(wù)GUID                                                    |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 重裝

**請(qǐng)求參數(shù)**

| 參數(shù)     | 必選 | 類型             | 示例值           | 說(shuō)明                                                         |
| -------- | ---- | ---------------- | ---------------- | ------------------------------------------------------------ |
| action   | 是   | string           | install          | 重裝  重裝中的業(yè)務(wù) 不能進(jìn)行其它操作，存在快照的情況下，不允許重裝 |
| systemID | 是   | string           | 2208417546192729 | 操作系統(tǒng)GUID                                                 |
| password | 是   | string           | setpsw           | base64_encode 之后的數(shù)據(jù) 密碼規(guī)則【創(chuàng)建】的password參數(shù)      |
| guid     | 是   | 1708217536092719 | 1                | 業(yè)務(wù)GUID                                                     |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 獲取快照列表

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型   | 示例值           | 說(shuō)明     |
| ------ | ---- | ------ | ---------------- | -------- |
| action | 是   | string | listsnapshot     | 獲取快照 |
| guid   | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"snapshottree": "=twqag,twqag=yegta",
			"snapshotlist": [
				{
				"name": "twqag",
				"create_time": "2021-08-16 16:17:23",
				"end_time": "2021-08-23 16:17:23",
				"status": "1",
				"current": 0,
				"parent_name": ""
				},
				{
				"name": "yegta",
				"create_time": "2021-08-16 16:38:00",
				"end_time": "2021-08-23 16:38:00",
				"status": "1",
				"current": 1,
				"parent_name": "twqag"
				}
			]
		}
	}

**返回值**

| 參數(shù)                          | 類型/長(zhǎng)度 | 示例值              | 說(shuō)明                                                         |
| ----------------------------- | --------- | ------------------- | ------------------------------------------------------------ |
| code                          | int       | 0                   | 返回狀態(tài) 0:成功 , 1:失敗                                     |
| message                       | string    | success             | 反饋信息                                                     |
| data                          | array     | array               |                                                              |
| data.snapshottree             | string    | =twqag,twqag=yegta  | 快照樹名稱 =twqag 表示頂級(jí)，沒有上級(jí) twqag=yegta 表示twqag是yegta的上級(jí) |
| data.snapshotlist             | array     | []]                 | 列表數(shù)據(jù)                                                     |
| data.snapshotlist.name        | string    | yegta               | 快照名稱                                                     |
| data.snapshotlist.create_time | string    | 2021-08-16 16:38:00 | 開始時(shí)間                                                     |
| data.snapshotlist.end_time    | string    | 2021-08-23 16:38:00 | 結(jié)束時(shí)間                                                     |
| data.snapshotlist.status      | string    | 1                   | 表示正常                                                     |
| data.snapshotlist.current     | string    | 1                   | 0 表示頂級(jí)  1表示下一級(jí)                                      |
| data.snapshotlist.parent_name | string    | twqag               | 父類的名稱                                                   |

### 創(chuàng)建快照

**請(qǐng)求參數(shù)**

| 參數(shù)           | 必選 | 類型   | 示例值             | 說(shuō)明                     |
| -------------- | ---- | ------ | ------------------ | ------------------------ |
| action         | 是   | string | createsnapshot     | 創(chuàng)建快照                 |
| agent_order_no | 是   | string | 650682444529030123 | 客戶端訂單號(hào)             |
| days           | 是   | string | 7                  | 快照天數(shù)                 |
| months         | 是   | string | 1                  | 快照月份數(shù)  與days二選一 |
| guid           | 是   | string | 1708217536092719   | 業(yè)務(wù)GUID                 |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"snapshotname": "ujerm",
			"createtime": "2021-08-16 15:55:29",
			"endtime": "2021-08-23 15:55:29"
		}
	}

**返回值**

| 參數(shù)              | 類型/長(zhǎng)度 | 示例值              | 說(shuō)明                     |
| ----------------- | --------- | ------------------- | ------------------------ |
| code              | int       | 0                   | 返回狀態(tài) 0:成功 , 1:失敗 |
| message           | string    | success             | 反饋信息                 |
| data              | array     | array               |                          |
| data.snapshotname | string    | ujerm               | 快照名稱                 |
| data.createtime   | string    | 2021-08-16 15:55:29 | 快照創(chuàng)建日期             |
| data.endtime      | string    | 2021-08-23 15:55:29 | 快照結(jié)束日期             |

### 還原快照

**請(qǐng)求參數(shù)**

| 參數(shù)         | 必選 | 類型   | 示例值           | 說(shuō)明     |
| ------------ | ---- | ------ | ---------------- | -------- |
| action       | 是   | string | revertsnapshot   | 恢復(fù)快照 |
| guid         | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID |
| snapshotname | 是   | string | yegta            | 快照名稱 |

**返回示例**

{
	  "code":0,
	  "message":"success",
	  "data":{
		"snapshotname":"yegta"
	  }
	}

**返回值**

| 參數(shù)              | 類型/長(zhǎng)度 | 示例值  | 說(shuō)明                     |
| ----------------- | --------- | ------- | ------------------------ |
| code              | int       | 0       | 返回狀態(tài) 0:成功 , 1:失敗 |
| message           | string    | success | 反饋信息                 |
| data              | array     | array   |                          |
| data.snapshotname | string    | yegta   | 恢復(fù)的快照名稱           |

### 續(xù)費(fèi)快照

**請(qǐng)求參數(shù)**

| 參數(shù)           | 必選 | 類型   | 示例值             | 說(shuō)明                     |
| -------------- | ---- | ------ | ------------------ | ------------------------ |
| action         | 是   | string | renewsnapshot      | 續(xù)費(fèi)快照                 |
| agent_order_no | 是   | string | 650682444529030123 | 客戶端訂單號(hào)             |
| snapshotname   | 是   | string | yegta              | 續(xù)費(fèi)快照名稱             |
| days           | 是   | string | 7                  | 快照天數(shù)                 |
| months         | 是   | string | 1                  | 快照月份數(shù)  與days二選一 |
| guid           | 是   | string | 1708217536092719   | 業(yè)務(wù)GUID                 |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": {
			"snapshotname": "ujerm",
			"createtime": "2021-08-16 15:55:29",
			"endtime": "2021-08-23 15:55:29"
		}
	}

**返回值**

### 刪除快照

**請(qǐng)求參數(shù)**

| 參數(shù)         | 必選 | 類型   | 示例值           | 說(shuō)明     |
| ------------ | ---- | ------ | ---------------- | -------- |
| action       | 是   | string | removesnapshot   | 刪除快照 |
| guid         | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID |
| snapshotname | 是   | string | yegta            | 快照名稱 |

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
			"snapshotname":"yegta"
		}
	}

**返回值**

### 升級(jí)

**請(qǐng)求參數(shù)**

| 參數(shù)          | 必選 | 類型   | 示例值             | 說(shuō)明                                                         |
| ------------- | ---- | ------ | ------------------ | ------------------------------------------------------------ |
| action        | 是   | string | upgrade            | 升級(jí)                                                         |
| password      | 是   | string | setpsw             | base64_encode 之后的數(shù)據(jù) 密碼規(guī)則參考【創(chuàng)建】的password參數(shù)  |
| guid          | 是   | string | 1708217536092719   | 業(yè)務(wù)GUID                                                     |
| cpu           | 是   | string | 2                  | 升級(jí)后的cpu配置                                              |
| memory        | 是   | string | 2                  | 升級(jí)后的內(nèi)存配置                                             |
| harddisks     | 是   | string | 10，10             | 升級(jí)后的磁盤配置 原磁盤一塊 10G ， 10，10表示新增一塊磁盤為10G的磁盤，如果在第一塊上的磁盤大小上新增10G ，請(qǐng)求參數(shù)應(yīng)該是20,10 |
| bandwidth     | 是   | string | 2                  | 升級(jí)后的帶寬配置                                             |
| defense       | 是   | string | 10                 | 升級(jí)后的防御配置                                             |
| clientOrderNo | 是   | string | 980682449503309004 | 客戶端訂單號(hào)                                                 |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 續(xù)費(fèi)降配

**請(qǐng)求參數(shù)**

| 參數(shù)          | 必選 | 類型   | 示例值             | 說(shuō)明             |
| ------------- | ---- | ------ | ------------------ | ---------------- |
| action        | 是   | string | renew_for_rd       | 預(yù)約降配         |
| guid          | 是   | string | 1708217536092719   | 業(yè)務(wù)GUID         |
| cpu           | 是   | string | 2                  | 降配后的cpu配置  |
| memory        | 是   | string | 2                  | 降配后的內(nèi)存配置 |
| bandwidth     | 是   | string | 2                  | 降配后的帶寬配置 |
| defense       | 是   | string | 10                 | 降配后的防御配置 |
| clientOrderNo | 是   | string | 980682449503309004 | 客戶端訂單號(hào)     |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 申請(qǐng)端口（共享業(yè)務(wù)專用）

**請(qǐng)求參數(shù)**

| 參數(shù)         | 必選 | 類型   | 示例值           | 說(shuō)明                                                         |
| ------------ | ---- | ------ | ---------------- | ------------------------------------------------------------ |
| action       | 是   | string | create_port      | 申請(qǐng)端口                                                     |
| guid         | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID                                                     |
| remark       | 是   | string | 申請(qǐng)8080端口     | 申請(qǐng)備注                                                     |
| local_port   | 是   | string | 8080             | 開通的內(nèi)網(wǎng)端口  范圍：1，65535之間                           |
| service_type | 是   | string | 1                | 類型  1云服務(wù)器                                              |
| form         | 是   | string | default          | 來(lái)源                                                         |
| port_type    | 是   | string | 1                | 端口分配類型  1 不對(duì)等分配 2，對(duì)等分配 ；說(shuō)明：對(duì)等分配表示公網(wǎng)隨機(jī)端口與服務(wù)開放端口保持一致；不對(duì)等分配，就是公網(wǎng)端口隨機(jī) |

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
			"port_info":{
				"id":"1036",
				"public_ip":"172.23.8.151",
				"public_port":"10033",
				"local_ip":"152.152.1.3",
				"local_port":"8080",
				"protocol":"tcp,udp",
				"create_time":"2021-08-16 17:42:04",
				"is_deleted":"0",
				"is_used":"1",
				"guid":"3045ac3d-3cd8-480e-872f-778900c46dad",
				"service_id":"9519",
				"service_type":"1",
				"controller_guid":"1695712043844187",
				"remark":"\u7533\u8bf7\u516c\u7f51\u7aef\u53e3"
			},
			"share_ip":"putianyun.com"
		}
	}

**返回值**

| 參數(shù)                       | 類型/長(zhǎng)度 | 示例值                               | 說(shuō)明                             |
| -------------------------- | --------- | ------------------------------------ | -------------------------------- |
| code                       | int       | 0                                    | 返回狀態(tài) 0:成功 , 1:失敗         |
| message                    | string    | success                              | 反饋信息                         |
| data                       | array     | array                                |                                  |
| data.port_info             | json      | {}                                   | 開通的端口信息                   |
| data.port_info.id          | string    | 1036                                 | 特殊id                           |
| data.port_info.public_ip   | string    | 172.23.8.151                         | 公網(wǎng)ip                           |
| data.port_info.public_port | string    | 10033                                | 公網(wǎng)端口                         |
| data.port_info.local_ip    | string    | 152.152.1.3                          | 內(nèi)網(wǎng)ip                           |
| data.port_info.local_port  | string    | 8080                                 | 內(nèi)網(wǎng)開放端口                     |
| data.port_info.protocol    | string    | tcp,udp                              | 端口協(xié)議                         |
| data.port_info.create_time | string    | 2021-08-16 17:42:04                  | 端口創(chuàng)建時(shí)間                     |
| data.port_info.is_deleted  | string    | 0                                    | 是否被刪除  1，刪除 0 未刪除     |
| data.port_info.is_used     | string    | 1                                    | 是否被使用 1，被使用 0，未被使用 |
| data.port_info.guid        | string    | 3045ac3d-3cd8-480e-872f-778900c46dad | 端口轉(zhuǎn)發(fā)記錄的唯一Guid           |
| data.port_info.share_ip    | string    | 1                                    | 公網(wǎng)ip或者域名                   |

### 刪除端口（共享業(yè)務(wù)專用）

**請(qǐng)求參數(shù)**

| 參數(shù)         | 必選 | 類型   | 示例值                               | 說(shuō)明            |
| ------------ | ---- | ------ | ------------------------------------ | --------------- |
| action       | 是   | string | delete_port                          | 刪除端口        |
| guid         | 是   | string | 1708217536092719                     | 業(yè)務(wù)GUID        |
| port_guid    | 是   | string | 30298762-2b21-45e2-b547-06c2e17b44ca | 端口記錄guid    |
| service_type | 是   | string | 1                                    | 類型  1云服務(wù)器 |
| form         | 是   | string | default                              | 來(lái)源            |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 新增安全組

**請(qǐng)求參數(shù)**

| 參數(shù)       | 必選 | 類型   | 示例值           | 說(shuō)明                                              |
| ---------- | ---- | ------ | ---------------- | ------------------------------------------------- |
| action     | 是   | string | add_hardpolicy   | 新增安全組                                        |
| guid       | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID                                          |
| weight     | 是   | string | 1                | 權(quán)重  權(quán)重級(jí)別不能重復(fù)                            |
| name       | 是   | string | 開放3389端口     | 安全組名稱                                        |
| direction  | 是   | enum   | Inbound          | 方向:[入方向 Inbound/出方向 Outbound/雙方向 Both] |
| protocol   | 是   | string | tcp              | 協(xié)議類型 TCP、UDP、ICMP、自定義                   |
| operation  | 是   | enum   | Allow            | 行為: [拒絕 Deny/允許 Allow]                      |
| remote_ip  | 否   | string | 127.0.0.1        | 遠(yuǎn)程IP地址 可以為單個(gè)IP也可以為IP網(wǎng)段             |
| local_port | 否   | string | 3389             | 本地端口  ，0表示所有，也可以 5-15的格式          |

**返回示例**

{
		"code":0,
		"message":"success",
		"data":{
			"policy_info":{
				"id":"825",
				"name":"\u5b89\u5168\u7ec41",
				"guid":"1708300552317770",
				"weight":"1",
				"direction":"Inbound",
				"action":"Allow",
				"protocol":"tcp",
				"remote_ip":"127.0.0.1",
				"local_port":"3389",
				"switch_name":"private_net",
				"service_type":"server",
				"service_id":"9519",
				"create_time":"2021-08-17 09:06:01",
				"status":"1",
				"strategy_type":"1",
				"master_strategy_id":"0",
				"message":"",
				"is_agent":"0"
			}
		}
	}

**返回值**

| 參數(shù)                                | 類型/長(zhǎng)度 | 示例值              | 說(shuō)明                                              |
| ----------------------------------- | --------- | ------------------- | ------------------------------------------------- |
| code                                | int       | 0                   | 返回狀態(tài) 0:成功 , 1:失敗                          |
| message                             | string    | success             | 反饋信息                                          |
| data                                | array     | array               |                                                   |
| data.policy_info                    | json      | {}                  | 開通的端口信息                                    |
| data.policy_info.id                 | string    | 1036                | 特殊id                                            |
| data.policy_info.name               | string    | 開放3389端口        | 安全組名稱                                        |
| data.policy_info.weight             | string    | 1                   | 安全組權(quán)重                                        |
| data.policy_info.direction          | enum      | Inbound             | 方向:[入方向 Inbound/出方向 Outbound/雙方向 Both] |
| data.policy_info.action             | enum      | Allow               | 行為: [拒絕 Deny/允許 Allow]                      |
| data.policy_info.protocol           | string    | tcp,udp             | 端口協(xié)議                                          |
| data.policy_info.remote_ip          | string    | 127.0.0.1           | 遠(yuǎn)程ip                                            |
| data.policy_info.local_port         | string    | 3389                | 本地端口                                          |
| data.policy_info.switch_name        | string    | private_net         | 網(wǎng)卡名稱                                          |
| data.policy_info.service_type       | string    | server              | 業(yè)務(wù)類型                                          |
| data.policy_info.service_id         | string    | 9519                | 業(yè)務(wù)id,本地需要替換成自己的業(yè)務(wù)id                 |
| data.policy_info.create_time        | string    | 2021-08-17 09:06:01 | 創(chuàng)建日期                                          |
| data.policy_info.status             | string    | 1                   | 狀態(tài)值 1 正常 0 異常 -1刪除                       |
| data.policy_info.strategy_type      | string    | 1                   | 策略類型：1，普通策略；2，預(yù)設(shè)策略                |
| data.policy_info.master_strategy_id | string    | 0                   | 下級(jí)可忽略                                        |
| data.policy_info.message            | string    | 0                   | 策略創(chuàng)建信息                                      |
| data.policy_info.is_agent           | string    | 0                   | 是否api請(qǐng)求                                       |

### 刪除安全組

**請(qǐng)求參數(shù)**

| 參數(shù)        | 必選 | 類型   | 示例值           | 說(shuō)明       |
| ----------- | ---- | ------ | ---------------- | ---------- |
| action      | 是   | string | del_hardpolicy   | 刪除安全組 |
| guid        | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID   |
| policy_guid | 是   | string | 1708300552317770 | 安全組GUID |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 續(xù)費(fèi)

**請(qǐng)求參數(shù)**

| 參數(shù)            | 必選 | 類型   | 示例值              | 說(shuō)明           |
| --------------- | ---- | ------ | ------------------- | -------------- |
| action          | 是   | string | renew               | 續(xù)費(fèi)           |
| guid            | 是   | string | 1708217536092719    | 業(yè)務(wù)GUID       |
| months          | 是   | string | 1                   | 續(xù)費(fèi)的月份數(shù)   |
| client_end_time | 是   | string | 2021-09-11 14:35:34 | 續(xù)費(fèi)后到期時(shí)間 |
| clientOrderNo   | 是   | string | 800682511569178001  | 客戶端訂單號(hào)   |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

### 退款

**請(qǐng)求參數(shù)**

| 參數(shù)   | 必選 | 類型   | 示例值           | 說(shuō)明     |
| ------ | ---- | ------ | ---------------- | -------- |
| action | 是   | string | refund           | 退款     |
| guid   | 是   | string | 1708217536092719 | 業(yè)務(wù)GUID |

**返回示例**

{
		"code": 0,
		"message": "success",
		"data": []
	}

**返回值**

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎開放API

文檔首頁(yè)

云業(yè)務(wù)管理系統(tǒng)（國(guó)內(nèi)版）

云服務(wù)器API文檔

18+

1000+

30+

5+