调用SetBackendServers设置后端服务器权重。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SetBackendServers

要执行的操作。

取值:SetBackendServers

LoadBalancerId String lb-bp1qjwo61pqz3a******

负载均衡实例ID。

RegionId String cn-hangzhou

负载均衡实例的地域ID。

BackendServers String [{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]

要添加的后端服务器列表。

取值:是一个Json string,其结构是一个JsonList。一次请求中,List中的元素个数最多20个。

  • ServerId:String类型,必选,后端服务器的实例ID。
  • Port:Integer类型,必选,后端服务器使用的端口,取值范围:1-65535。
  • Weight:Integer类型,必选,后端服务器的权重,取值范围:0-100。
  • Description :String类型,非必选,后端服务器描述,长度为1-80个字符,允许包含字母、数字、短横线(-)、正斜杠(/)、点号(.)和下划线(_),支持中文。
  • Type:String类型,表示后端服务器的实例类型,取值:
    • ecs: ECS实例(默认)。
    • eni:弹性网卡实例。
  • ServerIp:ECS或者ENI的实例IP。

示例说明如下:

  • 挂载ECS示例:[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]
  • 挂载ENI:[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]
  • 挂载ENI多IP:[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]
说明
  • 后端服务器实例必须是运行中才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。
  • 只有性能保障型实例支持添加eni类型的后端服务器。

返回数据

名称 类型 示例值 描述
LoadBalancerId String lb-bp1qjwo61pqz3a******

负载均衡实例ID。

BackendServers Array

后端服务器列表。

BackendServer
ServerId String i-xxxxxxxxx

ECS实例ID。

Weight String 100

后端服务器的权重。

Description String 后端服务器

后端服务器描述。

Type String ecs

后端服务器类型,取值:

  • ecs:ECS实例(默认)。
  • eni:弹性网卡实例。
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SetBackendServers
&LoadBalancerId=lb-bp1qjwo61pqz3a******
&BackendServers=[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs",  "Port":"80","Description":"test-112" }]
&<公共请求参数>

正常返回示例

XML 格式

<SetBackendServersResponse>
      <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
      <LoadBalancerId>lb-dhf13*******</LoadBalancerId>
      <BackendServers>
            <BackendServer>
                  <ServerId>eni-hg231**</ServerId>
                  <Weight>100</Weight>
                              <Type>eni</Type>
            </BackendServer>
            <BackendServer>
                  <ServerId>eni-hfhf***</ServerId>
                  <Weight>100</Weight>
                              <Type>eni</Type>
            </BackendServer>
      </BackendServers>
</SetBackendServersResponse>

JSON 格式

{
    "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
    "LoadBalancerId": "139a00604ad-cn-ea******",
    "BackendServers": {
      "BackendServer": [
        {
          "ServerId": "eni-hg231**",
          "Weight": "100",
          "Type": "eni"
        },
        {
          "ServerId": "eni-hhshhs****",
          "Weight": "100",
          "Type": "eni"
        }
      ]
    }
  }

错误码

访问错误中心查看更多错误码。