aws_sdk_ec2/client/

create_interruptible_capacity_reservation_allocation.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateInterruptibleCapacityReservationAllocation`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`capacity_reservation_id(impl Into<String>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::capacity_reservation_id) / [`set_capacity_reservation_id(Option<String>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::set_capacity_reservation_id):<br>required: **true**<br><p>The ID of the source Capacity Reservation from which to create the interruptible Capacity Reservation. Your Capacity Reservation must be in active state with no end date set and have available capacity for allocation.</p><br>
    ///   - [`instance_count(i32)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::instance_count) / [`set_instance_count(Option<i32>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::set_instance_count):<br>required: **true**<br><p>The number of instances to allocate from your source reservation. You can only allocate available instances (also called unused capacity).</p><br>
    ///   - [`client_token(impl Into<String>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::set_client_token):<br>required: **false**<br><p>Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p><br>
    ///   - [`dry_run(bool)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::dry_run) / [`set_dry_run(Option<bool>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::set_dry_run):<br>required: **false**<br><p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response.</p><br>
    ///   - [`tag_specifications(TagSpecification)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::tag_specifications) / [`set_tag_specifications(Option<Vec::<TagSpecification>>)`](crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::set_tag_specifications):<br>required: **false**<br><p>The tags to apply to the interruptible Capacity Reservation during creation.</p><br>
    /// - On success, responds with [`CreateInterruptibleCapacityReservationAllocationOutput`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationOutput) with field(s):
    ///   - [`source_capacity_reservation_id(Option<String>)`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationOutput::source_capacity_reservation_id): <p>The ID of the source Capacity Reservation from which the interruptible Capacity Reservation was created.</p>
    ///   - [`target_instance_count(Option<i32>)`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationOutput::target_instance_count): <p>The number of instances allocated to the interruptible reservation.</p>
    ///   - [`status(Option<InterruptibleCapacityReservationAllocationStatus>)`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationOutput::status): <p>The current status of the allocation request (creating, active, updating).</p>
    ///   - [`interruption_type(Option<InterruptionType>)`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationOutput::interruption_type): <p>The type of interruption applied to the interruptible reservation.</p>
    /// - On failure, responds with [`SdkError<CreateInterruptibleCapacityReservationAllocationError>`](crate::operation::create_interruptible_capacity_reservation_allocation::CreateInterruptibleCapacityReservationAllocationError)
    pub fn create_interruptible_capacity_reservation_allocation(
        &self,
    ) -> crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder
    {
        crate::operation::create_interruptible_capacity_reservation_allocation::builders::CreateInterruptibleCapacityReservationAllocationFluentBuilder::new(self.handle.clone())
    }
}