AvailableCapacityPerAvailabilityZone - Amazon Relational Database Service
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

AvailableCapacityPerAvailabilityZone

Contains the unused capacity of a DB capacity reservation in one Availability Zone.

This data type is used as a response element in the following operations:

  • CancelDBCapacityReservation

  • CreateDBCapacityReservation

  • DescribeDBCapacityReservations

  • ModifyDBCapacityReservation

Contents

Note

In the following list, the required parameters are described first.

AvailabilityZone

The name of the Availability Zone.

Type: String

Required: No

AvailableCapacity

The number of DB instances that remain available in this Availability Zone. Amazon RDS decreases this value when a DB instance takes a unit of reserved capacity in this Availability Zone, and it increases this value when a DB instance releases that unit.

A DB instance with a pending modification also holds a unit of reserved capacity. A DB instance has a pending modification when Amazon RDS accepts a change to the DB instance and applies that change later, during the maintenance window. Amazon RDS holds the unit from the time that it accepts the request. To find a DB instance with a pending modification, check PendingModifiedValues in the response of DescribeDBInstances.

Amazon RDS reports available capacity only for a reservation that is in the active state and not past its end date. Otherwise, this value is 0.

Type: Integer

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: