Vpn Connections - Get
擷取 VPN 連線的詳細數據。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}?api-version=2024-05-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
connection
|
path | True |
string |
vpn 連線的名稱。 |
gateway
|
path | True |
string |
閘道名稱。 |
resource
|
path | True |
string |
VpnGateway 的資源組名。 |
subscription
|
path | True |
string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
要求成功。 傳回 vpn 連線的詳細數據。 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
VpnConnectionGet
範例要求
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1?api-version=2024-05-01
範例回覆
{
"name": "vpnConnection1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"properties": {
"provisioningState": "Succeeded",
"remoteVpnSite": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1"
},
"enableInternetSecurity": false,
"ingressBytesTransferred": 0,
"egressBytesTransferred": 0,
"trafficSelectorPolicies": [],
"vpnLinkConnections": [
{
"name": "Connection-Link1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1/VpnSiteLinkConnections/Connection-Link1",
"type": "Microsoft.Network/vpnGateways/vpnConnections/VpnSiteLinkConnections",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"properties": {
"provisioningState": "Succeeded",
"vpnSiteLink": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/siteLink1"
},
"connectionBandwidth": 200,
"ipsecPolicies": [],
"vpnConnectionProtocolType": "IKEv2",
"sharedKey": "key",
"ingressBytesTransferred": 0,
"egressBytesTransferred": 0,
"enableBgp": false,
"enableRateLimiting": false,
"useLocalAzureIpAddress": false,
"usePolicyBasedTrafficSelectors": false,
"routingWeight": 0,
"vpnLinkConnectionMode": "ResponderOnly"
}
},
{
"name": "Connection-Link2",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1/VpnSiteLinkConnections/Connection-Link2",
"type": "Microsoft.Network/vpnGateways/vpnConnections/VpnSiteLinkConnections",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"properties": {
"provisioningState": "Succeeded",
"vpnSiteLink": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/siteLink2"
},
"connectionBandwidth": 200,
"ipsecPolicies": [],
"vpnConnectionProtocolType": "IKEv2",
"sharedKey": "key",
"ingressBytesTransferred": 0,
"egressBytesTransferred": 0,
"enableBgp": false,
"enableRateLimiting": false,
"useLocalAzureIpAddress": false,
"usePolicyBasedTrafficSelectors": false,
"routingWeight": 0,
"vpnLinkConnectionMode": "InitiatorOnly"
}
}
],
"routingConfiguration": {
"associatedRouteTable": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable1"
},
"propagatedRouteTables": {
"labels": [
"label1",
"label2"
],
"ids": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable1"
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable2"
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable3"
}
]
},
"inboundRouteMap": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap1"
},
"outboundRouteMap": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap2"
}
}
}
}
定義
名稱 | Description |
---|---|
Cloud |
來自服務的錯誤回應。 |
Cloud |
來自服務的錯誤回應。 |
Dh |
在 IKE 階段 1 中用於初始 SA 的 DH 群組。 |
Gateway |
虛擬網路網關聯機的 GatewayCustomBgpIpAddressIpConfiguration。 |
Ike |
IKE 加密演算法 (IKE 階段 2)。 |
Ike |
IKE 完整性演算法 (IKE 階段 2)。 |
Ipsec |
IPSec 加密演算法 (IKE 階段 1)。 |
Ipsec |
IPSec 完整性演算法 (IKE 階段 1)。 |
Ipsec |
虛擬網路網關聯機的IPSec原則設定。 |
Pfs |
IKE 階段 2 中用於新子 SA 的 Pfs 群組。 |
Propagated |
要公告路由的 RouteTable 列表。 |
Provisioning |
目前的布建狀態。 |
Routing |
路由組態,指出此聯機的相關和傳播路由表。 |
Static |
所有靜態路由的清單。 |
Static |
此 HubVnetConnectionConfiguration 上靜態路由的設定,用於此 HubVnetConnection 上的靜態路由。 |
Sub |
另一個子資源的參考。 |
Traffic |
虛擬網路網關聯機的流量選取器原則。 |
Virtual |
用於此連線的連接通訊協定。 |
Vnet |
參數,判斷輪輻 vnet 中的 NVA 是否針對輪輻 vnet 中目的地的流量略過。 |
Vnet |
控制從 VirtualHub 到虛擬網路連線路由的路由清單。 |
Vpn |
VpnConnection 資源。 |
Vpn |
VPN 連線的目前狀態。 |
Vpn |
Vpn 連結連線模式。 |
Vpn |
VpnSiteLinkConnection 資源。 |
CloudError
來自服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error |
雲端錯誤本文。 |
CloudErrorBody
來自服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤的識別碼。 程序代碼是不變的,而且是要以程序設計方式取用。 |
details |
錯誤的其他詳細數據清單。 |
|
message |
string |
描述錯誤的訊息,適用於在使用者介面中顯示。 |
target |
string |
特定錯誤的目標。 例如,錯誤中的屬性名稱。 |
DhGroup
在 IKE 階段 1 中用於初始 SA 的 DH 群組。
名稱 | 類型 | Description |
---|---|---|
DHGroup1 |
string |
|
DHGroup14 |
string |
|
DHGroup2 |
string |
|
DHGroup2048 |
string |
|
DHGroup24 |
string |
|
ECP256 |
string |
|
ECP384 |
string |
|
None |
string |
GatewayCustomBgpIpAddressIpConfiguration
虛擬網路網關聯機的 GatewayCustomBgpIpAddressIpConfiguration。
名稱 | 類型 | Description |
---|---|---|
customBgpIpAddress |
string |
屬於 IpconfigurationId 的自定義 BgpPeeringAddress。 |
ipConfigurationId |
string |
屬於閘道的 ipconfigurationId。 |
IkeEncryption
IKE 加密演算法 (IKE 階段 2)。
名稱 | 類型 | Description |
---|---|---|
AES128 |
string |
|
AES192 |
string |
|
AES256 |
string |
|
DES |
string |
|
DES3 |
string |
|
GCMAES128 |
string |
|
GCMAES256 |
string |
IkeIntegrity
IKE 完整性演算法 (IKE 階段 2)。
名稱 | 類型 | Description |
---|---|---|
GCMAES128 |
string |
|
GCMAES256 |
string |
|
MD5 |
string |
|
SHA1 |
string |
|
SHA256 |
string |
|
SHA384 |
string |
IpsecEncryption
IPSec 加密演算法 (IKE 階段 1)。
名稱 | 類型 | Description |
---|---|---|
AES128 |
string |
|
AES192 |
string |
|
AES256 |
string |
|
DES |
string |
|
DES3 |
string |
|
GCMAES128 |
string |
|
GCMAES192 |
string |
|
GCMAES256 |
string |
|
None |
string |
IpsecIntegrity
IPSec 完整性演算法 (IKE 階段 1)。
名稱 | 類型 | Description |
---|---|---|
GCMAES128 |
string |
|
GCMAES192 |
string |
|
GCMAES256 |
string |
|
MD5 |
string |
|
SHA1 |
string |
|
SHA256 |
string |
IpsecPolicy
虛擬網路網關聯機的IPSec原則設定。
名稱 | 類型 | Description |
---|---|---|
dhGroup |
在 IKE 階段 1 中用於初始 SA 的 DH 群組。 |
|
ikeEncryption |
IKE 加密演算法 (IKE 階段 2)。 |
|
ikeIntegrity |
IKE 完整性演算法 (IKE 階段 2)。 |
|
ipsecEncryption |
IPSec 加密演算法 (IKE 階段 1)。 |
|
ipsecIntegrity |
IPSec 完整性演算法 (IKE 階段 1)。 |
|
pfsGroup |
IKE 階段 2 中用於新子 SA 的 Pfs 群組。 |
|
saDataSizeKilobytes |
integer |
IPSec 安全性關聯 (也稱為快速模式或階段 2 SA) 承載大小 KB,適用於站對站 VPN 通道。 |
saLifeTimeSeconds |
integer |
IPSec 安全性關聯 (也稱為快速模式或階段 2 SA) 存留期,以秒為單位,用於站對站 VPN 通道。 |
PfsGroup
IKE 階段 2 中用於新子 SA 的 Pfs 群組。
名稱 | 類型 | Description |
---|---|---|
ECP256 |
string |
|
ECP384 |
string |
|
None |
string |
|
PFS1 |
string |
|
PFS14 |
string |
|
PFS2 |
string |
|
PFS2048 |
string |
|
PFS24 |
string |
|
PFSMM |
string |
PropagatedRouteTable
要公告路由的 RouteTable 列表。
名稱 | 類型 | Description |
---|---|---|
ids |
所有 RouteTable 的資源標識符清單。 |
|
labels |
string[] |
標籤清單。 |
ProvisioningState
目前的布建狀態。
名稱 | 類型 | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RoutingConfiguration
路由組態,指出此聯機的相關和傳播路由表。
名稱 | 類型 | Description |
---|---|---|
associatedRouteTable |
與此 RoutingConfiguration 相關聯的資源標識碼 RouteTable。 |
|
inboundRouteMap |
與此 RoutingConfiguration 相關聯的 RouteMap 資源識別碼,用於輸入學習的路由。 |
|
outboundRouteMap |
與這個 RoutingConfiguration 相關聯的RouteMap 資源標識碼,用於輸出公告的路由。 |
|
propagatedRouteTables |
要公告路由的 RouteTable 列表。 |
|
vnetRoutes |
控制從 VirtualHub 到虛擬網路連線路由的路由清單。 |
StaticRoute
所有靜態路由的清單。
名稱 | 類型 | Description |
---|---|---|
addressPrefixes |
string[] |
所有地址前綴的清單。 |
name |
string |
VnetRoute 內唯一的 StaticRoute 名稱。 |
nextHopIpAddress |
string |
下一個躍點的IP位址。 |
StaticRoutesConfig
此 HubVnetConnectionConfiguration 上靜態路由的設定,用於此 HubVnetConnection 上的靜態路由。
名稱 | 類型 | Description |
---|---|---|
propagateStaticRoutes |
boolean |
布爾值,指出此聯機上的靜態路由是否會自動傳播至此連線所傳播的路由表。 |
vnetLocalRouteOverrideCriteria |
參數,判斷輪輻 vnet 中的 NVA 是否針對輪輻中目的地的流量略過。 |
SubResource
另一個子資源的參考。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼。 |
TrafficSelectorPolicy
虛擬網路網關聯機的流量選取器原則。
名稱 | 類型 | Description |
---|---|---|
localAddressRanges |
string[] |
CIDR 格式的本機位址空間集合。 |
remoteAddressRanges |
string[] |
CIDR 格式的遠端位址空間集合。 |
VirtualNetworkGatewayConnectionProtocol
用於此連線的連接通訊協定。
名稱 | 類型 | Description |
---|---|---|
IKEv1 |
string |
|
IKEv2 |
string |
VnetLocalRouteOverrideCriteria
參數,判斷輪輻 vnet 中的 NVA 是否針對輪輻 vnet 中目的地的流量略過。
名稱 | 類型 | Description |
---|---|---|
Contains |
string |
|
Equal |
string |
VnetRoute
控制從 VirtualHub 到虛擬網路連線路由的路由清單。
名稱 | 類型 | Description |
---|---|---|
bgpConnections |
HubBgpConnection 對象的參考清單。 |
|
staticRoutes |
所有靜態路由的清單。 |
|
staticRoutesConfig |
此 HubVnetConnection 上的靜態路由設定。 |
VpnConnection
VpnConnection 資源。
名稱 | 類型 | Description |
---|---|---|
etag |
string |
每當更新資源時變更的唯一隻讀字串。 |
id |
string |
資源標識碼。 |
name |
string |
資源群組內唯一的資源名稱。 此名稱可用來存取資源。 |
properties.connectionBandwidth |
integer |
MBPS 的預期頻寬。 |
properties.connectionStatus |
線上狀態。 |
|
properties.dpdTimeoutSeconds |
integer |
VPN 連線的 DPD 逾時,以秒為單位。 |
properties.egressBytesTransferred |
integer |
傳輸的輸出位元組。 |
properties.enableBgp |
boolean |
EnableBgp 旗標。 |
properties.enableInternetSecurity |
boolean |
啟用因特網安全性。 |
properties.enableRateLimiting |
boolean |
EnableBgp 旗標。 |
properties.ingressBytesTransferred |
integer |
傳輸的輸入位元組。 |
properties.ipsecPolicies |
此連線所要考慮的IPSec原則。 |
|
properties.provisioningState |
VPN 連線資源的布建狀態。 |
|
properties.remoteVpnSite |
已連線 VPN 網站的識別碼。 |
|
properties.routingConfiguration |
路由組態,指出此聯機上相關聯的和傳播的路由表。 |
|
properties.routingWeight |
integer |
VPN 連線的路由權數。 |
properties.sharedKey |
string |
VPN 連線的 SharedKey。 |
properties.trafficSelectorPolicies |
此連線所要考慮的流量選取器原則。 |
|
properties.useLocalAzureIpAddress |
boolean |
使用本機 Azure IP 起始連線。 |
properties.usePolicyBasedTrafficSelectors |
boolean |
啟用以原則為基礎的流量選取器。 |
properties.vpnConnectionProtocolType |
用於此連線的連接通訊協定。 |
|
properties.vpnLinkConnections |
閘道的所有 VPN 網站連結連線清單。 |
VpnConnectionStatus
VPN 連線的目前狀態。
名稱 | 類型 | Description |
---|---|---|
Connected |
string |
|
Connecting |
string |
|
NotConnected |
string |
|
Unknown |
string |
VpnLinkConnectionMode
Vpn 連結連線模式。
名稱 | 類型 | Description |
---|---|---|
Default |
string |
|
InitiatorOnly |
string |
|
ResponderOnly |
string |
VpnSiteLinkConnection
VpnSiteLinkConnection 資源。
名稱 | 類型 | Description |
---|---|---|
etag |
string |
每當更新資源時變更的唯一隻讀字串。 |
id |
string |
資源標識碼。 |
name |
string |
資源群組內唯一的資源名稱。 此名稱可用來存取資源。 |
properties.connectionBandwidth |
integer |
MBPS 的預期頻寬。 |
properties.connectionStatus |
線上狀態。 |
|
properties.dpdTimeoutSeconds |
integer |
VpnLink 連線的死對等偵測逾時,以秒為單位。 |
properties.egressBytesTransferred |
integer |
傳輸的輸出位元組。 |
properties.egressNatRules |
輸出 NatRules 的清單。 |
|
properties.enableBgp |
boolean |
EnableBgp 旗標。 |
properties.enableRateLimiting |
boolean |
EnableBgp 旗標。 |
properties.ingressBytesTransferred |
integer |
傳輸的輸入位元組。 |
properties.ingressNatRules |
輸入 NatRules 的清單。 |
|
properties.ipsecPolicies |
此連線所要考慮的IPSec原則。 |
|
properties.provisioningState |
VPN 月台連結連線資源的布建狀態。 |
|
properties.routingWeight |
integer |
VPN 連線的路由權數。 |
properties.sharedKey |
string |
VPN 連線的 SharedKey。 |
properties.useLocalAzureIpAddress |
boolean |
使用本機 Azure IP 起始連線。 |
properties.usePolicyBasedTrafficSelectors |
boolean |
啟用以原則為基礎的流量選取器。 |
properties.vpnConnectionProtocolType |
用於此連線的連接通訊協定。 |
|
properties.vpnGatewayCustomBgpAddresses |
vpnGatewayCustomBgpAddresses 使用此聯機。 |
|
properties.vpnLinkConnectionMode |
Vpn 連結連線模式。 |
|
properties.vpnSiteLink |
已連線 VPN 網站鏈接的識別碼。 |
|
type |
string |
資源類型。 |