@aws-sdk/client-fsx 3.699.0 → 3.703.0

package/dist-types/models/models_0.d.ts

@@ -645,6 +645,12 @@ export interface LustreFileSystemConfiguration {
      * @public
      */
     MetadataConfiguration?: FileSystemLustreMetadataConfiguration | undefined;
+    /**
+     * <p>Specifies whether Elastic Fabric Adapter (EFA) and GPUDirect Storage (GDS)
+     *             support is enabled for the Amazon FSx for Lustre file system.</p>
+     * @public
+     */
+    EfaEnabled?: boolean | undefined;
 }
 /**
  * @public
@@ -908,6 +914,52 @@ export declare const OpenZFSDeploymentType: {
  * @public
  */
 export type OpenZFSDeploymentType = (typeof OpenZFSDeploymentType)[keyof typeof OpenZFSDeploymentType];
+/**
+ * @public
+ * @enum
+ */
+export declare const OpenZFSReadCacheSizingMode: {
+    readonly NO_CACHE: "NO_CACHE";
+    readonly PROPORTIONAL_TO_THROUGHPUT_CAPACITY: "PROPORTIONAL_TO_THROUGHPUT_CAPACITY";
+    readonly USER_PROVISIONED: "USER_PROVISIONED";
+};
+/**
+ * @public
+ */
+export type OpenZFSReadCacheSizingMode = (typeof OpenZFSReadCacheSizingMode)[keyof typeof OpenZFSReadCacheSizingMode];
+/**
+ * <p>
+ *             The configuration for the optional provisioned SSD read cache on file systems that use the Intelligent-Tiering storage class.
+ *         </p>
+ * @public
+ */
+export interface OpenZFSReadCacheConfiguration {
+    /**
+     * <p>
+     *             Specifies how the provisioned SSD read cache is sized, as follows:
+     *         </p>
+     *          <ul>
+     *             <li>
+     *                <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>
+     *             </li>
+     *             <li>
+     *                <p>Set to <code>USER_PROVISIONED</code> to specify the exact size of your SSD read cache.</p>
+     *             </li>
+     *             <li>
+     *                <p>Set to <code>PROPORTIONAL_TO_THROUGHPUT_CAPACITY</code> to have your SSD read cache automatically sized based on your throughput capacity.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    SizingMode?: OpenZFSReadCacheSizingMode | undefined;
+    /**
+     * <p>
+     *             Required if <code>SizingMode</code> is set to <code>USER_PROVISIONED</code>. Specifies the size of the file system's SSD read cache, in gibibytes (GiB).
+     *         </p>
+     * @public
+     */
+    SizeGiB?: number | undefined;
+}
 /**
  * <p>The configuration for the Amazon FSx for OpenZFS file system. </p>
  * @public
@@ -1012,6 +1064,12 @@ export interface OpenZFSFileSystemConfiguration {
      * @public
      */
     EndpointIpAddress?: string | undefined;
+    /**
+     * <p>
+     *             Required when <code>StorageType</code> is set to <code>INTELLIGENT_TIERING</code>. Specifies the optional provisioned SSD read cache. </p>
+     * @public
+     */
+    ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 /**
  * @public
@@ -1019,6 +1077,7 @@ export interface OpenZFSFileSystemConfiguration {
  */
 export declare const StorageType: {
     readonly HDD: "HDD";
+    readonly INTELLIGENT_TIERING: "INTELLIGENT_TIERING";
     readonly SSD: "SSD";
 };
 /**
@@ -4913,6 +4972,13 @@ export interface CreateFileSystemLustreConfiguration {
      * @public
      */
     DataCompressionType?: DataCompressionType | undefined;
+    /**
+     * <p>(Optional) Specifies whether Elastic Fabric Adapter (EFA) and GPUDirect Storage (GDS)
+     *             support is enabled for the Amazon FSx for Lustre file system.</p>
+     *          <p>(Default = <code>false</code>)</p>
+     * @public
+     */
+    EfaEnabled?: boolean | undefined;
     /**
      * <p>The Lustre logging configuration used when creating an Amazon FSx for Lustre
      *             file system. When logging is enabled, Lustre logs error and warning events for data repositories
@@ -5310,6 +5376,13 @@ export interface CreateFileSystemOpenZFSConfiguration {
      * @public
      */
     RouteTableIds?: string[] | undefined;
