Share via

Hub Virtual Network Connections - Create Or Update

  • Odwołanie
Service:
Virtual WAN
API Version:
2023-09-01

Tworzy połączenie z siecią wirtualną koncentratora, jeśli jeszcze nie istnieje, aktualizuje istniejące.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
connectionName
 path True

string

Nazwa centrumVirtualNetworkConnection.
resourceGroupName
 path True

string

Nazwa grupy zasobów HubVirtualNetworkConnection.
subscriptionId
 path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
virtualHubName
 path True

string

Nazwa usługi VirtualHub.
api-version
 query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu, który jest unikatowy w grupie zasobów. Ta nazwa może służyć do uzyskiwania dostępu do zasobu.
properties.allowHubToRemoteVnetTransit

boolean

Przestarzałe: tranzyt z usługi VirtualHub do usługi RemoteVnet w celu włączenia lub nie.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Przestarzałe: Zezwalaj zdalnej sieciVnet na używanie bram koncentratora wirtualnego.
properties.enableInternetSecurity

boolean

Włącz zabezpieczenia internetowe.
properties.remoteVirtualNetwork

SubResource

Odwołanie do zdalnej sieci wirtualnej.
properties.routingConfiguration

RoutingConfiguration

Konfiguracja routingu wskazująca skojarzone i propagowane tabele tras w tym połączeniu.

Odpowiedzi

Nazwa Typ Opis
200 OK

HubVirtualNetworkConnection

Żądanie zakończyło się pomyślnie. Zwraca szczegóły połączenia sieci wirtualnej koncentratora utworzonego lub zaktualizowanego.
201 Created

HubVirtualNetworkConnection

Żądanie zakończyło się pomyślnie. Zwraca szczegóły pobranego połączenia sieci wirtualnej koncentratora.
Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa Opis
CloudError

Odpowiedź błędu z usługi.
CloudErrorBody

Odpowiedź błędu z usługi.
HubVirtualNetworkConnection

Zasób HubVirtualNetworkConnection.
PropagatedRouteTable

Lista elementów RouteTables do anonsowania tras do.
ProvisioningState

Bieżący stan aprowizacji.
RoutingConfiguration

Konfiguracja routingu wskazująca skojarzone i propagowane tabele tras dla tego połączenia.
StaticRoute

Lista wszystkich tras statycznych.
StaticRoutesConfig

Konfiguracja tras statycznych w tym hubVnetConnectionConfiguration dla tras statycznych w tym hubVnetConnection.
SubResource

Odwołanie do innego podźródła.
VnetLocalRouteOverrideCriteria

Parametr określający, czy urządzenie WUS w sieci wirtualnej szprych jest pomijane dla ruchu z miejscem docelowym w sieci wirtualnej szprychy.
VnetRoute

Lista tras kontrolujących routing z usługi VirtualHub do połączenia z siecią wirtualną.

CloudError

Odpowiedź błędu z usługi.

Nazwa Typ Opis
error

CloudErrorBody

Treść błędu chmury.

CloudErrorBody

Odpowiedź błędu z usługi.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details

CloudErrorBody[]

Lista dodatkowych szczegółów dotyczących błędu.
message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
target

string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

HubVirtualNetworkConnection

Zasób HubVirtualNetworkConnection.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu, który jest unikatowy w grupie zasobów. Ta nazwa może służyć do uzyskiwania dostępu do zasobu.
properties.allowHubToRemoteVnetTransit

boolean

Przestarzałe: tranzyt z usługi VirtualHub do usługi RemoteVnet w celu włączenia lub nie.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Przestarzałe: Zezwalaj zdalnej sieciVnet na używanie bram koncentratora wirtualnego.
properties.enableInternetSecurity

boolean

Włącz zabezpieczenia internetowe.
properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu połączenia sieci wirtualnej koncentratora.
properties.remoteVirtualNetwork

SubResource

Odwołanie do zdalnej sieci wirtualnej.
properties.routingConfiguration

RoutingConfiguration

Konfiguracja routingu wskazująca skojarzone i propagowane tabele tras w tym połączeniu.

PropagatedRouteTable

Lista elementów RouteTables do anonsowania tras do.

Nazwa Typ Opis
ids

SubResource[]

Lista identyfikatorów zasobów wszystkich tabel tras.
labels

string[]

Lista etykiet.

ProvisioningState

Bieżący stan aprowizacji.

Nazwa Typ Opis
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Konfiguracja routingu wskazująca skojarzone i propagowane tabele tras dla tego połączenia.

Nazwa Typ Opis
associatedRouteTable

SubResource

Identyfikator zasobu RouteTable skojarzony z tą konfiguracją routingu.
inboundRouteMap

SubResource

Identyfikator zasobu RouteMap skojarzony z tą konfiguracją routingu dla tras przychodzących poznanych.
outboundRouteMap

SubResource

Identyfikator zasobu mapyroute skojarzonej z tą konfiguracją routingu dla tras anonsowanych dla ruchu wychodzącego.
propagatedRouteTables

PropagatedRouteTable

Lista elementów RouteTables do anonsowania tras do.
vnetRoutes

VnetRoute

Lista tras kontrolujących routing z usługi VirtualHub do połączenia z siecią wirtualną.

StaticRoute

Lista wszystkich tras statycznych.

Nazwa Typ Opis
addressPrefixes

string[]

Lista wszystkich prefiksów adresów.
name

string

Nazwa usługi StaticRoute, która jest unikatowa w ramach usługi VnetRoute.
nextHopIpAddress

string

Adres IP następnego przeskoku.

StaticRoutesConfig

Konfiguracja tras statycznych w tym hubVnetConnectionConfiguration dla tras statycznych w tym hubVnetConnection.

Nazwa Typ Opis
propagateStaticRoutes

boolean

Wartość logiczna wskazująca, czy trasy statyczne w tym połączeniu są automatycznie propagowane do tabel tras, do których propaguje to połączenie.
vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parametr określający, czy urządzenie WUS w sieci wirtualnej szprychy jest pomijane dla ruchu z miejscem docelowym w szprychach.

SubResource

Odwołanie do innego podźródła.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

VnetLocalRouteOverrideCriteria

Parametr określający, czy urządzenie WUS w sieci wirtualnej szprych jest pomijane dla ruchu z miejscem docelowym w sieci wirtualnej szprychy.

Nazwa Typ Opis
Contains

string

Equal

string

VnetRoute

Lista tras kontrolujących routing z usługi VirtualHub do połączenia z siecią wirtualną.

Nazwa Typ Opis
bgpConnections

SubResource[]

Lista odwołań do obiektów HubBgpConnection.
staticRoutes

StaticRoute[]

Lista wszystkich tras statycznych.
staticRoutesConfig

StaticRoutesConfig

Konfiguracja tras statycznych w tej sieci HubVnetConnection.