Queries detailed information about a specified Classic Load Balancer (CLB) instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeLoadBalancerAttribute

The operation that you want to perform.

Set the value to DescribeLoadBalancerAttribute.

LoadBalancerId String Yes lb-bp1b6c719dfa08ex*****

The ID of the CLB instance.

RegionId String Yes cn-hangzhou

The region where the CLB instance is created.

You can retrieve the region ID from the Regions and zones list or by calling the DescribeRegions operation.

Response parameters

Parameter Type Example Description
LoadBalancerId String lb-bp1o94dp5i6ea*******

The ID of the CLB instance.

RegionId String cn-hangzhou

The ID of the region where the CLB instance is created.

RegionIdAlias String hangzhou

The alias of the region where the CLB instance is created.

LoadBalancerName String lb-instance-test

The name of the CLB instance.

LoadBalancerStatus String active

The state of the CLB instance. Valid values:

  • inactive: The CLB instance is stopped. CLB instances in the inactive state do not forward traffic.
  • active: The CLB instance runs as expected. Newly created CLB instances are in the active state by default.
  • locked: The CLB instance is locked. CLB instances may be locked by Alibaba Cloud due to overdue payments or other reasons.
Address String 42.250.6.**

The IP address that the CLB instance uses to provide services.

AddressType String internet

The type of IP address that the CLB instance uses to provide services.

NetworkType String vpc

The type of network where the CLB instance is deployed.

VpcId String vpc-25dvzy9f8*****

The ID of the virtual private cloud (VPC) where the internal-facing CLB instance is deployed.

Bandwidth Integer 5

The maximum bandwidth of the Internet-facing CLB instance that is billed on a pay-by-bandwidth basis.

CreateTime String 2017-08-31T02:49:05Z

The time when the CLB instance was created.

ListenerPorts List 80

The frontend port that is used by the CLB instance.

ListenerPortsAndProtocol Array of ListenerPortAndProtocol

The frontend ports and protocols that are used by the CLB instance.

ListenerPortAndProtocol
ListenerPort Integer 80

The frontend port that is used by the CLB instance.

ListenerProtocol String https

The frontend protocol that is used by the CLB instance.

Description String The description of the listener.

The description of the port and protocol that are used by the listener.

ForwardPort Integer 443

The port that the listener uses to distribute requests. The port must be open and use the HTTPS protocol.

ListenerForward String on

Indicates whether the listener is enabled to distribute requests.

BackendServers Array of BackendServer

The list of backend servers that are added to the CLB instance.

BackendServer
ServerId String i-djghr2****

The ID of the backend server.

Weight Integer 90

The weight of the backend server.

Description String BackendServertoReceiveRequests

The description of the backend server.

Type String ecs

The type of the backend server.

MasterZoneId String cn-hangzhou-b

The ID of the primary zone to which the CLB instance belongs.

AddressIPVersion String ipv4

The IP version. Valid values: ipv4 and ipv6.

AutoReleaseTime Long 1513947075000

The timestamp generated when the CLB instance was released.

CreateTimeStamp Long 1504147745000

The timestamp generated when the CLB instance was created.

DeleteProtection String off

Indicates whether deletion protection is enabled for the CLB instance.

Valid values: on and off.

EndTime String 2999-09-08T16:00:00Z

The time when the CLB instance was stopped.

EndTimeStamp Long 32493801600000

The timestamp generated when the CLB instance was suspended.

InternetChargeType String paybybandwidth

The billing method of the Internet-facing CLB instance.

Valid values:

  • paybybandwidth: pay-by-bandwidth
  • paybytraffic (default): pay-by-data-transfer
ListenerPortsAndProtocal Array of ListenerPortAndProtocal

The ports or protocols of the listeners.

ListenerPortAndProtocal
ListenerPort Integer 80

The frontend port that is used by the CLB instance.

ListenerProtocal String http

The frontend protocol that is used by the CLB instance.

