CreateRule_应用型负载均衡_API文档-阿里云OpenAPI开发者门户

接口说明

调用该接口创建转发规则时，请注意以下事项：

配置 Redirect 转发动作时，除了 HttpCode 参数外，其余参数不能全部配置为默认值。
同一个转发规则配置多个转发动作时，Rewrite 转发动作必须配置 ForwardGroup 的动作类型。
CreateRule 接口属于异步接口，即系统返回一个实例 ID，但该转发规则尚未创建成功，系统后台的创建任务仍在进行。您可以调用 ListRules 查询转发规则的创建状态：
- 当转发规则处于 Provisioning 状态时，表示转发规则正在创建中。
- 当转发规则处于 Available 状态时，表示转发规则创建成功。
一条转发规则最多支持添加的条件数（RuleConditions）和动作数（RuleActions）如下：
- 条件数：基础版 5 条，标准版 10 条，WAF 增强版 10 条。
- 动作数：基础版 3 条，标准版 5 条，WAF 增强版 5 条。

流控信息

请求速率为200/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

alb:CreateRule	Create	LoadBalancer acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId} ServerGroup acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}	无	无

请求参数

字段名称	字段详情
ListenerIdstring	应用型负载均衡实例监听 ID。示例值:lsn-l16uo9y******参考取值来源: ListListeners CreateListener
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:5A2CFF0E-5718-45B5-9D4D-70B******
DryRunboolean	是否只预检此次请求，取值：展开详情示例值:false
Priorityinteger<int32>	规则优先级，取值范围：1~10000。值越小表示优先级越高。展开详情示例值:10
Directionstring	转发规则的方向。取值：展开详情示例值:Request
RuleActionsarray<object>	转发规则动作列表。子级条数 <= 100子级条数 >= 1
RuleConditionsarray<object>	转发规则条件列表。子级条数 <= 100子级条数 >= 1
RuleNamestring	转发规则名称。展开详情示例值:rule-doc参考取值来源: CreateRules ListRules
Tagarray<object>	标签列表。

返回参数

字段名称	字段详情
JobIdstring	异步任务 ID。示例值:72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestIdstring	请求 ID。示例值:365F4154-92F6-4AE4-92F8-7FF34B540750
RuleIdstring	转发规则 ID。示例值:rule-a3x3pg1yohq3lq****

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	IncorrectStatus.Listener	The status of %s [%s] is incorrect.	诊断
400	OperationDenied.SameGroupForForwardAndMirrorAction	The operation is not allowed because of %s.	诊断
400	OperationDenied.IpGroupCanNotUsedForMirrorAction	The operation is not allowed because of %s.	诊断
400	OperationDenied.GRPCServerGroup	The operation is not allowed because of %s.	诊断
400	Conflict.Priority	There is already %s having the same configuration with %s.	诊断
400	ResourceQuotaExceeded.LoadBalancerRulesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	诊断
400	ResourceQuotaExceeded.ServerGroupAttachedNum	The quota of %s is exceeded for resource %s, usage %s/%s.	诊断
400	ResourceQuotaExceeded.LoadBalancerServersNum	The quota of %s is exceeded for resource %s, usage %s/%s.	诊断
400	ResourceQuotaExceeded.ServerAddedNum	The quota of %s is exceeded for resource %s, usage %s/%s.	诊断
400	QuotaExceeded.RuleWildcardsNum	The quota of %s is exceeded, usage %s/%s.	诊断
400	QuotaExceeded.RuleMatchEvaluationsNum	The quota of %s is exceeded, usage %s/%s.	诊断
400	QuotaExceeded.RuleActionsNum	The quota of %s is exceeded, usage %s/%s.	诊断
400	Mismatch.Protocol	The %s is mismatched for %s and %s.	诊断
400	Mismatch.VpcId	The %s is mismatched for %s and %s.	诊断
400	OperationDenied.RewriteMissingForwardGroup	The operation is not allowed because of RewriteMissingForwardGroup.	诊断
400	ResourceInConfiguring.Listener	The specified listener is being configured, please try again later.	诊断
400	OperationDenied.MirrorActionSupportHttpGroupOnly	The operation is not allowed because of MirrorActionSupportHttpGroupOnly.	诊断
400	OperationDenied.ProtocolMustSameForForwardGroupAction	The operation is not allowed because of ProtocolMustSameForForwardGroupAction.	诊断
404	ResourceNotFound.Listener	The specified resource %s is not found.	诊断
404	ResourceNotFound.ServerGroup	The specified resource %s is not found.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-09-23	变更请求参数RuleConditions
	2024-01-17	变更错误码400
	2023-11-09	变更请求参数RuleActions 变更请求参数RuleConditions
	2021-03-02	变更请求参数RuleActions

CreateRule_应用型负载均衡_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例