Condividi tramite


Vpn Connections - List By Vpn Gateway

Recupera tutte le connessioni VPN per un gateway VPN della rete WAN virtuale specifico.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections?api-version=2023-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
gatewayName
path True

string

Nome del gateway.

resourceGroupName
path True

string

Nome del gruppo di risorse di VpnGateway.

subscriptionId
path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

api-version
query True

string

Versione dell'API client.

Risposte

Nome Tipo Descrizione
200 OK

ListVpnConnectionsResult

Richiesta riuscita. Restituisce tutte le connessioni VPN per un gateway VPN wan virtuale.

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

VpnConnectionList

Esempio di richiesta

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections?api-version=2023-11-01

Risposta di esempio

[
  {
    "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": "Default"
          }
        },
        {
          "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": "Default"
          }
        }
      ],
      "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"
        }
      }
    }
  }
]

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

DhGroup

I gruppi DH usati nella fase 1 IKE per l'amministratore di sicurezza iniziale.

GatewayCustomBgpIpAddressIpConfiguration

GatewayCustomBgpIpAddressIpConfiguration per una connessione gateway di rete virtuale.

IkeEncryption

Algoritmo di crittografia IKE (fase 2 IKE).

IkeIntegrity

Algoritmo di integrità IKE (fase 2 IKE).

IpsecEncryption

Algoritmo di crittografia IPSec (fase 1 IKE).

IpsecIntegrity

Algoritmo di integrità IPSec (fase 1 IKE).

IpsecPolicy

Configurazione dei criteri IPSec per una connessione gateway di rete virtuale.

ListVpnConnectionsResult

Risultato della richiesta di elencare tutte le connessioni VPN a un gateway VPN wan virtuale. Contiene un elenco di connessioni VPN e un URL nextLink per ottenere il set di risultati successivo.

PfsGroup

I gruppi Pfs usati nella fase 2 di IKE per il nuovo sa figlio.

PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.

ProvisioningState

Stato di provisioning corrente.

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate per questa connessione.

StaticRoute

Elenco di tutte le route statiche.

StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnectionConfiguration per le route statiche in questo hubVnetConnection.

SubResource

Riferimento a un'altra sottorisorsa.

TrafficSelectorPolicy

Criteri del selettore di traffico per una connessione gateway di rete virtuale.

VirtualNetworkGatewayConnectionProtocol

Protocollo di connessione usato per questa connessione.

VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete virtuale in spoke viene ignorata per il traffico con destinazione nella rete virtuale spoke.

VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

VpnConnection

Risorsa VpnConnection.

VpnConnectionStatus

Stato corrente della connessione VPN.

VpnLinkConnectionMode

Modalità di connessione del collegamento VPN.

VpnSiteLinkConnection

Risorsa VpnSiteLinkConnection.

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

DhGroup

I gruppi DH usati nella fase 1 IKE per l'amministratore di sicurezza iniziale.

Nome Tipo Descrizione
DHGroup1

string

DHGroup14

string

DHGroup2

string

DHGroup2048

string

DHGroup24

string

ECP256

string

ECP384

string

None

string

GatewayCustomBgpIpAddressIpConfiguration

GatewayCustomBgpIpAddressIpConfiguration per una connessione gateway di rete virtuale.

Nome Tipo Descrizione
customBgpIpAddress

string

BgpPeeringAddress personalizzato che appartiene a IpconfigurationId.

ipConfigurationId

string

IpconfigurationId di ipconfiguration che appartiene al gateway.

IkeEncryption

Algoritmo di crittografia IKE (fase 2 IKE).

Nome Tipo Descrizione
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES256

string

IkeIntegrity

Algoritmo di integrità IKE (fase 2 IKE).

Nome Tipo Descrizione
GCMAES128

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

SHA384

string

IpsecEncryption

Algoritmo di crittografia IPSec (fase 1 IKE).

Nome Tipo Descrizione
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES192

string

GCMAES256

string

None

string

IpsecIntegrity

Algoritmo di integrità IPSec (fase 1 IKE).

Nome Tipo Descrizione
GCMAES128

string

GCMAES192

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

IpsecPolicy

