modify_capacity_reservation ¶

modify_capacity_reservation(
    *,
    config_overrides: Optional[ElasticLoadBalancingv2ClientConfig] = None,
    load_balancer_arn: Optional[LoadBalancerArn] = None,
    minimum_load_balancer_capacity: Optional[MinimumLoadBalancerCapacity] = None,
    reset_capacity_reservation: Optional[ResetCapacityReservation] = None,
) -> ModifyCapacityReservationOutput

Modifies the capacity reservation of the specified load balancer.

When modifying capacity reservation, you must include at least one MinimumLoadBalancerCapacity or ResetCapacityReservation.

Parameters:

load_balancer_arn (Optional[LoadBalancerArn], default: None ) –

The Amazon Resource Name (ARN) of the load balancer.
minimum_load_balancer_capacity (Optional[MinimumLoadBalancerCapacity], default: None ) –

The minimum load balancer capacity reserved.
reset_capacity_reservation (Optional[ResetCapacityReservation], default: None ) –

Resets the capacity reservation.

Raises:

CapacityDecreaseRequestsLimitExceededException –

You've exceeded the daily capacity decrease limit for this reservation.
CapacityReservationPendingException –

There is a pending capacity reservation.
CapacityUnitsLimitExceededException –

You've exceeded the capacity units limit.
InsufficientCapacityException –

There is insufficient capacity to reserve.
InvalidConfigurationRequestException –

The requested configuration is not valid.
LoadBalancerNotFoundException –

The specified load balancer does not exist.
OperationNotPermittedException –

This operation is not allowed.
PriorRequestNotCompleteException –

This operation is not allowed while a prior request has not been completed.
UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_elastic_load_balancing_v2/_services/elastic_load_balancingv2.py

def modify_capacity_reservation(
    self,
    *,
    config_overrides: Optional[ElasticLoadBalancingv2ClientConfig] = None,
    load_balancer_arn: Optional[
        "capo_elastic_load_balancing_v2.types.load_balancer_arn.LoadBalancerArn"
    ] = None,
    minimum_load_balancer_capacity: Optional[
        "capo_elastic_load_balancing_v2.types.minimum_load_balancer_capacity.MinimumLoadBalancerCapacity"
    ] = None,
    reset_capacity_reservation: Optional[
        "capo_elastic_load_balancing_v2.types.reset_capacity_reservation.ResetCapacityReservation"
    ] = None,
) -> "capo_elastic_load_balancing_v2.types.modify_capacity_reservation_output.ModifyCapacityReservationOutput":
    """<p>Modifies the capacity reservation of the specified load balancer.</p> <p>When modifying capacity reservation, you must include at least one <code>MinimumLoadBalancerCapacity</code> or <code>ResetCapacityReservation</code>.</p>

    Args:
        load_balancer_arn: <p>The Amazon Resource Name (ARN) of the load balancer.</p>
        minimum_load_balancer_capacity: <p>The minimum load balancer capacity reserved.</p>
        reset_capacity_reservation: <p>Resets the capacity reservation.</p>

    Raises:
        capo_elastic_load_balancing_v2.errors.capacity_decrease_requests_limit_exceeded_exception.CapacityDecreaseRequestsLimitExceededException: <p>You've exceeded the daily capacity decrease limit for this reservation.</p>
        capo_elastic_load_balancing_v2.errors.capacity_reservation_pending_exception.CapacityReservationPendingException: <p>There is a pending capacity reservation.</p>
        capo_elastic_load_balancing_v2.errors.capacity_units_limit_exceeded_exception.CapacityUnitsLimitExceededException: <p>You've exceeded the capacity units limit.</p>
        capo_elastic_load_balancing_v2.errors.insufficient_capacity_exception.InsufficientCapacityException: <p>There is insufficient capacity to reserve.</p>
        capo_elastic_load_balancing_v2.errors.invalid_configuration_request_exception.InvalidConfigurationRequestException: <p>The requested configuration is not valid.</p>
        capo_elastic_load_balancing_v2.errors.load_balancer_not_found_exception.LoadBalancerNotFoundException: <p>The specified load balancer does not exist.</p>
        capo_elastic_load_balancing_v2.errors.operation_not_permitted_exception.OperationNotPermittedException: <p>This operation is not allowed.</p>
        capo_elastic_load_balancing_v2.errors.prior_request_not_complete_exception.PriorRequestNotCompleteException: <p>This operation is not allowed while a prior request has not been completed.</p>
        capo_elastic_load_balancing_v2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_elastic_load_balancing_v2.types.modify_capacity_reservation_input.ModifyCapacityReservationInput]",
    ) -> OperationResponse[
        "capo_elastic_load_balancing_v2.types.modify_capacity_reservation_output.ModifyCapacityReservationOutput"
    ]:
        import capo_elastic_load_balancing_v2._operations.elastic_load_balancing_v10.modify_capacity_reservation

        output, http_response = (
            capo_elastic_load_balancing_v2._operations.elastic_load_balancing_v10.modify_capacity_reservation.modify_capacity_reservation(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ModifyCapacityReservation")
    )
    input_: capo_elastic_load_balancing_v2.types.modify_capacity_reservation_input.ModifyCapacityReservationInput = {}
    if load_balancer_arn is not None:
        input_["load_balancer_arn"] = load_balancer_arn
    if minimum_load_balancer_capacity is not None:
        input_["minimum_load_balancer_capacity"] = minimum_load_balancer_capacity
    if reset_capacity_reservation is not None:
        input_["reset_capacity_reservation"] = reset_capacity_reservation

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output