You need to enable JavaScript to run this app.
文档中心
中转路由器

中转路由器

复制全文
下载 pdf
核心网
DescribeCoreNetworkRouteEntries-查询核心网路由条目
复制全文
下载 pdf
DescribeCoreNetworkRouteEntries-查询核心网路由条目
调用DescribeCoreNetworkRouteEntries接口,查询核心网的路由条目列表。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeCoreNetworkRouteEntries​
接口名称。当前 API 的名称为 DescribeCoreNetworkRouteEntries。​
​
Version String 必选 示例值:2026-06-01​
接口版本。当前 API 的版本为 2026-06-01。​
​
CoreNetworkId String 必选 示例值:cn-3hxn9ush899xmr2jxo0p***​
核心网实例的ID。​
您可以调用DescribeCoreNetworks接口获取核心网实例ID。​
​
RegionId String 必选 示例值:cn-beijing​
核心网的地域。​
您可以参考地域介绍获取地域ID。​
​
SegmentName String 可选 示例值:SegmentName01​
网络平面的名称。​
SegmentName与NetworkFunctionGroupName至少传入一个值。​
​
NetworkFunctionGroupName String 可选 示例值:NetworkFunctionGroup01​
网络服务组的名称。​
SegmentName与NetworkFunctionGroupName至少传入一个值。​
​
DestinationCidrBlock String 可选 示例值:192.***.**.0/24​
目的网段。​
仅传入SegmentName时,可传入本参数。​
​
CoreNetworkRouteEntryName String 可选 示例值:CoreNetworkRouteEntry01​
路由条目的名称。​
​
Status String 可选 示例值:Available​
路由条目的状态。​
  • Available:可用。​
  • Creating:创建中。​
  • Pending:配置中。​
  • Deleting:删除中。​
  • Conflicted:未生效。​
​
CoreNetworkRouteEntryNextHopResourceId String 可选 示例值:vpc-ga923sag24***​
静态路由下一跳的网络实例ID。​
仅传入SegmentName时,可传入本参数。​
​
PageNumber Integer 可选 示例值:1​
列表的页码,默认值为1。​
​
PageSize Integer 可选 示例值:20​
分页查询时每页的行数,取值范围为1 ~ 100,默认值为20。​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
CoreNetworkRouteEntries Object[] 示例值:-​
符合条件的核心网路由条目信息。​
AsPath String[] 示例值:["20314"]​
路由条目的AS路径。​
​
Status String 示例值:Available​
路由条目状态​
  • Available:可用。​
  • Creating:创建中。​
  • Pending:配置中。​
  • Deleting:删除中。​
  • Conflicted:未生效。​
​
DestinationCidrBlock String 示例值:192.***.**.0/24​
目的网段。​
​
CoreNetworkRouteEntryName String 示例值:CoreNetworkRouteEntry01​
路由条目的名称。​
​
CoreNetworkRouteEntryType String 示例值:Propagated​
路由条目的类型。​
  • Static:静态路由。​
  • Propagated:传播路由。​
​
CoreNetworkRouteEntryNextHopId String 示例值:cn-attach-3tex2x1cwd4c6c0v****​
下一跳网络实例连接的ID。​
黑洞路由返回值为空。​
​
CoreNetworkRouteEntryNextHopType String 示例值:VPC​
下一跳网络实例连接的类型。​
  • BlackHole:黑洞,表示匹配该路由条目的流量会被丢弃。​
  • InterRegion:跨地域​
  • VPC:私有网络。​
  • VPN:VPN连接。​
  • DirectConnectGateway:专线网关。​
  • TransitRouterRouteTable:TR路由表。​
​
CoreNetworkRouteEntryNextHopRegionId String 示例值:cn-shanghai​
跨域路由的地域。​
仅跨域路由NextHopType取值为InterRegion时有返回值。​
​
CoreNetworkRouteEntryNextHopResourceId String 示例值:vpc-3tex2x1cwd4c6c0v****​
路由条目的下一跳资源 ID,表示匹配该路由条目的流量会被转发到的目标资源 ID。​
跨域传播路由和黑洞路由返回值为空。​
​
CoreNetworkRouteEntryNextHopVpnTunnelId String 示例值:tunnel-123456​
VPN隧道的ID。​
仅CoreNetworkRouteEntryNextHopType返回VPN时,有返回值。​
​
​
PageNumber Integer 示例值:1​
当前分页的行数。​
​
PageSize Integer 示例值:20​
当前页码。​
​
TotalCount Integer 示例值:33​
符合条件的路由条目总数。​
​
​
请求示例​
​
GET /?Action=DescribeCoreNetworkRouteEntries&Version=2026-06-01&CoreNetworkId=cn-3hxn9ush899xmr2jxo0p***&RegionId=cn-guangzhou&SegmentName=SegmentName01&NetworkFunctionGroupName=NetworkFunctionGroup01&DestinationCidrBlock=192.***.**.0/24&CoreNetworkRouteEntryName=CoreNetworkRouteEntry01&Status=Available&CoreNetworkRouteEntryNextHopResourceId=vpc-ga923sag24***&PageNumber=1&PageSize=20 HTTP/1.1​
Host: transitrouter.cn-guangzhou.volcengineapi.com​
X-Date: 20251029T033538Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-guangzhou/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeCoreNetworkRouteEntries",​
"Version": "2026-06-01",​
"Service": "transitrouter",​
"Region": "cn-guangzhou"​
},​
"Result": {​
"CoreNetworkRouteEntries": [​
{​
"AsPath": [​
"20314"​
],​
"Status": "Available",​
"DestinationCidrBlock": "192.***.**.0/24",​
"CoreNetworkRouteEntryName": "CoreNetworkRouteEntry01",​
"CoreNetworkRouteEntryType": "Propagated",​
"CoreNetworkRouteEntryNextHopId": "cn-attach-3tex2x1cwd4c6c0v****",​
"CoreNetworkRouteEntryNextHopType": "VPC",​
"CoreNetworkRouteEntryNextHopRegionId": "cn-shanghai",​
"CoreNetworkRouteEntryNextHopResourceId": "vpc-3tex2x1cwd4c6c0v****",​
"CoreNetworkRouteEntryNextHopVpnTunnelId": "tunnel-123456"​
}​
],​
"PageNumber": 1,​
"PageSize": 20,​
"TotalCount": 33​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidPage.Malformed​
The specified page is malformed.​
指定的分页参数不合法。​
​
最近更新时间:2026.06.18 14:27:24
这个页面对您有帮助吗?
有用
有用
无用
无用