@aws-sdk/client-fsx 3.816.0 → 3.820.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/dist-cjs/index.js +7 -0
  2. package/dist-cjs/runtimeConfig.js +4 -1
  3. package/dist-es/models/models_0.js +5 -0
  4. package/dist-es/runtimeConfig.js +4 -1
  5. package/dist-types/commands/CopyBackupCommand.d.ts +11 -1
  6. package/dist-types/commands/CopySnapshotAndUpdateVolumeCommand.d.ts +11 -1
  7. package/dist-types/commands/CreateBackupCommand.d.ts +11 -1
  8. package/dist-types/commands/CreateDataRepositoryAssociationCommand.d.ts +1 -1
  9. package/dist-types/commands/CreateDataRepositoryTaskCommand.d.ts +1 -1
  10. package/dist-types/commands/CreateFileCacheCommand.d.ts +1 -1
  11. package/dist-types/commands/CreateFileSystemCommand.d.ts +16 -1
  12. package/dist-types/commands/CreateFileSystemFromBackupCommand.d.ts +16 -1
  13. package/dist-types/commands/CreateSnapshotCommand.d.ts +11 -1
  14. package/dist-types/commands/CreateStorageVirtualMachineCommand.d.ts +1 -1
  15. package/dist-types/commands/CreateVolumeCommand.d.ts +11 -1
  16. package/dist-types/commands/CreateVolumeFromBackupCommand.d.ts +11 -1
  17. package/dist-types/commands/DeleteDataRepositoryAssociationCommand.d.ts +1 -1
  18. package/dist-types/commands/DeleteFileCacheCommand.d.ts +1 -1
  19. package/dist-types/commands/DeleteFileSystemCommand.d.ts +1 -1
  20. package/dist-types/commands/DeleteVolumeCommand.d.ts +1 -1
  21. package/dist-types/commands/DescribeBackupsCommand.d.ts +10 -0
  22. package/dist-types/commands/DescribeFileSystemsCommand.d.ts +10 -0
  23. package/dist-types/commands/DescribeSnapshotsCommand.d.ts +10 -0
  24. package/dist-types/commands/DescribeVolumesCommand.d.ts +10 -0
  25. package/dist-types/commands/ReleaseFileSystemNfsV3LocksCommand.d.ts +11 -1
  26. package/dist-types/commands/RestoreVolumeFromSnapshotCommand.d.ts +10 -0
  27. package/dist-types/commands/StartMisconfiguredStateRecoveryCommand.d.ts +10 -0
  28. package/dist-types/commands/UpdateDataRepositoryAssociationCommand.d.ts +1 -1
  29. package/dist-types/commands/UpdateFileCacheCommand.d.ts +1 -1
  30. package/dist-types/commands/UpdateFileSystemCommand.d.ts +31 -6
  31. package/dist-types/commands/UpdateSnapshotCommand.d.ts +10 -0
  32. package/dist-types/commands/UpdateVolumeCommand.d.ts +10 -0
  33. package/dist-types/models/models_0.d.ts +211 -112
  34. package/dist-types/ts3.4/models/models_0.d.ts +17 -0
  35. package/package.json +2 -2
