负载均衡
负载均衡
传统型负载均衡CLB
请输入
- 文档首页
负载均衡API参考后端服务器组CreateServerGroup - 创建后端服务器组
复制全文
下载 pdfCreateServerGroup - 创建后端服务器组
文档反馈
问问助手调用 CreateServerGroup 接口，创建一个后端服务器组。
使用说明
- 每个CLB实例默认最多可创建200个后端服务器组。
- 调用一次接口最多可添加20台后端服务器。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：CreateServerGroup
要执行的操作，取值：CreateServerGroup。
Version String 必选 示例值：2020-04-01
API的版本信息，当前版本为 2020-04-01。
LoadBalancerId String 必选 示例值：clb-bp1b6c719dfa08ex****
负载均衡实例的ID。
ServerGroupName String 可选 示例值：myservergroup
后端服务器组名称。
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：点号（.）、下划线（_）和中划线（-）。
- 限制为1 ～ 128个字符。
- 不填默认为后端服务器组ID。
Description String 可选 示例值：This is a servergroup.
后端服务器组的描述。
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
- 长度限制为0 ～ 255个字符。
- 不填则默认为空字符串。
AddressIpVersion String 可选 示例值：ipv4
后端服务器组的IP地址类型。取值如下：
- ipv4（默认值）：表示该后端服务器组IPv4类型。
- ipv6：表示该后端服务器组为IPv6类型。
说明
支持IPv6后端的功能正在邀测中，如需试用，请联系客户经理。
Type String 可选 示例值：instance
后端服务器组的类型。取值如下：
- instance（默认值）：云服务器实例。
- ip：IP地址。
IP地址作为后端服务器的功能正在邀测中，如需试用，请联系客户经理。
Servers.N.Type String 必选 示例值：ecs
后端服务器的类型。
- 当参数Type取instance时，取值如下：
- ecs：云服务器实例。
- eni：网卡。
- 当参数Type取ip时，本参数取值为ip。
- 参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
Servers.N.InstanceId String 必选 示例值：i-3tkuehz8oa3vj0wz****
后端服务器。
- 取值情况如下：
- 当Servers.N.Type 取ecs时，传云服务器实例的ID。您可以调用DescribeInstances接口，查询云服务器实例ID。
- 当Servers.N.Type 取eni时，传已挂载至云服务器的辅助网卡的ID。您可以调用DescribeNetworkInterfaces接口，查询网卡ID。
- 当Servers.N.Type 取ip时，传IP地址作为后端服务器。
- 参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
- 多个后端服务器ID间使用“&”分隔。
Servers.N.Weight Integer 可选 示例值：100
后端服务器的权重，取值范围为0 ～ 100。
- 不填则默认为0。0表示不会将请求转发给该后端服务器。
- 参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
Servers.N.Ip String 必选 示例值：192.XX.XX.2
后端服务器的私网IP地址。
- 您可以调用DescribeInstances接口获取“ecs”类型后端服务器的私网IP地址，调用DescribeNetworkInterfaces接口获取“eni”类型后端服务器的私网IP地址。
- 参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
- 多个后端服务器IP之间使用“&”分隔。
AnyPortEnabled String 可选 示例值：on
后端服务器组是否开启全端口转发。
- on：开启。
- off（默认值）：关闭。
说明
该参数正在邀测中，如需试用，请联系客户经理。
Servers.N.Port Integer 必选 示例值：88
后端服务器接收请求的端口号，取值范围为1～65535。
参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
说明
- 参数AnyPortEnabled为“off”，且需要同时添加后端服务器时，该参数必须传入；参数AnyPortEnabled为“on”时，该参数默认为0。
- 如果您不希望在创建后端服务器组的同时添加后端服务器，那么可以不传入该参数。
- 多个后端服务器IP之间使用“&”分隔。
Servers.N.Description String 可选 示例值：ecs1
后端服务器的描述。
- 参数 - N：表示后端服务器的序号。取值范围：1 ～ 20。
- 必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
- 长度限制为0 ～ 255个字符。
- 不填则默认为空字符串。
Tags.N.Key String 可选 示例值：key1
用户标签的标签键。
- 参数 - N：表示标签键的序号，取值范围：1～20。
- 多个标签键之间用&分隔。
- 不能以 volc:或sys:开头，包括任意大小写形式。
- 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 若标签键开头或结尾存在空格，系统会自动为其去除。
说明
同一资源的标签键不允许重复。
Tags.N.Value String 可选 示例值：value1
用户标签的标签值。
- 参数 - N：表示标签值的序号，取值范围：1～20。
- 多个标签值之间用&分隔。
- 长度取值范围为0～256字符，不填默认为空。
- 允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 大小写敏感。
- 若标签值开头或结尾存在空格，系统会自动为其去除。
说明
若传入该参数，则必须先传入Tags.N.Key。
返回参数
RequestId String 示例值：20210811152539010225146063030****
请求ID。
ServerGroupId String 示例值：rsp-bp1o94dp5i6ea****
后端服务器组ID。
请求示例
返回示例
错误码
最近更新时间：2026.02.13 10:32:59
这个页面对您有帮助吗？
有用
有用
无用
无用