DescribeLoadBalancerAttributes--负载均衡-火山引擎

文档中心

立即注册

导航

DescribeLoadBalancerAttributes

最近更新时间：2024.06.04 17:37:43首次发布时间：2021.08.31 10:37:27

调用 DescribeLoadBalancerAttributes 接口，查看指定负载均衡实例的详情。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLoadBalancerAttributes	要执行的操作，取值为DescribeLoadBalancerAttributes。
Version	String	是	2020-04-01	API版本信息，当前版本为：2020-04-01。
LoadBalancerId	String	是	clb-bp1b6c719dfa08ex****	CLB实例ID。您可以调用DescribeLoadBalancers接口，查询CLB实例ID。

返回参数

名称	类型	示例值	描述
RequestId	String	202108161106382514606306AF947C****	请求ID。
AccountId	String	210012****	CLB实例所属的账号ID。
ExclusiveClusterId	String	ec-bp1o94dp5i6ea****	独占集群的ID。非独占集群类型的CLB实例该参数返回为空。独占集群正在邀测中，如需试用，请联系客户经理。
LoadBalancerId	String	clb-bp1b6c719dfa08ex****	CLB实例ID。
LoadBalancerName	String	clb-test1	CLB实例的名称。
Description	String	测试实例	CLB实例的描述。
Type	String	private	CLB实例的类型。 public：公网。 private：私网。
AddressIpVersion	String	ipv4	CLB实例的IP地址类型。 ipv4：仅IPv4。 DualStack：双栈，即IPv4和IPv6。
LoadBalancerBillingType	Integer	2	CLB实例计费类型。 1：包年包月 2：按量计费-按规格计费 3：按量计费-按使用量计费说明按使用量计费正在邀测中，如需使用，请联系客户经理。
LoadBalancerSpec	String	small_1	CLB实例的规格。 small_1：小型I small_2：小型II medium_1：中型I medium_2：中型II large_1：大型I large_2：大型II
MasterZoneId	String	cn-shanghai-a	CLB实例的主可用区ID。
SlaveZoneId	String	cn-shanghai-b	CLB实例的备可用区ID。 CLB实例为单可用区实例时，该参数返回为空。负载均衡单可用区正在邀测中，如需试用，请联系客户经理。
VpcId	String	vpc-bp1aevy8sofi8mh1****	CLB实例所属的VPC ID。
SubnetId	String	subnet-bp12mw1f8k3jgy****	CLB实例所属的子网ID。
EniID	String	eni-2fe6rabqt8gxruv8u8c9f****	CLB实例占用的网卡ID。
EipID	String	eip-2fe698wsnjoxruvtryndp****	公网IP的ID。
EipAddress	String	10.XX.XX.27	CLB实例的公网IP地址。
EniAddress	String	172.XX.XX.33	CLB实例的私网IPv4地址。
EniAddressNum	Integer	2	CLB实例的私网IPv4地址数量。
EniAddresses	Array of String	["172.XX.XX.2", "172.XX.XX.3"]	CLB实例的私网IPv4地址信息。具体请参见下表“ EniAddresses”。
Eip	Struct	-	CLB实例的公网IP的信息。具体请参见下表“ Eip ”。
EniIpv6Address	String	2408:4005:XX:XX:200	CLB实例的私网IPv6地址。
Ipv6EipId	String	eip-2zaiwb7ujxscd****	IPv6公网带宽的ID。
Ipv6AddressBandwidth	Struct	-	CLB实例的IPv6公网带宽信息。具体请参见下表“ Ipv6AddressBandwidth ”。
ModificationProtectionStatus	String	ConsoleProtection	是否开启控制台修改保护。 NonProtection或空：不开启。配置后会清空已配置的`ModificationProtectionReason`。 ConsoleProtection：开启。开启后，禁止通过控制台修改实例或删除实例，但允许通过API接口修改或删除。
ModificationProtectionReason	String	托管实例	设置修改保护状态的原因。说明仅在`ModificationProtectionStatus`为 ConsoleProtection时有效。
ServiceManaged	Boolean	false	CLB实例是否为托管资源。 true：托管资源。表示创建CLB以外的其他云资源时系统同步创建的CLB资源。 false：非托管资源。表示在CLB侧手动创建的CLB资源。
Status	String	Active	CLB实例状态。 Inactive：已停止。 Active：运行中。 Creating：创建中。 Provisioning：创建中。 Configuring：配置中。 Deleting：删除中。 CreateFailed：创建失败。
BusinessStatus	String	FinancialLocked	CLB实例是否被锁定。 Normal: 正常。 FinancialLocked: 被锁定。说明该参数返回为空时，表示实例未被锁定。
LockReason	String	Financial	CLB实例被冻结的原因。该参数只有实例处于 FinancialLocked 状态时有返回值。 Financial: 因欠费被锁定。说明参数`BusinessStatus`取值为“Normal”或空值时，该参数返回为空。
Listeners	Array of Struct	-	CLB实例中监听器的信息。具体请参见下表“ Listener ”。
ServerGroups	Array of Struct	-	CLB实例中后端服务器组的信息。具体请参见下表“ ServerGroup ”。
LogTopicId	String	74936ae4-bbd6-41de-a0d2-ed156203****	日志主题的ID。
AccessLog	Struct	-	CLB实例中访问日志的信息。具体请参见下表“ AccessLog ”。
Enabled	Boolean	true	CLB实例的启用状态。 true：表示启用。 false：表示禁用。说明当CLB实例处于欠费关停或到期关停状态时，该参数值为“false”，其他情况下均为“true”。
ProjectName	String	default	CLB实例所属项目的名称。
Tags	Array of Struct	-	CLB实例的标签信息。具体请参见下表“Tags”。
CreateTime	String	2021-08-11T16:37:37Z	CLB实例的创建时间。
UpdateTime	String	2021-08-11T16:37:37Z	CLB实例的最近操作时间。
OverdueTime	String	2021-08-11T16:37:37Z	CLB实例的冻结时间。说明参数`BusinessStatus`取值为“Normal”或空值时，该参数返回为空。
DeletedTime	String	2021-08-11T16:37:37Z	CLB实例的预期回收时间。该参数只有实例处于 FinancialLocked 状态时有返回值。
ExpiredTime	String	2021-08-11T23:59:59Z	CLB实例到期时间。说明仅在参数`LoadBalancerBillingType`配置为1时，返回该参数。

