Delen via


Vpn Gateways - Reset

Hiermee stelt u de primaire waarde van de VPN-gateway in de opgegeven resourcegroep opnieuw in.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/reset?api-version=2024-05-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/reset?ipConfigurationId={ipConfigurationId}&api-version=2024-05-01

URI-parameters

Name In Vereist Type Description
gatewayName
path True

string

De naam van de gateway.

resourceGroupName
path True

string

De naam van de resourcegroep van de VpnGateway.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

api-version
query True

string

Client-API-versie.

ipConfigurationId
query

string

VpnGateway ipConfigurationId om het gateway-exemplaar op te geven.

Antwoorden

Name Type Description
200 OK

VpnGateway

Aanvraag is voltooid. Met de bewerking wordt de primaire waarde van de VpnGateway opnieuw ingesteld.

202 Accepted

Geaccepteerd en de bewerking wordt asynchroon voltooid.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

ResetVpnGateway

Voorbeeldaanvraag

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/vpngw/reset?api-version=2024-05-01

Voorbeeldrespons

location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}
{
  "name": "vpngw",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/vpngw",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "type": "Microsoft.Network/vpnGateways",
  "properties": {
    "provisioningState": "Succeeded",
    "virtualHub": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1"
    },
    "connections": [
      {
        "name": "vpnConnection1",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/vpngw/vpnConnections/vpnConnection1",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "properties": {
          "provisioningState": "Succeeded",
          "remoteVpnSite": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1"
          },
          "connectionStatus": "Connected",
          "ingressBytesTransferred": 0,
          "egressBytesTransferred": 0,
          "routingWeight": 0,
          "connectionBandwidth": 100,
          "sharedKey": "key",
          "enableBgp": false,
          "useLocalAzureIpAddress": false,
          "ipsecPolicies": [],
          "routingConfiguration": {
            "associatedRouteTable": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
            },
            "propagatedRouteTables": {
              "labels": [
                "label1",
                "label2"
              ],
              "ids": [
                {
                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
                },
                {
                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable2"
                },
                {
                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable3"
                }
              ]
            },
            "vnetRoutes": {
              "staticRoutes": []
            }
          }
        }
      }
    ],
    "bgpSettings": {
      "asn": 65514,
      "bgpPeeringAddress": "10.0.1.30",
      "peerWeight": 0,
      "bgpPeeringAddresses": [
        {
          "ipconfigurationId": "Instance0",
          "defaultBgpIpAddresses": [
            "10.30.0.4"
          ],
          "customBgpIpAddresses": [
            "169.254.21.5"
          ],
          "tunnelIpAddresses": [
            "104.208.48.178"
          ]
        },
        {
          "ipconfigurationId": "Instance1",
          "defaultBgpIpAddresses": [
            "10.30.0.5"
          ],
          "customBgpIpAddresses": [
            "169.254.21.10"
          ],
          "tunnelIpAddresses": [
            "104.208.48.179"
          ]
        }
      ]
    },
    "natRules": [],
    "isRoutingPreferenceInternet": false,
    "enableBgpRouteTranslationForNat": false
  }
}

Definities

Name Description
BgpSettings

Details van BGP-instellingen.

CloudError

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

DhGroup

De DH-groepen die worden gebruikt in IKE Fase 1 voor de eerste SA.

GatewayCustomBgpIpAddressIpConfiguration

GatewayCustomBgpIpAddressIpConfiguration voor een virtuele netwerkgatewayverbinding.

IkeEncryption

Het IKE-versleutelingsalgoritmen (IKE-fase 2).

IkeIntegrity

Het IKE-integriteitsalgoritmen (IKE-fase 2).

IPConfigurationBgpPeeringAddress

Eigenschappen van IPConfigurationBgpPeeringAddress.

IpsecEncryption

Het IPSec-versleutelingsalgoritmen (IKE-fase 1).

IpsecIntegrity

Het IPSec-integriteitsalgoritmen (IKE-fase 1).

IpsecPolicy

Een IPSec-beleidsconfiguratie voor een virtuele netwerkgatewayverbinding.

PfsGroup

