aws_sdk_ec2/client/
create_capacity_reservation_by_splitting.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`CreateCapacityReservationBySplitting`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`dry_run(bool)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::dry_run) / [`set_dry_run(Option<bool>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::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. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p><br>
7    ///   - [`client_token(impl Into<String>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::set_client_token):<br>required: **false**<br><p>Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensure Idempotency</a>.</p><br>
8    ///   - [`source_capacity_reservation_id(impl Into<String>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::source_capacity_reservation_id) / [`set_source_capacity_reservation_id(Option<String>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::set_source_capacity_reservation_id):<br>required: **true**<br><p>The ID of the Capacity Reservation from which you want to split the capacity.</p><br>
9    ///   - [`instance_count(i32)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::instance_count) / [`set_instance_count(Option<i32>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::set_instance_count):<br>required: **true**<br><p>The number of instances to split from the source Capacity Reservation.</p><br>
10    ///   - [`tag_specifications(TagSpecification)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::tag_specifications) / [`set_tag_specifications(Option<Vec::<TagSpecification>>)`](crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::set_tag_specifications):<br>required: **false**<br><p>The tags to apply to the new Capacity Reservation.</p><br>
11    /// - On success, responds with [`CreateCapacityReservationBySplittingOutput`](crate::operation::create_capacity_reservation_by_splitting::CreateCapacityReservationBySplittingOutput) with field(s):
12    ///   - [`source_capacity_reservation(Option<CapacityReservation>)`](crate::operation::create_capacity_reservation_by_splitting::CreateCapacityReservationBySplittingOutput::source_capacity_reservation): <p>Information about the source Capacity Reservation.</p>
13    ///   - [`destination_capacity_reservation(Option<CapacityReservation>)`](crate::operation::create_capacity_reservation_by_splitting::CreateCapacityReservationBySplittingOutput::destination_capacity_reservation): <p>Information about the destination Capacity Reservation.</p>
14    ///   - [`instance_count(Option<i32>)`](crate::operation::create_capacity_reservation_by_splitting::CreateCapacityReservationBySplittingOutput::instance_count): <p>The number of instances in the new Capacity Reservation. The number of instances in the source Capacity Reservation was reduced by this amount.</p>
15    /// - On failure, responds with [`SdkError<CreateCapacityReservationBySplittingError>`](crate::operation::create_capacity_reservation_by_splitting::CreateCapacityReservationBySplittingError)
16    pub fn create_capacity_reservation_by_splitting(
17        &self,
18    ) -> crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder {
19        crate::operation::create_capacity_reservation_by_splitting::builders::CreateCapacityReservationBySplittingFluentBuilder::new(
20            self.handle.clone(),
21        )
22    }
23}