LoadBalancerSpec String slb.s1.small

The specification of the CLB instance.

ModificationProtectionReason String ManageInstance

The reason why the xxx mode is enabled or disabled. The value is 1 to 80 characters in length. It must start with a letter and can contain digits, periods (.), underscores (_), and hyphens (-).

Note This parameter is effective only when ModificationProtectionStatus is set to ConsoleProtection.
ModificationProtectionStatus String ConsoleProtection

Indicates whether the configuration read-only mode is enabled for the CLB instance. Valid values:

  • NonProtection: indicates that the configuration read-only mode is disabled. After you disable the configuration read-only mode, the value of ModificationProtectionReason is cleared.
  • ConsoleProtection: indicates that the configuration read-only mode is enabled.
PayType String PrePay

The billing method of the CLB instance. Valid values: PayOnDemand and PrePay.

RenewalCycUnit String Month

Auto-renewal cycle. Valid values: Year and Month. Default value: Month.

This parameter is effective only when RenewalStatus is set to AutoRenewal.

RenewalDuration Integer 1

Auto-renewal duration. This parameter is effective only when RenewalStatus is set to AutoRenewal.

  • PeriodUnit is set to Year: Valid values: 1, 2, and 3.
  • PeriodUnit is set toMonth: Valid values: 1, 2, 3, and 6.
RenewalStatus String AutoRenewal

The renewal method. Valid values:

  • AutoRenewal: The system automatically renews the CLB instance.
  • Normal: You must manually renew the CLB instance.
  • NotRenewal: The CLB instance will not be renewed upon expiration. If this option is selected, the system does not send notifications until three days before the expiration date.
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

The ID of the request.

ResourceGroupId String rg-atstuj3rtop*****

The ID of the resource group.

SlaveZoneId String cn-hangzhou-d

The ID of the secondary zone to which the CLB instance belongs.

VSwitchId String vsw-255ecrwq5*****

The ID of the vSwitch to which the internal-facing CLB instance belongs.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeLoadBalancerAttribute
&LoadBalancerId=lb-bp1b6c719dfa08ex*****
&<Common request parameters>

Sample success responses

XML format

<DescribeLoadBalancerAttributeResponse>
  <RenewalDuration>1</RenewalDuration>
  <EndTime>2999-09-08T16:00:00Z</EndTime>
  <Address>42.250.6. **</Address>
  <ResourceGroupId>rg-atstuj3rtop*****</ResourceGroupId>
  <ListenerPortsAndProtocal>
        <ListenerPortAndProtocal>
              <ListenerPort>443</ListenerPort>
              <ListenerProtocal>http</ListenerProtocal>
        </ListenerPortAndProtocal>
  </ListenerPortsAndProtocal>
  <AddressIPVersion>ipv4</AddressIPVersion>
  <LoadBalancerId>lb-bp1o94dp5i6ea*******</LoadBalancerId>
  <ListenerPortsAndProtocol>
        <ListenerPortAndProtocol>
              <ListenerForward>yes</ListenerForward>
              <ListenerPort>443</ListenerPort>
              <Description>ListenerDescription. </Description>
              <ForwardPort>80</ForwardPort>
              <ListenerProtocol>https</ListenerProtocol>
        </ListenerPortAndProtocol>
  </ListenerPortsAndProtocol>
  <BackendServers>
        <BackendServer>
              <Type>ecs</Type>
              <Description>BackendServerDescription</Description>
              <ServerId>i-djghr2****</ServerId>
              <Weight>90</Weight>
        </BackendServer>
  </BackendServers>
  <ModificationProtectionStatus>ConsoleProtection</ModificationProtectionStatus>
  <LoadBalancerSpec>slb.s2.small</LoadBalancerSpec>
  <NetworkType>vpc</NetworkType>
  <Bandwidth>5</Bandwidth>
  <ModificationProtectionReason>ManagedInstance</ModificationProtectionReason>
  <MasterZoneId>cn-hangzhou-b</MasterZoneId>
  <ListenerPorts>
        <ListenerPort>80</ListenerPort>
  </ListenerPorts>
  <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
  <CreateTime>2017-08-31T02:49:05Z</CreateTime>
  <VSwitchId>vsw-255ecrwq5*****</VSwitchId>
  <RenewalStatus>AutoRenewal</RenewalStatus>
  <RenewalCycUnit>Month</RenewalCycUnit>
  <PayType>PrePay</PayType>
  <SlaveZoneId>cn-hangzhou-d</SlaveZoneId>
  <InternetChargeType>paybybandwidth</InternetChargeType>
  <RegionIdAlias>hangzhou</RegionIdAlias>
  <LoadBalancerName>lb-instance-test</LoadBalancerName>
  <DeleteProtection>off</DeleteProtection>
  <VpcId>vpc-25dvzy9f8*****</VpcId>
  <EndTimeStamp>32493801600000</EndTimeStamp>
  <RegionId>cn-hangzhou</RegionId>
  <AddressType>internet</AddressType>
  <LoadBalancerStatus>active</LoadBalancerStatus>
  <CreateTimeStamp>1504147745000</CreateTimeStamp>
  <AutoReleaseTime>1513947075</AutoReleaseTime>
