调用ModifyRouteDistributionStrategy修改路由发布策略。

调试

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

请求参数

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

系统规定参数。取值：ModifyRouteDistributionStrategy。

RegionId String 是 cn-shanghai

智能接入网关实例的地域ID。
SmartAGId String 是 sag-erx3qta5xg5zyq****

智能接入网关实例ID。
HcInstanceId String 是 hc-sztovuprqzgm50****

健康检查实例ID。
SourceType String 是 local

路由来源类型：

  • cloud：云上路由。
  • local：线下路由。
DestCidrBlock String 是 172.XX.XX.0/24

目标网段。
RouteSource String 是 OSPF

路由来源：

  • 云上路由
    • 专有网络（VPC）实例ID：通过VPC学来的路由。
    • 虚拟边界路由器（VBR）实例ID：通过VBR学来的路由。
    • 智能接入网关（SAG）实例ID：通过SAG学来的路由。
  • 线下路由
    • STATIC：通过管理控制台添加的静态路由。
    • OSPF：通过OSPF路由协议学习来的路由。
    • BGP：通过BGP路由协议学习来的路由。
RouteDistribution String 是 publish

路由发布策略：

  • publish：发布。
  • no_publish：不发布。
  • no_publish_and_publish_on_health_success：不发布-健康检查成功时发布。
  • no_publish_and_publish_on_health_fail：不发布-健康检查失败时发布。
  • publish_and_revoke_on_health_success：发布-健康检查成功时撤销。
  • publish_and_revoke_on_health_fail：发布-健康检查失败时撤销。

更多详情请参见关联健康检查和路由发布。

返回数据

名称 类型 示例值 描述
RequestId String 24C58BD0-1679-4942-9D42-00B635DAAADB

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyRouteDistributionStrategy
&DestCidrBlock=172.XX.XX.0/24
&HcInstanceId=hc-sztovuprqzgm50****
&RegionId=cn-shanghai
&RouteDistribution=publish
&RouteSource=OSPF
&SmartAGId=sag-erx3qta5xg5zyq****
&SourceType=local
&<公共请求参数>

正常返回示例

XML格式 

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

<ModifyRouteDistributionStrategyResponse>
<RequestId>24C58BD0-1679-4942-9D42-00B635DAAADB</RequestId>
</ModifyRouteDistributionStrategyResponse>

JSON格式 

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

{
  "RequestId" : "24C58BD0-1679-4942-9D42-00B635DAAADB"
}

错误码

HttpCode 错误码 错误信息 描述
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. 智能接入网关实例ID为空。
400 SAG.InstanceNoFound The specified SAG instance does not exist. 智能接入网关实例不存在。
400 RD.InvalidDestCidrBlock The specified destination CIDR block is invalid. 非法的目标地址网段。
400 RD.InvalidHcInstanceId The specified network health check instance ID is invalid. 非法的健康检查实例。
400 RD.InvalidRouteDistribution The specified route distribution policy is invalid. 非法的路由发布策略。
400 RD.InvalidRouteSource The specified route source is invalid. 非法路由来源。
400 RD.InvalidSourceType The specified route source type is invalid. 非法的路由来源类型。
400 HC.InstanceNoFound The specified network health check instance does not exist. 健康检查实例不存在。
400 SAG.Arrearage The specified SAG instance has overdue payments. Renew the instance first. 智能接入网关实例已经欠费，请先续费。
400 SAG.NoActive The specified SAG instance has not been activated. 智能接入网关实例还未激活，请先激活。
400 SAG.SoftwareNotSupportFeature The specified SAG Software instance does not support this feature. 智能接入网关软件版实例不支持当前特性。
500 InternalError An error occurred while processing your request. 请求失败，发生未知错误。
403 FeatureNotSupport The current edition of the smart access gateway does not support this feature. 智能接入网关当前版本不支持该功能特性。

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