下載對端配置
更新時間 2023-12-28 15:00:12
最近更新時間: 2023-12-28 15:00:12
分享文章
下載VPN連接對端的配置信息。
接口功能介紹
下載VPN連接對端的配置信息
接口約束
支持主備模式資源池。
URI
GET /v4/vpn/config/query
路徑參數
無
Query 參數
無
請求參數
請求頭 header 參數
無
請求體 body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池ID | ||
| vpnGatewayID | 是 | String | VPN網關 ID | ||
| userGatewayID | 是 | String | 用戶網關 ID | ||
| vpnConnectionID | 是 | String | VPN連接 ID |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼(800為成功，900為失敗) | ||
| message | String | 失敗時的錯誤描述，一般為英文描述 | ||
| description | String | 失敗時的錯誤描述，一般為中文描述 | ||
| returnObj | Object | 返回對象 | returnObj | |
| errorCode | String | 業務細分碼，為product.module.code三段式碼 | ||
| errorDetail | Object | 錯誤明細 |
表returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| currentCount | Interger | 當前返回連接配置數量 | ||
| totalCount | Interger | 總共連接配置數量 | ||
| totalPage | Interger | 總共連接配置頁數 | ||
| results | Array of Object | VPN連接策略信息列表 | result | |
| errorCode | String | 錯誤碼 | ||
| message | String | 錯誤信息 | ||
| description | String | 描述 | ||
| statusCode | String | 800成功，900失敗 |
表result
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| vpnGateway | Object | VPN網關配置信息 | VPNGateway | |
| userGateway | Object | 用戶網關配置信息 | UserGateway | |
| vpnConnection | Object | VPN連接配置信息 | VPNConnection | |
| ikePolicy | Object | IKE 策略 | IkePolicy | |
| ipsecPolicy | Object | IPSec 策略 | IpsecPolicy |
表VPNGateway
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| vpnConnectionID | String | VPN連接ID | ||
| type | String | VPN類型(如IPSEC) | ||
| vpcID | String | VPC ID | ||
| vpnGatewayName | String | VPN網關名字 | ||
| vpnGatewayID | String | VPN網關ID | ||
| vpcName | String | VPC 名字 | ||
| ipAddress | String | IP地址 | ||
| bandwidth | Interger | 帶寬 | ||
| isExpire | Boolean | 是否過期 | ||
| isTalkOrder | Boolean | 是否按需訂單 | ||
| status | Integer | 狀態碼 | ||
| createDate | String | 創建時間 | ||
| deleteDate | String | 刪除時間 |
表UserGateway
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| vpnConnectionID | String | VPN連接ID | ||
| userGatewayID | String | 用戶網關ID | ||
| userGatewayName | String | 用戶網關名字 | ||
| ipAddress | String | IP地址 | ||
| createDate | String | 創建時間 | ||
| description | String | 描述 |
表VPNConnection
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| dstCidr | Array of String | 目的子網列表 | ||
| srcSubnet | Array of String | 源子網列表 | ||
| vpnConnectionID | String | VPN連接ID | ||
| vpnConnectionName | String | VPN連接名字 | ||
| userGatewayID | String | 用戶網關ID | ||
| userGatewayName | String | 用戶網關名字 | ||
| vpnGatewayID | String | VPN網關ID | ||
| vpnGatewayName | String | VPN網關名字 | ||
| status | Integer | 狀態碼 | ||
| createDate | String | 創建時間 | ||
| description | String | 描述 |
表IkePolicy
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| authAlgorithm | String | IKE認證算法 | ||
| encryptionAlgorithm | String | IKE加密算法 | ||
| ikeVersion | String | IKE版本 | ||
| lifetime | String | 生命周期 | ||
| pfs | String | IKE DH算法 | ||
| phase1NegotiationMode | String | 協商模式 |
表IpsecPolicy
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| transformProtocol | String | 傳輸協議 | ||
| authAlgorithm | String | IPSEC認證算法 | ||
| encryptionAlgorithm | String | IPSEC 加密算法 | ||
| lifetime | String | IPSEC 生命周期 | ||
| pfs | String | IPSEC DH算法 |
請求示例
請求頭
無
請求體 body
{
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"vpnGatewayID": "e023d46d-87ac-4f39-ae62-eb5c5434aa8c",
"userGatewayID": "b91735c9-41d8-40cf-88c6-f12a4064f09f",
"vpnConnectionID": "9480b3dc-f3e9-4a85-b170-0106f6218637"
}
響應示例
{
"returnObj": {
"currentCount": 1,
"totalCount": 1,
"totalPage": 1,
"results": [{
"vpnGateway": {
"status": "normal",
"vpnConnectionID": "9480b3dc-f3e9-4a85-b170-0106f6218637",
"vpnID": "e023d46d-87ac-4f39-ae62-eb5c5434aa8c",
"vpcID": "4df24b8e-b92d-473b-9f28-bf92dca073d1",
"vpnConnectionCount": 1,
"resourceID": "9d93348ff0da426294876b152a74a009",
"createDate": "2023-02-02T07:37:54Z",
"isTalkOrder": false,
"bandwidth": 5,
"vpcName": "vpc-7e53",
"isExpire": false,
"connectionLimit": 10,
"type": "IPsec",
"ipAddress": "100.127.7.231",
"vpnName": "vpn-gateway-ab55",
"deleteDate": "2023-05-02T07:38:38Z"
},
"ikePolicy": {
"lifetime": "86400",
"ikeVersion": "v1",
"pfs": "group5",
"authAlgorithm": "sha1",
"phase1NegotiationMode": "main",
"encryptionAlgorithm": "aes-128"
},
"userGateway": {
"vpnConnectionName": null,
"vpnConnectionID": "9480b3dc-f3e9-4a85-b170-0106f6218637",
"description": "",
"userGatewayID": "b91735c9-41d8-40cf-88c6-f12a4064f09f",
"createDate": "2023-02-02T09:10:07.581253Z",
"userGatewayName": "user-gateway-6941",
"ipAddress": "149.2.1.1"
},
"ipsecPolicy": {
"lifetime": "3600",
"encryptionAlgorithm": "aes-128",
"pfs": "group5",
"authAlgorithm": "sha1",
"transformProtocol": "esp"
},
"vpnConnection": {
"vpnConnectionName": "connection-caf9",
"vpnConnectionID": "9480b3dc-f3e9-4a85-b170-0106f6218637",
"description": "",
"userGatewayName": "user-gateway-6941",
"vpnGatewayName": "vpn-gateway-ab55",
"createDate": "2023-02-02T09:11:58.047522Z",
"dstCidr": ["172.29.55.0/24"],
"status": 1,
"vpnGatewayID": "e023d46d-87ac-4f39-ae62-eb5c5434aa8c",
"psk": "V2tkU2VtRkhlSFJqTVQxMTE=",
"srcSubnet": ["192.168.0.0/24"]
}
}]
},
"errorCode": "",
"message": "",
"description": "",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功 |
| 900 | 表示請求未成功 |
