Sdílet prostřednictvím

Hub Virtual Network Connections - Create Or Update

  • Reference
Služba:
Virtual WAN
Verze rozhraní API:
2024-05-01

Vytvoří připojení k virtuální síti rozbočovače, pokud neexistuje, aktualizuje existující.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
connectionName
 path True

string

Název HubVirtualNetworkConnection.
resourceGroupName
 path True

string

Název skupiny prostředků HubVirtualNetworkConnection.
subscriptionId
 path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
virtualHubName
 path True

string

Název VirtualHubu.
api-version
 query True

string

Verze rozhraní API klienta.

Text požadavku

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku, který je jedinečný v rámci skupiny prostředků. Tento název lze použít pro přístup k prostředku.
properties.allowHubToRemoteVnetTransit

boolean

Zastaralé: VirtualHub do vzdálené virtuální sítě pro přenos do povolené nebo ne.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Zastaralé: Povolte vzdálené virtuální síti používat brány virtuálního centra.
properties.enableInternetSecurity

boolean

Povolte zabezpečení internetu.
properties.remoteVirtualNetwork

SubResource

Odkaz na vzdálenou virtuální síť
properties.routingConfiguration

RoutingConfiguration

Konfigurace směrování označující přidružené a šířené směrovací tabulky v tomto připojení.

Odpovědi

Name Typ Description
200 OK

HubVirtualNetworkConnection

Žádost byla úspěšná. Vrátí podrobnosti o vytvořeném nebo aktualizovaném připojení k virtuální síti rozbočovače.
201 Created

HubVirtualNetworkConnection

Žádost byla úspěšná. Vrátí podrobnosti o načtených připojení virtuální sítě rozbočovače.
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

HubVirtualNetworkConnectionPut

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1?api-version=2024-05-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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"
      }
    }
  }
}
Stavový kód:
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"
      }
    }
  }
}

Definice

Name Description
CloudError

Chybová odpověď ze služby.
CloudErrorBody

Chybová odpověď ze služby.
HubVirtualNetworkConnection

Prostředek HubVirtualNetworkConnection
PropagatedRouteTable

Seznam směrovacích tabulek pro inzerování tras.
ProvisioningState

Aktuální stav zřizování.
RoutingConfiguration

Konfigurace směrování označující přidružené a šířené směrovací tabulky pro toto připojení
StaticRoute

Seznam všech statických tras
StaticRoutesConfig

Konfigurace statických tras v této hubVnetConnectionConfiguration pro statické trasy v tomto HubVnetConnection.
SubResource

Odkaz na jiný podsourc.
VnetLocalRouteOverrideCriteria

Parametr určující, jestli se síťové virtuální zařízení v paprskové virtuální síti vynechá pro provoz s cílem v paprskové virtuální síti.
VnetRoute

Seznam tras, které řídí směrování z VirtualHubu do připojení k virtuální síti

CloudError

Object

Chybová odpověď ze služby.

Name Typ Description
error

CloudErrorBody

Text chyby cloudu.

CloudErrorBody

Object

Chybová odpověď ze služby.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details

CloudErrorBody[]

Seznam dalších podrobností o chybě
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

HubVirtualNetworkConnection

Object

Prostředek HubVirtualNetworkConnection

Name Typ Description
etag

string

Jedinečný řetězec jen pro čtení, který se změní při každé aktualizaci prostředku.
id

string

ID prostředku.
name

string

Název prostředku, který je jedinečný v rámci skupiny prostředků. Tento název lze použít pro přístup k prostředku.
properties.allowHubToRemoteVnetTransit

boolean

Zastaralé: VirtualHub do vzdálené virtuální sítě pro přenos do povolené nebo ne.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Zastaralé: Povolte vzdálené virtuální síti používat brány virtuálního centra.
properties.enableInternetSecurity

boolean

Povolte zabezpečení internetu.
properties.provisioningState

ProvisioningState

Stav zřizování prostředku připojení virtuální sítě centra.
properties.remoteVirtualNetwork

SubResource

Odkaz na vzdálenou virtuální síť
properties.routingConfiguration

RoutingConfiguration

Konfigurace směrování označující přidružené a šířené směrovací tabulky v tomto připojení.

PropagatedRouteTable

Object

Seznam směrovacích tabulek pro inzerování tras.

Name Typ Description
ids

SubResource[]

Seznam ID prostředků všech směrovacích tabulek
labels

string[]

Seznam popisků

ProvisioningState

Enumeration

Aktuální stav zřizování.

Hodnota Description
Deleting
Failed
Succeeded
Updating

RoutingConfiguration

Object

Konfigurace směrování označující přidružené a šířené směrovací tabulky pro toto připojení

Name Typ Description
associatedRouteTable

SubResource

Id prostředku RouteTable přidružené k této RoutingConfiguration.
inboundRouteMap

SubResource

ID prostředku objektu RouteMap přidruženého k této směrování RoutingConfiguration pro příchozí naučené trasy.
outboundRouteMap

SubResource

ID prostředku mapyRoute přidružené k této RoutingConfiguration pro odchozí inzerované trasy.
propagatedRouteTables

PropagatedRouteTable

Seznam směrovacích tabulek pro inzerování tras.
vnetRoutes

VnetRoute

Seznam tras, které řídí směrování z VirtualHubu do připojení k virtuální síti

StaticRoute

Object

Seznam všech statických tras

Name Typ Description
addressPrefixes

string[]

Seznam všech předpon adres
name

string

Název StaticRoute, který je jedinečný v rámci virtuální sítěRoute.
nextHopIpAddress

string

IP adresa dalšího segmentu směrování.

StaticRoutesConfig

Object

Konfigurace statických tras v této hubVnetConnectionConfiguration pro statické trasy v tomto HubVnetConnection.

Name Typ Description
propagateStaticRoutes

boolean

Logická hodnota označující, jestli se statické trasy v tomto připojení automaticky rozšíří do směrovacích tabulek, do kterých se toto připojení rozšíří.
vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parametr určující, jestli je síťové virtuální zařízení v paprskové virtuální síti vynecháno pro provoz s cílem v paprsku.

SubResource

Object

Odkaz na jiný podsourc.

Name Typ Description
id

string

ID prostředku.

VnetLocalRouteOverrideCriteria

Enumeration

Parametr určující, jestli se síťové virtuální zařízení v paprskové virtuální síti vynechá pro provoz s cílem v paprskové virtuální síti.

Hodnota Description
Contains
Equal

VnetRoute

Object

Seznam tras, které řídí směrování z VirtualHubu do připojení k virtuální síti

Name Typ Description
bgpConnections

SubResource[]

Seznam odkazů na objekty HubBgpConnection.
staticRoutes

StaticRoute[]

Seznam všech statických tras
staticRoutesConfig

StaticRoutesConfig

Konfigurace statických tras v tomto hubVnetConnectionu