Share via

Hub Virtual Network Connections - Create Or Update

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

Skapar en virtuell hubbnätverksanslutning om den inte finns, annars uppdateras den befintliga.

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

URI-parametrar

Name I Obligatorisk Typ Description
connectionName
 path True

string

Namnet på HubVirtualNetworkConnection.
resourceGroupName
 path True

string

Resursgruppsnamnet för HubVirtualNetworkConnection.
subscriptionId
 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.
virtualHubName
 path True

string

Namnet på VirtualHub.
api-version
 query True

string

Klient-API-version.

Begärandetext

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

boolean

Inaktuell: VirtualHub till RemoteVnet-överföring till aktiverad eller inte.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Inaktuell: Tillåt att RemoteVnet använder virtual hubb-gatewayer.
properties.enableInternetSecurity

boolean

Aktivera Internetsäkerhet.
properties.remoteVirtualNetwork

SubResource

Referens till det fjärranslutna virtuella nätverket.
properties.routingConfiguration

RoutingConfiguration

Routningskonfigurationen som anger de associerade och utbredda routningstabellerna i den här anslutningen.

Svar

Name Typ Description
200 OK

HubVirtualNetworkConnection

Begäran lyckades. Returnerar information om hubbens virtuella nätverksanslutning som skapats eller uppdaterats.
201 Created

HubVirtualNetworkConnection

Begäran lyckades. Returnerar information om hubbens virtuella nätverksanslutning som hämtats.
Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

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"
      }
    }
  }
}

Definitioner

Name Description
CloudError

Ett felsvar från tjänsten.
CloudErrorBody

Ett felsvar från tjänsten.
HubVirtualNetworkConnection

HubVirtualNetworkConnection-resurs.
PropagatedRouteTable

Listan över RouteTables som vägarna ska annonseras till.
ProvisioningState

Det aktuella etableringstillståndet.
RoutingConfiguration

Routningskonfiguration som anger de associerade och spridde routningstabellerna för den här anslutningen.
StaticRoute

Lista över alla statiska vägar.
StaticRoutesConfig

Konfiguration för statiska vägar på denna HubVnetConnectionConfiguration för statiska vägar på denna HubVnetConnection.
SubResource

Referens till en annan underresurs.
VnetLocalRouteOverrideCriteria

Parameter som avgör om NVA i ett virtuellt ekernätverk kringgås för trafik med målet i det virtuella ekernätverket.
VnetRoute

Lista över vägar som styr routning från VirtualHub till en virtuell nätverksanslutning.

CloudError

Ett felsvar från tjänsten.

Name Typ Description
error

CloudErrorBody

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

CloudErrorBody[]

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.

HubVirtualNetworkConnection

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

boolean

Inaktuell: VirtualHub till RemoteVnet-överföring till aktiverad eller inte.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Inaktuell: Tillåt att RemoteVnet använder virtual hubb-gatewayer.
properties.enableInternetSecurity

boolean

Aktivera Internetsäkerhet.
properties.provisioningState

ProvisioningState

Etableringstillståndet för den virtuella nätverksanslutningsresursen för hubben.
properties.remoteVirtualNetwork

SubResource

Referens till det fjärranslutna virtuella nätverket.
properties.routingConfiguration

RoutingConfiguration

Routningskonfigurationen som anger de associerade och utbredda routningstabellerna i den här anslutningen.

PropagatedRouteTable

Listan över RouteTables som vägarna ska annonseras till.

Name Typ Description
ids

SubResource[]

Listan över resurs-ID:t för alla RouteTables.
labels

string[]

Listan över etiketter.

ProvisioningState

Det aktuella etableringstillståndet.

Name Typ Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Routningskonfiguration som anger de associerade och spridde routningstabellerna för den här anslutningen.

Name Typ Description
associatedRouteTable

SubResource

Resurs-ID:t RouteTable som är associerad med den här RoutingConfiguration.
inboundRouteMap

SubResource

Resurs-ID:t för RouteMap som är associerad med den här RoutingConfiguration för inkommande inlärda vägar.
outboundRouteMap

SubResource

Resurs-ID:t för denRouteMap som är associerad med den här RoutingConfiguration för utgående annonserade vägar.
propagatedRouteTables

PropagatedRouteTable

Listan över RouteTables som vägarna ska annonseras till.
vnetRoutes

VnetRoute

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å den StaticRoute som är unik i en VnetRoute.
nextHopIpAddress

string

IP-adressen för nästa hopp.

StaticRoutesConfig

Konfiguration för statiska vägar på denna 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

VnetLocalRouteOverrideCriteria

Parameter som avgör om NVA i ett virtuellt ekernätverk kringgås för trafik med målet i ekern.

SubResource

Referens till en annan underresurs.

Name Typ Description
id

string

Resurs-ID.

VnetLocalRouteOverrideCriteria

Parameter som avgör om NVA i ett virtuellt ekernätverk 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

SubResource[]

Listan över referenser till HubBgpConnection-objekt.
staticRoutes

StaticRoute[]

Lista över alla statiska vägar.
staticRoutesConfig

StaticRoutesConfig

Konfiguration för statiska vägar på denna HubVnetConnection.