Interface ILustreConfiguration
The configuration for the Amazon FSx for Lustre file system.
Namespace: Amazon.CDK.AWS.FSx
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface ILustreConfiguration
Syntax (vb)
Public Interface ILustreConfiguration
Remarks
ExampleMetadata: infused
Examples
using Amazon.CDK.AWS.S3;
Vpc vpc;
Bucket bucket;
IDictionary<string, object> lustreConfiguration = new Dictionary<string, object> {
{ "deploymentType", LustreDeploymentType.SCRATCH_2 },
{ "exportPath", bucket.S3UrlForObject() },
{ "importPath", bucket.S3UrlForObject() },
{ "autoImportPolicy", LustreAutoImportPolicy.NEW_CHANGED_DELETED }
};
var fs = new LustreFileSystem(this, "FsxLustreFileSystem", new LustreFileSystemProps {
Vpc = vpc,
VpcSubnet = vpc.PrivateSubnets[0],
StorageCapacityGiB = 1200,
LustreConfiguration = lustreConfiguration
});
Synopsis
Properties
AutoImportPolicy | Available with |
DataCompressionType | Sets the data compression configuration for the file system. |
DeploymentType | The type of backing file system deployment used by FSx. |
ExportPath | The path in Amazon S3 where the root of your Amazon FSx file system is exported. |
ImportedFileChunkSizeMiB | For files imported from a data repository, this value determines the stripe count and maximum amount of data per file (in MiB) stored on a single physical disk. |
ImportPath | The path to the Amazon S3 bucket (including the optional prefix) that you're using as the data repository for your Amazon FSx for Lustre file system. |
PerUnitStorageThroughput | Required for the PERSISTENT_1 deployment type, describes the amount of read and write throughput for each 1 tebibyte of storage, in MB/s/TiB. |
WeeklyMaintenanceStartTime | The preferred day and time to perform weekly maintenance. |
Properties
AutoImportPolicy
Available with Scratch
and Persistent_1
deployment types.
virtual Nullable<LustreAutoImportPolicy> AutoImportPolicy { get; }
Property Value
System.Nullable<LustreAutoImportPolicy>
Remarks
When you create your file system, your existing S3 objects appear as file and directory listings. Use this property to choose how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your linked S3 bucket. AutoImportPolicy
can have the following values:
For more information, see Automatically import updates from your S3 bucket .
This parameter is not supported for Lustre file systems using the Persistent_2
deployment type.
Default: - no import policy
DataCompressionType
Sets the data compression configuration for the file system.
virtual Nullable<LustreDataCompressionType> DataCompressionType { get; }
Property Value
System.Nullable<LustreDataCompressionType>
Remarks
For more information, see Lustre data compression in the Amazon FSx for Lustre User Guide .
Default: - no compression
DeploymentType
The type of backing file system deployment used by FSx.
LustreDeploymentType DeploymentType { get; }
Property Value
ExportPath
The path in Amazon S3 where the root of your Amazon FSx file system is exported.
virtual string ExportPath { get; }
Property Value
System.String
Remarks
The path must use the same Amazon S3 bucket as specified in ImportPath. If you only specify a bucket name, such as s3://import-bucket, you get a 1:1 mapping of file system objects to S3 bucket objects. This mapping means that the input data in S3 is overwritten on export. If you provide a custom prefix in the export path, such as s3://import-bucket/[custom-optional-prefix], Amazon FSx exports the contents of your file system to that export prefix in the Amazon S3 bucket.
Default: s3://import-bucket/FSxLustre[creation-timestamp]
ImportedFileChunkSizeMiB
For files imported from a data repository, this value determines the stripe count and maximum amount of data per file (in MiB) stored on a single physical disk.
virtual Nullable<double> ImportedFileChunkSizeMiB { get; }
Property Value
System.Nullable<System.Double>
Remarks
Allowed values are between 1 and 512,000.
Default: 1024
ImportPath
The path to the Amazon S3 bucket (including the optional prefix) that you're using as the data repository for your Amazon FSx for Lustre file system.
virtual string ImportPath { get; }
Property Value
System.String
Remarks
Must be of the format "s3://{bucketName}/optional-prefix" and cannot exceed 900 characters.
Default: - no bucket is imported
PerUnitStorageThroughput
Required for the PERSISTENT_1 deployment type, describes the amount of read and write throughput for each 1 tebibyte of storage, in MB/s/TiB.
virtual Nullable<double> PerUnitStorageThroughput { get; }
Property Value
System.Nullable<System.Double>
Remarks
Valid values are 50, 100, 200.
Default: - no default, conditionally required for PERSISTENT_1 deployment type
WeeklyMaintenanceStartTime
The preferred day and time to perform weekly maintenance.
virtual LustreMaintenanceTime WeeklyMaintenanceStartTime { get; }
Property Value
Remarks
The first digit is the day of the week, starting at 1 for Monday, then the following are hours and minutes in the UTC time zone, 24 hour clock. For example: '2:20:30' is Tuesdays at 20:30.
Default: - no preference