Eip

名称	类型	示例值	描述
ISP	String	BGP	CLB实例上的公网IP线路类型。 BGP：BGP (多线)。 ChinaMobile：中国移动静态单线。 ChinaTelecom：中国电信静态单线。 ChinaUnicom：中国联通静态单线。 SingleLine_BGP：BGP单线。 Static_BGP：静态BGP。说明除BGP（多线）外，其他线路类型均在邀测中，如需使用，请联系客户经理。
EipBillingType	Integer	2	公网IP的计费方式。 1：包年包月计费 2：按量计费-按带宽上限计费 3：按量计费-按实际流量计费
Bandwidth	Integer	10	公网IP的带宽峰值，单位为Mbps。
EipAddress	String	10.XX.XX.27	CLB实例的公网IP地址。
BandwidthPackageId	String	bwp-2zeo05qre24nhrqpy****	公网IP加入的共享带宽包的ID。
SecurityProtectionTypes	Array of String	["AntiDDoS_Enhanced"]	公网IP的安全防护类型。 AntiDDoS_Enhanced：表示公网IP为增强防护类型，该公网IP可以加入到DDoS原生防护（企业版）实例。空值：表示公网IP为基础防护类型。说明增强防护型公网IP正在邀测中，如果未开通该功能，则不会返回该参数。

Ipv6AddressBandwidth

名称	类型	示例值	描述
Bandwidth	Integer	10	IPv6公网带宽的带宽峰值，单位为Mbps。
NetworkType	String	public	CLB实例IPv6地址的网络类型。 public：表示该IPv6地址已开通公网带宽，可以转发IPv6公网流量。
BillingType	Integer	2	IPv6公网带宽的计费方式。 2：按量计费-按带宽上限计费。 3：按量计费-按实际流量计费。
ISP	String	BGP	IPv6公网带宽的线路类型。 BGP：BGP（多线）。
BandwidthPackageId	String	bwp-2zeo05qre24nhrqpy****	IPv6公网带宽加入的共享带宽包的ID。

ServerGroup

名称	类型	示例值	描述
ServerGroupId	String	rsp-1g0ogy36a8t8g8ibuxwy5****	后端服务器组的ID。
ServerGroupName	String	servergroup-1	后端服务器组的名称。

