调用CreateCenRouteMap接口创建路由策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | CreateCenRouteMap |
要执行的操作,取值:CreateCenRouteMap。 |
CenId | String | 是 | cen-7qthudw0ll6jmc**** |
云企业网的ID。 |
CenRegionId | String | 是 | cn-hangzhou |
云企业网所在的地域。您可以通过调用DescribeRegions接口获取地域ID。 |
Priority | Integer | 是 | 3 |
路由策略的优先级,取值:1~100。优先级数字越小,优先级越高。 说明 同地域同策略应用方向的路由策略优先级唯一。执行路由策略时,系统从优先级数字最小的路由策略开始匹配条件语句,因此在指定路由策略优先级时,要注意符合期望的匹配顺序。
|
TransmitDirection | String | 是 | RegionIn |
路由策略应用的方向,取值:
|
MapResult | String | 是 | Permit |
所有匹配条件通过后的策略行为,取值:
|
NextPriority | Integer | 否 | 20 |
关联的下一条路由策略的优先级,取值:1~100。
仅MapResult取值为Permit时,匹配通过的路由才会继续匹配关联的下一条路由策略。 |
Description | String | 否 | abc |
路由策略的描述。 |
SourceRegionIds.N | RepeatList | 否 | cn-beijing |
匹配路由的源地域ID列表,为match语句。最多可输入32个地域ID。 |
SourceInstanceIds.N | RepeatList | 否 | vpc-adeg3544fdf34vf**** |
匹配路由的源实例ID列表,为match语句。 支持输入专有网络实例ID、边界路由器实例ID、中国内地云连接网实例ID、智能接入网关实例ID。 最多可输入32个实例ID。 |
SourceInstanceIdsReverseMatch | Boolean | 否 | false |
路由传递源实例ID列表排除匹配模式,取值:
|
DestinationInstanceIds.N | RepeatList | 否 | vpc-afrfs434465fdf**** |
匹配路由的目的实例ID列表,为match语句。 支持输入专有网络实例ID、边界路由器实例ID、中国内地云连接网实例ID、智能接入网关实例ID。 最多可输入32个实例ID。 说明 目的实例ID列表仅策略应用方向为出地域网关方向且目的实例ID为本地域下实例时有效。
|
DestinationInstanceIdsReverseMatch | Boolean | 否 | false |
路由传递目的实例ID列表排除匹配模式,取值:
|
SourceRouteTableIds.N | RepeatList | 否 | vtb-adfr233vf34rvd4**** |
匹配路由的源路由表ID列表,为match语句。最多可输入32个路由表ID。 |
DestinationRouteTableIds.N | RepeatList | 否 | vtb-adefrgtr144vf**** |
匹配路由的目的路由表ID列表,为match语句。最多可输入32个路由表ID。 说明 目的路由表仅策略应用方向为出地域网关方向且目的路由表为本地域下路由表时有效。
|
SourceChildInstanceTypes.N | RepeatList | 否 | VPC |
匹配路由的源实例类型列表,为match语句,取值:
|
DestinationChildInstanceTypes.N | RepeatList | 否 | VPC |
匹配路由的目的实例类型列表,为match语句,取值:
说明 目的实例类型仅策略应用方向为出地域网关方向且目的实例类型为本地域下实例类型时有效。
|
DestinationCidrBlocks.N | RepeatList | 否 | 1.1.1.0/10 |
匹配路由的前缀列表,为match语句。使用CIDR格式,最多可输入32个CIDR。 |
CidrMatchMode | String | 否 | Include |
匹配前缀模式,为match语句,取值:
|
RouteTypes.N | RepeatList | 否 | System |
匹配路由的类型列表,为match语句,取值:
支持输入多种类型。 |
MatchAsns.N | RepeatList | 否 | 65501 |
匹配路由的as-path列表,为match语句。as-path是公认强制属性,描述了一条BGP路由在传递过程中所经过的AS的号码。 仅支持AS SEQUENCE,不支持AS SET、AS CONFED SEQUENCE和AS CONFED SET,即只能是AS号列表,不支持集合和子列表。 |
AsPathMatchMode | String | 否 | Include |
匹配as-path模式,为match语句,取值:
|
MatchCommunitySet.N | RepeatList | 否 | 65501:1 |
匹配community集合,为match语句。每个community格式为nn:nn,nn取值范围为1~65535,最多输入32个community。community需要符合RFC 1997,不支持Large community(RFC 8092)。 说明 community配置错误可能导致路由不能发布到IDC侧。
|
CommunityMatchMode | String | 否 | Include |
匹配community模式,为match语句,取值:
|
CommunityOperateMode | String | 否 | Additive |
操作community的模式,为action语句,取值:
|
OperateCommunitySet.N | RepeatList | 否 | 65501:1 |
操作community的集合,为action语句。每个community格式为nn:nn,nn取值范围为1~65535,最多输入32个community。community需要符合RFC 1997,不支持Large community(RFC 8092)。 说明 community配置错误可能导致路由不能发布到IDC侧。
|
Preference | Integer | 否 | 22 |
修改路由的优先级,为action语句,取值:1~100,路由默认优先级为50,取值越小优先级越高。 |
PrependAsPath.N | RepeatList | 否 | 65501 |
地域网关接收或发布路由时附加AS Path,为action语句。 路由策略应用方向不同,配置追加AS Path的要求也不同,具体如下:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 54B48E3D-DF70-471B-AA93-08E683A1B457 |
请求ID。 |
RouteMapId | String | cenrmap-w4yf7toozfol3q**** |
路由策略的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateCenRouteMap
&CenId=cen-7qthudw0ll6jmc****
&CenRegionId=cn-hangzhou
&Priority=3
&TransmitDirection=RegionIn
&MapResult=Permit
&<公共请求参数>
正常返回示例
XML
格式
<CreateCenRouteMapResponse>
<RequestId>62172DD5-6BAC-45DF-8D44-6DFG456BAC</RequestId>
<RouteMapId>rmap-df12d22sd23****</RouteMapId>
</CreateCenRouteMapResponse>
JSON
格式
{
"RequestId": "62172DD5-6BAC-45DF-8D44-56SDF467BAC",
"RouteMapId": "cenrmap-w4yf7toozfol3q****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Forbidden.CenRouteMapExist | The specified CEN route map ID already exists. | 路由策略已经存在。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交