De Pfs-groepen die worden gebruikt in IKE Fase 2 voor nieuwe onderliggende SA.

PropagatedRouteTable

De lijst met RouteTables om de routes naar te adverteren.

ProvisioningState

De huidige inrichtingsstatus.

RoutingConfiguration

Routeringsconfiguratie die de gekoppelde en doorgegeven routetabellen voor deze verbinding aangeeft.

StaticRoute

Lijst met alle statische routes.

StaticRoutesConfig

Configuratie voor statische routes op deze HubVnetConnectionConfiguration voor statische routes op deze HubVnetConnection.

SubResource

Verwijzing naar een andere subresource.

TrafficSelectorPolicy

Een verkeersselectorbeleid voor een gatewayverbinding met een virtueel netwerk.

VirtualNetworkGatewayConnectionProtocol

Verbindingsprotocol dat wordt gebruikt voor deze verbinding.

VnetLocalRouteOverrideCriteria

Parameter die bepaalt of NVA in spoke-vnet wordt omzeild voor verkeer met bestemming in spoke-vnet.

VnetRoute

Lijst met routes die routering van VirtualHub naar een virtuele netwerkverbinding beheren.

VpnConnection

VpnConnection-resource.

VpnConnectionStatus

De huidige status van de VPN-verbinding.

VpnGateway

VpnGateway-resource.

VpnGatewayIpConfiguration

IP-configuratie van een VPN Gateway-resource.

VpnGatewayNatRule

VpnGatewayNatRule-resource.

VpnLinkConnectionMode

Vpn-koppelingsverbindingsmodus.

VpnNatRuleMapping

Vpn NatRule-toewijzing.

VpnNatRuleMode

De bron-NAT-richting van een VPN NAT.

VpnNatRuleType

Het type NAT-regel voor VPN NAT.

VpnSiteLinkConnection

VpnSiteLinkConnection-resource.

BgpSettings

Details van BGP-instellingen.

Name Type Description
asn

integer (int64)

minimum: 0
maximum: 4294967295

De ASN van de BGP-spreker.

bgpPeeringAddress

string

Het BGP-peeringadres en de BGP-id van deze BGP-spreker.

bgpPeeringAddresses

IPConfigurationBgpPeeringAddress[]

BGP-peeringadres met IP-configuratie-id voor virtuele netwerkgateway.

peerWeight

integer (int32)

Het gewicht toegevoegd aan routes die zijn geleerd van deze BGP-luidspreker.

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Hoofdtekst van cloudfout.

CloudErrorBody

Een foutreactie van de service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

CloudErrorBody[]

Een lijst met aanvullende informatie over de fout.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target

string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

DhGroup

De DH-groepen die worden gebruikt in IKE Fase 1 voor de eerste SA.

Waarde Description
DHGroup1
DHGroup14
DHGroup2
DHGroup2048
DHGroup24
ECP256
ECP384
None

GatewayCustomBgpIpAddressIpConfiguration

GatewayCustomBgpIpAddressIpConfiguration voor een virtuele netwerkgatewayverbinding.

Name Type Description
customBgpIpAddress

string

Het aangepaste BgpPeeringAddress dat deel uitmaakt van IpconfigurationId.

ipConfigurationId

string

De IpconfigurationId van ipconfiguration die deel uitmaakt van de gateway.

IkeEncryption

Het IKE-versleutelingsalgoritmen (IKE-fase 2).

Waarde Description
AES128
AES192
AES256
DES
DES3
GCMAES128
GCMAES256

IkeIntegrity

Het IKE-integriteitsalgoritmen (IKE-fase 2).

Waarde Description
GCMAES128
GCMAES256
MD5
SHA1
SHA256
SHA384

IPConfigurationBgpPeeringAddress

Eigenschappen van IPConfigurationBgpPeeringAddress.

Name Type Description
customBgpIpAddresses

string[]

De lijst met aangepaste BGP-peeringadressen die deel uitmaken van ip-configuratie.

defaultBgpIpAddresses

string[]

De lijst met standaard BGP-peeringadressen die deel uitmaken van ip-configuratie.

ipconfigurationId

string

De id van de IP-configuratie die deel uitmaakt van de gateway.