@@ -172,6 +172,58 @@ export declare const DataCompressionType: {
172
172
  * @public
173
173
  */
174
174
  export type DataCompressionType = (typeof DataCompressionType)[keyof typeof DataCompressionType];
175
+ /**
176
+ * @public
177
+ * @enum
178
+ */
179
+ export declare const LustreReadCacheSizingMode: {
180
+ readonly NO_CACHE: "NO_CACHE";
181
+ readonly PROPORTIONAL_TO_THROUGHPUT_CAPACITY: "PROPORTIONAL_TO_THROUGHPUT_CAPACITY";
182
+ readonly USER_PROVISIONED: "USER_PROVISIONED";
183
+ };
184
+ /**
185
+ * @public
186
+ */
187
+ export type LustreReadCacheSizingMode = (typeof LustreReadCacheSizingMode)[keyof typeof LustreReadCacheSizingMode];
188
+ /**
189
+ * <p>
190
+ * The configuration for the optional provisioned SSD read cache on Amazon FSx for Lustre file systems
191
+ * that use the Intelligent-Tiering storage class.
192
+ * </p>
193
+ * @public
194
+ */
195
+ export interface LustreReadCacheConfiguration {
196
+ /**
197
+ * <p>
198
+ * Specifies how the provisioned SSD read cache is sized, as follows:
199
+ * </p>
200
+ * <ul>
201
+ * <li>
202
+ * <p>Set to <code>NO_CACHE</code> if you do not want to use an SSD read cache with your Intelligent-Tiering file system.</p>
203
+ * </li>
204
+ * <li>
205
+ * <p>Set to <code>USER_PROVISIONED</code> to specify the exact size of your SSD read cache.</p>
206
+ * </li>
207
+ * <li>
208
+ * <p>Set to <code>PROPORTIONAL_TO_THROUGHPUT_CAPACITY</code> to have your SSD read cache automatically sized based on your throughput capacity.</p>
209
+ * </li>
210
+ * </ul>
211
+ * @public
212
+ */
213
+ SizingMode?: LustreReadCacheSizingMode | undefined;
214
+ /**
215
+ * <p>
216
+ * Required if <code>SizingMode</code> is set to <code>USER_PROVISIONED</code>.
217
+ * Specifies the size of the file system's SSD read cache, in gibibytes (GiB).
218
+ * </p>
219
+ * <p>The SSD read cache size is distributed across provisioned file servers in
220
+ * your file system. Intelligent-Tiering file systems support a minimum of 32 GiB
221
+ * and maximum of 131072 GiB for SSD read cache size for every 4,000 MB/s of throughput
222
+ * capacity provisioned.</p>
223
+ * @public
224
+ */
225
+ SizeGiB?: number | undefined;
226
+ }
175
227
  /**
176
228
  * @public
177
229
  * @enum
@@ -428,9 +480,18 @@ export type MetadataConfigurationMode = (typeof MetadataConfigurationMode)[keyof
428
480
  */
429
481
  export interface FileSystemLustreMetadataConfiguration {
430
482
  /**
431
- * <p>The number of Metadata IOPS provisioned for the file system. Valid values
432
- * are <code>1500</code>, <code>3000</code>, <code>6000</code>, <code>12000</code>,
433
- * and multiples of <code>12000</code> up to a maximum of <code>192000</code>.</p>
483
+ * <p>The number of Metadata IOPS provisioned for the file system.</p>
484
+ * <ul>
485
+ * <li>
486
+ * <p>For SSD file systems, valid values are <code>1500</code>,
487
+ * <code>3000</code>, <code>6000</code>, <code>12000</code>, and
488
+ * multiples of <code>12000</code> up to a maximum of <code>192000</code>.</p>
489
+ * </li>
490
+ * <li>
491
+ * <p>For Intelligent-Tiering file systems, valid values are <code>6000</code>
492
+ * and <code>12000</code>.</p>
493
+ * </li>
494
+ * </ul>
434
495
  * @public
435
496
  */
436
497
  Iops?: number | undefined;
@@ -439,9 +500,10 @@ export interface FileSystemLustreMetadataConfiguration {
439
500
  * file system.</p>
440
501
  * <ul>
441
502
  * <li>
442
- * <p>In AUTOMATIC mode, FSx for Lustre automatically
443
- * provisions and scales the number of Metadata IOPS on your file system based
444
- * on your file system storage capacity.</p>
503
+ * <p>In AUTOMATIC mode (supported only on SSD file systems),
504
+ * FSx for Lustre automatically provisions and scales the
505
+ * number of Metadata IOPS on your file system based on your file
506
+ * system storage capacity.</p>
445
507
  * </li>
446
508
  * <li>
447
509
  * <p>In USER_PROVISIONED mode, you can choose to specify the number
@@ -537,8 +599,8 @@ export interface LustreFileSystemConfiguration {
537
599
  * for longer-term storage and workloads and encryption of data in transit.
538
600
  * <code>PERSISTENT_2</code> offers higher <code>PerUnitStorageThroughput</code>
539
601
  * (up to 1000 MB/s/TiB) along with a lower minimum storage capacity requirement (600 GiB).
540
- * To learn more about FSx for Lustre deployment types, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/lustre-deployment-types.html">
541
- * FSx for Lustre deployment options</a>.</p>
602
+ * To learn more about FSx for Lustre deployment types, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html">Deployment and storage class options for
603
+ * FSx for Lustre file systems</a>.</p>
542
604
  * <p>The default is <code>SCRATCH_1</code>.</p>
543
605
  * @public
544
606
  */
@@ -651,6 +713,18 @@ export interface LustreFileSystemConfiguration {
651
713
  * @public
652
714
  */
653
715
  EfaEnabled?: boolean | undefined;
716
+ /**
717
+ * <p>The throughput of an Amazon FSx for Lustre file system using the Intelligent-Tiering
718
+ * storage class, measured in megabytes per second (MBps).</p>
719
+ * @public
720
+ */
721
+ ThroughputCapacity?: number | undefined;
722
+ /**
723
+ * <p>Required when <code>StorageType</code> is set to <code>INTELLIGENT_TIERING</code>.
724
+ * Specifies the optional provisioned SSD read cache.</p>
725
+ * @public
726
+ */
727
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
654
728
  }
655
729
  /**
656
730
  * @public
@@ -836,13 +910,8 @@ export interface OntapFileSystemConfiguration {
836
910
  */
837
911
  ThroughputCapacity?: number | undefined;
838
912
  /**
839
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
840
- * <p>
841
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
842
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
843
- * <p>
844
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
845
- * the zero-padded minute of the hour. </p>
913
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
914
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
846
915
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
847
916
  * @public
848
917
  */
@@ -929,7 +998,7 @@ export declare const OpenZFSReadCacheSizingMode: {
929
998
  export type OpenZFSReadCacheSizingMode = (typeof OpenZFSReadCacheSizingMode)[keyof typeof OpenZFSReadCacheSizingMode];
930
999
  /**
931
1000
  * <p>
932
- * The configuration for the optional provisioned SSD read cache on file systems that use the Intelligent-Tiering storage class.
1001
+ * The configuration for the optional provisioned SSD read cache on Amazon FSx for OpenZFS file systems that use the Intelligent-Tiering storage class.
933
1002
  * </p>
934
1003
  * @public
935
1004
  */
@@ -1013,13 +1082,8 @@ export interface OpenZFSFileSystemConfiguration {
1013
1082
  */
1014
1083
  ThroughputCapacity?: number | undefined;
1015
1084
  /**
1016
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
1017
- * <p>
1018
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
1019
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
1020
- * <p>
1021
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
1022
- * the zero-padded minute of the hour. </p>
1085
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
1086
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
1023
1087
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
1024
1088
  * @public
1025
1089
  */
@@ -2963,7 +3027,7 @@ export declare const ServiceLimit: {
2963
3027
  export type ServiceLimit = (typeof ServiceLimit)[keyof typeof ServiceLimit];
2964
3028
  /**
2965
3029
  * <p>An error indicating that a particular service limit was exceeded. You can increase
2966
- * some service limits by contacting Amazon Web Services Support.</p>
3030
+ * some service limits by contacting Amazon Web ServicesSupport.</p>
2967
3031
  * @public
2968
3032
  */
2969
3033
  export declare class ServiceLimitExceeded extends __BaseException {
@@ -3337,7 +3401,7 @@ export interface NFSDataRepositoryConfiguration {
3337
3401
  * </ul>
3338
3402
  * <p>Data repository associations are supported on Amazon File Cache resources and
3339
3403
  * all FSx for Lustre 2.12 and 2.15 file systems, excluding
3340
- * <code>scratch_1</code> deployment type.</p>
3404
+ * Intelligent-Tiering and <code>scratch_1</code> file systems.</p>
3341
3405
  * @public
3342
3406
  */
3343
3407
  export interface DataRepositoryAssociation {
@@ -4221,13 +4285,8 @@ export interface CreateFileCacheLustreConfiguration {
4221
4285
  */
4222
4286
  DeploymentType: FileCacheLustreDeploymentType | undefined;
4223
4287
  /**
4224
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
4225
- * <p>
4226
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
4227
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
4228
- * <p>
4229
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
4230
- * the zero-padded minute of the hour. </p>
4288
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
4289
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
4231
4290
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
4232
4291
  * @public
4233
4292
  */
@@ -4385,13 +4444,8 @@ export interface FileCacheLustreConfiguration {
4385
4444
  */
4386
4445
  MountName?: string | undefined;
4387
4446
  /**
4388
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
4389
- * <p>
4390
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
4391
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
4392
- * <p>
4393
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
4394
- * the zero-padded minute of the hour. </p>
4447
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
4448
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
4395
4449
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
4396
4450
  * @public
4397
4451
  */
@@ -4698,11 +4752,21 @@ export interface CreateFileSystemLustreMetadataConfiguration {
4698
4752
  /**
4699
4753
  * <p>(USER_PROVISIONED mode only) Specifies the number of Metadata IOPS to provision
4700
4754
  * for the file system. This parameter sets the maximum rate of metadata disk IOPS
4701
- * supported by the file system. Valid values are <code>1500</code>, <code>3000</code>,
4702
- * <code>6000</code>, <code>12000</code>, and multiples of <code>12000</code>
4703
- * up to a maximum of <code>192000</code>.</p>
4755
+ * supported by the file system.</p>
4756
+ * <ul>
4757
+ * <li>
4758
+ * <p>For SSD file systems, valid values are <code>1500</code>,
4759
+ * <code>3000</code>, <code>6000</code>, <code>12000</code>, and
4760
+ * multiples of <code>12000</code> up to a maximum of <code>192000</code>.</p>
4761
+ * </li>
4762
+ * <li>
4763
+ * <p>For Intelligent-Tiering file systems, valid values are <code>6000</code>
4764
+ * and <code>12000</code>.</p>
4765
+ * </li>
4766
+ * </ul>
4704
4767
  * <note>
4705
- * <p>Iops doesn’t have a default value. If you're using USER_PROVISIONED mode,
4768
+ * <p>
4769
+ * <code>Iops</code> doesn’t have a default value. If you're using USER_PROVISIONED mode,
4706
4770
  * you can choose to specify a valid value. If you're using AUTOMATIC mode,
4707
4771
  * you cannot specify a value because FSx for Lustre automatically sets
4708
4772
  * the value based on your file system storage capacity.
@@ -4717,8 +4781,9 @@ export interface CreateFileSystemLustreMetadataConfiguration {
4717
4781
  * deployment type.</p>
4718
4782
  * <ul>
4719
4783
  * <li>
4720
- * <p>In AUTOMATIC mode, FSx for Lustre automatically
4721
- * provisions and scales the number of Metadata IOPS for your file system
4784
+ * <p>In AUTOMATIC mode (supported only on SSD file systems),
4785
+ * FSx for Lustre automatically provisions and scales the
4786
+ * number of Metadata IOPS for your file system
4722
4787
  * based on your file system storage capacity.</p>
4723
4788
  * </li>
4724
4789
  * <li>
@@ -4828,13 +4893,14 @@ export interface CreateFileSystemLustreConfiguration {
4828
4893
  * Amazon Web Services Regions in which FSx for Lustre is available.</p>
4829
4894
  * <p>Choose <code>PERSISTENT_2</code> for longer-term storage and for latency-sensitive workloads
4830
4895
  * that require the highest levels of IOPS/throughput. <code>PERSISTENT_2</code> supports
4831
- * SSD storage, and offers higher <code>PerUnitStorageThroughput</code> (up to 1000 MB/s/TiB).
4896
+ * the SSD and Intelligent-Tiering storage classes.
4832
4897
  * You can optionally specify a metadata configuration mode for <code>PERSISTENT_2</code>
4833
4898
  * which supports increasing metadata performance. <code>PERSISTENT_2</code> is available
4834
4899
  * in a limited number of Amazon Web Services Regions. For more information, and an up-to-date
4835
4900
  * list of Amazon Web Services Regions in which <code>PERSISTENT_2</code> is available, see
4836
- * <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types">File
4837
- * system deployment options for FSx for Lustre</a> in the <i>Amazon FSx for Lustre User Guide</i>.</p>
4901
+ * <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html">Deployment and
4902
+ * storage class options for FSx for Lustre file systems</a> in
4903
+ * the <i>Amazon FSx for Lustre User Guide</i>.</p>
4838
4904
  * <note>
4839
4905
  * <p>If you choose <code>PERSISTENT_2</code>, and you set <code>FileSystemTypeVersion</code> to
4840
4906
  * <code>2.10</code>, the <code>CreateFileSystem</code> operation fails.</p>
@@ -4892,7 +4958,7 @@ export interface CreateFileSystemLustreConfiguration {
4892
4958
  AutoImportPolicy?: AutoImportPolicyType | undefined;
4893
4959
  /**
4894
4960
  * <p>Required with <code>PERSISTENT_1</code> and <code>PERSISTENT_2</code> deployment
4895
- * types, provisions the amount of read and write throughput for each 1 tebibyte (TiB) of
4961
+ * types using an SSD or HDD storage class, provisions the amount of read and write throughput for each 1 tebibyte (TiB) of
4896
4962
  * file system storage capacity, in MB/s/TiB. File system throughput capacity is calculated
4897
4963
  * by multiplying file system storage capacity (TiB) by the
4898
4964
  * <code>PerUnitStorageThroughput</code> (MB/s/TiB). For a 2.4-TiB file system,
@@ -5000,6 +5066,20 @@ export interface CreateFileSystemLustreConfiguration {
5000
5066
  * @public
5001
5067
  */
5002
5068
  MetadataConfiguration?: CreateFileSystemLustreMetadataConfiguration | undefined;
5069
+ /**
5070
+ * <p>Specifies the throughput of an FSx for Lustre file system using the Intelligent-Tiering storage class,
5071
+ * measured in megabytes per second (MBps). Valid values are 4000 MBps or
5072
+ * multiples of 4000 MBps. You pay for the amount of throughput that you provision.</p>
5073
+ * @public
5074
+ */
5075
+ ThroughputCapacity?: number | undefined;
5076
+ /**
5077
+ * <p>Specifies the optional provisioned SSD read cache on FSx for Lustre file systems that
5078
+ * use the Intelligent-Tiering storage class. Required when <code>StorageType</code> is set
5079
+ * to <code>INTELLIGENT_TIERING</code>.</p>
5080
+ * @public
5081
+ */
5082
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
5003
5083
  }
5004
5084
  /**
5005
5085
  * <p>The ONTAP configuration properties of the FSx for ONTAP file system that you
@@ -5111,13 +5191,8 @@ export interface CreateFileSystemOntapConfiguration {
5111
5191
  */
5112
5192
  ThroughputCapacity?: number | undefined;
5113
5193
  /**
5114
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
5115
- * <p>
5116
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
5117
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
5118
- * <p>
5119
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
5120
- * the zero-padded minute of the hour. </p>
5194
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
5195
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
5121
5196
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
5122
5197
  * @public
5123
5198
  */
@@ -5314,7 +5389,7 @@ export interface CreateFileSystemOpenZFSConfiguration {
5314
5389
  */
5315
5390
  DeploymentType: OpenZFSDeploymentType | undefined;
5316
5391
  /**
5317
- * <p>Specifies the throughput of an Amazon FSx for OpenZFS file system, measured in megabytes per second (MBps). Valid values depend on the DeploymentType you choose, as follows:</p>
5392
+ * <p>Specifies the throughput of an Amazon FSx for OpenZFS file system, measured in megabytes per second (MBps). Valid values depend on the <code>DeploymentType</code> that you choose, as follows:</p>
5318
5393
  * <ul>
5319
5394
  * <li>
5320
5395
  * <p>For <code>MULTI_AZ_1</code> and <code>SINGLE_AZ_2</code>, valid values are 160, 320, 640,
@@ -5329,13 +5404,8 @@ export interface CreateFileSystemOpenZFSConfiguration {
5329
5404
  */
5330
5405
  ThroughputCapacity: number | undefined;
5331
5406
  /**
5332
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
5333
- * <p>
5334
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
5335
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
5336
- * <p>
5337
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
5338
- * the zero-padded minute of the hour. </p>
5407
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
5408
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
5339
5409
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
5340
5410
  * @public
5341
5411
  */
@@ -5364,7 +5434,7 @@ export interface CreateFileSystemOpenZFSConfiguration {
5364
5434
  * file system will be created. By default in the Amazon FSx API and Amazon FSx console, Amazon FSx
5365
5435
  * selects an available /28 IP address range for you from one of the VPC's CIDR ranges.
5366
5436
  * You can have overlapping endpoint IP addresses for file systems deployed in the
5367
- * same VPC/route tables.</p>
5437
+ * same VPC/route tables, as long as they don't overlap with any subnet.</p>
5368
5438
  * @public
5369
5439
  */
5370
5440
  EndpointIpAddressRange?: string | undefined;
@@ -5744,20 +5814,21 @@ export interface CreateFileSystemRequest {
5744
5814
  * Lustre, ONTAP, and OpenZFS deployment types.</p>
5745
5815
  * </li>
5746
5816
  * <li>
5747
- * <p>Set to <code>HDD</code> to use hard disk drive storage.
5748
- * HDD is supported on <code>SINGLE_AZ_2</code> and <code>MULTI_AZ_1</code> Windows file system deployment types,
5817
+ * <p>Set to <code>HDD</code> to use hard disk drive storage, which is supported on
5818
+ * <code>SINGLE_AZ_2</code> and <code>MULTI_AZ_1</code> Windows file system deployment types,
5749
5819
  * and on <code>PERSISTENT_1</code> Lustre file system deployment types.</p>
5750
5820
  * </li>
5751
5821
  * <li>
5752
- * <p>Set to <code>INTELLIGENT_TIERING</code> to use fully elastic, intelligently-tiered storage. Intelligent-Tiering is only available for OpenZFS file systems with the Multi-AZ deployment type.</p>
5822
+ * <p>Set to <code>INTELLIGENT_TIERING</code> to use fully elastic, intelligently-tiered storage.
5823
+ * Intelligent-Tiering is only available for OpenZFS file systems with the Multi-AZ deployment type
5824
+ * and for Lustre file systems with the Persistent_2 deployment type.</p>
5753
5825
  * </li>
5754
5826
  * </ul>
5755
5827
  * <p>Default value is <code>SSD</code>. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/optimize-fsx-costs.html#storage-type-options"> Storage
5756
5828
  * type options</a> in the <i>FSx for Windows File Server User
5757
- * Guide</i>, <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/what-is.html#storage-options">Multiple storage
5758
- * options</a> in the <i>FSx for Lustre User
5759
- * Guide</i>, and <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance-intelligent-tiering">Working with Intelligent-Tiering</a> in the <i>Amazon FSx for OpenZFS User
5760
- * Guide</i>. </p>
5829
+ * Guide</i>, <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/lustre-storage-classes">FSx for Lustre storage classes</a>
5830
+ * in the <i>FSx for Lustre User Guide</i>, and <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance-intelligent-tiering">Working with Intelligent-Tiering</a>
5831
+ * in the <i>Amazon FSx for OpenZFS User Guide</i>.</p>
5761
5832
  * @public
5762
5833
  */
5763
5834
  StorageType?: StorageType | undefined;
@@ -6038,8 +6109,8 @@ export interface CreateFileSystemFromBackupRequest {
6038
6109
  */
6039
6110
  LustreConfiguration?: CreateFileSystemLustreConfiguration | undefined;
6040
6111
  /**
6041
- * <p>Sets the storage type for the Windows or OpenZFS file system that you're creating from
6042
- * a backup. Valid values are <code>SSD</code> and <code>HDD</code>.</p>
6112
+ * <p>Sets the storage type for the Windows, OpenZFS, or Lustre file system that you're creating from
6113
+ * a backup. Valid values are <code>SSD</code>, <code>HDD</code>, and <code>INTELLIGENT_TIERING</code>.</p>
6043
6114
  * <ul>
6044
6115
  * <li>
6045
6116
  * <p>Set to <code>SSD</code> to use solid state drive storage. SSD is supported on all Windows and OpenZFS
@@ -6049,6 +6120,11 @@ export interface CreateFileSystemFromBackupRequest {
6049
6120
  * <p>Set to <code>HDD</code> to use hard disk drive storage.
6050
6121
  * HDD is supported on <code>SINGLE_AZ_2</code> and <code>MULTI_AZ_1</code> FSx for Windows File Server file system deployment types.</p>
6051
6122
  * </li>
6123
+ * <li>
6124
+ * <p>Set to <code>INTELLIGENT_TIERING</code> to use fully elastic, intelligently-tiered storage.
6125
+ * Intelligent-Tiering is only available for OpenZFS file systems with the Multi-AZ deployment type
6126
+ * and for Lustre file systems with the Persistent_2 deployment type.</p>
6127
+ * </li>
6052
6128
  * </ul>
6053
6129
  * <p> The default value is <code>SSD</code>. </p>
6054
6130
  * <note>
@@ -6836,11 +6912,9 @@ export interface CreateOpenZFSVolumeConfiguration {
6836
6912
  DataCompressionType?: OpenZFSDataCompressionType | undefined;
6837
6913
  /**
6838
6914
  * <p>A Boolean value indicating whether tags for the volume should be copied to snapshots.
6839
- * This value defaults to <code>false</code>. If it's set to <code>true</code>, all tags
6840
- * for the volume are copied to snapshots where the user doesn't specify tags. If this
6841
- * value is <code>true</code>, and you specify one or more tags, only the specified tags
6842
- * are copied to snapshots. If you specify one or more tags when creating the snapshot, no
6843
- * tags are copied from the volume, regardless of this value.</p>
6915
+ * This value defaults to <code>false</code>. If this value is set to <code>true</code>, and you do not specify any tags, all tags for the original volume are copied over to snapshots.
6916
+ * If this value is set to <code>true</code>, and you do specify one or more tags, only the specified tags for the original volume are copied over to snapshots. If you specify one or more tags when creating a new snapshot, no tags are copied over from the original volume, regardless of this value.
6917
+ * </p>
6844
6918
  * @public
6845
6919
  */
6846
6920
  CopyTagsToSnapshots?: boolean | undefined;
@@ -8586,13 +8660,8 @@ export interface UpdateDataRepositoryAssociationResponse {
8586
8660
  */
8587
8661
  export interface UpdateFileCacheLustreConfiguration {
8588
8662
  /**
8589
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
8590
- * <p>
8591
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
8592
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
8593
- * <p>
8594
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
8595
- * the zero-padded minute of the hour. </p>
8663
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
8664
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
8596
8665
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
8597
8666
  * @public
8598
8667
  */
@@ -8642,9 +8711,18 @@ export interface UpdateFileCacheResponse {
8642
8711
  export interface UpdateFileSystemLustreMetadataConfiguration {
8643
8712
  /**
8644
8713
  * <p>(USER_PROVISIONED mode only) Specifies the number of Metadata IOPS to provision
8645
- * for your file system. Valid values are <code>1500</code>, <code>3000</code>,
8646
- * <code>6000</code>, <code>12000</code>, and multiples of <code>12000</code>
8647
- * up to a maximum of <code>192000</code>.</p>
8714
+ * for your file system.</p>
8715
+ * <ul>
8716
+ * <li>
8717
+ * <p>For SSD file systems, valid values are <code>1500</code>,
8718
+ * <code>3000</code>, <code>6000</code>, <code>12000</code>, and
8719
+ * multiples of <code>12000</code> up to a maximum of <code>192000</code>.</p>
8720
+ * </li>
8721
+ * <li>
8722
+ * <p>For Intelligent-Tiering file systems, valid values are <code>6000</code>
8723
+ * and <code>12000</code>.</p>
8724
+ * </li>
8725
+ * </ul>
8648
8726
  * <p>The value you provide must be greater than or equal to the current number of
8649
8727
  * Metadata IOPS provisioned for the file system.</p>
8650
8728
  * @public
@@ -8656,19 +8734,28 @@ export interface UpdateFileSystemLustreMetadataConfiguration {
8656
8734
  * deployment type.</p>
8657
8735
  * <ul>
8658
8736
  * <li>
8659
- * <p>To increase the Metadata IOPS or to switch from AUTOMATIC mode,
8737
+ * <p>To increase the Metadata IOPS or to switch an SSD file system from
8738
+ * AUTOMATIC,
8660
8739
  * specify <code>USER_PROVISIONED</code> as the value for this parameter. Then use the
8661
8740
  * Iops parameter to provide a Metadata IOPS value that is greater than or equal to
8662
8741
  * the current number of Metadata IOPS provisioned for the file system.</p>
8663
8742
  * </li>
8664
8743
  * <li>
8665
- * <p>To switch from USER_PROVISIONED mode, specify
8744
+ * <p>To switch from USER_PROVISIONED mode on an SSD file system, specify
8666
8745
  * <code>AUTOMATIC</code> as the value for this parameter, but do not input a value
8667
8746
  * for Iops.</p>
8668
8747
  * <note>
8669
- * <p>If you request to switch from USER_PROVISIONED to AUTOMATIC mode and the
8670
- * current Metadata IOPS value is greater than the automated default, FSx for Lustre
8671
- * rejects the request because downscaling Metadata IOPS is not supported.</p>
8748
+ * <ul>
8749
+ * <li>
8750
+ * <p>If you request to switch from USER_PROVISIONED to AUTOMATIC mode and the
8751
+ * current Metadata IOPS value is greater than the automated default, FSx for Lustre
8752
+ * rejects the request because downscaling Metadata IOPS is not supported.</p>
8753
+ * </li>
8754
+ * <li>
8755
+ * <p>AUTOMATIC mode is not supported on Intelligent-Tiering
8756
+ * file systems. For Intelligent-Tiering file systems, use USER_PROVISIONED mode.</p>
8757
+ * </li>
8758
+ * </ul>
8672
8759
  * </note>
8673
8760
  * </li>
8674
8761
  * </ul>
@@ -8802,6 +8889,19 @@ export interface UpdateFileSystemLustreConfiguration {
8802
8889
  * @public
8803
8890
  */
8804
8891
  MetadataConfiguration?: UpdateFileSystemLustreMetadataConfiguration | undefined;
8892
+ /**
8893
+ * <p>The throughput of an Amazon FSx for Lustre file system using an Intelligent-Tiering
8894
+ * storage class, measured in megabytes per second (MBps). You can only increase your file
8895
+ * system's throughput. Valid values are 4000 MBps or multiples of 4000 MBps.</p>
8896
+ * @public
8897
+ */
8898
+ ThroughputCapacity?: number | undefined;
8899
+ /**
8900
+ * <p>Specifies the optional provisioned SSD read cache on Amazon FSx for Lustre file systems that
8901
+ * use the Intelligent-Tiering storage class.</p>
8902
+ * @public
8903
+ */
8904
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
8805
8905
  }
8806
8906
  /**
8807
8907
  * <p>The configuration updates for an Amazon FSx for NetApp ONTAP file system.</p>
@@ -8831,13 +8931,8 @@ export interface UpdateFileSystemOntapConfiguration {
8831
8931
  */
8832
8932
  FsxAdminPassword?: string | undefined;
8833
8933
  /**
8834
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
8835
- * <p>
8836
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
8837
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
8838
- * <p>
8839
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
8840
- * the zero-padded minute of the hour. </p>
8934
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
8935
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
8841
8936
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
8842
8937
  * @public
8843
8938
  */
@@ -8979,13 +9074,8 @@ export interface UpdateFileSystemOpenZFSConfiguration {
8979
9074
  */
8980
9075
  ThroughputCapacity?: number | undefined;
8981
9076
  /**
8982
- * <p>A recurring weekly time, in the format <code>D:HH:MM</code>. </p>
8983
- * <p>
8984
- * <code>D</code> is the day of the week, for which 1 represents Monday and 7
8985
- * represents Sunday. For further details, see <a href="https://en.wikipedia.org/wiki/ISO_week_date">the ISO-8601 spec as described on Wikipedia</a>.</p>
8986
- * <p>
8987
- * <code>HH</code> is the zero-padded hour of the day (0-23), and <code>MM</code> is
8988
- * the zero-padded minute of the hour. </p>
9077
+ * <p>The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC
9078
+ * time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.</p>
8989
9079
  * <p>For example, <code>1:05:00</code> specifies maintenance at 5 AM Monday.</p>
8990
9080
  * @public
8991
9081
  */
@@ -9864,10 +9954,19 @@ export interface FileSystem {
9864
9954
  */
9865
9955
  StorageCapacity?: number | undefined;
9866
9956
  /**
9867
- * <p>The type of storage the file system is using.
9868
- * If set to <code>SSD</code>, the file system uses solid state drive storage.
9869
- * If set to <code>HDD</code>, the file system uses hard disk drive storage.
9870
- * </p>
9957
+ * <p>The type of storage the file system is using.</p>
9958
+ * <ul>
9959
+ * <li>
9960
+ * <p>If set to <code>SSD</code>, the file system uses solid state drive storage.</p>
9961
+ * </li>
9962
+ * <li>
9963
+ * <p>If set to <code>HDD</code>, the file system uses hard disk drive storage.</p>
9964
+ * </li>
9965
+ * <li>
9966
+ * <p>If set to <code>INTELLIGENT_TIERING</code>, the file system uses fully elastic,
9967
+ * intelligently-tiered storage.</p>
9968
+ * </li>
9969
+ * </ul>
9871
9970
  * @public
9872
9971
  */
9873
9972
  StorageType?: StorageType | undefined;
@@ -82,6 +82,17 @@ export declare const DataCompressionType: {
82
82
  };
83
83
  export type DataCompressionType =
84
84
  (typeof DataCompressionType)[keyof typeof DataCompressionType];
85
+ export declare const LustreReadCacheSizingMode: {
86
+ readonly NO_CACHE: "NO_CACHE";
87
+ readonly PROPORTIONAL_TO_THROUGHPUT_CAPACITY: "PROPORTIONAL_TO_THROUGHPUT_CAPACITY";
88
+ readonly USER_PROVISIONED: "USER_PROVISIONED";
89
+ };
90
+ export type LustreReadCacheSizingMode =
91
+ (typeof LustreReadCacheSizingMode)[keyof typeof LustreReadCacheSizingMode];
92
+ export interface LustreReadCacheConfiguration {
93
+ SizingMode?: LustreReadCacheSizingMode | undefined;
94
+ SizeGiB?: number | undefined;
95
+ }
85
96
  export declare const AutoImportPolicyType: {
86
97
  readonly NEW: "NEW";
87
98
  readonly NEW_CHANGED: "NEW_CHANGED";
@@ -166,6 +177,8 @@ export interface LustreFileSystemConfiguration {
166
177
  RootSquashConfiguration?: LustreRootSquashConfiguration | undefined;
167
178
  MetadataConfiguration?: FileSystemLustreMetadataConfiguration | undefined;
168
179
  EfaEnabled?: boolean | undefined;
180
+ ThroughputCapacity?: number | undefined;
181
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
169
182
  }
170
183
  export declare const OntapDeploymentType: {
171
184
  readonly MULTI_AZ_1: "MULTI_AZ_1";
@@ -1007,6 +1020,8 @@ export interface CreateFileSystemLustreConfiguration {
1007
1020
  MetadataConfiguration?:
1008
1021
  | CreateFileSystemLustreMetadataConfiguration
1009
1022
  | undefined;
1023
+ ThroughputCapacity?: number | undefined;
1024
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
1010
1025
  }
1011
1026
  export interface CreateFileSystemOntapConfiguration {
1012
1027
  AutomaticBackupRetentionDays?: number | undefined;
@@ -1706,6 +1721,8 @@ export interface UpdateFileSystemLustreConfiguration {
1706
1721
  MetadataConfiguration?:
1707
1722
  | UpdateFileSystemLustreMetadataConfiguration
1708
1723
  | undefined;
1724
+ ThroughputCapacity?: number | undefined;
1725
+ DataReadCacheConfiguration?: LustreReadCacheConfiguration | undefined;
1709
1726
  }
1710
1727
  export interface UpdateFileSystemOntapConfiguration {
1711
1728
  AutomaticBackupRetentionDays?: number | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-fsx",
3
3
  "description": "AWS SDK for JavaScript Fsx Client for Node.js, Browser and React Native",
4
- "version": "3.816.0",
4
+ "version": "3.820.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-fsx",
@@ -21,7 +21,7 @@
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
23
  "@aws-sdk/core": "3.816.0",
24
- "@aws-sdk/credential-provider-node": "3.816.0",
24
+ "@aws-sdk/credential-provider-node": "3.817.0",
25
25
  "@aws-sdk/middleware-host-header": "3.804.0",
26
26
  "@aws-sdk/middleware-logger": "3.804.0",
27
27
  "@aws-sdk/middleware-recursion-detection": "3.804.0",