转发规则相关API：CreateRules

描述


创建并添加一组转发规则到监听。

请求参数


                                                                                                                                                                                                                                            

名称	类型	是否必须	描述
Action	String	是	操作接口名，系统规定参数。取值：CreateRules。
RegionId	String	是	负载均衡地域ID。
LoadBalancerId	String	是	负载均衡实例的唯一标识。
ListenerPort	String	是	负载均衡实例前端使用的监听端口。 取值范围：1-65535。
RuleList	String	是	欲添加的转发规则列表。 取值：是一个Json string，其结构为一个JsonList。其中包含的每一个转发规则结构如Rule所示。一次添加请求中，最多包含10个转发规则。

Rule
                                                                                                                                                                                                        

名称	类型	是否必须	描述
RuleName	String	是	转发规则名称，长度限制为1-80，只能使用字母、数字、‘-’、‘/’、‘.’、‘_’这些字符。注意：同一个监听内不同规则的名称必须唯一。
Domain	String	否	域名。
Url	String	否	访问路径。长度限制为1-80，只能使用字母、数字、‘-’、‘/’、‘.’、‘%’、‘?’、‘#’、‘&’这些字符Domain和Url两者必传其一，也可都传。Domain和Url的组合在同一个监听内必须唯一。
VServerGroupId	String	否	该转发规则的目标VServerGroup ID。

返回参数


                                                                                                                                                                        

名称	类型	描述
<公共返回参数>		详见[url=https://help.aliyun.com/document_detail/%7B%7Bdoc/[3]API%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C/[3]%E8%B0%83%E7%94%A8%E6%96%B9%E5%BC%8F/[3]%E5%85%AC%E5%85%B1%E5%8F%82%E6%95%B0.md%7D%7D]<公共返回参数>[/url] 。
Rules	List	数组格式，转发规则列表，列表中元素结构见下表。

                                                                                                                                                                        

名称	类型	描述
RuleId	String	转发规则ID。
RuleName	String	转发规则名称。

示例



请求示例

1. https://slb.aliyuncs.com/?<公共请求参数>
2. &Action=CreateRules
3. &RegionId=cn-east-hangzhou-01
4. &LoadBalancerId=152a602e315-cn-beijing-btc-a01
5. &ListenerPort=80
6. &RuleList=[
7. {"RuleName":"Rule1","Domain":"abcdefg.com","Url":"/image","VServerGroupId":"Group1"},
8. {"RuleName":"Rule2","Domain":"abcdefg.com","Url":"/cache","VServerGroupId":"Group2"},
9.         ]

返回示例

• 
  XML 格式
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <CreateRules>
  3.   <RequestId>9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C</RequestId>
  4.   <Rules>
  5.       <Rule>
  6.           <RuleId>rule-3ejhktkaeu<RuleId>
  7.           <RuleName>Rule1<RuleName>
  8.       </Rule>
  9.       <Rule>
  10.           <RuleId>rule-tybqi6qkp8<RuleId>
  11.           <RuleName>Rule2<RuleName>
  12.       </Rule>
  13.   </Rules>
  14. </CreateRules>
• 
  JSON格式
  1. {
  2. "RequestId":"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C",
  3. "Rules":{
  4.       "Rule":[
  5.           {'RuleId':'rule-3ejhktkaeu','RuleName':'Rule1'},
  6.           {'RuleId':'rule-tybqi6qkp8','RuleName':'Rule2'}
  7.               ]}
  8. }