最近更新时间:2023.11.16 15:51:41
首次发布时间:2021.08.31 10:37:27
调用 CreateServerGroup 接口创建一个后端服务器组。
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateServerGroup | 要执行的操作,取值为CreateServerGroup。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为:2020-04-01。 |
LoadBalancerId | String | 是 | clb-bp1b6c719dfa08ex**** | 后端服务器组所属的负载均衡实例的ID。您可以调用DescribeLoadBalancers接口获取负载均衡实例ID。 |
ServerGroupName | String | 否 | myservergroup | 后端服务器组名称。
|
Description | String | 否 | This is a servergroup. | 后端服务器组的描述。
|
Type | String | 否 | instance | 后端服务器组的类型。取值如下:
|
Servers.N.InstanceId | String | 是 | Servers.1.InstanceId=i-3tkuehz8oa3vj0wz****&Servers.2.InstanceId=eni-2feo5qd3orri85oxruvxv**** | 云服务器实例ID或已绑定云服务器实例的网卡ID。您可以调用DescribeInstances接口获取云服务实例ID,调用DescribeNetworkInterfaces接口获取网卡ID。
说明 如果您不希望在创建后端服务器组的同时添加后端服务器,那么可以不传入该参数。后端服务器组创建成功后,请您调用AddServerGroupBackendServers接口添加后端服务器。 |
Servers.N.Type | String | 是 | Servers.1.Type=ecs&Servers.2.Type=eni | 后端服务器的类型,取值如下:
说明
|
Servers.N.Weight | Integer | 否 | Servers.1.Weight=100&Servers.2.Weight=100 | 后端服务器的权重,取值范围为0 ~ 100。
|
Servers.N.Ip | String | 是 | Servers.1.Ip=192.XX.XX.2&Servers.2.Ip=192.XX.XX.3 | 后端服务器的私网IP地址。您可以调用DescribeInstances接口获取“ecs”类型后端服务器的私网IP地址,调用DescribeNetworkInterfaces接口获取“eni”类型后端服务器的私网IP地址。 说明 如果您不希望在创建后端服务器组的同时添加后端服务器,那么可以不传入该参数。 |
Servers.N.Port | Integer | 是 | Servers.1.Port=88&Servers.2.Port=443 | 后端服务器接收请求的端口号,取值范围为1~65535。 说明 如果您不希望在创建后端服务器组的同时添加后端服务器,那么可以不传入该参数。 |
Servers.N.Description | String | 否 | Servers.1.Description=ecs1&Servers.2.Description=eni1 | 后端服务器的描述。
|
AddressIpVersion | String | 否 | ipv4 | 后端服务器组的IP地址类型。取值如下:
说明 支持IPv6后端的功能正在邀测中,如需使用,请联系客户经理申请权限。 |
字段 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 20210811152539010225146063030**** | 请求ID。 |
ServerGroupId | String | rsp-bp1o94dp5i6ea**** | 后端服务器组ID。 |
GET /?Action=CreateServerGroup&Version=2020-04-01&LoadBalancerId=clb-bp1b6c719dfa08ex****&ServerGroupName=myservergroup&Servers.1.InstanceId=i-3tkuehz8oa3vj0wz****&Servers.1.Ip=192.XX.XX.2&Servers.1.Port=88&Servers.1.Type=ecs&Servers.1.Weight=100 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: clb
{ "ResponseMetadata": { "RequestId": "20210811152539010225146063030****", "Action": "CreateServerGroup", "Version": "2020-04-01", "Service": "clb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811152539010225146063030****", "ServerGroupId": "rsp-bp1o94dp5i6ea****" } }
此处仅展示当前API的错误码,更多错误码请参见公共错误码。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'. | 该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如XXX。 说明 其中,XXX表示缺少的参数名称。 |
400 | InvalidAddressIpVersion.LoadBalancerMismatch | The specified AddressIpVersion and LoadBalancer are not matched. | 指定的 IP 类型与负载均衡不匹配。 |
400 | InvalidAddressIpVersion.Malformed | The specified AddressIpVersion is malformed. | 指定的 AddressIpVersion 参数格式不合法。 |
400 | InvalidAddressIpVersion.TypeMismatch | The specified AddressIpVersion and Type are not matched. | 指定的 IP 类型与服务器组类型不匹配。 |
400 | InvalidAddressIpVersion.VpcMismatch | The specified AddressIpVersion and Vpc are not matched. | 指定的 IP 类型与 VPC 不匹配。 |
400 | InvalidType.Malformed | The specified Type is malformed. | 指定的 Type 参数格式不合法。 |
400 | InvalidDescription.Malformed | The specified Description is malformed. | 指定的 Description 参数格式不合法。 |
400 | InvalidName.Malformed | The specified Name is malformed. | 指定的 Name 参数格式不合法。 |
400 | InvalidServers.Description.Malformed | The specified Servers.Description is malformed. | 指定的 Servers.Description 参数格式不合法。 |
400 | InvalidServers.Ip.Malformed | The specified Servers.Ip is malformed. | 指定的 Servers.Ip 参数格式不合法。 |
400 | InvalidServers.Port.Malformed | The specified Servers.Port is malformed. | 指定的 Servers.Port 参数格式不合法。 |
400 | InvalidServers.Type.Malformed | The specified Servers.Type is malformed. | 指定的 Servers.Type 参数格式不合法。 |
400 | InvalidServers.Weight.Malformed | The specified Servers.Weight is malformed. | 指定的 Servers.Weight 参数格式不合法。 |
400 | InvalidLoadBalancer.InvalidStatus | The specified LoadBalancer is not in the correct status for the request. | 指定的负载均衡所处状态无法响应该请求。 |
400 | UnsupportedOperation.AccountArrears | The request on the specified instance is denied due to the account in arrears status. | 因账户处于欠费状态,对于该实例的操作请求被拒绝。 |
400 | InvalidServer.Type | The specified Server type not match with ServerGroup. | 指定的后端服务器类型与服务器组类型不一致。 |
400 | LimitExceeded.ServerNumber | You've reached the limit on the number of add servers that you can operate. | 已达到单次可操作的后端服务器的数量上限。 |
400 | QuotaExceed.ServerGroupNumberEachInstance | You've reached the limit on the number of ServerGroups that you can create. | 已达到可创建后端服务器组的数量的配额上限。 |
400 | QuotaExceed.ServerNumberEachInstance | You've reached the limit on the number of Servers that you can create. | 已达到可创建后端服务器的数量的配额上限。 |
400 | InvalidServerId.ServerIPMismatch | The specified serverIP and InstanceId are not matched. | 指定的后端服务器 ID 与 IP 不匹配。 |
400 | InvalidEni.UnSupportAction | The specified Eni does not support this action. | 指定的网卡不支持当前操作。 |
400 | InvalidBackendServer.ServerVpcMismatch | The specified BackendServer and Vpc are not matched. | 指定的后端服务器与 VPC 不匹配。 |
400 | InvalidIncorrectOrder.Malformed | The specified index order is malformed. | 指定的索引顺序参数格式不合法。 |
400 | InvalidServerIp.UnSupportAction | The specified Server Ip does not support this action. | 指定的后端服务器 IP 不支持当前操作。 |
400 | InvalidProject.Malformed | The specified Project is malformed. | 指定的 Project 参数格式不合法。 |
400 | InvalidLoadBalancer.UnSupportAction | The specified LoadBalancer does not support this action. | 指定的负载均衡不支持当前操作。 |
403 | InvalidResourceType.ServcieManaged | The specified ResourceType is managed by a service. | 指定的资源是服务托管资源。 |
404 | InvalidLoadBalancer.NotFound | The specified LoadBalancer does not exist. | 指定的负载均衡实例不存在。 |
404 | InvalidServer.NotFound | The specified Server does not exist. | 指定的后端服务器不存在。 |
404 | InvalidExclusiveCluster.NotFound | The specified ExclusiveCluster does not exist. | 指定的独占集群不存在。 |
409 | InvalidServer.Conflict | The specified Server already exists. | 指定的后端服务器端口已存在。 |
412 | InvalidLoadBalancer.Expired | The specified LoadBalancer has expired. | 指定的负载均衡已过期。 |
412 | InvalidExclusiveCluster.Expired | The specified ExclusiveCluster has expired. | 指定的独占集群已过期。 |
412 | InvalidExclusiveCluster.UnPurchased | The specified ExclusiveCluster is not purchased. | 指定的独占集群未购买。 |