调用 ModifyServerGroupAttributes 接口,修改指定后端服务器组,包括服务器组的名称、描述、以及指定服务器的相关信息。
调用本接口时,若可选参数未进行配置,则该可选参数的配置保持原状。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyServerGroupAttributes | 要执行的操作,取值为ModifyServerGroupAttributes。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为:2020-04-01。 |
ServerGroupId | String | 是 | rsp-bp1o94dp5i6ea**** | 后端服务器组ID。 |
ServerGroupName | String | 否 | myservergroup | 后端服务器组的名称。
|
Description | String | 否 | This is a servergroup. | 后端服务器组的描述。
|
Servers.N.ServerId | String | 是 | Servers.1.ServerId=rs-mjc9b2p0v6rk5smt1b27****&Servers.2.ServerId=rs-rry6aq7sb280v0x588v**** | 后端服务器ID。
|
Servers.N.Weight | Integer | 是 | Servers.1.Weight=100&Servers.2.Weight=100 | 后端服务器的权重,取值范围为0 ~ 100。
|
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 | 后端服务器的描述。
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 20210811152539010225146063030**** | 请求ID。 |
GET /?Action=ModifyServerGroupAttributes&Version=2020-04-01&ServerGroupId=rsp-bp1o94dp5i6ea****&ServerGroupName=myservergroup&Servers.1.ServerId=rs-mjc9b2p0v6rk5smt1b27****&Servers.1.Port=88&&Servers.1.Weight=100 HTTP/11 Host: open.volcengineapi.com Region: cn-beijing Service: clb
{ "ResponseMetadata": { "RequestId": "20210811152539010225146063030****", "Action": "ModifyServerGroupAttributes", "Version": "2020-04-01", "Service": "clb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811152539010225146063030****" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
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 | InvalidDescription.Malformed | The specified Description is malformed. | 指定的 Description 参数格式不合法。 |
400 | InvalidPort.Malformed | The specified Port is malformed. | 指定的 Port 参数格式不合法。 |
400 | InvalidServerGroupName.Malformed | The specified ServerGroupName is malformed. | 指定的 ServerGroupName 参数格式不合法。 |
400 | InvalidServers.Description.Malformed | The specified Servers.Description is malformed. | 指定的 Servers.Description 参数格式不合法。 |
400 | InvalidServers.Weight.Malformed | The specified Servers.Weight is malformed. | 指定的 Servers.Weight 参数格式不合法。 |
400 | UnsupportedOperation.AccountArrears | The request on the specified instance is denied due to the account in arrears status. | 因账户处于欠费状态,对于该实例的操作请求被拒绝。 |
400 | LimitExceeded.ServerNumber | You've reached the limit on the number of add servers that you can operate. | 已达到单次可操作的后端服务器的数量上限。 |
400 | InvalidIncorrectOrder.Malformed | The specified index order is malformed. | 指定的索引顺序参数格式不合法。 |
403 | Forbidden | You are not authorized to perform operations on the specified service. | 无权限对指定服务进行操作。 |
403 | InvalidResourceType.ServcieManaged | The specified ResourceType is managed by a service. | 指定的资源是服务托管资源。 |
404 | InvalidServerGroup.NotFound | The specified ServerGroup 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. | 指定的后端服务器已存在。 |
409 | InvalidServerPort.Conflict | The specified Server Port already exists. | 指定的后端服务器端口已存在。 |
400 | InvalidLoadBalancer.InvalidStatus | The specified LoadBalancer is not in the correct status for the request. | 指定的负载均衡所处状态无法响应该请求。 |
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. | 指定的独占集群未购买。 |