+    /**
+     * <p>
+     *             Specifies the optional provisioned SSD read cache on file systems that use the Intelligent-Tiering storage class.
+     *         </p>
+     * @public
+     */
+    ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 /**
  * <p>The Windows file access auditing configuration used when creating
@@ -5661,10 +5734,10 @@ export interface CreateFileSystemRequest {
      *          </ul>
      * @public
      */
-    StorageCapacity: number | undefined;
+    StorageCapacity?: number | undefined;
     /**
-     * <p>Sets the storage type for the file system that you're creating. Valid values are
-     *                 <code>SSD</code> and <code>HDD</code>.</p>
+     * <p>Sets the storage class for the file system that you're creating. Valid values are
+     *                 <code>SSD</code>, <code>HDD</code>, and <code>INTELLIGENT_TIERING</code>.</p>
      *          <ul>
      *             <li>
      *                <p>Set to <code>SSD</code> to use solid state drive storage. SSD is supported on all Windows,
@@ -5675,12 +5748,16 @@ export interface CreateFileSystemRequest {
      *                 HDD is supported on <code>SINGLE_AZ_2</code> and <code>MULTI_AZ_1</code> Windows file system deployment types,
      *                 and on <code>PERSISTENT_1</code> Lustre file system deployment types.</p>
      *             </li>
+     *             <li>
+     *                <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>
+     *             </li>
      *          </ul>
      *          <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
      *                 type options</a> in the <i>FSx for Windows File Server User
-     *                 Guide</i> and <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/what-is.html#storage-options">Multiple storage
+     *                 Guide</i>, <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/what-is.html#storage-options">Multiple storage
      *                 options</a> in the <i>FSx for Lustre User
-     *             Guide</i>. </p>
+     *                     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
+     *                             Guide</i>. </p>
      * @public
      */
     StorageType?: StorageType | undefined;
