Delen via

Hub Virtual Network Connections - Create Or Update

  • Referentie
Service:
Virtual WAN
API Version:
2023-09-01

Hiermee maakt u een virtuele netwerkverbinding voor de hub als deze niet bestaat, anders wordt de bestaande verbinding bijgewerkt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}?api-version=2023-09-01

URI-parameters

Name In Vereist Type Description
connectionName
 path True

string

De naam van de HubVirtualNetworkConnection.
resourceGroupName
 path True

string

De resourcegroepnaam van de HubVirtualNetworkConnection.
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 service-aanroep.
virtualHubName
 path True

string

De naam van de VirtualHub.
api-version
 query True

string

Client-API-versie.

Aanvraagbody

Name Type Description
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.allowHubToRemoteVnetTransit

boolean

Afgeschaft: VirtualHub naar RemoteVnet-overdracht naar ingeschakeld of niet.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Afgeschaft: RemoteVnet toestaan om de gateways van de virtuele hub te gebruiken.
properties.enableInternetSecurity

boolean

Internetbeveiliging inschakelen.
properties.remoteVirtualNetwork

SubResource

Verwijzing naar het externe virtuele netwerk.
properties.routingConfiguration

RoutingConfiguration

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

Antwoorden

Name Type Description
200 OK

HubVirtualNetworkConnection

De aanvraag is voltooid. Retourneert de details van de virtuele netwerkverbinding van de hub die is gemaakt of bijgewerkt.
201 Created

HubVirtualNetworkConnection

De aanvraag is voltooid. Retourneert de details van de opgehaalde virtuele netwerkverbinding van de hub.
Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

HubVirtualNetworkConnectionPut

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1?api-version=2023-09-01

{
  "properties": {
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "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"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ]
      },
      "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"
      }
    }
  }
}

Sample Response

Status code:
200 
{
  "name": "connection1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "properties": {
    "provisioningState": "Updating",
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "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"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "propagateStaticRoutes": true,
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ],
        "bgpConnections": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/bgpConnections/bgpConn1"
          }
        ]
      },
      "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"
      }
    }
  }
}
Status code:
201 
{
  "name": "connection1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "properties": {
    "provisioningState": "Updating",
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "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"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "propagateStaticRoutes": true,
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ],
        "bgpConnections": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/bgpConnections/bgpConn1"
          }
        ]
      },
      "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"
      }
    }
  }
}

Definities

Name Description
CloudError

Een foutreactie van de service.
CloudErrorBody

Een foutreactie van de service.
HubVirtualNetworkConnection

HubVirtualNetworkConnection-resource.
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.
VnetLocalRouteOverrideCriteria

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

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

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.

HubVirtualNetworkConnection

HubVirtualNetworkConnection-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.allowHubToRemoteVnetTransit

boolean

Afgeschaft: VirtualHub naar RemoteVnet-overdracht naar ingeschakeld of niet.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Afgeschaft: RemoteVnet toestaan om de gateways van de virtuele hub te gebruiken.
properties.enableInternetSecurity

boolean

Internetbeveiliging inschakelen.
properties.provisioningState

ProvisioningState

De inrichtingsstatus van de virtuele netwerkverbindingsresource van de hub.
properties.remoteVirtualNetwork

SubResource

Verwijzing naar het externe virtuele netwerk.
properties.routingConfiguration

RoutingConfiguration

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

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.

Name Type Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

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 het doel in spoke.

SubResource

Verwijzing naar een andere subresource.

Name Type Description
id

string

Resource-id.

VnetLocalRouteOverrideCriteria

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

Name Type Description
Contains

string

Equal

string

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.