DescribeVpnGateway - VPN Gateway

呼叫 DescribeVpnGateway 介面查詢指定 VPN 閘道的詳細資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:DescribeVpnGateway

get

*VpnGateway

acs:vpc:{#regionId}:{#accountId}:vpngateway/{#VpnGatewayId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	VPN 閘道所在的地域 ID。您可以透過呼叫 DescribeRegions 介面取得地域 ID。	cn-hangzhou
VpnGatewayId	string	是	VPN 閘道執行個體 ID。	vpn-bp1r3v1xqkl0w519g****
IncludeReservationData	boolean	否	是否包含未生效的訂單資料。取值： false（預設值）：不包含未生效的訂單資料。 true：包含未生效的訂單資料。	true

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
VpnType	string	VPN 閘道類型。取值：Normal，表示普通型。	Normal
Status	string	VPN 閘道的狀態。取值： init：初始化。 provisioning：準備中。 active：正常。 updating：更新中。 deleting：刪除中。	init
VpcId	string	VPN 閘道所屬 VPC 的 ID。	vpc-bp19m2yx1m5q0avyq****
SslMaxConnections	integer	SSL-VPN 並行連線使用者數的規格。	5
Spec	string	VPN 閘道的頻寬規格。單位：Mbps。	5
InternetIp	string	在 VPN 閘道執行個體支援建立單隧道模式 IPsec-VPN 連線的場景下，該地址為 VPN 閘道執行個體的 IP 地址，可用於建立 IPsec-VPN 連線或 SSL-VPN 連線。在 VPN 閘道執行個體支援建立雙隧道模式 IPsec-VPN 連線的場景下，該地址為用於建立 IPsec-VPN 連線的第一個 IP 地址，不能用於建立 SSL-VPN 連線。在 VPN 閘道執行個體支援建立雙隧道模式 IPsec-VPN 連線的場景下，系統會為 VPN 閘道執行個體分配兩個 IPsec 地址，用於建立雙隧道模式的 IPsec-VPN 連線。	47.22.XX.XX
CreateTime	integer	建立 VPN 閘道的時間戳記。單位：毫秒。時間戳記的格式採用 Unix 時間戳記，表示從格林威治時間 1970 年 01 月 01 日 00 時 00 分 00 秒至建立 VPN 閘道時的總時長。	1495382400000
AutoPropagate	boolean	是否已開啟 VPN 閘道的路由自動傳播功能。取值： true：已開啟。 false：未開啟。	true
ChargeType	string	付費類型。僅取值： POSTPAY，按量計費。。	中国站示例值：Prepay，国际站示例值：POSTPAY
VpnGatewayId	string	VPN 閘道執行個體 ID。	vpn-bp1r3v1xqkl0w519g****
Tag	string	系統自動產生的 VPN 閘道標籤。 VpnEnableBgp：表示 VPN 閘道是否支援 BGP 功能。 true：支援。 false：不支援。 VisuallySsl：表示 VPN 閘道是否支援查看 SSL 用戶端的連線資訊。 true：支援。 false：不支援。 PbrPriority：表示 VPN 閘道是否支援為策略路由配置策略優先級。 true：支援。 false：不支援。 VpnNewImage：表示 VPN 閘道是否為新型 VPN 閘道。 true：是。 false：否。 description：表示 VPN 閘道的描述資訊，僅供系統內部使用。 VpnVersion：表示 VPN 閘道的版本號。 IDaaSNewVersion：表示 VPN 閘道是否支援綁定 EIAM 2.0 執行個體。 true：支援。 false：不支援。	{\"VpnEnableBgp\":\"true\",\"VisuallySsl\":\"true\",\"PbrPriority\":\"true\",\"VpnNewImage\":\"true\",\"description\":\"转发1.3.24\",\"VpnVersion\":\"v1.2.4\",\"IDaaSNewVersion\":\"true\"}
IpsecVpn	string	是否開啟了 IPsec-VPN 功能。取值： enable：已開啟。 disable：未開啟。	enable
EndTime	integer	VPN 閘道到期時間戳記。單位：毫秒。時間戳記的格式採用 Unix 時間戳記，表示從格林威治時間 1970 年 01 月 01 日 00 時 00 分 00 秒至 VPN 閘道到期時的總時長。	1544666102000
VSwitchId	string	VPN 閘道所屬交換機的 ID。	vsw-bp1dmzugdikc6hdgx****
RequestId	string	請求 ID。	27E4E088-8DE0-4672-BF5C-0A412389DB9E
Description	string	VPN 閘道的描述資訊。	vpngatewaydescription
EnableBgp	boolean	VPN 閘道 BGP 功能的開啟狀態。取值： true：已開啟。 false：未開啟。	true
BusinessStatus	string	VPN 閘道的付費狀態。取值： Normal：正常。 FinancialLocked：欠費鎖定。	Normal
SslVpn	string	SSL-VPN 功能的開啟狀態。取值： enable：已開啟。 disable：未開啟。	enable
Name	string	VPN 閘道的名稱。	vpngatewayname
ReservationData	object	未生效的訂單資料。說明僅 IncludeReservationData 傳入 true 才會返回該組參數。
Status	string	未生效訂單狀態。取值： 1：表示續費或續費變配的訂單未生效。 2：表示臨時升配的訂單已生效。在到達還原時間後，系統會將 VPN 閘道規格恢復到臨時升配前的規格。此時 ReservationIpsec、ReservationMaxConnections、ReservationSpec、ReservationSsl 表示為 VPN 閘道臨時升配前的規格。	1
ReservationOrderType	string	未生效訂單類型。取值： RENEWCHANGE：續費變配。 TEMP_UPGRADE：臨時升配。 RENEW：續費。	TEMP_UPGRADE
ReservationIpsec	string	未生效訂單 IPsec-VPN 功能開啟狀態。取值： enable：已開啟。 disable：未開啟。	enable
ReservationSpec	string	未生效訂單的頻寬規格。單位：Mbps。	5
ReservationSsl	string	未生效訂單 SSL-VPN 功能開啟狀態。取值： enable：已開啟。 disable：未開啟。	enable
ReservationMaxConnections	integer	未生效訂單 SSL-VPN 並行連線使用者數的規格。	5
ReservationEndTime	string	如果未生效訂單類型為 TEMP_UPGRADE（臨時升配）時，該參數表示為臨時升配的還原時間。如果未生效訂單類型為 RENEWCHANGE（續費變配）或 RENEW（續費）時，該參數表示為續費或續費變配開始生效時間。	2020-07-20T16:00:00Z
Tags	object
Tag	array<object>	VPN 閘道執行個體綁定的標籤列表。
	object	VPN 閘道執行個體綁定的標籤列表。
Key	string	標籤鍵。	aaa
Value	string	標籤值。	bbb
NetworkType	string	VPN 閘道的網路類型。 public：公網 VPN 閘道。 private：私網 VPN 閘道。	public
DisasterRecoveryInternetIp	string	系統為 VPN 閘道執行個體分配的用於建立 IPsec-VPN 連線的第二個 IP 地址。僅支援建立雙隧道模式 IPsec-VPN 連線的 VPN 閘道執行個體會返回當前參數。	47.91.XX.XX
DisasterRecoveryVSwitchId	string	VPN 閘道執行個體關聯的第二個交換機 ID。僅支援建立雙隧道模式 IPsec-VPN 連線的 VPN 閘道執行個體會返回當前參數。	vsw-p0w95ql6tmr2ludkt****
SslVpnInternetIp	string	SSL-VPN 連線的 IP 地址。僅支援建立雙隧道模式 IPsec-VPN 連線的公網網路類型的 VPN 閘道執行個體開啟 SSL-VPN 功能後，才會返回當前參數。	47.74.XX.XX
ResourceGroupId	string	VPN 閘道所屬的資源群組 ID。您可以呼叫 ListResourceGroups 介面查詢資源群組資訊。	rg-acfmzs372yg****
EniInstanceIds	object
EniInstanceId	array	系統為 VPN 閘道執行個體建立的彈性網卡 ENI（Elastic Network Interfaces）列表。
	string	ENI ID。僅支援建立雙隧道模式 IPsec-VPN 連線的 VPN 閘道執行個體會返回當前參數。	eni-7xvcxgmd4y2ypibn****
GatewayType	string	VPN 閘道類型，取值： Traditional：傳統型 VPN 閘道，覆蓋 IPSec 功能和 SSL 功能 Enhanced.SiteToSite：增強型站點入雲 VPN，只覆蓋 IPSec 功能。	Enhanced.SiteToSite

樣本

正常返回樣本

JSON格式

{
  "VpnType": "Normal",
  "Status": "init",
  "VpcId": "vpc-bp19m2yx1m5q0avyq****",
  "SslMaxConnections": 5,
  "Spec": "5",
  "InternetIp": "47.22.XX.XX",
  "CreateTime": 1495382400000,
  "AutoPropagate": true,
  "ChargeType": "中国站示例值：Prepay，国际站示例值：POSTPAY",
  "VpnGatewayId": "vpn-bp1r3v1xqkl0w519g****",
  "Tag": "{\\\"VpnEnableBgp\\\":\\\"true\\\",\\\"VisuallySsl\\\":\\\"true\\\",\\\"PbrPriority\\\":\\\"true\\\",\\\"VpnNewImage\\\":\\\"true\\\",\\\"description\\\":\\\"转发1.3.24\\\",\\\"VpnVersion\\\":\\\"v1.2.4\\\",\\\"IDaaSNewVersion\\\":\\\"true\\\"}",
  "IpsecVpn": "enable",
  "EndTime": 1544666102000,
  "VSwitchId": "vsw-bp1dmzugdikc6hdgx****",
  "RequestId": "27E4E088-8DE0-4672-BF5C-0A412389DB9E",
  "Description": "vpngatewaydescription",
  "EnableBgp": true,
  "BusinessStatus": "Normal",
  "SslVpn": "enable",
  "Name": "vpngatewayname",
  "ReservationData": {
    "Status": "1",
    "ReservationOrderType": "TEMP_UPGRADE",
    "ReservationIpsec": "enable",
    "ReservationSpec": "5",
    "ReservationSsl": "enable",
    "ReservationMaxConnections": 5,
    "ReservationEndTime": "2020-07-20T16:00:00Z"
  },
  "Tags": {
    "Tag": [
      {
        "Key": "aaa",
        "Value": "bbb"
      }
    ]
  },
  "NetworkType": "public",
  "DisasterRecoveryInternetIp": "47.91.XX.XX",
  "DisasterRecoveryVSwitchId": "vsw-p0w95ql6tmr2ludkt****",
  "SslVpnInternetIp": "47.74.XX.XX",
  "ResourceGroupId": "rg-acfmzs372yg****",
  "EniInstanceIds": {
    "EniInstanceId": [
      "eni-7xvcxgmd4y2ypibn****"
    ]
  },
  "GatewayType": "Enhanced.SiteToSite"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	InvalidVpnGatewayInstanceId.NotFound	The specified vpn gateway instance id does not exist.
403	Forbbiden.SubUser	User not authorized to operate on the specified resource as your account is created by another user.
403	Forbidden	User not authorized to operate on the specified resource.
404	InvalidVpnGatewayInstanceId.NotFound	The specified vpn gateway instance id does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。