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

接口说明

UpdateRuleAttribute 接口属于异步接口，即系统返回一个请求 ID，但该转发规则属性尚未更新成功，系统后台的更新任务仍在进行。您可以调用 ListRules 查询转发规则属性的更新状态：
- 当转发规则属性处于 Configuring 状态时，表示转发规则属性正在更新中。
- 当转发规则属性处于 Available 状态时，表示转发规则属性更新成功。
一条转发规则最多支持添加的条件数（RuleConditions）和动作数（RuleActions）如下：
- 条件数：基础版 5 条、标准版 10 条、WAF 增强版 10 条。
- 动作数：基础版 3 条，标准版 5 条、WAF 增强版 5 条。

流控信息

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

授权信息

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

具体说明如下：展开详情

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

alb:UpdateRuleAttribute	Update	LoadBalancer acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId} ServerGroup acs:alb:{#regionId}:{#accountId}:servergroup/{#ServerGroupId}	无	无

请求参数

字段名称	字段详情
RuleIdstring	转发规则 ID。示例值:rule-4dp5i6ea****参考取值来源: ListRules CreateRule
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRunboolean	是否只预检此次请求，取值：展开详情示例值:false
RuleConditionsarray<object>	转发规则条件。子级条数 <= 100子级条数 >= 1
RuleActionsarray<object>	转发规则动作列表。子级条数 <= 100子级条数 >= 1
RuleNamestring	转发规则名称。长度为 2~128 个英文或中文字符，必须以大小字母或中文开头，可包含数字，半角句号（.），下划线（_）和短划线（-）。示例值:rule-instance-test参考取值来源: CreateRule ListRules
Priorityinteger<int32>	规则优先级，取值范围：1~10000。值越小表示优先级越高。展开详情示例值:10

返回参数

字段名称	字段详情
JobIdstring	异步任务 ID。示例值:72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestIdstring	请求 ID。示例值:365F5378-41F6-4AE4-92F8-7FF34B540710

返回示例

错误码

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

全局错误码

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

400	IncorrectStatus.Rule	The status of %s [%s] is incorrect.	诊断
400	OperationDenied.IpGroupCanNotUsedForMirrorAction	The operation is not allowed because of %s.	诊断
400	OperationDenied.SameGroupForForwardAndMirrorAction	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.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.ProtocolMustSameForForwardGroupAction	The operation is not allowed because of ProtocolMustSameForForwardGroupAction.	诊断
403	Forbidden.ServerGroup	Authentication has failed for ServerGroup.	诊断
403	Forbidden.LoadBalancer	Authentication is failed for %s.	诊断
404	ResourceNotFound.Rule	The specified resource %s is not found.	诊断
404	ResourceNotFound.ServerGroup	The specified resource %s is not found.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-01-29	变更错误码403
	2024-01-17	变更错误码400 新增错误码403
	2023-11-09	变更请求参数RuleConditions 变更请求参数RuleActions
	2023-09-26	删除返回参数
	2021-03-02	变更请求参数RuleActions

1
2
10 条/页

UpdateRuleAttribute_应用型负载均衡_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例