Dela via


Virtual Hubs - Get Effective Virtual Hub Routes

Hämtar de effektiva vägar som konfigurerats för Virtual Hub-resursen eller den angivna resursen .

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Resursgruppens namn på VirtualHub.

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
resourceId

string

Resursen vars effektiva vägar begärs.

virtualWanResourceType

string

Typ av angiven resurs som RouteTable, ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection och P2SConnection.

Svar

Name Typ Description
200 OK

VirtualHubEffectiveRouteList

Begäran lyckades. Returnerar listan över effektiva vägar eller följer platsrubriken för listan över effektiva vägar.

202 Accepted

Godkänd och åtgärden slutförs asynkront.

Other Status Codes

CloudError

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

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Effective Routes for a Connection resource
Effective Routes for a Route Table resource
Effective Routes for the Virtual Hub

Effective Routes for a Connection resource

Exempelbegäran

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2024-05-01

{
  "resourceId": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/expressRouteGatewayName/expressRouteConnections/connectionName",
  "virtualWanResourceType": "ExpressRouteConnection"
}

Exempelsvar

{
  "value": [
    {
      "addressPrefixes": [
        "10.147.128.0/17"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0"
      ],
      "nextHopType": "Remote Hub",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0",
      "asPath": "65520-65520"
    },
    {
      "addressPrefixes": [
        "10.0.0.0/16"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1"
      ],
      "nextHopType": "ExpressRouteGateway",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1",
      "asPath": "12076-12076"
    }
  ]
}
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}

Effective Routes for a Route Table resource

Exempelbegäran

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2024-05-01

{
  "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1",
  "virtualWanResourceType": "RouteTable"
}

Exempelsvar

{
  "value": [
    {
      "addressPrefixes": [
        "10.147.128.0/17"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0"
      ],
      "nextHopType": "Remote Hub",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0",
      "asPath": "65520-65520"
    },
    {
      "addressPrefixes": [
        "10.0.0.0/16"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1"
      ],
      "nextHopType": "ExpressRouteGateway",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1",
      "asPath": "12076-12076"
    }
  ]
}
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}

Effective Routes for the Virtual Hub

Exempelbegäran

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2024-05-01

Exempelsvar

{
  "value": [
    {
      "addressPrefixes": [
        "10.147.128.0/17"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0"
      ],
      "nextHopType": "Remote Hub",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/hub0",
      "asPath": "65520-65520"
    },
    {
      "addressPrefixes": [
        "10.0.0.0/16"
      ],
      "nextHops": [
        "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1"
      ],
      "nextHopType": "ExpressRouteGateway",
      "routeOrigin": "/subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/expressRouteGateways/ErGw1",
      "asPath": "12076-12076"
    }
  ]
}
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}

Definitioner

Name Description
CloudError

Ett felsvar från tjänsten.

CloudErrorBody

Ett felsvar från tjänsten.

EffectiveRoutesParameters

Parametrarna som anger den resurs vars effektiva vägar begärs.

VirtualHubEffectiveRoute

Den effektiva vägen som konfigurerats på den virtuella hubben eller den angivna resursen.

VirtualHubEffectiveRouteList

EffectiveRoutes-lista.

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.

EffectiveRoutesParameters

Parametrarna som anger den resurs vars effektiva vägar begärs.

Name Typ Description
resourceId

string

Resursen vars effektiva vägar begärs.

virtualWanResourceType

string

Typ av angiven resurs som RouteTable, ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection och P2SConnection.

VirtualHubEffectiveRoute

Den effektiva vägen som konfigurerats på den virtuella hubben eller den angivna resursen.

Name Typ Description
addressPrefixes

string[]

Listan över adressprefix.

asPath

string

ASPath för den här vägen.

nextHopType

string

Typ av nästa hopp.

nextHops

string[]

Listan över nästa hopp.

routeOrigin

string

Den här vägens ursprung.

VirtualHubEffectiveRouteList

EffectiveRoutes-lista.

Name Typ Description
value

VirtualHubEffectiveRoute[]

Listan över effektiva vägar som konfigurerats på den virtuella hubben eller den angivna resursen.