Listener

名称	类型	示例值	描述
ListenerId	String	lsn-2fea4ayvu2g3k5oxruuze****	监听器的ID。
ListenerName	String	listener-1	监听器的名称。

AccessLog

名称	类型	示例值	描述
Enabled	Boolean	true	是否开启访问日志（七层）功能。 true：已开启。 false：未开启。
BucketName	String	clb-tos	存储七层访问日志的对象存储桶的名称。

名称

类型

示例值

描述

Enabled

Boolean

true

是否开启访问日志（七层）功能。

true：已开启。
false：未开启。

BucketName

String

clb-tos

存储七层访问日志的对象存储桶的名称。

名称	类型	示例值	描述
Key	String	k1	标签的标签键。
Value	String	v1	标签的标签值。

EniAddresses

名称	类型	示例值	描述
EniAddress	String	172.XX.XX.33	CLB实例的私网IPv4地址。
EipId	String	eip-3ciyamhu46c6rrswwusg****	私网IPv4地址绑定的公网IP的ID。
EipAddress	String	10.XX.XX.27	私网IPv4地址绑定的公网IP地址。

请求示例

GET /?Action=DescribeLoadBalancerAttributes&LoadBalancerId=clb-bp1b6c719dfa08ex****&Version=2020-04-01 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-shanghai
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202108161106382514606306AF947C****",
        "Action": "DescribeLoadBalancerAttributes",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-shanghai"
    },    
    "Result": {
        "RequestId": "202108161106382514606306AF947C****",
        "AccountId": "210012****",
        "ExclusiveClusterId": "",
        "LoadBalancerId": "clb-bp1b6c719dfa08ex****",
        "LoadBalancerName": "clb-test1",
        "Description": "测试实例",
        "Type": "public",
        "AddressIpVersion": "ipv4",
        "LoadBalancerBillingType": 2,
        "LoadBalancerSpec": "small_1",
        "MasterZoneId": "cn-shanghai-a",
        "SlaveZoneId": "cn-shanghai-b",
        "VpcId": "vpc-bp1aevy8sofi8mh1****",
        "SubnetId": "subnet-bp12mw1f8k3jgy****",
        "EniID": "eni-2fe6rabqt8gxruv8u8c9f****",
        "EipAddress": "10.XX.XX.27",
        "EniAddress": "172.XX.XX.33",
        "Eip": {
            "ISP": "BGP",
            "Bandwidth": 1,
            "EipBillingType": 2,
            "EipAddress": "10.XX.XX.27",
            "BandwidthPackageId": "bwp-2zeo05qre24nhrqpy****",
            "SecurityProtectionTypes": [
                "AntiDDoS_Enhanced"
            ]
        },
        "EniIpv6Address": "2408:4005:XX:XX:200",
        "Ipv6EipId": "eip-2zaiwb7ujxscd****",
        "Ipv6AddressBandwidth": {
            "ISP": "BGP",
            "Bandwidth": 10,
            "EipBillingType": 2,
            "NetworkType": "public"
        },
        "ModificationProtectionStatus": "",
        "ModificationProtectionReason": "",
        "ServiceManaged": false,
        "Status": "Active",
        "BusinessStatus": "",
        "LockReason": "",
        "Enabled": true,
        "Listeners": [
            {
                "ListenerId": "lsn-2fea4ayvu2g3k5oxruuze****",
                "ListenerName": "listener-1"
            }
        ]，
        "ServerGroups": [
            {
                "ServerGroupId": "rsp-1g0ogy36a8t8g8ibuxwy5****",
                "ServerGroupName": "servergroup-1"
            }
        ],
        "LogTopicId": "",
        "AccessLog": {
            "Enabled": true,
            "BucketName": "clb-tos",
        },
        "ProjectName": "default",
        "Tags": [
            {
                "Key": "k1",
                "Value": "v1"
            },
            {
                "Key": "volc:clb:k1",
                "Value": ""
            }
        ],
        "CreateTime": "2021-08-11T18:01:42Z",
        "UpdateTime": "2021-08-11T18:18:13Z",
        "OverdueTime": "",
        "DeletedTime": "" 
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

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表示缺少的参数名称。
404	InvalidLoadBalancer.NotFound	The specified LoadBalancer does not exist.	指定的负载均衡不存在。