#[non_exhaustive]pub struct CreateFileSystemWindowsConfiguration {
pub active_directory_id: Option<String>,
pub self_managed_active_directory_configuration: Option<SelfManagedActiveDirectoryConfiguration>,
pub deployment_type: Option<WindowsDeploymentType>,
pub preferred_subnet_id: Option<String>,
pub throughput_capacity: Option<i32>,
pub weekly_maintenance_start_time: Option<String>,
pub daily_automatic_backup_start_time: Option<String>,
pub automatic_backup_retention_days: Option<i32>,
pub copy_tags_to_backups: Option<bool>,
pub aliases: Option<Vec<String>>,
pub audit_log_configuration: Option<WindowsAuditLogCreateConfiguration>,
pub disk_iops_configuration: Option<DiskIopsConfiguration>,
}
Expand description
The configuration object for the Microsoft Windows file system used in CreateFileSystem
and CreateFileSystemFromBackup
operations.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.active_directory_id: Option<String>
The ID for an existing Amazon Web Services Managed Microsoft Active Directory (AD) instance that the file system should join when it's created.
self_managed_active_directory_configuration: Option<SelfManagedActiveDirectoryConfiguration>
The configuration that Amazon FSx uses to join a FSx for Windows File Server file system or an FSx for ONTAP storage virtual machine (SVM) to a self-managed (including on-premises) Microsoft Active Directory (AD) directory. For more information, see Using Amazon FSx for Windows with your self-managed Microsoft Active Directory or Managing FSx for ONTAP SVMs.
deployment_type: Option<WindowsDeploymentType>
Specifies the file system deployment type, valid values are the following:
-
MULTI_AZ_1
- Deploys a high availability file system that is configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. You can only deploy a Multi-AZ file system in Amazon Web Services Regions that have a minimum of three Availability Zones. Also supports HDD storage type -
SINGLE_AZ_1
- (Default) Choose to deploy a file system that is configured for single AZ redundancy. -
SINGLE_AZ_2
- The latest generation Single AZ file system. Specifies a file system that is configured for single AZ redundancy and supports HDD storage type.
For more information, see Availability and Durability: Single-AZ and Multi-AZ File Systems.
preferred_subnet_id: Option<String>
Required when DeploymentType
is set to MULTI_AZ_1
. This specifies the subnet in which you want the preferred file server to be located. For in-Amazon Web Services applications, we recommend that you launch your clients in the same Availability Zone (AZ) as your preferred file server to reduce cross-AZ data transfer costs and minimize latency.
throughput_capacity: Option<i32>
Sets the throughput capacity of an Amazon FSx file system, measured in megabytes per second (MB/s), in 2 to the nth increments, between 2^3 (8) and 2^11 (2048).
weekly_maintenance_start_time: Option<String>
The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.
daily_automatic_backup_start_time: Option<String>
The preferred time to take daily automatic backups, formatted HH:MM in the UTC time zone.
automatic_backup_retention_days: Option<i32>
The number of days to retain automatic backups. Setting this property to 0
disables automatic backups. You can retain automatic backups for a maximum of 90 days. The default is 30
.
A boolean flag indicating whether tags for the file system should be copied to backups. This value defaults to false. If it's set to true, all tags for the file system are copied to all automatic and user-initiated backups where the user doesn't specify tags. If this value is true, and you specify one or more tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the file system, regardless of this value.
aliases: Option<Vec<String>>
An array of one or more DNS alias names that you want to associate with the Amazon FSx file system. Aliases allow you to use existing DNS names to access the data in your Amazon FSx file system. You can associate up to 50 aliases with a file system at any time. You can associate additional DNS aliases after you create the file system using the AssociateFileSystemAliases operation. You can remove DNS aliases from the file system after it is created using the DisassociateFileSystemAliases operation. You only need to specify the alias name in the request payload.
For more information, see Working with DNS Aliases and Walkthrough 5: Using DNS aliases to access your file system, including additional steps you must take to be able to access your file system using a DNS alias.
An alias name has to meet the following requirements:
-
Formatted as a fully-qualified domain name (FQDN),
hostname.domain
, for example,accounting.example.com
. -
Can contain alphanumeric characters, the underscore (_), and the hyphen (-).
-
Cannot start or end with a hyphen.
-
Can start with a numeric.
For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.
audit_log_configuration: Option<WindowsAuditLogCreateConfiguration>
The configuration that Amazon FSx for Windows File Server uses to audit and log user accesses of files, folders, and file shares on the Amazon FSx for Windows File Server file system.
disk_iops_configuration: Option<DiskIopsConfiguration>
The SSD IOPS (input/output operations per second) configuration for an Amazon FSx for Windows file system. By default, Amazon FSx automatically provisions 3 IOPS per GiB of storage capacity. You can provision additional IOPS per GiB of storage, up to the maximum limit associated with your chosen throughput capacity.
Implementations§
source§impl CreateFileSystemWindowsConfiguration
impl CreateFileSystemWindowsConfiguration
sourcepub fn active_directory_id(&self) -> Option<&str>
pub fn active_directory_id(&self) -> Option<&str>
The ID for an existing Amazon Web Services Managed Microsoft Active Directory (AD) instance that the file system should join when it's created.
sourcepub fn self_managed_active_directory_configuration(
&self
) -> Option<&SelfManagedActiveDirectoryConfiguration>
pub fn self_managed_active_directory_configuration( &self ) -> Option<&SelfManagedActiveDirectoryConfiguration>
The configuration that Amazon FSx uses to join a FSx for Windows File Server file system or an FSx for ONTAP storage virtual machine (SVM) to a self-managed (including on-premises) Microsoft Active Directory (AD) directory. For more information, see Using Amazon FSx for Windows with your self-managed Microsoft Active Directory or Managing FSx for ONTAP SVMs.
sourcepub fn deployment_type(&self) -> Option<&WindowsDeploymentType>
pub fn deployment_type(&self) -> Option<&WindowsDeploymentType>
Specifies the file system deployment type, valid values are the following:
-
MULTI_AZ_1
- Deploys a high availability file system that is configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. You can only deploy a Multi-AZ file system in Amazon Web Services Regions that have a minimum of three Availability Zones. Also supports HDD storage type -
SINGLE_AZ_1
- (Default) Choose to deploy a file system that is configured for single AZ redundancy. -
SINGLE_AZ_2
- The latest generation Single AZ file system. Specifies a file system that is configured for single AZ redundancy and supports HDD storage type.
For more information, see Availability and Durability: Single-AZ and Multi-AZ File Systems.
sourcepub fn preferred_subnet_id(&self) -> Option<&str>
pub fn preferred_subnet_id(&self) -> Option<&str>
Required when DeploymentType
is set to MULTI_AZ_1
. This specifies the subnet in which you want the preferred file server to be located. For in-Amazon Web Services applications, we recommend that you launch your clients in the same Availability Zone (AZ) as your preferred file server to reduce cross-AZ data transfer costs and minimize latency.
sourcepub fn throughput_capacity(&self) -> Option<i32>
pub fn throughput_capacity(&self) -> Option<i32>
Sets the throughput capacity of an Amazon FSx file system, measured in megabytes per second (MB/s), in 2 to the nth increments, between 2^3 (8) and 2^11 (2048).
sourcepub fn weekly_maintenance_start_time(&self) -> Option<&str>
pub fn weekly_maintenance_start_time(&self) -> Option<&str>
The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.
sourcepub fn daily_automatic_backup_start_time(&self) -> Option<&str>
pub fn daily_automatic_backup_start_time(&self) -> Option<&str>
The preferred time to take daily automatic backups, formatted HH:MM in the UTC time zone.
sourcepub fn automatic_backup_retention_days(&self) -> Option<i32>
pub fn automatic_backup_retention_days(&self) -> Option<i32>
The number of days to retain automatic backups. Setting this property to 0
disables automatic backups. You can retain automatic backups for a maximum of 90 days. The default is 30
.
A boolean flag indicating whether tags for the file system should be copied to backups. This value defaults to false. If it's set to true, all tags for the file system are copied to all automatic and user-initiated backups where the user doesn't specify tags. If this value is true, and you specify one or more tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the file system, regardless of this value.
sourcepub fn aliases(&self) -> &[String]
pub fn aliases(&self) -> &[String]
An array of one or more DNS alias names that you want to associate with the Amazon FSx file system. Aliases allow you to use existing DNS names to access the data in your Amazon FSx file system. You can associate up to 50 aliases with a file system at any time. You can associate additional DNS aliases after you create the file system using the AssociateFileSystemAliases operation. You can remove DNS aliases from the file system after it is created using the DisassociateFileSystemAliases operation. You only need to specify the alias name in the request payload.
For more information, see Working with DNS Aliases and Walkthrough 5: Using DNS aliases to access your file system, including additional steps you must take to be able to access your file system using a DNS alias.
An alias name has to meet the following requirements:
-
Formatted as a fully-qualified domain name (FQDN),
hostname.domain
, for example,accounting.example.com
. -
Can contain alphanumeric characters, the underscore (_), and the hyphen (-).
-
Cannot start or end with a hyphen.
-
Can start with a numeric.
For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .aliases.is_none()
.
sourcepub fn audit_log_configuration(
&self
) -> Option<&WindowsAuditLogCreateConfiguration>
pub fn audit_log_configuration( &self ) -> Option<&WindowsAuditLogCreateConfiguration>
The configuration that Amazon FSx for Windows File Server uses to audit and log user accesses of files, folders, and file shares on the Amazon FSx for Windows File Server file system.
sourcepub fn disk_iops_configuration(&self) -> Option<&DiskIopsConfiguration>
pub fn disk_iops_configuration(&self) -> Option<&DiskIopsConfiguration>
The SSD IOPS (input/output operations per second) configuration for an Amazon FSx for Windows file system. By default, Amazon FSx automatically provisions 3 IOPS per GiB of storage capacity. You can provision additional IOPS per GiB of storage, up to the maximum limit associated with your chosen throughput capacity.
source§impl CreateFileSystemWindowsConfiguration
impl CreateFileSystemWindowsConfiguration
sourcepub fn builder() -> CreateFileSystemWindowsConfigurationBuilder
pub fn builder() -> CreateFileSystemWindowsConfigurationBuilder
Creates a new builder-style object to manufacture CreateFileSystemWindowsConfiguration
.
Trait Implementations§
source§impl Clone for CreateFileSystemWindowsConfiguration
impl Clone for CreateFileSystemWindowsConfiguration
source§fn clone(&self) -> CreateFileSystemWindowsConfiguration
fn clone(&self) -> CreateFileSystemWindowsConfiguration
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl PartialEq for CreateFileSystemWindowsConfiguration
impl PartialEq for CreateFileSystemWindowsConfiguration
source§fn eq(&self, other: &CreateFileSystemWindowsConfiguration) -> bool
fn eq(&self, other: &CreateFileSystemWindowsConfiguration) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for CreateFileSystemWindowsConfiguration
Auto Trait Implementations§
impl Freeze for CreateFileSystemWindowsConfiguration
impl RefUnwindSafe for CreateFileSystemWindowsConfiguration
impl Send for CreateFileSystemWindowsConfiguration
impl Sync for CreateFileSystemWindowsConfiguration
impl Unpin for CreateFileSystemWindowsConfiguration
impl UnwindSafe for CreateFileSystemWindowsConfiguration
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more