tunnelIpAddresses

string[]

De lijst met openbare IP-adressen van de tunnel die deel uitmaken van de IP-configuratie.

IpsecEncryption

Het IPSec-versleutelingsalgoritmen (IKE-fase 1).

Waarde Description
AES128
AES192
AES256
DES
DES3
GCMAES128
GCMAES192
GCMAES256
None

IpsecIntegrity

Het IPSec-integriteitsalgoritmen (IKE-fase 1).

Waarde Description
GCMAES128
GCMAES192
GCMAES256
MD5
SHA1
SHA256

IpsecPolicy

Een IPSec-beleidsconfiguratie voor een virtuele netwerkgatewayverbinding.

Name Type Description
dhGroup

DhGroup

De DH-groep die wordt gebruikt in IKE Fase 1 voor de eerste SA.

ikeEncryption

IkeEncryption

Het IKE-versleutelingsalgoritmen (IKE-fase 2).

ikeIntegrity

IkeIntegrity

Het IKE-integriteitsalgoritmen (IKE-fase 2).

ipsecEncryption

IpsecEncryption

Het IPSec-versleutelingsalgoritmen (IKE-fase 1).

ipsecIntegrity

IpsecIntegrity

Het IPSec-integriteitsalgoritmen (IKE-fase 1).

pfsGroup

PfsGroup

De Pfs-groep die wordt gebruikt in IKE Fase 2 voor nieuwe onderliggende SA.

saDataSizeKilobytes

integer (int32)

De nettoladinggrootte IPSec-beveiligingskoppeling (ook wel snelle modus of fase 2 SA genoemd) in KB voor een site-naar-site-VPN-tunnel.

saLifeTimeSeconds

integer (int32)

De LEVENSDUUR van de IPSec-beveiligingskoppeling (ook wel snelle modus of fase 2 SA genoemd) in seconden voor een site-naar-site-VPN-tunnel.

PfsGroup

De Pfs-groepen die worden gebruikt in IKE Fase 2 voor nieuwe onderliggende SA.

Waarde Description
ECP256
ECP384
None
PFS1
PFS14
PFS2
PFS2048
PFS24
PFSMM

PropagatedRouteTable

De lijst met RouteTables om de routes naar te adverteren.

Name Type Description
ids

SubResource[]

De lijst met resource-id's van alle RouteTables.

labels

string[]

De lijst met labels.

ProvisioningState

De huidige inrichtingsstatus.

Waarde Description
Deleting
Failed
Succeeded
Updating

RoutingConfiguration

Routeringsconfiguratie die de gekoppelde en doorgegeven routetabellen voor deze verbinding aangeeft.

Name Type Description
associatedRouteTable

SubResource

De resource-id RouteTable die is gekoppeld aan deze RoutingConfiguration.

inboundRouteMap

SubResource

De resource-id van de RouteMap die is gekoppeld aan deze RoutingConfiguration voor binnenkomende geleerde routes.

outboundRouteMap

SubResource

De resource-id van deRouteMap die is gekoppeld aan deze RoutingConfiguration voor uitgaande geadverteerde routes.

propagatedRouteTables

PropagatedRouteTable

De lijst met RouteTables om de routes naar te adverteren.

vnetRoutes

VnetRoute

Lijst met routes die routering van VirtualHub naar een virtuele netwerkverbinding beheren.

StaticRoute

Lijst met alle statische routes.

Name Type Description
addressPrefixes

string[]

Lijst met alle adresvoorvoegsels.

name

string

De naam van de StaticRoute die uniek is binnen een VnetRoute.

nextHopIpAddress

string

Het IP-adres van de volgende hop.

StaticRoutesConfig

Configuratie voor statische routes op deze HubVnetConnectionConfiguration voor statische routes op deze HubVnetConnection.

Name Type Description
propagateStaticRoutes

boolean

Booleaanse waarde die aangeeft of statische routes op deze verbinding automatisch worden doorgegeven aan routetabellen waarnaar deze verbinding wordt doorgegeven.

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parameter die bepaalt of NVA in spoke-vnet wordt omzeild voor verkeer met bestemming in spoke.

SubResource

