动态与公告

产品动态

产品公告

产品简介

产品概述

产品优势

使用场景

技术原理

产品对比

使用约束

Service Regions and Service Providers

购买指南

计费概述

计费项

CLB 资源包

购买方式

欠费说明

产品属性选择

快速入门

域名化负载均衡快速入门

负载均衡快速入门

IPv6 负载均衡快速入门

CentOS 下部署 Nginx

CentOS 下部署 Java Web

操作指南

负载均衡实例

负载均衡监听器

后端服务器

健康检查

证书管理

日志管理

监控告警

访问管理

传统型负载均衡

实践教程

部署证书到负载均衡（双向认证）

负载均衡开启 Gzip 配置及检测方法说明

HTTPS 转发配置入门指南

如何获取客户端真实 IP

负载均衡配置监控告警最佳实践

产品高可用说明

均衡算法选择与权重配置示例

配置 WAF 对负载均衡的监听域名进行 Web 安全防护

配置 IAP 对负载均衡的域名和路径的web访问进行身份验证

配置 IAP 对负载均衡的域名和路径的程序化访问进行身份验证

运维指南

客户端 timewait 过多解决方案

负载均衡HTTPS服务性能测试

压力测试常见问题

CLB 证书操作权限问题

故障处理

UDP 健康检查出现异常

API 文档

History

Introduction

API Category

Instance APIs

Listener APIs

Backend Service APIs

Target Group APIs

Redirection APIs

Other APIs

Classic CLB APIs

Load Balancing APIs

Making API Requests

Data Types

Error Codes

CLB API 2017

常见问题

计费相关

负载均衡配置相关

健康检查异常排查

HTTPS 相关

WS/WSS 协议支持相关

HTTP/2 协议支持相关

默认域名阻断提示

服务等级协议

联系我们

词汇表

ModifyLoadBalancerBackends

PDF

聚焦模式

字号

最后更新时间： 2025-11-20 15:20:22

API Description
This API is used to modify the weight of CVMs bound to a CLB instance, thereby adjusting the request forwarding rule.
Domain name for API calls: lb.api.qcloud.com
Request Parameters
The list below contains only the API request parameters. Common parameters should be added when you call the API. For more information, see Common Request Parameters. The Action field for this API is ModifyLoadBalancerBackends.
Parameter
Required
Type
Description
 loadBalancerId
 Yes
 String
 CLB instance ID, which can be queried via the DescribeLoadBalancers API.
 backends.n.instanceId
 Yes
 String
 Unique ID of the CVM, which can be obtained from the `unInstanceId` field in the response of the DescribeInstances API.This API supports entering multiple CVM instance IDs at a time. For example, if you want to specify two CVMs, enter backends.0.instanceId&backends.1.instanceId.
 backends.n.weight
 Yes
 Int
 Weight of the bound CVMs. Value range: 0-100. Default value: 10.
Response Parameters
Parameter
Type
Description
 code
 Int
 Common error code. 0: success; other values: failure. For more information, see Common Error Codes.
 message
 String
API-related module error message description.
 codeDesc
 String
 Error code. For a successful operation, "Success" is returned. For a failed operation, a message describing the failure is returned.
 requestId
 Int
 Request task ID. The API provides an asynchronous task. You can use this parameter to query the execution result of the task via the  DescribeLoadBalancersTaskResult API.
Example
Request
https://lb.api.qcloud.com/v2/index.php?Action=ModifyLoadBalancerBackends
&<Common request parameters>
&loadBalancerId=lb-abcdefgh
&backends.0.instanceId=ins-6789test
&backends.0.weight=10
&backends.1.instanceId=ins-1234test
&backends.1.weight=6
Response
﻿
{
  "code" : 0,
  "message" : "",
  "codeDesc": "Success",
  "requestId" : 1234
}
﻿
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

Parameter	Required	Type	Description
loadBalancerId	Yes	String	CLB instance ID, which can be queried via the DescribeLoadBalancers API.
backends.n.instanceId	Yes	String	Unique ID of the CVM, which can be obtained from the `unInstanceId` field in the response of the DescribeInstances API.This API supports entering multiple CVM instance IDs at a time. For example, if you want to specify two CVMs, enter backends.0.instanceId&backends.1.instanceId.
backends.n.weight	Yes	Int	Weight of the bound CVMs. Value range: 0-100. Default value: 10.

tencent cloud

负载均衡

ModifyLoadBalancerBackends

API Description

Request Parameters

Response Parameters

Example

帮助和支持