Virtual Hubs - Get Effective Virtual Hub Routes
获取为虚拟中心资源或指定资源配置的有效路由。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/effectiveRoutes?api-version=2025-03-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
resource
|
path | True |
string |
VirtualHub 的资源组名称。 |
|
subscription
|
path | True |
string |
唯一标识 Azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
|
virtual
|
path | True |
string |
VirtualHub 的名称。 |
|
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| resourceId |
string |
正在请求其有效路由的资源。 |
| virtualWanResourceType |
string |
指定资源的类型,如 RouteTable、ExpressRouteConnection、HubVirtualNetworkConnection、VpnConnection 和 P2SConnection。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
请求成功。 返回有效路径的列表,或遵循有效路径列表的位置标题。 |
|
| 202 Accepted |
已接受,作将异步完成。 |
|
| Other Status Codes |
描述作失败的原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
| 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
示例请求
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2025-03-01
{
"resourceId": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/expressRouteGatewayName/expressRouteConnections/connectionName",
"virtualWanResourceType": "ExpressRouteConnection"
}
示例响应
{
"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
示例请求
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2025-03-01
{
"resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1",
"virtualWanResourceType": "RouteTable"
}
示例响应
{
"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
示例请求
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/effectiveRoutes?api-version=2025-03-01
示例响应
{
"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}
定义
| 名称 | 说明 |
|---|---|
|
Cloud |
服务的错误响应。 |
|
Cloud |
服务的错误响应。 |
|
Effective |
指定正在请求其有效路由的资源的参数。 |
|
Virtual |
在虚拟中心或指定资源上配置的有效路由。 |
|
Virtual |
EffectiveRoutes 列表。 |
CloudError
服务的错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
云错误正文。 |
CloudErrorBody
服务的错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
| details |
有关错误的其他详细信息的列表。 |
|
| message |
string |
描述错误的消息,旨在适合在用户界面中显示。 |
| target |
string |
特定错误的目标。 例如,错误属性的名称。 |
EffectiveRoutesParameters
指定正在请求其有效路由的资源的参数。
| 名称 | 类型 | 说明 |
|---|---|---|
| resourceId |
string |
正在请求其有效路由的资源。 |
| virtualWanResourceType |
string |
指定资源的类型,如 RouteTable、ExpressRouteConnection、HubVirtualNetworkConnection、VpnConnection 和 P2SConnection。 |
VirtualHubEffectiveRoute
在虚拟中心或指定资源上配置的有效路由。
| 名称 | 类型 | 说明 |
|---|---|---|
| addressPrefixes |
string[] |
地址前缀列表。 |
| asPath |
string |
此路由的 ASPath。 |
| nextHopType |
string |
下一跃点的类型。 |
| nextHops |
string[] |
下一跃点的列表。 |
| routeOrigin |
string |
这条路线的起源。 |
VirtualHubEffectiveRouteList
EffectiveRoutes 列表。
| 名称 | 类型 | 说明 |
|---|---|---|
| value |
在虚拟中心或指定资源上配置的有效路由列表。 |