Verwijzing naar een andere subresource.

Name Type Description
id

string

Resource-id.

TrafficSelectorPolicy

Een verkeersselectorbeleid voor een gatewayverbinding met een virtueel netwerk.

Name Type Description
localAddressRanges

string[]

Een verzameling lokale adresruimten in CIDR-indeling.

remoteAddressRanges

string[]

Een verzameling externe adresruimten in CIDR-indeling.

VirtualNetworkGatewayConnectionProtocol

Verbindingsprotocol dat wordt gebruikt voor deze verbinding.

Waarde Description
IKEv1
IKEv2

VnetLocalRouteOverrideCriteria

Parameter die bepaalt of NVA in spoke-vnet wordt omzeild voor verkeer met bestemming in spoke-vnet.

Waarde Description
Contains
Equal

VnetRoute

Lijst met routes die routering van VirtualHub naar een virtuele netwerkverbinding beheren.

Name Type Description
bgpConnections

SubResource[]

De lijst met verwijzingen naar HubBgpConnection-objecten.

staticRoutes

StaticRoute[]

Lijst met alle statische routes.

staticRoutesConfig

StaticRoutesConfig

Configuratie voor statische routes op deze HubVnetConnection.

VpnConnection

VpnConnection-resource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

name

string

De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.connectionBandwidth

integer (int32)

Verwachte bandbreedte in MBPS.

properties.connectionStatus

VpnConnectionStatus

De verbindingsstatus.

properties.dpdTimeoutSeconds

integer (int32)

DPD-time-out in seconden voor vpn-verbinding.

properties.egressBytesTransferred

integer (int64)

Uitgaande bytes overgedragen.

properties.enableBgp

boolean

EnableBgp-vlag.

properties.enableInternetSecurity

boolean

Internetbeveiliging inschakelen.

properties.enableRateLimiting

boolean

EnableBgp-vlag.

properties.ingressBytesTransferred

integer (int64)

Binnenkomende bytes overgedragen.

properties.ipsecPolicies

IpsecPolicy[]

Het IPSec-beleid dat door deze verbinding moet worden overwogen.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de VPN-verbindingsresource.

properties.remoteVpnSite

SubResource

Id van de verbonden VPN-site.

properties.routingConfiguration

RoutingConfiguration

De routeringsconfiguratie die de gekoppelde en doorgegeven routetabellen op deze verbinding aangeeft.

properties.routingWeight

integer (int32)

Routeringsgewicht voor vpn-verbinding.

properties.sharedKey

string

SharedKey voor de VPN-verbinding.

properties.trafficSelectorPolicies

TrafficSelectorPolicy[]

Het beleid voor verkeersselector dat door deze verbinding moet worden overwogen.

properties.useLocalAzureIpAddress

boolean

Gebruik lokale Azure IP om verbinding te initiëren.

properties.usePolicyBasedTrafficSelectors

boolean

Schakel verkeerkiezers op basis van beleid in.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

Verbindingsprotocol dat wordt gebruikt voor deze verbinding.

properties.vpnLinkConnections

VpnSiteLinkConnection[]

Lijst met alle vpn-sitekoppelingen naar de gateway.

VpnConnectionStatus

De huidige status van de VPN-verbinding.

Waarde Description
Connected
Connecting
NotConnected
Unknown

VpnGateway

VpnGateway-resource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.bgpSettings

BgpSettings

De BGP-sprekerinstellingen van de lokale netwerkgateway.

properties.connections

VpnConnection[]

Lijst met alle VPN-verbindingen met de gateway.

properties.enableBgpRouteTranslationForNat

boolean

Schakel BGP-routes vertalen in voor NAT op deze VpnGateway.

properties.ipConfigurations

VpnGatewayIpConfiguration[]

Lijst met alle IP-adressen die zijn geconfigureerd op de gateway.

properties.isRoutingPreferenceInternet

boolean

Schakel de eigenschap Routeringsvoorkeur in voor de openbare IP-interface van de VpnGateway.

properties.natRules

VpnGatewayNatRule[]

Lijst met alle nat-regels die zijn gekoppeld aan de gateway.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de VPN-gatewayresource.

properties.virtualHub

