修改负载均衡器目标规则属性

最近更新时间: 2026-10-12 00:12:35

1. 接口描述

接口请求域名： as.api3.fincloud.tencent.com。

本接口（ModifyLoadBalancerTargetAttributes）用于修改伸缩组内负载均衡器的目标规则属性。

默认接口请求频率限制：20次/秒。

接口更新时间：2026-01-27 15:20:49。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：ModifyLoadBalancerTargetAttributes
Version 是 否 String 公共参数，本接口取值：2018-04-19
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
AutoScalingGroupId 是 是 String 伸缩组ID。可通过登录 [控制台] 或调用接口 [DescribeAutoScalingGroups] ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
示例值： asg-12wjuh0s
ForwardLoadBalancers 是 是 Array of ForwardLoadBalancer 需修改目标规则属性的负载均衡器列表，列表长度上限为100。可以通过 [DescribeLoadBalancers] 接口获取。
示例值：查看

3. 输出参数

参数名称 类型 描述
ActivityId String 伸缩活动ID
示例值： asa-67izy66g
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InvalidParameter.Conflict 参数冲突，指定的多个参数冲突，不能同时存在。
ResourceUnavailable.AutoScalingGroupInActivity 伸缩组正在活动中。
InvalidParameterValue.Range 取值超出指定范围。
InvalidParameterValue.LimitExceeded 取值超出限制。
MissingParameter.InScenario 在特定场景下缺少参数。
InvalidParameter.InScenario 在特定场景下的不合法参数。
ResourceNotFound.LoadBalancerNotFound 找不到指定负载均衡器。
InvalidParameterValue.ForwardLb 错误地指定了一个应用型负载均衡器。
InvalidParameterValue.InvalidClbRegion
ResourceUnavailable.LbBackendRegionInconsistent
InvalidParameterValue.InvalidAutoScalingGroupId
InternalError.RequestError 请求错误
FailedOperation.NoActivityToGenerate
ResourceNotFound.AutoScalingGroupNotFound
ResourceNotFound.LocationNotFound
ResourceNotFound.ListenerNotFound
ResourceUnavailable.LbVpcInconsistent
ResourceUnavailable.InstanceInOperation
ResourceUnavailable.LoadBalancerInOperation
InvalidParameterValue.ClassicLb
ResourceUnavailable.LbProjectInconsistent
InvalidParameter.LoadBalancerNotInAutoScalingGroup
LimitExceeded.AfterAttachLbLimitExceeded
InvalidParameterValue.TargetPortDuplicated
ResourceNotFound.LoadBalancerNotInAutoScalingGroup
InvalidParameter.ActionNotFound

5. 示例

示例1 修改应用型负载均衡器lb-23aejgcv（监听器为lbl-ncw704sn，转发路径为loc-l3hmaev9）的目标规则属性，将端口修改为8080，权重修改为20。

输入示例

POST / HTTP/1.1
Content-Type: application/json
X-TC-Action: ModifyLoadBalancerTargetAttributes
<Common Parameters>

{
    "AutoScalingGroupId": "asg-12wjuh0s",
    "ForwardLoadBalancers": [
        {
            "TargetAttributes": [
                {
                    "Port": 8080,
                    "Weight": 20
                }
            ],
            "Region": "ap-region1",
            "LocationId": "loc-l3hmaev9",
            "ListenerId": "lbl-ncw704sn",
            "LoadBalancerId": "lb-23aejgcv"
        }
    ]
}

输出示例

{
  "Response": {
    "ActivityId": "asa-9asddelc",
    "RequestId": "8d78668d-61eb-456d-855b-f34f91371089"
  }
}