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

接口说明

CreateServerGroup 接口属于异步接口，即系统返回一个请求 ID，但该服务器组尚未创建成功，系统后台的创建任务仍在进行。您可以调用 ListServerGroups 查询服务器组的创建状态：

当服务器组处于 Creating 状态时，表示服务器组正在创建中。
当服务器组处于 Available 状态时，表示服务器组创建成功。

流控信息

请求速率为200/60(s)。更多流控信息，请前往配额中心查看

授权信息

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

具体说明如下：展开详情

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

alb:CreateServerGroup	Create	ServerGroup acs:alb:{#regionId}:{#accountId}:servergroup/*	alb:ServerGroupProtocol	无

请求参数

字段名称	字段详情
ServerGroupNamestring	服务器组名称。长度为 2~128 个字符，必须以大小写字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-）。示例值:test参考取值来源: ListServerGroups
ServerGroupTypestring	服务器组类型。取值：展开详情示例值:Instance参考取值来源: ListServerGroups
VpcIdstring	VPC 实例 ID。只有该 VPC 下的服务器可以加入到该服务器组。展开详情示例值:vpc-bp15zdkdt37pq72zv****
Schedulerstring	调度算法。取值：展开详情示例值:Wrr
Protocolstring	后端协议。取值：展开详情示例值:HTTP
ResourceGroupIdstring	资源组 ID。示例值:rg-atstuj3rsop****参考取值来源: ListServerGroups
HealthCheckConfigobject	健康检查相关配置。
StickySessionConfigobject	会话保持配置结构体。展开详情
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:5A2CAF0E-5718-45B5-9D4D-70B******
DryRunboolean	是否只预检此次请求，取值：展开详情示例值:false
Ipv6Enabledboolean	是否开启 Ipv6
UpstreamKeepaliveEnabledboolean	是否开启后端长链接。展开详情示例值:false
ServiceNamestring	仅适用于 ALB Ingress 场景，表示服务器组对应的`K8s Service`名称。示例值:test
UchConfigobject	url 一致性 hash 参数配置。
ConnectionDrainConfigobject	连接优雅中断相关配置。展开详情
SlowStartConfigobject	慢启动相关配置。展开详情
Tagarray<object>	标签。
CrossZoneEnabledboolean	服务器组是否开启跨 AZ 负载均衡。取值：展开详情示例值:true

返回参数

字段名称	字段详情
JobIdstring	异步任务 ID。示例值:72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestIdstring	请求 ID。示例值:365F4154-92F6-4AE4-92F8-7FF******
ServerGroupIdstring	服务器组 ID。示例值:sgp-8ilqs4axp6******

返回示例

错误码

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

全局错误码

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

400	QuotaExceeded.ServerGroupsNum	The quota of %s is exceeded, usage %s/%s.	诊断
400	Mismatch.LoadBalancerEditionAndSlowStartEnable	The %s and %s are mismatched.	诊断
400	Mismatch.ServerGroupSchedulerAndSlowStartEnable	The %s and %s are mismatched.	诊断
400	QuotaExceeded.SlowStartDuration	The quota of %s is exceeded, usage %s/%s.	诊断
400	UnsupportedFeature.SlowStart	The feature of %s is not supported.	诊断
400	Mismatch.LoadBalancerEditionAndConnectionDrain	The %s and %s are mismatched.	诊断
400	QuotaExceeded.ConnectionDrainTimeout	The quota of %s is exceeded, usage %s/%s.	诊断
400	UnsupportedFeature.ConnectionDrain	The feature of %s is not supported.	诊断
400	NotExist.ResourceGroup	ResourceGroup does not exist.	诊断
400	OperationDenied.VpcNotSupportIpv6	The operation is not allowed because of VpcNotSupportIpv6.	诊断
400	UnsupportedFeature.FcServerGroup	Server groups of type FC are not supported.	诊断
404	ResourceNotFound.Vpc	The specified resource %s is not found.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-02-11	新增请求参数Ipv6Enabled
	2024-11-28	新增请求参数CrossZoneEnabled
	2024-02-27	变更错误码400
	2024-02-23	变更错误码400 新增错误码404 新增请求参数ConnectionDrainConfig 新增请求参数SlowStartConfig
	2023-11-03	新增请求参数UpstreamKeepaliveEnabled
	2023-04-11	新增请求参数UchConfig