调用DescribePublishedRouteEntries查询已加载到CEN网络实例(VPC和VBR)的各条路由在CEN中的发布情况。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
CenId String cen-7qthudw0ll6jm****

需要查询的云企业网ID。

ChildInstanceId String vpc-bp18sth14qii3pnv****

网络实例ID。

ChildInstanceRegionId String cn-hangzhou

需要查询的地域ID。

ChildInstanceType String VPC

网络实例类型,取值:

  • VPC:专有网络。
  • VBR:边界路由器接口。
  • CCN:云连接网。
Action String DescribePublishedRouteEntries

要执行的操作,取值:DescribePublishedRouteEntries

ChildInstanceRouteTableId String vtb-bp174d1gje79u1g4****

网络实例的路由表ID。

DestinationCidrBlock String 172.xx.xx.xx/24

要查询的网段。

PageNumber Integer 1

列表的页码,默认值为1

PageSize Integer 2

分页查询时每页的行数,最大值为50,默认值为10

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

当前页码。

PageSize Integer 2

每页包含的条目数。

PublishedRouteEntries

返回指定的云企业网的指定的region的路由信息。

ChildInstanceRouteTableId String vtb-il7qut3mjgtlcbpk****

路由表ID。

Conflicts

冲突路由列表。

DestinationCidrBlock String 192.168.10.0/24

冲突目标网段地址。

InstanceId String ecs-xxdjakjdakhfkfka****

冲突实例ID。

InstanceType String Instance

网络实例类型。

RegionId String cn-hangzhou

冲突实例所在的地域ID。

Status String conflict

异常原因,取值:

  • conflict:路由发生冲突。
  • overflow:其他网络实例路由表路由数量超出限制。
  • prohibited:VBR策略不允许的默认路由。
DestinationCidrBlock String 172.16.xx.xx/24

冲突目标网段地址。

NextHopId String ecs-bp18sth14qii3pn****

下一跳实例的ID。

NextHopType String Instance

下一跳的类型,取值:

  • Instance(默认值):ECS实例。
  • HaVip:高可用虚拟IP。
  • RouterInterface:路由器接口。
OperationalMode Boolean true

是否允许发布或撤销该路由到CEN:

  • true:允许发布或撤销。
  • false:不允许发布或撤销。
PublishStatus String Published

在CEN中的发布状态:

  • Published:已发布
  • NonPublished:未发布
RouteType String System

路由条目的类型,取值:

  • System:系统路由。
  • Custom:用户路由。
  • BGP:BGP路由。
RequestId String FF1A7B2A-677F-4F71-96EA-6002B329F437

请求ID。

TotalCount Integer 10

列表条目数。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribePublishedRouteEntries
&CenId=cen-7qthudw0ll6jm****
&ChildInstanceId=vpc-bp18sth14qii3pnv****
&ChildInstanceRegionId=cn-hangzhou
&ChildInstanceType=VPC
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRouteConflictResponse>
	  <TotalCount>2</TotalCount>
	  <PublishRouteEntries>
		    <PublishRouteEntries>
			      <DestinationCidrBlock>100.64.0.0/10</DestinationCidrBlock>
			      <NextHopId></NextHopId>
			      <NextHopType>service</NextHopType>
			      <ChildInstanceRouteTableId>vtb-il7qut3mjgtlcbpk2****</ChildInstanceRouteTableId>
			      <PublishStatus>NonPublished</PublishStatus>
			      <RouteConflicts></RouteConflicts>
			      <RouteType>System</RouteType>
		    </PublishRouteEntries>
		    <PublishRouteEntries>
			      <DestinationCidrBlock>192.168.10.0/24</DestinationCidrBlock>
			      <NextHopId></NextHopId>
			      <NextHopType>local</NextHopType>
			      <ChildInstanceRouteTableId>vtb-il7qut3mjgtlcbpk2****</ChildInstanceRouteTableId>
			      <PublishStatus>Published</PublishStatus>
			      <RouteConflicts></RouteConflicts>
			      <RouteType>System</RouteType>
		    </PublishRouteEntries>
	  </PublishRouteEntries>
	  <PageNumber>1</PageNumber>
	  <RequestId>FF1A7B2A-677F-4F71-96EA-6002B329F437</RequestId>
	  <PageSize>10</PageSize>
</DescribeRouteConflictResponse>

JSON 格式

{
	"PageNumber":1,
	"PublishRouteEntries":{
		"PublishRouteEntries":[
			{
				"RouteType":"System",
				"ChildInstanceRouteTableId":"vtb-il7qut3mjgtlcbpk2****",
				"NextHopId":"",
				"NextHopType":"service",
				"RouteConflicts":{
					"RouteConflicts":[]
				},
				"DestinationCidrBlock":"100.64.0.0/10",
				"PublishStatus":"NonPublished"
			},
			{
				"RouteType":"System",
				"ChildInstanceRouteTableId":"vtb-il7qut3mjgtlcbpk2****",
				"NextHopId":"",
				"NextHopType":"local",
				"RouteConflicts":{
					"RouteConflicts":[]
				},
				"DestinationCidrBlock":"192.168.10.0/24",
				"PublishStatus":"Published"
			}
		]
	},
	"TotalCount":2,
	"PageSize":10,
	"RequestId":"FF1A7B2A-677F-4F71-96EA-6002B329F437"
}

错误码

HttpCode 错误码 错误信息 描述
400 ParameterIllegal.CenInstanceId The parameter of CEN instance id is illegal. 云企业网ID不正确
400 ParameterIllegal.ChildInstanceRegionId The parameter of child instance region id is illegal. 网络实例所属地域信息不正确。
409 InvalidOperation.ChildInstanceStatus The child-instance is not in a valid state for the operation. 网络子实例正在处理状态,请稍后再操作
409 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation. CEN实例正在处理状态,请稍后再操作
400 ParameterIllegal.ChildInstanceType The parameter of child instance type is illegal. 网络子实例类型不正确
500 InternalError Internal error. 内部报错

访问错误中心查看更多错误码。