aws-sdk-fsx 1.111.0

AWS SDK for Amazon FSx
Documentation
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::update_file_system::_update_file_system_input::UpdateFileSystemInputBuilder;

pub use crate::operation::update_file_system::_update_file_system_output::UpdateFileSystemOutputBuilder;

impl crate::operation::update_file_system::builders::UpdateFileSystemInputBuilder {
    /// Sends a request with this input using the given client.
    pub async fn send_with(
        self,
        client: &crate::Client,
    ) -> ::std::result::Result<
        crate::operation::update_file_system::UpdateFileSystemOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::update_file_system::UpdateFileSystemError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let mut fluent_builder = client.update_file_system();
        fluent_builder.inner = self;
        fluent_builder.send().await
    }
}
/// Fluent builder constructing a request to `UpdateFileSystem`.
///
/// <p>Use this operation to update the configuration of an existing Amazon FSx file system. You can update multiple properties in a single request.</p>
/// <p>For FSx for Windows File Server file systems, you can update the following properties:</p>
/// <ul>
/// <li>
/// <p><code>AuditLogConfiguration</code></p></li>
/// <li>
/// <p><code>AutomaticBackupRetentionDays</code></p></li>
/// <li>
/// <p><code>DailyAutomaticBackupStartTime</code></p></li>
/// <li>
/// <p><code>DiskIopsConfiguration</code></p></li>
/// <li>
/// <p><code>SelfManagedActiveDirectoryConfiguration</code></p></li>
/// <li>
/// <p><code>StorageCapacity</code></p></li>
/// <li>
/// <p><code>StorageType</code></p></li>
/// <li>
/// <p><code>ThroughputCapacity</code></p></li>
/// <li>
/// <p><code>WeeklyMaintenanceStartTime</code></p></li>
/// </ul>
/// <p>For FSx for Lustre file systems, you can update the following properties:</p>
/// <ul>
/// <li>
/// <p><code>AutoImportPolicy</code></p></li>
/// <li>
/// <p><code>AutomaticBackupRetentionDays</code></p></li>
/// <li>
/// <p><code>DailyAutomaticBackupStartTime</code></p></li>
/// <li>
/// <p><code>DataCompressionType</code></p></li>
/// <li>
/// <p><code>FileSystemTypeVersion</code></p></li>
/// <li>
/// <p><code>LogConfiguration</code></p></li>
/// <li>
/// <p><code>LustreReadCacheConfiguration</code></p></li>
/// <li>
/// <p><code>LustreRootSquashConfiguration</code></p></li>
/// <li>
/// <p><code>MetadataConfiguration</code></p></li>
/// <li>
/// <p><code>PerUnitStorageThroughput</code></p></li>
/// <li>
/// <p><code>StorageCapacity</code></p></li>
/// <li>
/// <p><code>ThroughputCapacity</code></p></li>
/// <li>
/// <p><code>WeeklyMaintenanceStartTime</code></p></li>
/// </ul>
/// <p>For FSx for ONTAP file systems, you can update the following properties:</p>
/// <ul>
/// <li>
/// <p><code>AddRouteTableIds</code></p></li>
/// <li>
/// <p><code>AutomaticBackupRetentionDays</code></p></li>
/// <li>
/// <p><code>DailyAutomaticBackupStartTime</code></p></li>
/// <li>
/// <p><code>DiskIopsConfiguration</code></p></li>
/// <li>
/// <p><code>EndpointIpv6AddressRange</code></p></li>
/// <li>
/// <p><code>FsxAdminPassword</code></p></li>
/// <li>
/// <p><code>HAPairs</code></p></li>
/// <li>
/// <p><code>RemoveRouteTableIds</code></p></li>
/// <li>
/// <p><code>StorageCapacity</code></p></li>
/// <li>
/// <p><code>ThroughputCapacity</code></p></li>
/// <li>
/// <p><code>ThroughputCapacityPerHAPair</code></p></li>
/// <li>
/// <p><code>WeeklyMaintenanceStartTime</code></p></li>
/// </ul>
/// <p>For FSx for OpenZFS file systems, you can update the following properties:</p>
/// <ul>
/// <li>
/// <p><code>AddRouteTableIds</code></p></li>
/// <li>
/// <p><code>AutomaticBackupRetentionDays</code></p></li>
/// <li>
/// <p><code>CopyTagsToBackups</code></p></li>
/// <li>
/// <p><code>CopyTagsToVolumes</code></p></li>
/// <li>
/// <p><code>DailyAutomaticBackupStartTime</code></p></li>
/// <li>
/// <p><code>DiskIopsConfiguration</code></p></li>
/// <li>
/// <p><code>EndpointIpv6AddressRange</code></p></li>
/// <li>
/// <p><code>ReadCacheConfiguration</code></p></li>
/// <li>
/// <p><code>RemoveRouteTableIds</code></p></li>
/// <li>
/// <p><code>StorageCapacity</code></p></li>
/// <li>
/// <p><code>ThroughputCapacity</code></p></li>
/// <li>
/// <p><code>WeeklyMaintenanceStartTime</code></p></li>
/// </ul>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct UpdateFileSystemFluentBuilder {
    handle: ::std::sync::Arc<crate::client::Handle>,
    inner: crate::operation::update_file_system::builders::UpdateFileSystemInputBuilder,
    config_override: ::std::option::Option<crate::config::Builder>,
}
impl
    crate::client::customize::internal::CustomizableSend<
        crate::operation::update_file_system::UpdateFileSystemOutput,
        crate::operation::update_file_system::UpdateFileSystemError,
    > for UpdateFileSystemFluentBuilder
{
    fn send(
        self,
        config_override: crate::config::Builder,
    ) -> crate::client::customize::internal::BoxFuture<
        crate::client::customize::internal::SendResult<
            crate::operation::update_file_system::UpdateFileSystemOutput,
            crate::operation::update_file_system::UpdateFileSystemError,
        >,
    > {
        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
    }
}
impl UpdateFileSystemFluentBuilder {
    /// Creates a new `UpdateFileSystemFluentBuilder`.
    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
        Self {
            handle,
            inner: ::std::default::Default::default(),
            config_override: ::std::option::Option::None,
        }
    }
    /// Access the UpdateFileSystem as a reference.
    pub fn as_input(&self) -> &crate::operation::update_file_system::builders::UpdateFileSystemInputBuilder {
        &self.inner
    }
    /// Sends the request and returns the response.
    ///
    /// If an error occurs, an `SdkError` will be returned with additional details that
    /// can be matched against.
    ///
    /// By default, any retryable failures will be retried twice. Retry behavior
    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
    /// set when configuring the client.
    pub async fn send(
        self,
    ) -> ::std::result::Result<
        crate::operation::update_file_system::UpdateFileSystemOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::update_file_system::UpdateFileSystemError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let input = self
            .inner
            .build()
            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
        let runtime_plugins = crate::operation::update_file_system::UpdateFileSystem::operation_runtime_plugins(
            self.handle.runtime_plugins.clone(),
            &self.handle.conf,
            self.config_override,
        );
        crate::operation::update_file_system::UpdateFileSystem::orchestrate(&runtime_plugins, input).await
    }

    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
    pub fn customize(
        self,
    ) -> crate::client::customize::CustomizableOperation<
        crate::operation::update_file_system::UpdateFileSystemOutput,
        crate::operation::update_file_system::UpdateFileSystemError,
        Self,
    > {
        crate::client::customize::CustomizableOperation::new(self)
    }
    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
        self.set_config_override(::std::option::Option::Some(config_override.into()));
        self
    }

    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
        self.config_override = config_override;
        self
    }
    /// <p>The ID of the file system that you are updating.</p>
    pub fn file_system_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.file_system_id(input.into());
        self
    }
    /// <p>The ID of the file system that you are updating.</p>
    pub fn set_file_system_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_file_system_id(input);
        self
    }
    /// <p>The ID of the file system that you are updating.</p>
    pub fn get_file_system_id(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_file_system_id()
    }
    /// <p>A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent updates. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
    pub fn client_request_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.client_request_token(input.into());
        self
    }
    /// <p>A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent updates. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
    pub fn set_client_request_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_client_request_token(input);
        self
    }
    /// <p>A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent updates. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
    pub fn get_client_request_token(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_client_request_token()
    }
    /// <p>Use this parameter to increase the storage capacity of an FSx for Windows File Server, FSx for Lustre, FSx for OpenZFS, or FSx for ONTAP file system. For second-generation FSx for ONTAP file systems, you can also decrease the storage capacity. Specifies the storage capacity target value, in GiB, for the file system that you're updating.</p><note>
    /// <p>You can't make a storage capacity increase request if there is an existing storage capacity increase request in progress.</p>
    /// </note>
    /// <p>For Lustre file systems, the storage capacity target value can be the following:</p>
    /// <ul>
    /// <li>
    /// <p>For <code>SCRATCH_2</code>, <code>PERSISTENT_1</code>, and <code>PERSISTENT_2 SSD</code> deployment types, valid values are in multiples of 2400 GiB. The value must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>PERSISTENT HDD</code> file systems, valid values are multiples of 6000 GiB for 12-MBps throughput per TiB file systems and multiples of 1800 GiB for 40-MBps throughput per TiB file systems. The values must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>SCRATCH_1</code> file systems, you can't increase the storage capacity.</p></li>
    /// </ul>
    /// <p>For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-storage-capacity.html">Managing storage and throughput capacity</a> in the <i>FSx for Lustre User Guide</i>.</p>
    /// <p>For FSx for OpenZFS file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>FSx for OpenZFS User Guide</i>.</p>
    /// <p>For Windows file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. To increase storage capacity, the file system must have at least 16 MBps of throughput capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>Amazon FSxfor Windows File Server User Guide</i>.</p>
    /// <p>For ONTAP file systems, when increasing storage capacity, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. When decreasing storage capacity on second-generation file systems, the target value must be at least 9 percent smaller than the current SSD storage capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/storage-capacity-and-IOPS.html">File system storage capacity and IOPS</a> in the Amazon FSx for NetApp ONTAP User Guide.</p>
    pub fn storage_capacity(mut self, input: i32) -> Self {
        self.inner = self.inner.storage_capacity(input);
        self
    }
    /// <p>Use this parameter to increase the storage capacity of an FSx for Windows File Server, FSx for Lustre, FSx for OpenZFS, or FSx for ONTAP file system. For second-generation FSx for ONTAP file systems, you can also decrease the storage capacity. Specifies the storage capacity target value, in GiB, for the file system that you're updating.</p><note>
    /// <p>You can't make a storage capacity increase request if there is an existing storage capacity increase request in progress.</p>
    /// </note>
    /// <p>For Lustre file systems, the storage capacity target value can be the following:</p>
    /// <ul>
    /// <li>
    /// <p>For <code>SCRATCH_2</code>, <code>PERSISTENT_1</code>, and <code>PERSISTENT_2 SSD</code> deployment types, valid values are in multiples of 2400 GiB. The value must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>PERSISTENT HDD</code> file systems, valid values are multiples of 6000 GiB for 12-MBps throughput per TiB file systems and multiples of 1800 GiB for 40-MBps throughput per TiB file systems. The values must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>SCRATCH_1</code> file systems, you can't increase the storage capacity.</p></li>
    /// </ul>
    /// <p>For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-storage-capacity.html">Managing storage and throughput capacity</a> in the <i>FSx for Lustre User Guide</i>.</p>
    /// <p>For FSx for OpenZFS file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>FSx for OpenZFS User Guide</i>.</p>
    /// <p>For Windows file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. To increase storage capacity, the file system must have at least 16 MBps of throughput capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>Amazon FSxfor Windows File Server User Guide</i>.</p>
    /// <p>For ONTAP file systems, when increasing storage capacity, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. When decreasing storage capacity on second-generation file systems, the target value must be at least 9 percent smaller than the current SSD storage capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/storage-capacity-and-IOPS.html">File system storage capacity and IOPS</a> in the Amazon FSx for NetApp ONTAP User Guide.</p>
    pub fn set_storage_capacity(mut self, input: ::std::option::Option<i32>) -> Self {
        self.inner = self.inner.set_storage_capacity(input);
        self
    }
    /// <p>Use this parameter to increase the storage capacity of an FSx for Windows File Server, FSx for Lustre, FSx for OpenZFS, or FSx for ONTAP file system. For second-generation FSx for ONTAP file systems, you can also decrease the storage capacity. Specifies the storage capacity target value, in GiB, for the file system that you're updating.</p><note>
    /// <p>You can't make a storage capacity increase request if there is an existing storage capacity increase request in progress.</p>
    /// </note>
    /// <p>For Lustre file systems, the storage capacity target value can be the following:</p>
    /// <ul>
    /// <li>
    /// <p>For <code>SCRATCH_2</code>, <code>PERSISTENT_1</code>, and <code>PERSISTENT_2 SSD</code> deployment types, valid values are in multiples of 2400 GiB. The value must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>PERSISTENT HDD</code> file systems, valid values are multiples of 6000 GiB for 12-MBps throughput per TiB file systems and multiples of 1800 GiB for 40-MBps throughput per TiB file systems. The values must be greater than the current storage capacity.</p></li>
    /// <li>
    /// <p>For <code>SCRATCH_1</code> file systems, you can't increase the storage capacity.</p></li>
    /// </ul>
    /// <p>For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-storage-capacity.html">Managing storage and throughput capacity</a> in the <i>FSx for Lustre User Guide</i>.</p>
    /// <p>For FSx for OpenZFS file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>FSx for OpenZFS User Guide</i>.</p>
    /// <p>For Windows file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. To increase storage capacity, the file system must have at least 16 MBps of throughput capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-storage-capacity.html">Managing storage capacity</a> in the <i>Amazon FSxfor Windows File Server User Guide</i>.</p>
    /// <p>For ONTAP file systems, when increasing storage capacity, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. When decreasing storage capacity on second-generation file systems, the target value must be at least 9 percent smaller than the current SSD storage capacity. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/storage-capacity-and-IOPS.html">File system storage capacity and IOPS</a> in the Amazon FSx for NetApp ONTAP User Guide.</p>
    pub fn get_storage_capacity(&self) -> &::std::option::Option<i32> {
        self.inner.get_storage_capacity()
    }
    /// <p>The configuration updates for an Amazon FSx for Windows File Server file system.</p>
    pub fn windows_configuration(mut self, input: crate::types::UpdateFileSystemWindowsConfiguration) -> Self {
        self.inner = self.inner.windows_configuration(input);
        self
    }
    /// <p>The configuration updates for an Amazon FSx for Windows File Server file system.</p>
    pub fn set_windows_configuration(mut self, input: ::std::option::Option<crate::types::UpdateFileSystemWindowsConfiguration>) -> Self {
        self.inner = self.inner.set_windows_configuration(input);
        self
    }
    /// <p>The configuration updates for an Amazon FSx for Windows File Server file system.</p>
    pub fn get_windows_configuration(&self) -> &::std::option::Option<crate::types::UpdateFileSystemWindowsConfiguration> {
        self.inner.get_windows_configuration()
    }
    /// <p>The configuration object for Amazon FSx for Lustre file systems used in the <code>UpdateFileSystem</code> operation.</p>
    pub fn lustre_configuration(mut self, input: crate::types::UpdateFileSystemLustreConfiguration) -> Self {
        self.inner = self.inner.lustre_configuration(input);
        self
    }
    /// <p>The configuration object for Amazon FSx for Lustre file systems used in the <code>UpdateFileSystem</code> operation.</p>
    pub fn set_lustre_configuration(mut self, input: ::std::option::Option<crate::types::UpdateFileSystemLustreConfiguration>) -> Self {
        self.inner = self.inner.set_lustre_configuration(input);
        self
    }
    /// <p>The configuration object for Amazon FSx for Lustre file systems used in the <code>UpdateFileSystem</code> operation.</p>
    pub fn get_lustre_configuration(&self) -> &::std::option::Option<crate::types::UpdateFileSystemLustreConfiguration> {
        self.inner.get_lustre_configuration()
    }
    /// <p>The configuration updates for an Amazon FSx for NetApp ONTAP file system.</p>
    pub fn ontap_configuration(mut self, input: crate::types::UpdateFileSystemOntapConfiguration) -> Self {
        self.inner = self.inner.ontap_configuration(input);
        self
    }
    /// <p>The configuration updates for an Amazon FSx for NetApp ONTAP file system.</p>
    pub fn set_ontap_configuration(mut self, input: ::std::option::Option<crate::types::UpdateFileSystemOntapConfiguration>) -> Self {
        self.inner = self.inner.set_ontap_configuration(input);
        self
    }
    /// <p>The configuration updates for an Amazon FSx for NetApp ONTAP file system.</p>
    pub fn get_ontap_configuration(&self) -> &::std::option::Option<crate::types::UpdateFileSystemOntapConfiguration> {
        self.inner.get_ontap_configuration()
    }
    /// <p>The configuration updates for an FSx for OpenZFS file system.</p>
    pub fn open_zfs_configuration(mut self, input: crate::types::UpdateFileSystemOpenZfsConfiguration) -> Self {
        self.inner = self.inner.open_zfs_configuration(input);
        self
    }
    /// <p>The configuration updates for an FSx for OpenZFS file system.</p>
    pub fn set_open_zfs_configuration(mut self, input: ::std::option::Option<crate::types::UpdateFileSystemOpenZfsConfiguration>) -> Self {
        self.inner = self.inner.set_open_zfs_configuration(input);
        self
    }
    /// <p>The configuration updates for an FSx for OpenZFS file system.</p>
    pub fn get_open_zfs_configuration(&self) -> &::std::option::Option<crate::types::UpdateFileSystemOpenZfsConfiguration> {
        self.inner.get_open_zfs_configuration()
    }
    /// <p>Specifies the file system's storage type.</p>
    pub fn storage_type(mut self, input: crate::types::StorageType) -> Self {
        self.inner = self.inner.storage_type(input);
        self
    }
    /// <p>Specifies the file system's storage type.</p>
    pub fn set_storage_type(mut self, input: ::std::option::Option<crate::types::StorageType>) -> Self {
        self.inner = self.inner.set_storage_type(input);
        self
    }
    /// <p>Specifies the file system's storage type.</p>
    pub fn get_storage_type(&self) -> &::std::option::Option<crate::types::StorageType> {
        self.inner.get_storage_type()
    }
    /// <p>The Lustre version you are updating an FSx for Lustre file system to. Valid values are <code>2.12</code> and <code>2.15</code>. The value you choose must be newer than the file system's current Lustre version.</p>
    pub fn file_system_type_version(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.file_system_type_version(input.into());
        self
    }
    /// <p>The Lustre version you are updating an FSx for Lustre file system to. Valid values are <code>2.12</code> and <code>2.15</code>. The value you choose must be newer than the file system's current Lustre version.</p>
    pub fn set_file_system_type_version(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_file_system_type_version(input);
        self
    }
    /// <p>The Lustre version you are updating an FSx for Lustre file system to. Valid values are <code>2.12</code> and <code>2.15</code>. The value you choose must be newer than the file system's current Lustre version.</p>
    pub fn get_file_system_type_version(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_file_system_type_version()
    }
    /// <p>Changes the network type of an FSx for OpenZFS file system.</p>
    pub fn network_type(mut self, input: crate::types::NetworkType) -> Self {
        self.inner = self.inner.network_type(input);
        self
    }
    /// <p>Changes the network type of an FSx for OpenZFS file system.</p>
    pub fn set_network_type(mut self, input: ::std::option::Option<crate::types::NetworkType>) -> Self {
        self.inner = self.inner.set_network_type(input);
        self
    }
    /// <p>Changes the network type of an FSx for OpenZFS file system.</p>
    pub fn get_network_type(&self) -> &::std::option::Option<crate::types::NetworkType> {
        self.inner.get_network_type()
    }
}