负载均衡
负载均衡
传统型负载均衡CLB
请输入
- 文档首页
负载均衡API参考转发规则CreateRules - 创建转发规则
复制全文
下载 pdfCreateRules - 创建转发规则
文档反馈
问问助手调用 CreateRules 接口，为指定HTTP/HTTPS监听器添加转发规则，用于将访问不同域名或不同URL的请求转发到不同的后端服务器组。
使用说明
- 每个HTTP/HTTPS监听器中最多可添加50个转发规则，默认转发规则不计入在内。
- 调用一次接口最多可以添加50个转发规则。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
下表中，a.N.b类型类型参数中的“N”表示转发规则的序号，取值范围为1 ～ 50。多个转发规则间请使用“&”分隔。
Action String 必选 示例值：CreateRules
要执行的操作，取值：CreateRules。
Version String 必选 示例值：2020-04-01
API的版本信息，当前版本为 2020-04-01。
Rules.N.Domain String 可选 示例值：www.test.com
转发规则的域名，支持泛域名和精确域名。规范如下：
- 需至少包含一个‘.’，且不允许以‘.’开头或结尾。
- 仅允许包含字母、数字、‘.’、‘-‘、‘*’。
- 长度限制为1 ～ 128个字符。
- 泛域名：使用“*”代替1个或多个字符。
- “*”必须在域名开头或结尾。
- 同一条域名中“*”不能出现两次。
- “*”前后不能有除了.以外的字符。
- 合法示例：.com、www.test.。
- 非法示例：aaa.com、www..com
- 精确域名：符合域名规范的精确域名，例如：www.test.com。
说明
Rules.N.Domain和 Rules.N.Url两者至少需指定一个，且Rules.N.Domain和 Rules.N.Url的组合在同一个监听器内必须唯一。
Rules.N.Url String 可选 示例值：/poo
转发规则的URL，仅支持绝对路径。规范如下：
- 必须以正斜线“/”开头。
- 仅允许包含字母、数字、-、_、/、.、%、?、#、&、＝等字符。
- 支持正则表达式的URL：必须以“”开头，支持大小写字母、数字和特殊字符`.-_/=?~^*$:()[]+|`，只能在开头，且只能出现一次。
- 字符/不能连续出现。
- 长度限制为1 ～ 128个字符。
- 若指定Domain，则Url不传入数值时，默认为/。
说明
- Rules.N.Domain和Rules.N.Url两者至少需指定一个，且Rules.N.Domain和 Rules.N.Url的组合在同一个监听器内必须唯一。
- 当Rules.N.Domain设置为空时，Rules.N.Url不允许只为正斜线“/”。
Rules.N.ActionType String 可选 示例值：Forward
转发规则的转发动作。取值如下：
- Forward：转发至。
- Redirect：重定向至。
说明
该参数取值为Redirect且参数Rules.N.RedirectConfig.Protocol与该转发规则所属监听器协议相同时，参数Rules.N.RedirectConfig.Host、Rules.N.RedirectConfig.Path、Rules.N.RedirectConfig.Port不能均为空。
Rules.N.ServerGroupId String 可选 示例值：rsp-bp1o94dp5i6ea****
说明
参数Rules.N.ActionType取值为Forward时，该参数为必填。
Rules.N.RedirectConfig.Protocol String 可选 示例值：HTTPS
转发规则重定向的协议。取值如下：
- HTTP
- HTTPS（默认值）
说明
参数Rules.N.ActionType取值为Redirect时，不传入该参数或该参数不传入数值，则默认为HTTPS。
Rules.N.RedirectConfig.Host String 可选 示例值：www.test.com
转发规则重定向的域名，当前仅支持精确域名。规范如下：
- 需至少包含一个‘.’，且不允许以‘.’开头或结尾。
- 仅允许包含字母、数字、‘.’、‘-‘。
- 长度限制为1 ～ 128个字符。
- 符合域名规范的精确域名，例如：www.test.com。
说明
参数Rules.N.ActionType取值为Redirect时，不传入该参数或该参数不传入数值，则默认为空字符串，实际转发时与请求域名保持一致。
Rules.N.RedirectConfig.Path String 可选 示例值：/abc
转发规则重定向的路径。规范如下：
- 必须以正斜线“/”开头，字符‘/’不能连续出现。
- 仅允许包含字母、数字、‘-’、‘_’、‘/’、‘.’、‘%’、‘?’、‘#’、‘&’、‘＝’等字符。
- 长度限制为1 ～ 128个字符。
说明
参数Rules.N.ActionType取值为Redirect时，不传入该参数或该参数不传入数值，则默认为空字符串，实际转发时与请求路径保持一致。
Rules.N.RedirectConfig.Port String 可选 示例值：443
转发规则重定向的端口，取值范围为 1~65535。
说明
参数Rules.N.ActionType取值为Redirect时，不传入该参数或该参数不传入数值，则默认为空字符串，实际转发时与请求端口保持一致。
Rules.N.RedirectConfig.StatusCode String 可选 示例值：301
转发规则重定向的状态码。取值如下：
- 301（默认）：表示请求的资源已被永久移动到新的 URL，客户端应该使用新的 URL 进行后续请求。
- 302：表示请求的资源被临时移动到新的 URL，但未来可能会再次更改，客户端应该使用新的 URL 进行后续请求。
- 307：与 302 类似，但在重定向时要求客户端保持请求方法不变。例如，原来是 GET 请求，则重定向后仍然是 GET 请求。
- 308：与 301 类似，但在重定向时要求客户端保持请求方法不变。
说明
参数Rules.N.ActionType取值为Redirect时，不传入该参数或该参数不传入数值，则默认为301。
Rules.N.Description String 可选 示例值：This is a rule.
转发规则的描述，默认值为空字符串。规范如下：
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
- 长度限制为0 ～ 255个字符。
Rules.N.Tags.N.Key String 可选 示例值：k1
标签的标签键。
- 第一个N：表示转发规则的序号，取值范围为1 ～ 50。多个转发规则间请使用“&”分隔。
- 第二个N：表示标签键的序号，取值范围：1～50。多个标签键之间用&分隔。
- 不能以 volc:或sys:开头，包括任意大小写形式。
- 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 若标签键开头或结尾存在空格，系统会自动为其去除。
同一资源的标签键不允许重复。
Rules.N.Tags.N.Value String 可选 示例值：v1
标签的标签值。
- 第一个N：表示转发规则的序号，取值范围为1 ～ 50。多个转发规则间请使用“&”分隔。
- 第二个N：表示标签值的序号，取值范围：1～50。多个标签值之间用&分隔。
- 长度取值范围为0～256字符，不填默认为空。
- 允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 大小写敏感。
- 若标签值开头或结尾存在空格，系统会自动为其去除。
若传入该参数，则必须先传入标签键。
返回参数
RequestId String 示例值：2021081316135705146063000AD724****
请求ID。
RuleIds String[] 示例值：["rule-2fegss1cplxxc5oxruvvq****","rule-3ciynwkb46c6rrt4jszkd****"]
转发规则ID。
请求示例
返回示例
错误码
最近更新时间：2026.03.17 08:33:44
这个页面对您有帮助吗？
有用
有用
无用
无用