Windows
Manages a FSx Windows File System. See the FSx Windows Guide for more information.
NOTE: Either the
active_directory_idargument orself_managed_active_directoryconfiguration block must be specified.
Example Usage
Using AWS Directory Service
Additional information for using AWS Directory Service with Windows File Systems can be found in the FSx Windows Guide.
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.fsx.WindowsFileSystem;
import com.pulumi.aws.fsx.WindowsFileSystemArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new WindowsFileSystem("example", WindowsFileSystemArgs.builder()
.activeDirectoryId(aws_directory_service_directory.example().id())
.kmsKeyId(aws_kms_key.example().arn())
.storageCapacity(300)
.subnetIds(aws_subnet.example().id())
.throughputCapacity(1024)
.build());
}
}Using a Self-Managed Microsoft Active Directory
Additional information for using AWS Directory Service with Windows File Systems can be found in the FSx Windows Guide.
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.fsx.WindowsFileSystem;
import com.pulumi.aws.fsx.WindowsFileSystemArgs;
import com.pulumi.aws.fsx.inputs.WindowsFileSystemSelfManagedActiveDirectoryArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new WindowsFileSystem("example", WindowsFileSystemArgs.builder()
.kmsKeyId(aws_kms_key.example().arn())
.storageCapacity(300)
.subnetIds(aws_subnet.example().id())
.throughputCapacity(1024)
.selfManagedActiveDirectory(WindowsFileSystemSelfManagedActiveDirectoryArgs.builder()
.dnsIps(
"10.0.0.111",
"10.0.0.222")
.domainName("corp.example.com")
.password("avoid-plaintext-passwords")
.username("Admin")
.build())
.build());
}
}Import
FSx File Systems can be imported using the id, e.g.,
$ pulumi import aws:fsx/windowsFileSystem:WindowsFileSystem example fs-543ab12b1ca672f33Certain resource arguments, like security_group_ids and the self_managed_active_directory configuation block password, do not have a FSx API method for reading the information after creation. If these arguments are set in the provider configuration on an imported resource, the povider will always show a difference. To workaround this behavior, either omit the argument from the configuration or use ignoreChanges to hide the difference, e.g. terraform resource "aws_fsx_windows_file_system" "example" {
... other configuration ...
security_group_ids = aws_security_group.example.id
There is no FSx API for reading security_group_ids
lifecycle { ignore_changes = security_group_ids } }
Constructors
Properties
The ID for an existing Microsoft Active Directory instance that the file system should join when it's created. Cannot be specified with self_managed_active_directory.
An array DNS alias names that you want to associate with the Amazon FSx file system. For more information, see Working with DNS Aliases
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. See below.
The number of days to retain automatic backups. Minimum of 0 and maximum of 90. Defaults to 7. Set to 0 to disable.
A boolean flag indicating whether tags on the file system should be copied to backups. Defaults to false.
The preferred time (in HH:MM format) to take daily automatic backups, in the UTC time zone.
Specifies the file system deployment type, valid values are MULTI_AZ_1, SINGLE_AZ_1 and SINGLE_AZ_2. Default value is SINGLE_AZ_1.
Specifies the subnet in which you want the preferred file server to be located. Required for when deployment type is MULTI_AZ_1.
A list of IDs for the security groups that apply to the specified network interfaces created for file system access. These security groups will apply to all network interfaces.
Configuration block that Amazon FSx uses to join the Windows File Server instance to your self-managed (including on-premises) Microsoft Active Directory (AD) directory. Cannot be specified with active_directory_id. Detailed below.
When enabled, will skip the default final backup taken when the file system is deleted. This configuration must be applied separately before attempting to delete the resource to have the desired behavior. Defaults to false.
Storage capacity (GiB) of the file system. Minimum of 32 and maximum of 65536. If the storage type is set to HDD the minimum value is 2000. Required when not creating filesystem for a backup.
Specifies the storage type, Valid values are SSD and HDD. HDD is supported on SINGLE_AZ_2 and MULTI_AZ_1 Windows file system deployment types. Default value is SSD.
Throughput (megabytes per second) of the file system in power of 2 increments. Minimum of 8 and maximum of 2048. The following arguments are optional:
The preferred start time (in d:HH:MM format) to perform weekly maintenance, in the UTC time zone.