DescribeCapacityReservation - Server Load Balancer - Alibaba Cloud Documentation Center

Queries the details of a Load Balancer Capacity Unit (LCU) reservation.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
LoadBalancerId	string	Yes	The ID of the Application Load Balancer (ALB) instance.	alb-o9ulmq5hgn68jk****

Response elements

Element	Type	Description	Example
	object	The response elements.
RequestId	string	The request ID.	365F4154-92F6-4AE4-92F8-7FF3******
CapacityReservationState	array<object>	The LCU reservation state.
	object
AvailabilityZone	string	The zone.	cn-hangzhou-k
EffectiveCapacityUnits	number	The number of effective reserved LCUs per hour.	50.0
Status	string	The status of the LCU reservation. Valid values: Rebalancing : The LCU reservation is being rebalanced across zones. Failed : The LCU reservation failed. Pending : The LCU reservation is in progress. Provisioned : The LCU reservation is complete.	Provisioned
Reason	string	The cause for the failure. This parameter is returned when the reservation status is Failed.	INSUFFICIENT_CAPACITY
DecreaseRequestsRemaining	integer	The number of remaining attempts to decrease or cancel the LCU reservation.	2
LastModifiedTime	string	The time when the LCU reservation was last modified. The time is in the yyyy-MM-dd HH:mm:ss format.	2025-08-22 05:06:58
MinimumLoadBalancerCapacity	object	The minimum LCUs to reserve for an ALB instance.
CapacityUnits	integer	The number of LCUs.	100

Examples

Success response

JSON format

{
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF3******",
  "CapacityReservationState": [
    {
      "AvailabilityZone": "cn-hangzhou-k",
      "EffectiveCapacityUnits": 50,
      "Status": "Provisioned",
      "Reason": "INSUFFICIENT_CAPACITY"
    }
  ],
  "DecreaseRequestsRemaining": 2,
  "LastModifiedTime": "2025-08-22 05:06:58",
  "MinimumLoadBalancerCapacity": {
    "CapacityUnits": 100
  }
}

Error codes

HTTP status code	Error code	Error message	Description
404	ResourceNotFound.LoadBalancer	The specified resource of %s is not found.	The specified resource of %s is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.