Configurazione dei criteri IPSec per una connessione gateway di rete virtuale.

Nome Tipo Descrizione
dhGroup

DhGroup

Gruppo DH usato nella fase 1 IKE per l'amministratore di sicurezza iniziale.

ikeEncryption

IkeEncryption

Algoritmo di crittografia IKE (fase 2 IKE).

ikeIntegrity

IkeIntegrity

Algoritmo di integrità IKE (fase 2 IKE).

ipsecEncryption

IpsecEncryption

Algoritmo di crittografia IPSec (fase 1 IKE).

ipsecIntegrity

IpsecIntegrity

Algoritmo di integrità IPSec (fase 1 IKE).

pfsGroup

PfsGroup

Gruppo Pfs usato nella fase 2 di IKE per il nuovo sa figlio.

saDataSizeKilobytes

integer

Dimensioni del payload dell'associazione di sicurezza IPSec (detta anche modalità rapida o sa fase 2) in KB per un tunnel VPN da sito a sito.

saLifeTimeSeconds

integer

Durata dell'associazione di sicurezza IPSec (detta anche modalità rapida o sa fase 2) in secondi per un tunnel VPN da sito a sito.

ListVpnConnectionsResult

Risultato della richiesta di elencare tutte le connessioni VPN a un gateway VPN wan virtuale. Contiene un elenco di connessioni VPN e un URL nextLink per ottenere il set di risultati successivo.

Nome Tipo Descrizione
nextLink

string

URL per ottenere il set successivo di risultati dell'elenco di operazioni, se presenti.

value

VpnConnection[]

Elenco di connessioni VPN.

PfsGroup

I gruppi Pfs usati nella fase 2 di IKE per il nuovo sa figlio.

Nome Tipo Descrizione
ECP256

string

ECP384

string

None

string

PFS1

string

PFS14

string

PFS2

string

PFS2048

string

PFS24

string

PFSMM

string

PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.

Nome Tipo Descrizione
ids

SubResource[]

Elenco di ID risorsa di tutte le tabelle RouteTable.

labels

string[]

Elenco di etichette.

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate per questa connessione.

Nome Tipo Descrizione
associatedRouteTable

SubResource

Id risorsa RouteTable associato a questo RoutingConfiguration.

inboundRouteMap

SubResource

ID risorsa dell'oggetto RouteMap associato a questo RoutingConfiguration per le route apprese in ingresso.

outboundRouteMap

SubResource

ID risorsa dell'oggettoRouteMap associato a questo RoutingConfiguration per le route annunciate in uscita.

propagatedRouteTables

PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.

vnetRoutes

VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

StaticRoute

Elenco di tutte le route statiche.

Nome Tipo Descrizione
addressPrefixes

string[]

Elenco di tutti i prefissi di indirizzo.

name

string

Nome dell'oggetto StaticRoute univoco all'interno di una rete virtuale.

nextHopIpAddress

string

Indirizzo IP dell'hop successivo.

StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnectionConfiguration per le route statiche in questo hubVnetConnection.

Nome Tipo Descrizione
propagateStaticRoutes

boolean

Valore booleano che indica se le route statiche in questa connessione vengono propagate automaticamente alle tabelle di route a cui viene propagata la connessione.

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete nella rete virtuale spoke viene ignorata per il traffico con destinazione in spoke.

SubResource

Riferimento a un'altra sottorisorsa.

Nome Tipo Descrizione
id

string

ID risorsa.

TrafficSelectorPolicy

Criteri del selettore di traffico per una connessione gateway di rete virtuale.

Nome Tipo Descrizione
localAddressRanges

string[]

Raccolta di spazi indirizzi locali in formato CIDR.

remoteAddressRanges

string[]

Raccolta di spazi indirizzi remoti in formato CIDR.

VirtualNetworkGatewayConnectionProtocol

Protocollo di connessione usato per questa connessione.

Nome Tipo Descrizione
IKEv1

string

IKEv2

string

VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete virtuale in spoke viene ignorata per il traffico con destinazione nella rete virtuale spoke.

Nome Tipo Descrizione
Contains

string

Equal

string

VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

Nome Tipo Descrizione
bgpConnections

