Modifies a route map.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | No | ModifyCenRouteMap |
The operation that you want to perform. Set the value to ModifyCenRouteMap. |
CenId | String | Yes | cen-7qthudw0ll6jmc**** |
The ID of the Cloud Enterprise Network (CEN) instance. |
CenRegionId | String | Yes | cn-hangzhou |
The region where the CEN instance is deployed. You can call the DescribeRegions operation to query region IDs. |
MapResult | String | Yes | Permit |
The behavior after all conditions are matched. Valid values:
|
Priority | Integer | Yes | 10 |
The priority of the route map. Valid values: 1 to 100. A lower number indicates a higher priority. Note In the same region, for route maps that are applied in the same direction, the priority
is unique. When a route map is implemented, the system matches conditions with a route
map whose priority number is the smallest. Therefore, make sure that you set priorities
for route maps to meet your requirements.
|
RouteMapId | String | Yes | cenrmap-abcdedfghij**** |
The ID of the route map. |
NextPriority | Integer | No | 20 |
The priority of the next associated route map. Valid values: 1 to 100.
Only when the MapResult parameter is set to Permit, the matched routes continue to match the next associated route maps. |
Description | String | No | test |
The description of the route map. |
SourceRegionIds.N | RepeatList | No | cn-beijing |
Match statements are used to match source region IDs of the routes. You can enter at most 32 region IDs. |
SourceInstanceIds.N | RepeatList | No | vpc-afsfdf5435vcvc**** |
Match statements are used to match source instance IDs of the routes. You can enter instance IDs of the following types: virtual private cloud (VPC), virtual border router (VBR), Cloud Connect Network (CCN) in mainland China, Smart Access Gateway (SAG). You can enter at most 32 instance IDs. |
SourceInstanceIdsReverseMatch | Boolean | No | false |
The IDs of source instances to be advertised do not support match statements. Valid values:
|
DestinationInstanceIds.N | RepeatList | No | vpc-avcdsg34ds**** |
Match statements are used to match the destination instance IDs. You can enter instance IDs of the following types: VPC, VBR, CCN in mainland China, and SAG. You can enter at most 32 instance IDs. Note The destination instance IDs are valid only when the route map is applied to scenarios
where routes are advertised from gateways in the current region to instances in the
current region.
|
DestinationInstanceIdsReverseMatch | Boolean | No | false |
The IDs of destination instances to be advertised do not support match statements. Valid values:
|
SourceRouteTableIds.N | RepeatList | No | vtb-acdbvtbr342cd**** |
Match statements are used to match source route table IDs of the routes. You can enter at most 32 route table IDs. |
DestinationRouteTableIds.N | RepeatList | No | vtb-adfg53c322v**** |
Match statements are used to match the IDs of the destination route tables. You can enter at most 32 route table IDs. Note The destination route IDs are valid only when the route map is applied to scenarios
where routes are advertised from gateways in the current region to route tables in
the current region.
|
SourceChildInstanceTypes.N | RepeatList | No | VPC |
Match statements are used to match source instance types of the routes. Valid values:
|
DestinationChildInstanceTypes.N | RepeatList | No | VPC |
Match statements are used to match the destination instance types. Valid values:
Note The destination instance types are valid only when the route map is applied to scenarios
where routes are advertised from gateways in the current region to instances in the
current region.
|
DestinationCidrBlocks.N | RepeatList | No | 1.1.1.0/10 |
Match statements are used to match the routing prefixes. The CIDR format is used. You can enter at most 32 CIDR blocks. |
CidrMatchMode | String | No | Include |
Match statements are used to match the prefixes. Valid values:
|
RouteTypes.N | RepeatList | No | System |
Match statements are used to match the route types. Valid values:
You can enter multiple types. |
MatchAsns.N | RepeatList | No | 65501 |
Match statements are used to match AS paths of the routes. An AS path is a mandatory attribute, which describes the AS number through which a BGP route passes when the BGP route is advertised. Only the AS-SEQUENCE parameter is supported. The AS-SET, AS-CONFED-SEQUENCE, and AS-CONFED-SET parameters are not supported. Specifically, only the AS number list is supported. Sets and sub-lists are not supported. |
AsPathMatchMode | String | No | Include |
Match statements are used to match the AS paths. Valid values:
|
MatchCommunitySet.N | RepeatList | No | 65501:1 |
Match statements are used to match the Communities. Enter each Community in the format of nn:nn. Valid values of nn: 1 to 65535. You can enter at most 32 Communities. Each Community must comply with RFC 1997. RFC 8092 is not supported. Note If the configurations of the Communities are incorrect, routes may not be advertised
to the on-premises data center.
|
CommunityMatchMode | String | No | Include |
Match statements are used to match the Communities. Valid values:
|
CommunityOperateMode | String | No | Additive |
Action statements are used to operate the Communities. Valid values:
|
OperateCommunitySet.N | RepeatList | No | 65501:1 |
Action statements are used to operate the Communities. Valid values: Enter each Community in the format of nn:nn. Valid values of nn: 1 to 65535. You can enter at most 32 Communities. Each Community must comply with RFC 1997. RFC 8092 is not supported. Note If the configurations of the Communities are incorrect, routes may not be advertised
to the on-premises data center.
|
Preference | Integer | No | 22 |
Action statements are used to modify route priorities. Valid values: 1 to 100. Default value: 50. A smaller number indicates a higher priority. |
PrependAsPath.N | RepeatList | No | 65501 |
AS paths are attached when regional gateways receive or advertise routes. For route maps that are applied in different directions, the requirements for AS paths to be attached are different:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 54B48E3D-DF70-471B-AA93-08E683A1B457 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=ModifyCenRouteMap
&CenId=cen-7qthudw0ll6jmc****
&CenRegionId=cn-hangzhou
&MapResult=Permit
&Priority=10
&RouteMapId=cenrmap-abcdedfghij****
&<Common request parameters>
Sample success responses
XML
format
<ModifyCenRouteMapResponse>
<RequestId>62172DD5-6BAC-45DF-8D44-xxxxxxxx</RequestId>
</ModifyCenRouteMapResponse>
JSON
format
{
"RequestId": "62172DD5-6BAC-45DF-8D44-xxxxxxxx"
}
Error codes
For a list of error codes, visit the API Error Center.