SubResource

De VirtualHub waartoe de gateway behoort.

properties.vpnGatewayScaleUnit

integer (int32)

De schaaleenheid voor deze VPN-gateway.

tags

object

Resourcetags.

type

string

Resourcetype.

VpnGatewayIpConfiguration

IP-configuratie van een VPN Gateway-resource.

Name Type Description
id

string

De id van de IP-configuratie voor een VPN-gateway.

privateIpAddress

string

Het privé-IP-adres van deze IP-configuratie.

publicIpAddress

string

Het openbare IP-adres van deze IP-configuratie.

VpnGatewayNatRule

VpnGatewayNatRule-resource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

name

string

De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.egressVpnSiteLinkConnections

SubResource[]

Lijst met uitgaande VpnSiteLinkConnections.

properties.externalMappings

VpnNatRuleMapping[]

De externe toewijzing van het privé-IP-adres voor NAT.

properties.ingressVpnSiteLinkConnections

SubResource[]

Lijst met inkomende VpnSiteLinkConnections.

properties.internalMappings

VpnNatRuleMapping[]

De interne toewijzing van het privé-IP-adres voor NAT.

properties.ipConfigurationId

string

De IP-configuratie-id op deze NAT-regel is van toepassing.

properties.mode

VpnNatRuleMode

De bron-NAT-richting van een VPN NAT.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de NAT-regelresource.

properties.type

VpnNatRuleType

Het type NAT-regel voor VPN NAT.

type

string

Resourcetype.

VpnLinkConnectionMode

Vpn-koppelingsverbindingsmodus.

Waarde Description
Default
InitiatorOnly
ResponderOnly

VpnNatRuleMapping

Vpn NatRule-toewijzing.

Name Type Description
addressSpace

string

Adresruimte voor vpn NatRule-toewijzing.

portRange

string

Poortbereik voor Vpn NatRule-toewijzing.

VpnNatRuleMode

De bron-NAT-richting van een VPN NAT.

Waarde Description
EgressSnat
IngressSnat

VpnNatRuleType

Het type NAT-regel voor VPN NAT.

Waarde Description
Dynamic
Static

VpnSiteLinkConnection

VpnSiteLinkConnection-resource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

name

string

De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.connectionBandwidth

integer (int32)

Verwachte bandbreedte in MBPS.

properties.connectionStatus

VpnConnectionStatus

De verbindingsstatus.

properties.dpdTimeoutSeconds

integer (int32)

Time-out voor dead peer detection in seconden voor VpnLink-verbinding.

properties.egressBytesTransferred

integer (int64)

Uitgaande bytes overgedragen.

properties.egressNatRules

SubResource[]

Lijst met uitgaande NatRules.

properties.enableBgp

boolean

EnableBgp-vlag.

properties.enableRateLimiting

boolean

EnableBgp-vlag.

properties.ingressBytesTransferred

integer (int64)

Binnenkomende bytes overgedragen.

properties.ingressNatRules

SubResource[]

Lijst met inkomend verkeer NatRules.

properties.ipsecPolicies

IpsecPolicy[]

Het IPSec-beleid dat door deze verbinding moet worden overwogen.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de verbindingsresource van de VPN-sitekoppeling.

properties.routingWeight

integer (int32)

Routeringsgewicht voor vpn-verbinding.

properties.sharedKey

string

SharedKey voor de VPN-verbinding.

properties.useLocalAzureIpAddress

boolean

Gebruik lokale Azure IP om verbinding te initiëren.

properties.usePolicyBasedTrafficSelectors

boolean

Schakel verkeerkiezers op basis van beleid in.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

Verbindingsprotocol dat wordt gebruikt voor deze verbinding.

properties.vpnGatewayCustomBgpAddresses

GatewayCustomBgpIpAddressIpConfiguration[]

vpnGatewayCustomBgpAddresses die door deze verbinding worden gebruikt.

properties.vpnLinkConnectionMode

VpnLinkConnectionMode

Vpn-koppelingsverbindingsmodus.

properties.vpnSiteLink

SubResource

Id van de gekoppelde vpn-sitekoppeling.

type

string

Resourcetype.