调用DescribeRouteDistributionStrategies查询路由发布策略。

调试

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

请求参数

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

要执行的操作。

取值:DescribeRouteDistributionStrategies

RegionId String cn-shanghai

智能接入网关实例的地域ID。

SmartAGId String sag-erx3qta5xg5zyq****

智能接入网关实例ID。

SourceType String cloud

路由类型:

  • cloud:云上路由。智能接入网关到云上资源的路由。
  • local:线下路由。智能接入网关到线下节点的路由。
PageNumber Integer 1

当前分页的页码数。默认值为1

PageSize Integer 10

分页展示时,每个分页包含的列表条目数。默认为10

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

当前分页的页码数。

PageSize Integer 10

分页展示时,每个分页包含的列表条目数。

RequestId String 944C2533-1BB7-4578-B6EB-DA05BB61C02A

请求ID。

Strategies Array

路由策略列表。

Strategy
ConflictInfo String "10.90.6.0/24":"vbr-wz900pom71qyr6x67qz65,vbr-wz9f8icxnlcom7riz0gfx"

路由冲突信息。

CreateTime Long 1144445

健康检查实例的创建时间戳,单位为毫秒。

DestCidrBlock String 192.168.3.0/24

目标网段。

HcInstanceId String hc-sztovuprqzgm50****

健康检查实例ID。

IsConflict Boolean false

是否存在路由冲突:

  • true:是。
  • false:否。
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:发布-健康检查失败时撤销。

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

RouteSource String STATIC

路由来源:

  • 云上路由
    • 专有网络(VPC)实例ID:通过VPC学来的路由。
    • 虚拟边界路由器(VBR)实例ID:通过VBR学来的路由。
    • 智能接入网关(SAG)实例ID:通过SAG学来的路由。
  • 线下路由
    • STATIC:通过管理控制台添加的静态路由。
    • OSPF:通过OSPF路由协议学习来的路由。
    • BGP:通过BGP路由协议学习来的路由。
SmartAGId String sag-erx3qta5xg5zyq****

智能接入网关实例ID。

SourceType String cloud

路由类型:

  • cloud:云上路由。
  • local:线下路由。
Status String normal

路由状态:

  • normal:正常。
  • revoked:已撤销。
StrategyPublishStatus String publish

路由发布状态:

  • publish:已发布。
  • not_publish:未发布。
TotalCount Integer 5

总共的路由条目数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeRouteDistributionStrategies
&RegionId=cn-shanghai
&SmartAGId=sag-erx3qta5xg5zyq****
&SourceType=cloud
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRouteDistributionStrategiesResponse>
  <PageNumber>1</PageNumber>
  <TotalCount>2</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>944C2533-1BB7-4578-B6EB-DA05BB61C02A</RequestId>
  <Strategies>
        <Strategy>
              <SmartAGId>sag-erx3qta5xg5zyq****</SmartAGId>
              <Status>normal</Status>
              <RouteSource>STATIC</RouteSource>
              <SourceType>local</SourceType>
              <IsConflict>false</IsConflict>
              <DestCidrBlock>192.168.10.0/24</DestCidrBlock>
        </Strategy>
        <Strategy>
              <SmartAGId>sag-erx3qta5xg5zyq****</SmartAGId>
              <Status>normal</Status>
              <RouteSource>STATIC</RouteSource>
              <SourceType>local</SourceType>
              <IsConflict>false</IsConflict>
              <DestCidrBlock>192.168.11.0/24</DestCidrBlock>
        </Strategy>
  </Strategies>
</DescribeRouteDistributionStrategiesResponse>

JSON 格式

{
	"PageNumber": 1,
	"TotalCount": 2,
	"PageSize": 10,
	"RequestId": "944C2533-1BB7-4578-B6EB-DA05BB61C02A",
	"Strategies": {
		"Strategy": [
			{
				"SmartAGId": "sag-erx3qta5xg5zyq****",
				"Status": "normal",
				"RouteSource": "STATIC",
				"SourceType": "local",
				"IsConflict": false,
				"DestCidrBlock": "192.168.10.0/24"
			},
			{
				"SmartAGId": "sag-erx3qta5xg5zyq****",
				"Status": "normal",
				"RouteSource": "STATIC",
				"SourceType": "local",
				"IsConflict": false,
				"DestCidrBlock": "192.168.11.0/24"
			}
		]
	}
}

错误码

HttpCode 错误码 错误信息 描述
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. 智能网关实例ID为空。
400 SAG.InstanceNoFound The specified SAG instance does not exist. 智能网关实例不存在。
400 RD.InvalidSourceType The specified route source type is invalid. 非法的路由来源类型。

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