</DescribeLoadBalancerAttributeResponse>

JSON format

{"RenewalDuration":"1",
"EndTime":"2999-09-08T16:00:00Z",
"Address":"42.250.6. **",
"ResourceGroupId":"rg-atstuj3rtop*****",
"ListenerPortsAndProtocal":
{
    "ListenerPortAndProtocal":
    [
        {
            "ListenerPort":"443",
            "ListenerProtocal":"http"
            }
            ]
            },
            
            "AddressIPVersion":"ipv4",
            "LoadBalancerId":"lb-bp1o94dp5i6ea*******",
            "ListenerPortsAndProtocol":
            {
                "ListenerPortAndProtocol":
            [
                {
                    "ListenerForward":"yes",
                    "ListenerPort":"443",
                    "Description": "ListenerDescription",
                    "ForwardPort":"80",
                    "ListenerProtocol":"https"
                    }
                    ]
                    },
                    "BackendServers":
                    {
                        "BackendServer":
                        [
                            {
                                "Type":"ecs",
                                "Description":"BackendServerDescription",
                                "ServerId":"i-djghr2****",
                                "Weight":"90"
                                }
                                ]
                                },
                                "ModificationProtectionStatus":"ConsoleProtection",
                                "LoadBalancerSpec":"slb.s2.small",
                                "NetworkType":"vpc",
                                "Bandwidth":"5",
                                "ModificationProtectionReason":"ManagedInstance",
                                "MasterZoneId":"cn-hangzhou-b",
                                "ListenerPorts":
                                {
                                    "ListenerPort":"80"
                                    },
                                    "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
                                    "CreateTime":"2017-08-31T02:49:05Z",
                                    "VSwitchId":"vsw-255ecrwq5*****",
                                    "RenewalStatus":"AutoRenewal",
                                    "RenewalCycUnit":"Month",
                                    "PayType":"PrePay",
                                    "SlaveZoneId":"cn-hangzhou-d",
                                    "InternetChargeType":"paybybandwidth",
                                    "RegionIdAlias":"hangzhou",
                                    "LoadBalancerName":"lb-instance-test",
                                    "DeleteProtection":"off",
                                    "VpcId":"vpc-25dvzy9f8*****",
                                    "EndTimeStamp":"32493801600000",
                                    "RegionId":"cn-hangzhou",
                                    "AddressType":"internet",
                                    "LoadBalancerStatus":"active",
                                    "CreateTimeStamp":"1504147745000",
                                    "AutoReleaseTime":"1513947075"}

Error codes

For a list of error codes, visit the API Error Center.