Queries the routes of a Cloud Enterprise Network (CEN) instance in a specified region.

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
CenId String Yes cen-7qthudw0ll6j****

The ID of the CEN instance that you want to query.
CenRegionId String Yes cn-hangzhou

The ID of the region that you want to query.
Action String No DescribeCenRegionDomainRouteEntries

The operation that you want to perform. Set the value to DescribeCenRegionDomainRouteEntries.

PageNumber Integer No 1

The number of the page to return. Default value: 1.

PageSize Integer No 1

The number of entries to return on each page. Maximum value: 50. Default value: 10.

Status String No Active

The state of the route. Valid values:

  • Active: The route is active.
  • Candidate: The route is a standby route.
  • Rejected: The route is rejected.
  • Prohibited: The route is prohibited.
  • All: All.

Response parameters

Parameter Type Example Description
CenRouteEntries

Detailed information about the routes.
AsPaths 65501

The AsPath attribute.
CenOutRouteMapRecords

The route maps that are applied to the outbound traffic of the CEN instance.
RegionId String cn-hangzhou

The ID of the region.
RouteMapId String cenrmap-w4yf7toozfol3q****

The ID of the route map.
CenRouteMapRecords

The route maps that are applied to the inbound traffic of the CEN instance.
RegionId String cn-hangzhou

The ID of the region.
RouteMapId String cenrmap-w4yf7toozfol3q****

The ID of the route map.
Communities 65501:1

The Communities attribute.
DestinationCidrBlock String 192.168.1.0/24

The destination CIDR block of the route.
NextHopInstanceId String pc-rj9gt5nll27onu7****

The ID of the next hop (VPC or VBR).
NextHopRegionId String us-west-1

The ID of the region to which the next hop belongs.
NextHopType String VPC

The type of the next hop. The next hop can be a virtual border router (VBR) or a virtual private cloud (VPC).

Preference Integer 20

The priority of the route.
Status String Active

The state of the route. Valid values:

  • Active: The route is active.
  • Candidate: The route is a standby route.
  • Rejected: The route is rejected.
  • Prohibited: The route is prohibited.
  • All: All.
ToOtherRegionStatus String Active

The state of the route that points to other regions. Valid values:

  • Active: The route is active.
  • Prohibited: The route is prohibited.
Type String CBN

The type of the route.
PageNumber Integer 2

The number of the returned page.
PageSize Integer 2

The number of entries returned per page.
RequestId String 73C834EF-82EF-4721-952E-75291F169A64

The ID of the request.
TotalCount Integer 1

The number of entries returned.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeCenRegionDomainRouteEntries
&CenId=cen-7qthudw0ll6j****
&CenRegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format 

<DescribeCenRegionDomainRouteEntries>
      <PageNumber>1</PageNumber>
	  <TotalCount>2</TotalCount>
	  <PageSize>10</PageSize>
	  <RequestId>73C834EF-82EF-4721-952E-75291F169A64</RequestId>
	  <CenRouteEntries>
		    <CenRouteEntry>
			      <NextHopInstanceId>vpc-m5ex5mr548eb5f6te****</NextHopInstanceId>
			      <Type>CBN</Type>
			      <NextHopRegionId>cn-qingdao</NextHopRegionId>
			      <NextHopType>VPC</NextHopType>
			      <DestinationCidrBlock>192.168.0.0/24</DestinationCidrBlock>
		    </CenRouteEntry>
		    <CenRouteEntry>
			      <NextHopInstanceId>vpc-rj9gt5nll27onu7wj****</NextHopInstanceId>
			      <Type>CBN</Type>
			      <NextHopRegionId>us-west-1</NextHopRegionId>
			      <NextHopType>VPC</NextHopType>
			      <DestinationCidrBlock>192.168.1.0/24</DestinationCidrBlock>
		    </CenRouteEntry>
	  </CenRouteEntries>
    </DescribeCenRegionDomainRouteEntries>

JSON format 

{
	"PageNumber":1,
	"TotalCount":2,
	"PageSize":10,
	"RequestId":"73C834EF-82EF-4721-952E-75291F169A64",
	"CenRouteEntries":{
		"CenRouteEntry":[
			{
				"NextHopInstanceId":"vpc-m5ex5mr548eb5f6te****",
				"Type":"CBN",
				"NextHopType":"VPC",
				"NextHopRegionId":"cn-qingdao",
				"DestinationCidrBlock":"192.168.0.0/24"
			},
			{
				"NextHopInstanceId":"vpc-rj9gt5nll27onu7wj****",
				"Type":"CBN",
				"NextHopType":"VPC",
				"NextHopRegionId":"us-west-1",
				"DestinationCidrBlock":"192.168.1.0/24"
			}
		]
	}
}

Error codes

For a list of error codes, visit the API Error Center.