Vpn Connections - Get
Hämtar information om en VPN-anslutning.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}?api-version=2024-05-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
connection
|
path | True |
string |
Namnet på VPN-anslutningen. |
gateway
|
path | True |
string |
Namnet på gatewayen. |
resource
|
path | True |
string |
Resursgruppens namn på VpnGateway. |
subscription
|
path | True |
string |
Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
api-version
|
query | True |
string |
Klient-API-version. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Begäran lyckades. Returnerar information om VPN-anslutningen. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
VpnConnectionGet
Exempelbegäran
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1?api-version=2024-05-01
Exempelsvar
{
"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"
}
}
}
}
Definitioner
Name | Description |
---|---|
Cloud |
Ett felsvar från tjänsten. |
Cloud |
Ett felsvar från tjänsten. |
Dh |
De DH-grupper som används i IKE Fas 1 för inledande SA. |
Gateway |
GatewayCustomBgpIpAddressIpConfiguration för en virtuell nätverksgatewayanslutning. |
Ike |
IKE-krypteringsalgoritmen (IKE fas 2). |
Ike |
IKE-integritetsalgoritmen (IKE fas 2). |
Ipsec |
IPSec-krypteringsalgoritmen (IKE-fas 1). |
Ipsec |
IPSec-integritetsalgoritmen (IKE fas 1). |
Ipsec |
En IPSec-principkonfiguration för en anslutning till en virtuell nätverksgateway. |
Pfs |
Pfs-grupper som används i IKE Fas 2 för ny underordnad SA. |
Propagated |
Listan med RouteTables som du vill annonsera vägarna till. |
Provisioning |
Det aktuella etableringstillståndet. |
Routing |
Routningskonfiguration som anger de associerade och distribuerade routningstabellerna för den här anslutningen. |
Static |
Lista över alla statiska vägar. |
Static |
Konfiguration för statiska vägar på detta HubVnetConnectionConfiguration för statiska vägar på denna HubVnetConnection. |
Sub |
Referens till en annan underresurs. |
Traffic |
En trafikväljarprincip för en virtuell nätverksgatewayanslutning. |
Virtual |
Anslutningsprotokoll som används för den här anslutningen. |
Vnet |
Parameter som avgör om NVA i eker-vnet kringgås för trafik med målet i det virtuella ekernätverket. |
Vnet |
Lista över vägar som styr routning från VirtualHub till en virtuell nätverksanslutning. |
Vpn |
VpnConnection-resurs. |
Vpn |
Vpn-anslutningens aktuella tillstånd. |
Vpn |
Anslutningsläge för VPN-länk. |
Vpn |
VpnSiteLinkConnection-resurs. |
CloudError
Ett felsvar från tjänsten.
Name | Typ | Description |
---|---|---|
error |
Molnfeltext. |
CloudErrorBody
Ett felsvar från tjänsten.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
details |
En lista med ytterligare information om felet. |
|
message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
target |
string |
Målet för det specifika felet. Till exempel namnet på egenskapen i fel. |
DhGroup
De DH-grupper som används i IKE Fas 1 för inledande SA.
Name | Typ | Description |
---|---|---|
DHGroup1 |
string |
|
DHGroup14 |
string |
|
DHGroup2 |
string |
|
DHGroup2048 |
string |
|
DHGroup24 |
string |
|
ECP256 |
string |
|
ECP384 |
string |
|
None |
string |
GatewayCustomBgpIpAddressIpConfiguration
GatewayCustomBgpIpAddressIpConfiguration för en virtuell nätverksgatewayanslutning.
Name | Typ | Description |
---|---|---|
customBgpIpAddress |
string |
Den anpassade BgpPeeringAddress som tillhör IpconfigurationId. |
ipConfigurationId |
string |
IpconfigurationId för ipconfiguration som tillhör gatewayen. |
IkeEncryption
IKE-krypteringsalgoritmen (IKE fas 2).
Name | Typ | Description |
---|---|---|
AES128 |
string |
|
AES192 |
string |
|
AES256 |
string |
|
DES |
string |
|
DES3 |
string |
|
GCMAES128 |
string |
|
GCMAES256 |
string |
IkeIntegrity
IKE-integritetsalgoritmen (IKE fas 2).
Name | Typ | Description |
---|---|---|
GCMAES128 |
string |
|
GCMAES256 |
string |
|
MD5 |
string |
|
SHA1 |
string |
|
SHA256 |
string |
|
SHA384 |
string |
IpsecEncryption
IPSec-krypteringsalgoritmen (IKE-fas 1).
Name | Typ | Description |
---|---|---|
AES128 |
string |
|
AES192 |
string |
|
AES256 |
string |
|
DES |
string |
|
DES3 |
string |
|
GCMAES128 |
string |
|
GCMAES192 |
string |
|
GCMAES256 |
string |
|
None |
string |
IpsecIntegrity
IPSec-integritetsalgoritmen (IKE fas 1).
Name | Typ | Description |
---|---|---|
GCMAES128 |
string |
|
GCMAES192 |
string |
|
GCMAES256 |
string |
|
MD5 |
string |
|
SHA1 |
string |
|
SHA256 |
string |
IpsecPolicy
En IPSec-principkonfiguration för en anslutning till en virtuell nätverksgateway.
Name | Typ | Description |
---|---|---|
dhGroup |
Den DH-grupp som används i IKE Fas 1 för inledande SA. |
|
ikeEncryption |
IKE-krypteringsalgoritmen (IKE fas 2). |
|
ikeIntegrity |
IKE-integritetsalgoritmen (IKE fas 2). |
|
ipsecEncryption |
IPSec-krypteringsalgoritmen (IKE-fas 1). |
|
ipsecIntegrity |
IPSec-integritetsalgoritmen (IKE fas 1). |
|
pfsGroup |
Pfs-gruppen som används i IKE Fas 2 för ny underordnad SA. |
|
saDataSizeKilobytes |
integer |
IPSec-säkerhetsassociationen (kallas även snabbläge eller fas 2 SA) nyttolaststorlek i KB för en VPN-tunnel från plats till plats. |
saLifeTimeSeconds |
integer |
IPSec-säkerhetsassociationen (kallas även snabbläge eller fas 2 SA) i sekunder för en VPN-tunnel för plats-till-plats. |
PfsGroup
Pfs-grupper som används i IKE Fas 2 för ny underordnad SA.
Name | Typ | Description |
---|---|---|
ECP256 |
string |
|
ECP384 |
string |
|
None |
string |
|
PFS1 |
string |
|
PFS14 |
string |
|
PFS2 |
string |
|
PFS2048 |
string |
|
PFS24 |
string |
|
PFSMM |
string |
PropagatedRouteTable
Listan med RouteTables som du vill annonsera vägarna till.
Name | Typ | Description |
---|---|---|
ids |
Listan över resurs-ID:t för alla RouteTables. |
|
labels |
string[] |
Listan med etiketter. |
ProvisioningState
Det aktuella etableringstillståndet.
Name | Typ | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RoutingConfiguration
Routningskonfiguration som anger de associerade och distribuerade routningstabellerna för den här anslutningen.
Name | Typ | Description |
---|---|---|
associatedRouteTable |
Resurs-ID:t RouteTable som är associerad med den här RoutingConfiguration. |
|
inboundRouteMap |
Resurs-ID för RouteMap som är associerad med den här RoutingConfiguration för inkommande inlärda vägar. |
|
outboundRouteMap |
Resurs-ID för denRouteMap som är associerad med den här RoutingConfiguration för utgående annonserade vägar. |
|
propagatedRouteTables |
Listan med RouteTables som du vill annonsera vägarna till. |
|
vnetRoutes |
Lista över vägar som styr routning från VirtualHub till en virtuell nätverksanslutning. |
StaticRoute
Lista över alla statiska vägar.
Name | Typ | Description |
---|---|---|
addressPrefixes |
string[] |
Lista över alla adressprefix. |
name |
string |
Namnet på StaticRoute som är unikt i en VnetRoute. |
nextHopIpAddress |
string |
IP-adressen för nästa hopp. |
StaticRoutesConfig
Konfiguration för statiska vägar på detta HubVnetConnectionConfiguration för statiska vägar på denna HubVnetConnection.
Name | Typ | Description |
---|---|---|
propagateStaticRoutes |
boolean |
Booleskt värde som anger om statiska vägar i den här anslutningen automatiskt sprids till routningstabeller som anslutningen sprids till. |
vnetLocalRouteOverrideCriteria |
Parameter som avgör om NVA i eker-vnet kringgås för trafik med målet i eker. |
SubResource
Referens till en annan underresurs.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID. |
TrafficSelectorPolicy
En trafikväljarprincip för en virtuell nätverksgatewayanslutning.
Name | Typ | Description |
---|---|---|
localAddressRanges |
string[] |
En samling lokala adressutrymmen i CIDR-format. |
remoteAddressRanges |
string[] |
En samling fjärradressutrymmen i CIDR-format. |
VirtualNetworkGatewayConnectionProtocol
Anslutningsprotokoll som används för den här anslutningen.
Name | Typ | Description |
---|---|---|
IKEv1 |
string |
|
IKEv2 |
string |
VnetLocalRouteOverrideCriteria
Parameter som avgör om NVA i eker-vnet kringgås för trafik med målet i det virtuella ekernätverket.
Name | Typ | Description |
---|---|---|
Contains |
string |
|
Equal |
string |
VnetRoute
Lista över vägar som styr routning från VirtualHub till en virtuell nätverksanslutning.
Name | Typ | Description |
---|---|---|
bgpConnections |
Listan med referenser till HubBgpConnection-objekt. |
|
staticRoutes |
Lista över alla statiska vägar. |
|
staticRoutesConfig |
Konfiguration för statiska vägar på denna HubVnetConnection. |
VpnConnection
VpnConnection-resurs.
Name | Typ | Description |
---|---|---|
etag |
string |
En unik skrivskyddad sträng som ändras när resursen uppdateras. |
id |
string |
Resurs-ID. |
name |
string |
Namnet på resursen som är unik i en resursgrupp. Det här namnet kan användas för att komma åt resursen. |
properties.connectionBandwidth |
integer |
Förväntad bandbredd i MBPS. |
properties.connectionStatus |
Anslutningsstatus. |
|
properties.dpdTimeoutSeconds |
integer |
DPD-timeout i sekunder för VPN-anslutning. |
properties.egressBytesTransferred |
integer |
Utgående byte har överförts. |
properties.enableBgp |
boolean |
AktiveraBgp-flagga. |
properties.enableInternetSecurity |
boolean |
Aktivera internetsäkerhet. |
properties.enableRateLimiting |
boolean |
AktiveraBgp-flagga. |
properties.ingressBytesTransferred |
integer |
Inkommande byte har överförts. |
properties.ipsecPolicies |
IPSec-principerna som ska beaktas av den här anslutningen. |
|
properties.provisioningState |
Etableringstillståndet för VPN-anslutningsresursen. |
|
properties.remoteVpnSite |
ID för den anslutna VPN-platsen. |
|
properties.routingConfiguration |
Routningskonfigurationen som anger de associerade och spridade routningstabellerna i den här anslutningen. |
|
properties.routingWeight |
integer |
Routningsvikt för VPN-anslutning. |
properties.sharedKey |
string |
SharedKey för VPN-anslutningen. |
properties.trafficSelectorPolicies |
De trafikväljarprinciper som ska beaktas av den här anslutningen. |
|
properties.useLocalAzureIpAddress |
boolean |
Använd lokal azure ip för att initiera anslutningen. |
properties.usePolicyBasedTrafficSelectors |
boolean |
Aktivera principbaserade trafikväljare. |
properties.vpnConnectionProtocolType |
Anslutningsprotokoll som används för den här anslutningen. |
|
properties.vpnLinkConnections |
Lista över alla vpn-platslänkanslutningar till gatewayen. |
VpnConnectionStatus
Vpn-anslutningens aktuella tillstånd.
Name | Typ | Description |
---|---|---|
Connected |
string |
|
Connecting |
string |
|
NotConnected |
string |
|
Unknown |
string |
VpnLinkConnectionMode
Anslutningsläge för VPN-länk.
Name | Typ | Description |
---|---|---|
Default |
string |
|
InitiatorOnly |
string |
|
ResponderOnly |
string |
VpnSiteLinkConnection
VpnSiteLinkConnection-resurs.
Name | Typ | Description |
---|---|---|
etag |
string |
En unik skrivskyddad sträng som ändras när resursen uppdateras. |
id |
string |
Resurs-ID. |
name |
string |
Namnet på resursen som är unik i en resursgrupp. Det här namnet kan användas för att komma åt resursen. |
properties.connectionBandwidth |
integer |
Förväntad bandbredd i MBPS. |
properties.connectionStatus |
Anslutningsstatus. |
|
properties.dpdTimeoutSeconds |
integer |
Tidsgränsen för död peeridentifiering i sekunder för VpnLink-anslutning. |
properties.egressBytesTransferred |
integer |
Utgående byte har överförts. |
properties.egressNatRules |
Lista över utgående NatRules. |
|
properties.enableBgp |
boolean |
AktiveraBgp-flagga. |
properties.enableRateLimiting |
boolean |
AktiveraBgp-flagga. |
properties.ingressBytesTransferred |
integer |
Inkommande byte har överförts. |
properties.ingressNatRules |
Lista över inkommande NatRules. |
|
properties.ipsecPolicies |
IPSec-principerna som ska beaktas av den här anslutningen. |
|
properties.provisioningState |
Etableringstillståndet för VPN-platslänkanslutningsresursen. |
|
properties.routingWeight |
integer |
Routningsvikt för VPN-anslutning. |
properties.sharedKey |
string |
SharedKey för VPN-anslutningen. |
properties.useLocalAzureIpAddress |
boolean |
Använd lokal azure ip för att initiera anslutningen. |
properties.usePolicyBasedTrafficSelectors |
boolean |
Aktivera principbaserade trafikväljare. |
properties.vpnConnectionProtocolType |
Anslutningsprotokoll som används för den här anslutningen. |
|
properties.vpnGatewayCustomBgpAddresses |
vpnGatewayCustomBgpAddresses som används av den här anslutningen. |
|
properties.vpnLinkConnectionMode |
Anslutningsläge för VPN-länk. |
|
properties.vpnSiteLink |
Id för den anslutna vpn-platslänken. |
|
type |
string |
Resurstyp. |