Udostępnij za pośrednictwem


Virtual Hubs - Get Effective Virtual Hub Routes

Pobiera obowiązujące trasy skonfigurowane dla zasobu koncentratora wirtualnego lub określonego zasobu .

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów usługi VirtualHub.

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
resourceId

string

Zasób, którego obowiązujące trasy są żądane.

virtualWanResourceType

string

Typ określonego zasobu, taki jak RouteTable, ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection i P2SConnection.

Odpowiedzi

Nazwa Typ Opis
200 OK

VirtualHubEffectiveRouteList

Żądanie powiodło się. Zwraca listę obowiązujących tras lub postępuj zgodnie z nagłówka lokalizacji dla listy obowiązujących tras.

202 Accepted

Zaakceptowane i operacja zostanie ukończona asynchronicznie.

Other Status Codes

CloudError

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

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
CloudError

Odpowiedź na błąd z usługi.

CloudErrorBody

Odpowiedź na błąd z usługi.

EffectiveRoutesParameters

Parametry określające zasób, którego obowiązujące trasy są żądane.

VirtualHubEffectiveRoute

Efektywna trasa skonfigurowana w koncentratonie wirtualnym lub określonym zasobie.

VirtualHubEffectiveRouteList

Lista effectiveRoutes.

CloudError

Odpowiedź na błąd z usługi.

Nazwa Typ Opis
error

CloudErrorBody

Treść błędu chmury.

CloudErrorBody

Odpowiedź na błąd 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.

EffectiveRoutesParameters

Parametry określające zasób, którego obowiązujące trasy są żądane.

Nazwa Typ Opis
resourceId

string

Zasób, którego obowiązujące trasy są żądane.

virtualWanResourceType

string

Typ określonego zasobu, taki jak RouteTable, ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection i P2SConnection.

VirtualHubEffectiveRoute

Efektywna trasa skonfigurowana w koncentratonie wirtualnym lub określonym zasobie.

Nazwa Typ Opis
addressPrefixes

string[]

Lista prefiksów adresów.

asPath

string

Ścieżka ASPath tej trasy.

nextHopType

string

Typ następnego przeskoku.

nextHops

string[]

Lista następnych przeskoków.

routeOrigin

string

Początek tej trasy.

VirtualHubEffectiveRouteList

Lista effectiveRoutes.

Nazwa Typ Opis
value

VirtualHubEffectiveRoute[]

Lista obowiązujących tras skonfigurowanych w koncentratonie wirtualnym lub określonym zasobie.