Virtual Hubs - Get Inbound Routes

서비스:: Virtual WAN

API 버전:: 2025-05-01

특정 연결에서 가상 허브에 대해 구성된 인바운드 경로를 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
virtualHubName	path	True	string	VirtualHub의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
connectionType	string	ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection 및 P2SConnection과 같은 지정된 연결 리소스의 형식입니다.
resourceUri	string	인바운드 경로가 요청되는 연결 자원입니다.

응답

Name	형식	Description
200 OK	EffectiveRouteMapRouteList	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		자원 작업이 허용되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	Common.CloudError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

EffectiveRouteMapRouteList

Azure 작업이 성공적으로 완료되었습니다.

202 Accepted

자원 작업이 허용되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

Common.CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Inbound Routes for the Virtual Hub on a Particular Connection

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/inboundRoutes?api-version=2025-05-01

{
  "connectionType": "ExpressRouteConnection",
  "resourceUri": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/expressRouteGateways/exrGw1/expressRouteConnections/exrConn1"
}

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets the inbound routes configured for the Virtual Hub on a particular connection.
 *
 * @summary Gets the inbound routes configured for the Virtual Hub on a particular connection.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/GetInboundRoutes.json
 */
async function inboundRoutesForTheVirtualHubOnAParticularConnection() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const virtualHubName = "virtualHub1";
  const getInboundRoutesParameters = {
    connectionType: "ExpressRouteConnection",
    resourceUri:
      "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteGateways/exrGw1/expressRouteConnections/exrConn1",
  };
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.virtualHubs.beginGetInboundRoutesAndWait(
    resourceGroupName,
    virtualHubName,
    getInboundRoutesParameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "asPath": "65520-65520",
      "bgpCommunities": "4293853166,12076,51004",
      "prefix": "192.168.50.0/24"
    },
    {
      "asPath": "65520-65520-12076-12076",
      "bgpCommunities": "4293787629,12076,51027,4293734188",
      "prefix": "10.200.0.0/16"
    }
  ]
}

상태 코드:: 202

location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}

정의

Name	Description
Common.CloudError	서비스의 오류 응답입니다.
Common.CloudErrorBody	서비스의 오류 응답입니다.
EffectiveRouteMapRoute	연결 리소스에 구성된 유효 RouteMap 경로입니다.
EffectiveRouteMapRouteList	EffectiveRouteMapRoute 목록입니다.
GetInboundRoutesParameters	인바운드 경로가 요청되는 연결 리소스를 지정하는 매개 변수입니다.

Common.CloudError

Object

서비스의 오류 응답입니다.

Name	형식	Description
error	Common.CloudErrorBody	클라우드 오류 본문.

Common.CloudErrorBody

Object

서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	Common.CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

EffectiveRouteMapRoute

Object

연결 리소스에 구성된 유효 RouteMap 경로입니다.

Name	형식	Description
asPath	string	이 경로의 ASPath입니다.
bgpCommunities	string	경로의 BGP 커뮤니티.
prefix	string	경로의 주소 접두사입니다.

EffectiveRouteMapRouteList

Object

EffectiveRouteMapRoute 목록입니다.

Name	형식	Description
value	EffectiveRouteMapRoute[]	연결 리소스에 구성된 유효 RouteMap 경로 목록입니다.

GetInboundRoutesParameters

Object

인바운드 경로가 요청되는 연결 리소스를 지정하는 매개 변수입니다.

Name	형식	Description
connectionType	string	ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection 및 P2SConnection과 같은 지정된 연결 리소스의 형식입니다.
resourceUri	string	인바운드 경로가 요청되는 연결 자원입니다.