@@ -6720,14 +6797,11 @@ export interface CreateOpenZFSVolumeConfiguration {
      */
     StorageCapacityQuotaGiB?: number | undefined;
     /**
-     * <p>Specifies the suggested block size for a volume in a ZFS dataset, in kibibytes (KiB). Valid values are 4, 8,
-     *             16, 32, 64, 128, 256, 512, or 1024 KiB. The default is 128 KiB.
-     *             We recommend using the default setting for the majority of use cases.
-     *             Generally, workloads that write in fixed small or large record sizes
-     *             may benefit from setting a custom record size, like database workloads
-     *             (small record size) or media streaming workloads (large record size).
-     *             For additional guidance on when
-     *             to set a custom record size, see
+     * <p>Specifies the suggested block size for a volume in a ZFS dataset, in kibibytes (KiB).
+     *             For file systems using the Intelligent-Tiering storage class, valid values are 128, 256, 512, 1024, 2048, or 4096 KiB, with a default of 2048 KiB.
+     *             For all other file systems, valid values are 4, 8, 16, 32, 64, 128, 256, 512, or 1024 KiB, with a default of 128 KiB.
+     *             We recommend using the default setting for the majority of use cases. Generally, workloads that write in fixed small or large record sizes may benefit from setting a custom record size, like database workloads (small record size) or media streaming workloads (large record size).
+     *             For additional guidance on when to set a custom record size, see
      *             <a href="https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance.html#record-size-performance">
      *             ZFS Record size</a> in the <i>Amazon FSx for OpenZFS User Guide</i>.</p>
      * @public
@@ -8939,6 +9013,12 @@ export interface UpdateFileSystemOpenZFSConfiguration {
      * @public
      */
     RemoveRouteTableIds?: string[] | undefined;
+    /**
+     * <p>
+     *             The configuration for the optional provisioned SSD read cache on file systems that use the Intelligent-Tiering storage class.</p>
+     * @public
+     */
+    ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 /**
  * <p>Specifies changes you are making to the self-managed Microsoft Active Directory configuration to which
@@ -10398,6 +10478,13 @@ export interface Backup {
      * @public
      */
     Volume?: Volume | undefined;
+    /**
+     * <p>
+     *             The size of the backup in bytes. This represents the amount of data that the file system would contain if you restore this backup.
+     *         </p>
+     * @public
+     */
+    SizeInBytes?: number | undefined;
 }
 /**
  * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -165,6 +165,7 @@ export interface LustreFileSystemConfiguration {
   LogConfiguration?: LustreLogConfiguration | undefined;
   RootSquashConfiguration?: LustreRootSquashConfiguration | undefined;
   MetadataConfiguration?: FileSystemLustreMetadataConfiguration | undefined;
+  EfaEnabled?: boolean | undefined;
 }
 export declare const OntapDeploymentType: {
   readonly MULTI_AZ_1: "MULTI_AZ_1";
@@ -216,6 +217,17 @@ export declare const OpenZFSDeploymentType: {
 };
 export type OpenZFSDeploymentType =
   (typeof OpenZFSDeploymentType)[keyof typeof OpenZFSDeploymentType];
+export declare const OpenZFSReadCacheSizingMode: {
+  readonly NO_CACHE: "NO_CACHE";
+  readonly PROPORTIONAL_TO_THROUGHPUT_CAPACITY: "PROPORTIONAL_TO_THROUGHPUT_CAPACITY";
+  readonly USER_PROVISIONED: "USER_PROVISIONED";
+};
+export type OpenZFSReadCacheSizingMode =
+  (typeof OpenZFSReadCacheSizingMode)[keyof typeof OpenZFSReadCacheSizingMode];
+export interface OpenZFSReadCacheConfiguration {
+  SizingMode?: OpenZFSReadCacheSizingMode | undefined;
+  SizeGiB?: number | undefined;
+}
 export interface OpenZFSFileSystemConfiguration {
   AutomaticBackupRetentionDays?: number | undefined;
   CopyTagsToBackups?: boolean | undefined;
@@ -230,9 +242,11 @@ export interface OpenZFSFileSystemConfiguration {
   EndpointIpAddressRange?: string | undefined;
   RouteTableIds?: string[] | undefined;
   EndpointIpAddress?: string | undefined;
+  ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 export declare const StorageType: {
   readonly HDD: "HDD";
+  readonly INTELLIGENT_TIERING: "INTELLIGENT_TIERING";
   readonly SSD: "SSD";
 };
 export type StorageType = (typeof StorageType)[keyof typeof StorageType];
@@ -987,6 +1001,7 @@ export interface CreateFileSystemLustreConfiguration {
   CopyTagsToBackups?: boolean | undefined;
   DriveCacheType?: DriveCacheType | undefined;
   DataCompressionType?: DataCompressionType | undefined;
+  EfaEnabled?: boolean | undefined;
   LogConfiguration?: LustreLogCreateConfiguration | undefined;
   RootSquashConfiguration?: LustreRootSquashConfiguration | undefined;
   MetadataConfiguration?:
@@ -1028,6 +1043,7 @@ export interface CreateFileSystemOpenZFSConfiguration {
   PreferredSubnetId?: string | undefined;
   EndpointIpAddressRange?: string | undefined;
   RouteTableIds?: string[] | undefined;
+  ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 export interface WindowsAuditLogCreateConfiguration {
   FileAccessAuditLogLevel: WindowsAccessAuditLogLevel | undefined;
@@ -1061,7 +1077,7 @@ export interface CreateFileSystemWindowsConfiguration {
 export interface CreateFileSystemRequest {
   ClientRequestToken?: string | undefined;
   FileSystemType: FileSystemType | undefined;
-  StorageCapacity: number | undefined;
+  StorageCapacity?: number | undefined;
   StorageType?: StorageType | undefined;
   SubnetIds: string[] | undefined;
   SecurityGroupIds?: string[] | undefined;
@@ -1713,6 +1729,7 @@ export interface UpdateFileSystemOpenZFSConfiguration {
   DiskIopsConfiguration?: DiskIopsConfiguration | undefined;
   AddRouteTableIds?: string[] | undefined;
   RemoveRouteTableIds?: string[] | undefined;
+  ReadCacheConfiguration?: OpenZFSReadCacheConfiguration | undefined;
 }
 export interface SelfManagedActiveDirectoryConfigurationUpdates {
   UserName?: string | undefined;
@@ -1935,6 +1952,7 @@ export interface Backup {
   SourceBackupRegion?: string | undefined;
   ResourceType?: ResourceType | undefined;
   Volume?: Volume | undefined;
+  SizeInBytes?: number | undefined;
 }
 export interface CopyBackupResponse {
   Backup?: Backup | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-fsx",
   "description": "AWS SDK for JavaScript Fsx Client for Node.js, Browser and React Native",
-  "version": "3.699.0",
+  "version": "3.703.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-fsx",