SubResource[]

Elenco di riferimenti agli oggetti HubBgpConnection.

staticRoutes

StaticRoute[]

Elenco di tutte le route statiche.

staticRoutesConfig

StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnection.

VpnConnection

Risorsa VpnConnection.

Nome Tipo Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id

string

ID risorsa.

name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.

properties.connectionBandwidth

integer

Larghezza di banda prevista in MBPS.

properties.connectionStatus

VpnConnectionStatus

Stato della connessione.

properties.dpdTimeoutSeconds

integer

Timeout DPD in secondi per la connessione VPN.

properties.egressBytesTransferred

integer

Byte in uscita trasferiti.

properties.enableBgp

boolean

Flag EnableBgp.

properties.enableInternetSecurity

boolean

Abilitare la sicurezza Internet.

properties.enableRateLimiting

boolean

Flag EnableBgp.

properties.ingressBytesTransferred

integer

Byte in ingresso trasferiti.

properties.ipsecPolicies

IpsecPolicy[]

Criteri IPSec da considerare da questa connessione.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa di connessione VPN.

properties.remoteVpnSite

SubResource

ID del sito VPN connesso.

properties.routingConfiguration

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate in questa connessione.

properties.routingWeight

integer

Peso del routing per la connessione VPN.

properties.sharedKey

string

SharedKey per la connessione VPN.

properties.trafficSelectorPolicies

TrafficSelectorPolicy[]

Criteri del selettore di traffico da considerare da questa connessione.

properties.useLocalAzureIpAddress

boolean

Usare l'indirizzo IP di Azure locale per avviare la connessione.

properties.usePolicyBasedTrafficSelectors

boolean

Abilitare i selettori di traffico basati su criteri.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

Protocollo di connessione usato per questa connessione.

properties.vpnLinkConnections

VpnSiteLinkConnection[]

Elenco di tutte le connessioni al collegamento al sito VPN al gateway.

VpnConnectionStatus

Stato corrente della connessione VPN.

Nome Tipo Descrizione
Connected

string

Connecting

string

NotConnected

string

Unknown

string

VpnLinkConnectionMode

Modalità di connessione del collegamento VPN.

Nome Tipo Descrizione
Default

string

InitiatorOnly

string

ResponderOnly

string

VpnSiteLinkConnection

Risorsa VpnSiteLinkConnection.

Nome Tipo Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id

string

ID risorsa.

name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.

properties.connectionBandwidth

integer

Larghezza di banda prevista in MBPS.

properties.connectionStatus

VpnConnectionStatus

Stato della connessione.

properties.dpdTimeoutSeconds

integer

Timeout di rilevamento peer non recapitabili in secondi per la connessione VpnLink.

properties.egressBytesTransferred

integer

Byte in uscita trasferiti.

properties.egressNatRules

SubResource[]

Elenco di NatRules in uscita.

properties.enableBgp

boolean

Flag EnableBgp.

properties.enableRateLimiting

boolean

Flag EnableBgp.

properties.ingressBytesTransferred

integer

Byte in ingresso trasferiti.

properties.ingressNatRules

SubResource[]

Elenco di NatRules in ingresso.

properties.ipsecPolicies

IpsecPolicy[]

Criteri IPSec da considerare da questa connessione.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa di connessione al collegamento al sito VPN.

properties.routingWeight

integer

Peso del routing per la connessione VPN.

properties.sharedKey

string

SharedKey per la connessione VPN.

properties.useLocalAzureIpAddress

boolean

Usare l'indirizzo IP di Azure locale per avviare la connessione.

properties.usePolicyBasedTrafficSelectors

boolean

Abilitare i selettori di traffico basati su criteri.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

Protocollo di connessione usato per questa connessione.

properties.vpnGatewayCustomBgpAddresses

GatewayCustomBgpIpAddressIpConfiguration[]

vpnGatewayCustomBgpAddresses usato da questa connessione.

properties.vpnLinkConnectionMode

VpnLinkConnectionMode

Modalità di connessione del collegamento VPN.

properties.vpnSiteLink

SubResource

ID del collegamento al sito VPN connesso.

type

string

Tipo di risorsa.