接口说明
该接口仅在终端节点的后端服务流量通行策略为指定可以接收访问流量的通行目标时有效。您可以通过 DescribeCustomRoutingEndpoint 查询指定终端节点的后端服务流量通行策略。即当 TrafficToEndpointPolicy(后端服务流量通行策略)取值为 AllowCustom(指定可以接收访问流量的通行目标)时,该接口有效。
在调用本接口时,请注意以下事项:
- CreateCustomRoutingEndpointTrafficPolicies 接口属于异步接口,即系统会先返回一个请求 ID,但自定义路由类型监听的终端节点流量通行目标并未创建完成,系统后台的创建任务仍在进行。您可以通过调用 DescribeCustomRoutingEndpointGroup 接口查询终端节点组的状态,来确认终端节点流量通行目标是否创建完成。
- 当终端节点组处于 updating 状态时,表示终端节点流量通行目标正在创建中,在该状态下,您只能执行查询操作,不能执行其他操作。
- 当终端节点组处于 active 状态时,表示终端节点流量通行目标创建完成。
- CreateCustomRoutingEndpointTrafficPolicies 接口不支持在同一个全球加速实例内并发创建终端节点流量通行目标。
前提条件
创建终端节点流量通行目标前,请确保您已完成以下操作:
-
已创建标准型全球加速实例。具体操作,请参见 CreateAccelerator 。
-
标准型全球加速实例的带宽计费方式为按带宽时,已将带宽包与标准型全球加速实例绑定。具体操作,请参见 BandwidthPackageAddAccelerator 。
-
您已部署了相关应用,作为全球加速的后端服务接收转发的请求。自定义路由类型监听的后端服务类型仅支持交换机(vSwitch)。
-
您已经申请了自定义路由类型监听使用权限并创建了自定义路由类型监听。监听支持选择自定义路由类型的功能邀测中,如需使用,请联系阿里云客户经理。创建自定义路由类型监听,请参见 CreateListener 。
-
您已创建了自定义路由类型监听的终端节点组。具体操作,请参见 CreateCustomRoutingEndpointGroups 。
-
您已创建了自定义路由类型监听的终端节点。具体操作,请参见 CreateCustomRoutingEndpoints 。
流控信息
请求参数
字段名称 | 字段详情 |
---|---|
RegionIdstring | 全球加速实例所在的地域 ID,仅取值cn-hangzhou。 示例值:cn-hangzhou |
ClientTokenstring | 客户端 Token,用于保证请求的幂等性。展开详情 示例值:123e4567-e89b-12d3-a456-426655440000 |
EndpointIdstring | 待创建流量通行目标的终端节点 ID。 示例值:ep-2zewuzypq5e6r3pfh****参考取值来源: UpdateBasicEndpoint ListEndpointGroups CreateBasicEndpoint |
PolicyConfigurationsarray<object> | 流量通行目标配置。展开详情 子级条数 <= 500 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID。 示例值:04F0F334-1335-436C-A1D7-6C044FE73368 |
PolicyIdsarray<string> | 流量通行目标 ID 列表。 |
返回示例
错误码
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2024-07-23 | |||
2022-08-11 |