ListTransitRouterRouteTableAssociations -

Usage notes

When you call ListTransitRouterRouteTableAssociations, you must set at least one of TransitRouterRouteTableId and TransitRouterAttachmentId.

If you set only TransitRouterRouteTableId, the network instance connections that are in associated forwarding correlation with a route table of an Enterprise Edition transit router are queried.
If you set only TransitRouterAttachmentId, the route table of an Enterprise Edition transit router that is in associated forwarding correlation with a network instance connection is queried.
If you set both TransitRouterRouteTableId and TransitRouterAttachmentId, the associated forwarding correlations between a specified network instance connection and a specified route table of an Enterprise Edition transit router are queried.
- If an associated forwarding correlation is created between the network instance connection and the route table of the Enterprise Edition transit router, the information about the associated forwarding correlation is returned.
- If no associated forwarding correlation is created between the network instance connection and the route table of the Enterprise Edition transit router, TransitRouterAssociations in the response is empty.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	ListTransitRouterRouteTableAssociations	The operation that you want to perform. Set the value to ListTransitRouterRouteTableAssociations.
MaxResults	Integer	No	50	The number of entries to return on each page. Default value: 50.
NextToken	String	No	a415****	The token that determines the start point of the query. Valid values: If this is your first query or no subsequent query is to be sent, ignore this parameter. If a subsequent query is to be sent, set the value to the value of NextToken that was returned from the last call.
TransitRouterRouteTableId	String	No	vtb-bp1dudbh2d5na6b50****	The ID of the route table of the Enterprise Edition transit router.
TransitRouterAttachmentId	String	No	tr-attach-nls9fzkfat8934****	The ID of the network instance connection.

Response parameters


Parameter	Type	Example	Description
NextToken	String	a415****	The token that determines the start point of the query. Valid values: If NextToken was not returned, it indicates that no additional results exist. If NextToken was returned in the previous query, specify the value to obtain the next set of results.
RequestId	String	F6B1D9AB-176D-4399-801D-8BC576F4EB0D	The ID of the request.
TotalCount	Integer	1	The total number of entries returned.
MaxResults	Integer	50	The number of entries returned on each page.
TransitRouterAssociations	Array of TransitRouterAssociation		A list of associated forwarding correlations.
TransitRouterAttachmentId	String	tr-attach-nls9fzkfat8934****	The ID of the network instance connection.
Status	String	Associating	The state of the associated forwarding correlation. Valid values: Active: The associated forwarding correlation is available. Associating: The associated forwarding correlation is being created. Dissociating: The associated forwarding correlation is being deleted. Deleted: The associated forwarding correlation is deleted.
ResourceType	String	VPC	The type of next hop. Valid values: VPC: virtual private cloud (VPC) VBR: virtual border router (VBR) TR: transit router VPN: IPsec-VPN connection
ResourceId	String	vpc-bp1h8vbrbcgohcju5****	The ID of the next hop.
TransitRouterRouteTableId	String	vtb-bp1dudbh2d5na6b50****	The ID of the route table of the Enterprise Edition transit router.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListTransitRouterRouteTableAssociations
&MaxResults=50
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934****
&<Common request parameters>

Sample success responses

XML format

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

<ListTransitRouterRouteTableAssociationsResponse>
    <RequestId>F6B1D9AB-176D-4399-801D-8BC576F4EB0D</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>50</MaxResults>
    <TransitRouterAssociations>
        <TransitRouterAttachmentId>tr-attach-nls9fzkfat8934****</TransitRouterAttachmentId>
        <Status>Associating</Status>
        <ResourceType>VPC</ResourceType>
        <ResourceId>vpc-bp1h8vbrbcgohcju5****</ResourceId>
        <TransitRouterRouteTableId>vtb-bp1dudbh2d5na6b50****</TransitRouterRouteTableId>
    </TransitRouterAssociations>
</ListTransitRouterRouteTableAssociationsResponse>

JSON format

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

{
  "RequestId" : "F6B1D9AB-176D-4399-801D-8BC576F4EB0D",
  "TotalCount" : 1,
  "MaxResults" : 50,
  "TransitRouterAssociations" : [ {
    "TransitRouterAttachmentId" : "tr-attach-nls9fzkfat8934****",
    "Status" : "Associating",
    "ResourceType" : "VPC",
    "ResourceId" : "vpc-bp1h8vbrbcgohcju5****",
    "TransitRouterRouteTableId" : "vtb-bp1dudbh2d5na6b50****"
  } ]
}

Error codes


HttpCode	Error code	Error message	Description
400	IllegalParam.NextToken	The parameter NextToken is invalid.	The error message returned because NextToken is set to an invalid value. Specify a valid token and try again.

For a list of error codes, see Service error codes.