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;