调用ListTransitRouterPrefixListAssociation接口查询企业版转发路由器路由表绑定的前缀列表的信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTransitRouterPrefixListAssociation

系统规定参数。取值:ListTransitRouterPrefixListAssociation

RegionId String cn-hangzhou

转发路由器实例所属的地域ID。

您可以通过调用DescribeChildInstanceRegions接口获取地域ID。

TransitRouterId String tr-6ehx7q2jze8ch5ji0****

转发路由器实例ID。

TransitRouterTableId String vtb-6ehgc262hr170qgyc****

转发路由器路由表ID。

PrefixListId String pl-6ehtn5kqxgeyy08fi****

前缀列表ID。

OwnerUid Long 1210123456123456

前缀列表所属的阿里云账号(主账号)ID。

PageNumber Integer 1

待查询的列表的页码。默认值:1

PageSize Integer 10

分页查询时每页的条目数。最大值:100。默认值:10

NextHop String tr-attach-flbq507rg2ckrj****

下一跳连接ID。

说明 如果您需要查询生成黑洞路由的前缀列表的信息,本参数需输入BlackHole
NextHopType String VPC

下一跳类型。取值:

  • BlackHole:表示查询生成黑洞路由的前缀列表的信息。
  • VPC:表示查询下一跳为专有网络VPC(Virtual Private Cloud)连接的前缀列表的信息。
  • VBR:表示查询下一跳为边界路由器VBR(Virtual Border Router)连接的前缀列表的信息。
  • TR:表示查询下一跳为跨地域连接的前缀列表的信息。

返回数据

名称 类型 示例值 描述
RequestId String 6005CA94-676E-1FEE-985E-7602EFAADD6A

请求ID。

TotalCount Integer 1

符合查询条件的列表总条目数。

PageSize Integer 10

分页查询时每页的条目数。

PageNumber Integer 1

查询的列表页码。

PrefixLists Array of PrefixList

前缀列表的信息。

PrefixListId String pl-6ehtn5kqxgeyy08fi****

前缀列表ID。

OwnerUid Long 1210123456123456

前缀列表所属的阿里云账号(主账号)ID。

Status String Active

前缀列表的状态。

  • Active:已生效。
  • Updating:更新中。
NextHop String tr-attach-flbq507rg2ckrj****

下一跳连接ID。

说明 如果返回值为BlackHole,则表示前缀列表下的所有网段均为黑洞路由,所有去往前缀列表下网段的流量均会被丢弃。
NextHopInstanceId String vpc-6eh7fp9hdqa2wv85t****

下一跳连接关联的网络实例ID。

NextHopType String VPC

下一跳类型。

  • BlackHole:表示前缀列表下的网段均为黑洞路由,所有去往前缀列表下网段的流量均会被丢弃。
  • VPC:表示前缀列表下网段的下一跳为专有网络VPC(Virtual Private Cloud)连接。
  • VBR:表示前缀列表下网段的下一跳为边界路由器VBR(Virtual Border Router)连接。
  • TR:表示前缀列表下网段的下一跳为跨地域连接。
TransitRouterTableId String vtb-6ehgc262hr170qgyc****

转发路由器路由表ID。

TransitRouterId String tr-6ehx7q2jze8ch5ji0****

转发路由器实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterPrefixListAssociation
&RegionId=cn-hangzhou
&TransitRouterId=tr-6ehx7q2jze8ch5ji0****
&TransitRouterTableId=vtb-6ehgc262hr170qgyc****
&PrefixListId=pl-6ehtn5kqxgeyy08fi****
&OwnerUid=1210123456123456
&PageNumber=1
&PageSize=10
&NextHop=tr-attach-flbq507rg2ckrj****
&NextHopType=VPC
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTransitRouterPrefixListAssociationResponse>
    <RequestId>6005CA94-676E-1FEE-985E-7602EFAADD6A</RequestId>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <PrefixLists>
        <PrefixListId>pl-6ehtn5kqxgeyy08fi****</PrefixListId>
        <OwnerUid>1210123456123456</OwnerUid>
        <Status>Active</Status>
        <NextHop>tr-attach-flbq507rg2ckrj****</NextHop>
        <NextHopInstanceId>vpc-6eh7fp9hdqa2wv85t****</NextHopInstanceId>
        <NextHopType>VPC</NextHopType>
        <TransitRouterTableId>vtb-6ehgc262hr170qgyc****</TransitRouterTableId>
        <TransitRouterId>tr-6ehx7q2jze8ch5ji0****</TransitRouterId>
    </PrefixLists>
</ListTransitRouterPrefixListAssociationResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6005CA94-676E-1FEE-985E-7602EFAADD6A",
  "TotalCount" : 1,
  "PageSize" : 10,
  "PageNumber" : 1,
  "PrefixLists" : [ {
    "PrefixListId" : "pl-6ehtn5kqxgeyy08fi****",
    "OwnerUid" : 1210123456123456,
    "Status" : "Active",
    "NextHop" : "tr-attach-flbq507rg2ckrj****",
    "NextHopInstanceId" : "vpc-6eh7fp9hdqa2wv85t****",
    "NextHopType" : "VPC",
    "TransitRouterTableId" : "vtb-6ehgc262hr170qgyc****",
    "TransitRouterId" : "tr-6ehx7q2jze8ch5ji0****"
  } ]
}

错误码

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