调用 DescribeLoadBalancerAttributes 接口，查看ALB 实例详情。 ## 使用说明每秒最多提交 200 个 API 请求。 ## 调试 ## 请求参数 **Action** `String` %%require%% 示例值：`DescribeLoadBalancerAttributes` 接口名称。当前 API 的名称为 `DescribeLoadBalancerAttributes`。 **Version** `String` %%require%% 示例值：`2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **LoadBalancerId** `String` %%require%% 示例值：`alb-bp1b608ex****` ALB 实例 ID。 ## 返回参数 **RequestId** `String` `可选` 示例值：`202125146063030****` 请求ID。 **LoadBalancerId** `String` `可选` 示例值：`alb-bp1o94dp5i6ea****` ALB 实例ID。 **LoadBalancerName** `String` `可选` 示例值：`alb-test1` ALB 实例的名称。 **AddressIpVersion** `String` `可选` 示例值：`DualStack` ALB 实例的 IP 类型。 * IPv4：IPv4 类型。 * DualStack：IPv4&IPv6 双栈类型。 **Status** `String` `可选` 示例值：`Active` ALB 实例状态。 * Active：运行中。 * Provisioning：创建中。 * Configuring：配置中。 * Deleting：删除中。 * CreateFailed：创建失败。 * Inactive：已停止。 **Description** `String` `可选` 示例值：`Test` ALB 实例的描述。 **CreateTime** `String` `可选` 示例值：`2021-08-11T16:37:37Z` ALB 实例的创建时间。 **UpdateTime** `String` `可选` 示例值：`2021-08-11T16:37:37Z` ALB 实例的最近操作时间。 **Type** `String` `可选` 示例值：`private` ALB 实例的类型。 * public：公网ALB。 * private：私网ALB。 **VpcId** `String` `可选` 示例值：`vpc-bp1aevy8sofi8mh1****` ALB 实例所属的VPC ID。 **SubnetId** `String` `可选` 示例值：`subnet-bp11f8k3jgy****` ALB 实例所属的子网ID。 :::tip 本参数即将下线，请使用 ZoneMappings 字段。 ::: **EipId** `String` `可选` 示例值：`eip-2fe698wsddsnj****` 公网 IP ID。 :::tip 本参数即将下线，请使用 ZoneMappings 字段。 ::: **EniAddress** `String` `可选` 示例值：`172.XX.XX.33` ALB 实例的私网 IP 地址。 :::tip 本参数即将下线，请使用 ZoneMappings 字段。 ::: **EniId** `String` `可选` 示例值：`eni-2fe6rabddqt8g****` ALB 实例占用的网卡 ID。 :::tip 本参数即将下线，请使用 ZoneMappings 字段。 ::: **EipAddress** `String` `可选` 示例值：`10.XX.XX.27` ALB 实例的公网 IP 地址。 :::tip 本参数即将下线，请使用 ZoneMappings 字段。 ::: **BusinessStatus** `String` `可选` 示例值：`FinancialLocked` ALB 实例是否被锁定。此值为空时，实例状态为正常。 * Normal: 正常。 * FinancialLocked: 被锁定。 **LockReason** `String` `可选` 示例值：`Financial` ALB 实例被冻结的原因。该参数只有实例处于 FinancialLocked 状态时有返回值。 * Financial: 因欠费被锁定。 * Security: 因安全被锁定。 **OverdueTime** `String` `可选` 示例值：`2021-08-11T16:37:37Z` ALB 实例的冻结时间。该参数只有实例处于 FinancialLocked 状态时有返回值。 **DeletedTime** `String` `可选` 示例值：`2021-08-11T16:37:37Z` ALB 实例的预期回收时间。该参数只有实例处于 FinancialLocked 状态时有返回值。 **LoadBalancerBillingType** `Integer` `可选` 示例值：`1` ALB实例计费方式。 1：LCU性能容量单元 **Eip** `Object` `可选` 示例值：`-` ALB 实例的公网IP的信息。 **ISP** `String` `可选` 示例值：`BGP` ALB 实例上的公网IP线路类型。 * BGP：BGP多线。 **EipBillingType** `Integer` `可选` 示例值：`2` 公网IP的计费方式。 * 2：按带宽上限计费。 * 3：按实际流量计费。 **Bandwidth** `Integer` `可选` 示例值：`10` 公网IP的带宽峰值，单位为Mbps。 **EipAddress** `String` `可选` 示例值：`10.XX.XX.27` 负载均衡实例的公网IP地址。 **SecurityProtectionTypes** `String[]` `可选` 示例值：`-` 公网IP 的防护类型。 * AntiDDoS_Enhanced：增强防护类型的公网IP，可加入到 DDoS 原生防护实例。 * 空值：基础防护类型的公网IP。 **EipType** `String` `可选` ALB 实例上的公网IP类型。 * 空：公网IP。 * anycast：Anycast公网IP。 **PopLocations** `Object[]` `可选` 示例值：`-` ALB 作为Anycast公网IP的源站时，关联的接入点信息。 **PopId** `String` `可选` 示例值：`cn-beijing-pop` Anycast公网IP的接入点ID。 **PopName** `String` `可选` 示例值：`beijing-pop` Anycast公网IP的接入点名称。 **AssociationMode** `String` `可选` 示例值：`Default` ALB 作为Anycast公网IP的源站类型，仅绑定Anycast公网IP时有效。 * Default：默认模式。 * Normal：普通模式。 **Listeners** `Object[]` `可选` 示例值：`-` ALB 实例中监听器的信息。 **ListenerId** `String` `可选` 示例值：`lsn-2fea4ayvu2g3k5oxruuze****` ALB 实例中监听器的ID。 **ListenerName** `String` `可选` 示例值：`listener-1` ALB 实例中监听器的名称。 **AccessLog** `Object` `可选` 示例值：`-` ALB 实例中访问日志的信息。 **BucketName** `String` `可选` 示例值：`alb-tos` 存储七层访问日志的对象存储桶的名称。 **Enabled** `Boolean` `可选` 示例值：`true` 是否开启访问日志功能。 * true：已开启。 * false：未开启。 **TLSAccessLog** `Object` `可选` 示例值：`-` ALB 实例中访问日志的信息。 **Enabled** `Boolean` `可选` 示例值：`true` 是否开启访问日志投递TLS功能。 * true：已开启。 * false：未开启。 **ProjectId** `String` `可选` 示例值：`project-xxxx` 访问日志绑定的 TLS 项目 ID。 **TopicId** `String` `可选` 示例值：`topic-xxxxx` 访问日志绑定的 TLS 主题 ID。 **HealthLog** `Object` `可选` 示例值：`-` ALB 实例中健康检查日志的信息。 **Enabled** `Boolean` `可选` 示例值：`true` 是否开启访问日志功能。 * true：已开启。 * false：未开启。 **ProjectId** `String` `可选` 示例值：`project-xxxx` 健康检查日志绑定的 TLS 项目 ID。 **TopicId** `String` `可选` 示例值：`topic-xxxxx` 健康检查日志绑定的 TLS 主题 ID。 **DNSName** `String` `可选` 示例值：`alb-qwe1344.cn-beijing.volcenginealb.com` DNS域名。 **ZoneMappings** `Object[]` `可选` 示例值：`-` ALB 实例在不同可用区下的配置信息。 **ZoneId** `String` `可选` 示例值：`cn-beijing-a` ALB 实例所处的可用区 **SubnetId** `String` `可选` 示例值：`subnet-bp12mw1f8k3jgy****` ALB 实例在该可用区的子网ID。 **LoadBalancerAddresses** `Object[]` `可选` 示例值：`-` ALB 实例在该可用区的IP地址。 **EniAddress** `String` `可选` 示例值：`172.XX.XX.33` ALB 实例在该可用区的私网IP地址。 **EniId** `String` `可选` 示例值：`eni-2fe6rabqt8g****xruv8u8c9f` ALB 实例在该可用区占用的网卡ID。 **EipAddress** `String` `可选` 示例值：`10.XX.XX.27` ALB 实例在该可用区的公网IP地址。 **EipId** `String` `可选` 示例值：`eip-2fe698wsnj****oxruvtryndp` ALB 实例在该可用区的公网IP ID。 **Eip** `Object` `可选` 示例值：`-` ALB 实例在该可用区的公网IP的信息。 **ISP** `String` `可选` 示例值：`BGP` ALB 实例上的公网IP线路类型。 * BGP：BGP多线。 **EipBillingType** `Integer` `可选` 示例值：`2` 公网IP的计费方式。 * 2：按带宽上限计费。 * 3：按实际流量计费。 **Bandwidth** `Integer` `可选` 示例值：`10` 公网IP的带宽峰值，单位为Mbps。 **EipAddress** `String` `可选` 示例值：`10.XX.XX.27` 负载均衡实例的公网IP地址。 **SecurityProtectionTypes** `String[]` `可选` 示例值：`-` 公网IP 的防护类型。 * AntiDDoS_Enhanced：增强防护类型的公网IP，可加入到 DDoS 原生防护实例。 * 空值：基础防护类型的公网IP。 **EipType** `String` `可选` ALB 实例上的公网IP类型。 * 空：公网IP。 * anycast：Anycast公网IP。 **PopLocations** `Object[]` `可选` 示例值：`-` ALB 作为Anycast公网IP的源站时，关联的接入点信息。仅绑定Anycast公网IP时有效。 **PopId** `String` `可选` 示例值：`cn-beijing-pop` Anycast公网IP的接入点ID。 **PopName** `String` `可选` 示例值：`beijing-pop` Anycast公网IP的接入点名称。 **AssociationMode** `String` `可选` 示例值：`Default` ALB 作为Anycast公网IP的源站类型，仅绑定Anycast公网IP时有效。 * Default：默认模式。 * Normal：普通模式。 **EniIpv6Address** `String` `可选` 示例值：`2408:4005:XX:XX:200` IPv4&IPv6 双栈类型的 ALB 实例，在该可用区的 IPv6 地址。 **Ipv6EipId** `String` `可选` 示例值：`eip-2fe698wsnj****oxruvtryndp` IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽 ID。 **Ipv6Eip** `Object` `可选` 示例值：`-` IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽的信息。 **Bandwidth** `Integer` `可选` 示例值：`200` 公网ALB 实例的IPv6公网带宽的带宽上限，单位为Mbps。 **BillingType** `Integer` `可选` 示例值：`2` 公网ALB 实例的 IPv6 公网带宽的计费类型。 * 2：按量计费\-按带宽上限计费。 * 3：按量计费\-按实际流量计费。 **ISP** `String` `可选` 示例值：`BGP` 公网ALB 实例的 IPv6 公网带宽的线路类型。 * BGP：BGP多线。 **DeleteProtection** `String` `可选` 示例值：`off` ALB 实例的删除保护功能为开启或关闭状态。 * off：关闭。 * on：开启。 **LocalAddresses** `String[]` `可选` 示例值：`["100.64.1.0/20", "xxx"]` ALB 实例的回源地址。 **ProjectName** `String` `可选` 示例值：`default` 实例所属项目名称。 **Tags** `Object[]` `可选` 示例值：`-` 实例所属标签，具体参见下表 [Tags](#Tags)。 **Key** `String` `可选` 示例值：`key` 用户标签的标签键。 **Value** `String` `可选` 示例值：`value` 用户标签的标签值。 **SniAutoMatch** `String` `可选` 示例值：`off` 实例是否支持自动选择扩展证书。 * off：不支持。 * on：支持。 **WafProtectionEnabled** `String` `可选` 示例值：`off` WAF 安全防护开关。 * off：关闭。 * on：开启。 **WafInstanceId** `String` `可选` 示例值：`waf-14ca6f67c33c0****` ALB 实例绑定的 WAF 安全防护实例的 ID 。 **GlobalAccelerators** `Object[]` `可选` 示例值：`-` ALB 实例绑定的全球加速器。 **AcceleratorId** `String` `可选` 示例值：`accinstance-VYjG****` 全球加速 ID。 **AcceleratorName** `String` `可选` 示例值：`global-test` 全球加速器名称。 **ModificationProtectionStatus** `String` `可选` 示例值：`NonProtection` 是否启用了实例修改保护功能。 * NonProtection：未启用。 * ConsoleProtection：已启用。 **ModificationProtectionReason** `String` `可选` 示例值：`This is modification protection` 启用实例修改保护的原因。 **LoadBalancerEdition** `String` `可选` 示例值：`Standard` ALB 实例的版本： * Basic：基础版。 * Standard：标准版。 **Enabled** `Boolean` `可选` 示例值：`true` 实例的启用状态。 * true：表示启用。 * false：表示禁用。只有当实例处于欠费关停或到期关停时，实例启用状态为false。 ## 请求示例 ```JSON GET /?Action=DescribeLoadBalancerAttributes&LoadBalancerId=alb-1g1f1c6ae****A7&Version=2020-04-01 HTTP/1.1 Host: alb.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "DescribeLoadBalancerAttributes", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811183410010****4214202005AE9", "LoadBalancerId": "alb-1g1f1c6aevm****buxws5k0k3", "LoadBalancerName": "test", "Status": "Active", "Description": "test", "CreateTime": "2021-08-11T18:01:42Z", "UpdateTime": "2021-08-11T18:18:13Z", "Type": "public", "VpcId": "vpc-3tj9fo0uqy3****28rma", "SubnetId": "subnet-3tj9f****m3vj0x28rn5", "EipID": "eip-2fe698wsnj8c****ruvtryndp", "EipAddress": "10.XX.XX.17", "EniID": "eni-2fe6sjrih****5oxruw1c3d8b", "EniAddress": "172.XX.XX.172", "BusinessStatus": "", "LockReason": "", "OverdueTime": "", "DeletedTime": "", "LoadBalancerBillingType": 1, "AccessLog": { "Enabled": "true", "BucketName": "alb-tos", }, "Eip": { "ISP": "BGP", "Bandwidth": 1, "EipBillingType": 0, "EipAddress": "10.XX.XX.17" }, "Listeners": [ { "ListenerId": "lsn-2ff0ixt8****g5oxruw4bbqjt", "ListenerName": "test" } ], "DNSName": "alb-t5aepy8j****7mrjdjavoc2c.cn-beijing.volcalb.com", "ZoneMappings": [ { "ZoneId": "cn-beijing-a", "SubnetId": "subnet-274tv****duyo7fap8sc658ze", "LoadBalancerAddresses": [ { "EniAddress": "192.168.0.25", "EniId": "eni-274js3****xhc7fap8ssed7qg", "EipAddress": "", "EipId": "", "Eip": { "ISP": "BGP", "Bandwidth": 1, "EipBillingType": 0, "EipAddress": "10.XX.XX.17"， "SecurityProtectionTypes": ["AntiDDoS_Enhanced"] }, } ] }, { "ZoneId": "cn-beijing-b", "SubnetId": "subnet-274u****nb8xs7fap8t1odh1n", "LoadBalancerAddresses": [ { "EniAddress": "192.168.1.254", "EniId": "eni-274j****c6zgg7fap8t05movj", "EipAddress": "", "EipId": "", "Eip": { "ISP": "BGP", "Bandwidth": 1, "EipBillingType": 0, "EipAddress": "10.XX.XX.17"， "SecurityProtectionTypes": ["AntiDDoS_Enhanced"] }, } ] } ] } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |404 |InvalidLoadBalancer.NotFound |The specified LoadBalancer does not exist. |指定的 ALB 实例不存在。 |