Skip to main content

capacity_reservations

Creates, updates, deletes, gets or lists a capacity_reservations resource.

Overview​

Namecapacity_reservations
TypeResource
Idaws.elbv2.capacity_reservations

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
availability_zonestringInformation about the Availability Zone.
effective_capacity_unitsnumberThe number of effective capacity units.
statestringThe state of the capacity reservation.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_capacity_reservationselectLoadBalancerArn, regionDescribes the capacity reservation status for the specified load balancer.
modify_capacity_reservationupdateLoadBalancerArn, regionMinimumLoadBalancerCapacity, ResetCapacityReservationModifies the capacity reservation of the specified load balancer. When modifying capacity reservation, you must include at least one MinimumLoadBalancerCapacity or ResetCapacityReservation.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
LoadBalancerArnstringThe Amazon Resource Name (ARN) of the load balancer.
regionstringAWS region (default: us-east-1)
MinimumLoadBalancerCapacityobjectThe minimum load balancer capacity reserved.
ResetCapacityReservationbooleanResets the capacity reservation.

SELECT examples​

Describes the capacity reservation status for the specified load balancer.

SELECT
availability_zone,
effective_capacity_units,
state
FROM aws.elbv2.capacity_reservations
WHERE LoadBalancerArn = '{{ LoadBalancerArn }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples​

Modifies the capacity reservation of the specified load balancer. When modifying capacity reservation, you must include at least one MinimumLoadBalancerCapacity or ResetCapacityReservation.

UPDATE aws.elbv2.capacity_reservations
SET
-- No updatable properties
WHERE
LoadBalancerArn = '{{ LoadBalancerArn }}' --required
AND region = '{{ region }}' --required
AND MinimumLoadBalancerCapacity = '{{ MinimumLoadBalancerCapacity}}'
AND ResetCapacityReservation = {{ ResetCapacityReservation}}
RETURNING
line_items;