调用CreateRules为指定的HTTP或HTTPS监听添加转发规则。

调试

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

请求参数

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

要执行的操作。

取值:CreateRules

ListenerPort Integer 443

负载均衡实例前端使用的监听端口。

取值范围:1~65535

LoadBalancerId String lb-bp1ca0zt07t934w******

负载均衡实例ID。

RegionId String cn-hangzhou

负载均衡实例的地域ID。

您可以通过调用DescribeRegions接口查询地域ID。

RuleList String [{"RuleName":"Rule2","Domain":"test.com","VServerGroupId":"rsp-bp114ni******"}]

要添加的转发规则。一次请求中,最多可添加10条转发规则。每条转发规则包含以下参数:

  • RuleName(必选):String类型。转发规则名称,长度限制为1~40,只能使用字母、数字和-/._这些字符。同一个监听内不同规则的名称必须唯一。
  • Domain(可选): String类型。转发规则关联的请求域名,与Url参数至少选择一个。
  • Url(可选):String类型,可选,访问路径,长度限制为1~80,只能使用字母、数字和-/.%?#&这些字符。 URL不能只为/,但必须以/开头,与Domain参数至少选择一个。
  • VServerGroupId(必选):String类型。该转发规则的目标虚拟服务器组ID。

Domain和Url两者必须指定一个,也可以同时指定。Domain和Url的组合在同一个监听内必须唯一。

ListenerProtocol String https

负载均衡实例前端使用的协议。

说明 相同端口存在不同协议监听时,此字段必填。

返回数据

名称 类型 示例值 描述
RequestId String 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C

请求ID。

Rules Array

转发规则列表。

RuleId String rule-bp12jzy0hvio3

转发规则ID。

RuleName String Rule2

转发规则名称。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateRules
&ListenerPort=443
&LoadBalancerId=lb-bp1ca0zt07t934w******
&RegionId=cn-hangzhou
&RuleList=[{"RuleName":"Rule2","Domain":"test.com","VServerGroupId":"rsp-bp114ni******"}]
&<公共请求参数>

正常返回示例

XML 格式

<CreateRulesResponse>
	  <RequestId>D63E42FB-F963-4EE5-9B32-05602BF351F3</RequestId>
	  <Rules>
		    <Rule>
			      <RuleId>rule-bp12jzy******</RuleId>
			      <RuleName>Rule3</RuleName>
		    </Rule>
	  </Rules>
</CreateRulesResponse>

JSON 格式

{
    "RequestId": "D63E42FB-F963-4EE5-9B32-05602BF351F3", 
    "Rules": {
        "Rule": [
            {
                "RuleId": "rule-bp12jzy******", 
                "RuleName": "Rule3"
            }
        ]
    }
}

错误码

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