aws_sdk_ec2/client/

modify_hosts.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`ModifyHosts`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`host_recovery(HostRecovery)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::host_recovery) / [`set_host_recovery(Option<HostRecovery>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_host_recovery):<br>required: **false**<br><p>Indicates whether to enable or disable host recovery for the Dedicated Host. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-recovery.html">Host recovery</a> in the <i>Amazon EC2 User Guide</i>.</p><br>
    ///   - [`instance_type(impl Into<String>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::instance_type) / [`set_instance_type(Option<String>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_instance_type):<br>required: **false**<br><p>Specifies the instance type to be supported by the Dedicated Host. Specify this parameter to modify a Dedicated Host to support only a specific instance type.</p> <p>If you want to modify a Dedicated Host to support multiple instance types in its current instance family, omit this parameter and specify <b>InstanceFamily</b> instead. You cannot specify <b>InstanceType</b> and <b>InstanceFamily</b> in the same request.</p><br>
    ///   - [`instance_family(impl Into<String>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::instance_family) / [`set_instance_family(Option<String>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_instance_family):<br>required: **false**<br><p>Specifies the instance family to be supported by the Dedicated Host. Specify this parameter to modify a Dedicated Host to support multiple instance types within its current instance family.</p> <p>If you want to modify a Dedicated Host to support a specific instance type only, omit this parameter and specify <b>InstanceType</b> instead. You cannot specify <b>InstanceFamily</b> and <b>InstanceType</b> in the same request.</p><br>
    ///   - [`host_maintenance(HostMaintenance)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::host_maintenance) / [`set_host_maintenance(Option<HostMaintenance>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_host_maintenance):<br>required: **false**<br><p>Indicates whether to enable or disable host maintenance for the Dedicated Host. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-maintenance.html">Host maintenance</a> in the <i>Amazon EC2 User Guide</i>.</p><br>
    ///   - [`host_ids(impl Into<String>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::host_ids) / [`set_host_ids(Option<Vec::<String>>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_host_ids):<br>required: **true**<br><p>The IDs of the Dedicated Hosts to modify.</p><br>
    ///   - [`auto_placement(AutoPlacement)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::auto_placement) / [`set_auto_placement(Option<AutoPlacement>)`](crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::set_auto_placement):<br>required: **false**<br><p>Specify whether to enable or disable auto-placement.</p><br>
    /// - On success, responds with [`ModifyHostsOutput`](crate::operation::modify_hosts::ModifyHostsOutput) with field(s):
    ///   - [`successful(Option<Vec::<String>>)`](crate::operation::modify_hosts::ModifyHostsOutput::successful): <p>The IDs of the Dedicated Hosts that were successfully modified.</p>
    ///   - [`unsuccessful(Option<Vec::<UnsuccessfulItem>>)`](crate::operation::modify_hosts::ModifyHostsOutput::unsuccessful): <p>The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.</p>
    /// - On failure, responds with [`SdkError<ModifyHostsError>`](crate::operation::modify_hosts::ModifyHostsError)
    pub fn modify_hosts(&self) -> crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder {
        crate::operation::modify_hosts::builders::ModifyHostsFluentBuilder::new(self.handle.clone())
    }
}