aws-sdk-fsx 1.73.0 → 1.75.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.
@@ -79,6 +79,17 @@ module Aws::FSx
79
79
  # initiated from the Amazon FSx console, API (`UpdateFileSystem`),
80
80
  # or CLI (`update-file-system`).
81
81
  #
82
+ # * `THROUGHPUT_OPTIMIZATION` - After the `FILE_SYSTEM_UPDATE` task to
83
+ # increase a file system's throughput capacity has been completed
84
+ # successfully, a `THROUGHPUT_OPTIMIZATION` task starts.
85
+ #
86
+ # You can track the storage-optimization progress using the
87
+ # `ProgressPercent` property. When `THROUGHPUT_OPTIMIZATION` has
88
+ # been completed successfully, the parent `FILE_SYSTEM_UPDATE`
89
+ # action status changes to `COMPLETED`. For more information, see
90
+ # [Managing throughput capacity][1] in the *Amazon FSx for Windows
91
+ # File Server User Guide*.
92
+ #
82
93
  # * `STORAGE_OPTIMIZATION` - After the `FILE_SYSTEM_UPDATE` task to
83
94
  # increase a file system's storage capacity has been completed
84
95
  # successfully, a `STORAGE_OPTIMIZATION` task starts.
@@ -93,20 +104,40 @@ module Aws::FSx
93
104
  # `ProgressPercent` property. When `STORAGE_OPTIMIZATION` has been
94
105
  # completed successfully, the parent `FILE_SYSTEM_UPDATE` action
95
106
  # status changes to `COMPLETED`. For more information, see [Managing
96
- # storage capacity][1] in the *Amazon FSx for Windows File Server
97
- # User Guide*, [Managing storage and throughput capacity][2] in the
107
+ # storage capacity][2] in the *Amazon FSx for Windows File Server
108
+ # User Guide*, [Managing storage and throughput capacity][3] in the
98
109
  # *Amazon FSx for Lustre User Guide*, and [Managing storage capacity
99
- # and provisioned IOPS][3] in the *Amazon FSx for NetApp ONTAP User
110
+ # and provisioned IOPS][4] in the *Amazon FSx for NetApp ONTAP User
100
111
  # Guide*.
101
112
  #
102
113
  # * `FILE_SYSTEM_ALIAS_ASSOCIATION` - A file system update to
103
114
  # associate a new Domain Name System (DNS) alias with the file
104
115
  # system. For more information, see [
105
- # AssociateFileSystemAliases][4].
116
+ # AssociateFileSystemAliases][5].
106
117
  #
107
118
  # * `FILE_SYSTEM_ALIAS_DISASSOCIATION` - A file system update to
108
119
  # disassociate a DNS alias from the file system. For more
109
- # information, see [DisassociateFileSystemAliases][5].
120
+ # information, see [DisassociateFileSystemAliases][6].
121
+ #
122
+ # * `IOPS_OPTIMIZATION` - After the `FILE_SYSTEM_UPDATE` task to
123
+ # increase a file system's throughput capacity has been completed
124
+ # successfully, a `IOPS_OPTIMIZATION` task starts.
125
+ #
126
+ # You can track the storage-optimization progress using the
127
+ # `ProgressPercent` property. When `IOPS_OPTIMIZATION` has been
128
+ # completed successfully, the parent `FILE_SYSTEM_UPDATE` action
129
+ # status changes to `COMPLETED`. For more information, see [Managing
130
+ # provisioned SSD IOPS][7] in the *Amazon FSx for Windows File
131
+ # Server User Guide*.
132
+ #
133
+ # * `STORAGE_TYPE_OPTIMIZATION` - After the `FILE_SYSTEM_UPDATE` task
134
+ # to increase a file system's throughput capacity has been
135
+ # completed successfully, a `STORAGE_TYPE_OPTIMIZATION` task starts.
136
+ #
137
+ # You can track the storage-optimization progress using the
138
+ # `ProgressPercent` property. When `STORAGE_TYPE_OPTIMIZATION` has
139
+ # been completed successfully, the parent `FILE_SYSTEM_UPDATE`
140
+ # action status changes to `COMPLETED`.
110
141
  #
111
142
  # * `VOLUME_UPDATE` - A volume update to an Amazon FSx for NetApp
112
143
  # ONTAP or Amazon FSx for OpenZFS volume initiated from the Amazon
@@ -126,11 +157,13 @@ module Aws::FSx
126
157
  #
127
158
  #
128
159
  #
129
- # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-storage-capacity.html
130
- # [2]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-storage-capacity.html
131
- # [3]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-storage-capacity.html
132
- # [4]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_AssociateFileSystemAliases.html
133
- # [5]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_DisassociateFileSystemAliases.html
160
+ # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-throughput-capacity.html
161
+ # [2]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-storage-capacity.html
162
+ # [3]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-storage-capacity.html
163
+ # [4]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-storage-capacity.html
164
+ # [5]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_AssociateFileSystemAliases.html
165
+ # [6]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_DisassociateFileSystemAliases.html
166
+ # [7]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-provisioned-ssd-iops.html
134
167
  # @return [String]
135
168
  #
136
169
  # @!attribute [rw] progress_percent
@@ -1010,24 +1043,53 @@ module Aws::FSx
1010
1043
 
1011
1044
  # @!attribute [rw] type
1012
1045
  # Specifies the type of data repository task to create.
1046
+ #
1047
+ # * `EXPORT_TO_REPOSITORY` tasks export from your Amazon FSx for
1048
+ # Lustre file system to a linked data repository.
1049
+ #
1050
+ # * `IMPORT_METADATA_FROM_REPOSITORY` tasks import metadata changes
1051
+ # from a linked S3 bucket to your Amazon FSx for Lustre file system.
1052
+ #
1053
+ # * `RELEASE_DATA_FROM_FILESYSTEM` tasks release files in your Amazon
1054
+ # FSx for Lustre file system that have been exported to a linked S3
1055
+ # bucket and that meet your specified release criteria.
1056
+ #
1057
+ # * `AUTO_RELEASE_DATA` tasks automatically release files from an
1058
+ # Amazon File Cache resource.
1013
1059
  # @return [String]
1014
1060
  #
1015
1061
  # @!attribute [rw] paths
1016
1062
  # A list of paths for the data repository task to use when the task is
1017
1063
  # processed. If a path that you provide isn't valid, the task fails.
1018
- #
1019
- # * For export tasks, the list contains paths on the Amazon FSx file
1020
- # system from which the files are exported to the Amazon S3 bucket.
1021
- # The default path is the file system root directory. The paths you
1022
- # provide need to be relative to the mount point of the file system.
1023
- # If the mount point is `/mnt/fsx` and `/mnt/fsx/path1` is a
1024
- # directory or file on the file system you want to export, then the
1025
- # path to provide is `path1`.
1064
+ # If you don't provide paths, the default behavior is to export all
1065
+ # files to S3 (for export tasks), import all files from S3 (for import
1066
+ # tasks), or release all exported files that meet the last accessed
1067
+ # time criteria (for release tasks).
1068
+ #
1069
+ # * For export tasks, the list contains paths on the FSx for Lustre
1070
+ # file system from which the files are exported to the Amazon S3
1071
+ # bucket. The default path is the file system root directory. The
1072
+ # paths you provide need to be relative to the mount point of the
1073
+ # file system. If the mount point is `/mnt/fsx` and `/mnt/fsx/path1`
1074
+ # is a directory or file on the file system you want to export, then
1075
+ # the path to provide is `path1`.
1026
1076
  #
1027
1077
  # * For import tasks, the list contains paths in the Amazon S3 bucket
1028
- # from which POSIX metadata changes are imported to the Amazon FSx
1029
- # file system. The path can be an S3 bucket or prefix in the format
1030
- # `s3://myBucket/myPrefix` (where `myPrefix` is optional).
1078
+ # from which POSIX metadata changes are imported to the FSx for
1079
+ # Lustre file system. The path can be an S3 bucket or prefix in the
1080
+ # format `s3://myBucket/myPrefix` (where `myPrefix` is optional).
1081
+ #
1082
+ # * For release tasks, the list contains directory or file paths on
1083
+ # the FSx for Lustre file system from which to release exported
1084
+ # files. If a directory is specified, files within the directory are
1085
+ # released. If a file path is specified, only that file is released.
1086
+ # To release all exported files in the file system, specify a
1087
+ # forward slash (/) as the path.
1088
+ #
1089
+ # <note markdown="1"> A file must also meet the last accessed time criteria specified in
1090
+ # for the file to be released.
1091
+ #
1092
+ # </note>
1031
1093
  # @return [Array<String>]
1032
1094
  #
1033
1095
  # @!attribute [rw] file_system_id
@@ -1066,6 +1128,12 @@ module Aws::FSx
1066
1128
  # from the cache.
1067
1129
  # @return [Integer]
1068
1130
  #
1131
+ # @!attribute [rw] release_configuration
1132
+ # The configuration that specifies the last accessed time criteria for
1133
+ # files that will be released from an Amazon FSx for Lustre file
1134
+ # system.
1135
+ # @return [Types::ReleaseConfiguration]
1136
+ #
1069
1137
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateDataRepositoryTaskRequest AWS API Documentation
1070
1138
  #
1071
1139
  class CreateDataRepositoryTaskRequest < Struct.new(
@@ -1075,7 +1143,8 @@ module Aws::FSx
1075
1143
  :report,
1076
1144
  :client_request_token,
1077
1145
  :tags,
1078
- :capacity_to_release)
1146
+ :capacity_to_release,
1147
+ :release_configuration)
1079
1148
  SENSITIVE = []
1080
1149
  include Aws::Structure
1081
1150
  end
@@ -1370,7 +1439,8 @@ module Aws::FSx
1370
1439
  #
1371
1440
  # @!attribute [rw] file_system_type_version
1372
1441
  # Sets the version for the Amazon FSx for Lustre file system that
1373
- # you're creating from a backup. Valid values are `2.10` and `2.12`.
1442
+ # you're creating from a backup. Valid values are `2.10`, `2.12`, and
1443
+ # `2.15`.
1374
1444
  #
1375
1445
  # You don't need to specify `FileSystemTypeVersion` because it will
1376
1446
  # be applied using the backup's `FileSystemTypeVersion` setting. If
@@ -1769,11 +1839,11 @@ module Aws::FSx
1769
1839
  # @return [String]
1770
1840
  #
1771
1841
  # @!attribute [rw] route_table_ids
1772
- # (Multi-AZ only) Specifies the virtual private cloud (VPC) route
1773
- # tables in which your file system's endpoints will be created. You
1774
- # should specify all VPC route tables associated with the subnets in
1775
- # which your clients are located. By default, Amazon FSx selects your
1776
- # VPC's default route table.
1842
+ # (Multi-AZ only) Specifies the route tables in which Amazon FSx
1843
+ # creates the rules for routing traffic to the correct file server.
1844
+ # You should specify all virtual private cloud (VPC) route tables
1845
+ # associated with the subnets in which your clients are located. By
1846
+ # default, Amazon FSx selects your VPC's default route table.
1777
1847
  # @return [Array<String>]
1778
1848
  #
1779
1849
  # @!attribute [rw] throughput_capacity
@@ -1857,17 +1927,24 @@ module Aws::FSx
1857
1927
  # Zone in an Amazon Web Services Region . Valid values are the
1858
1928
  # following:
1859
1929
  #
1860
- # * `SINGLE_AZ_1`- (Default) Creates file systems with throughput
1861
- # capacities of 64 - 4,096 MBps. `Single_AZ_1` is available in all
1862
- # Amazon Web Services Regions where Amazon FSx for OpenZFS is
1863
- # available.
1930
+ # * `MULTI_AZ_1`- Creates file systems with high availability that are
1931
+ # configured for Multi-AZ redundancy to tolerate temporary
1932
+ # unavailability in Availability Zones (AZs). `Multi_AZ_1` is
1933
+ # available only in the US East (N. Virginia), US East (Ohio), US
1934
+ # West (Oregon), Asia Pacific (Singapore), Asia Pacific (Tokyo), and
1935
+ # Europe (Ireland) Amazon Web Services Regions.
1936
+ #
1937
+ # * `SINGLE_AZ_1`- Creates file systems with throughput capacities of
1938
+ # 64 - 4,096 MB/s. `Single_AZ_1` is available in all Amazon Web
1939
+ # Services Regions where Amazon FSx for OpenZFS is available.
1864
1940
  #
1865
1941
  # * `SINGLE_AZ_2`- Creates file systems with throughput capacities of
1866
1942
  # 160 - 10,240 MB/s using an NVMe L2ARC cache. `Single_AZ_2` is
1867
1943
  # available only in the US East (N. Virginia), US East (Ohio), US
1868
- # West (Oregon), and Europe (Ireland) Amazon Web Services Regions.
1944
+ # West (Oregon), Asia Pacific (Singapore), Asia Pacific (Tokyo), and
1945
+ # Europe (Ireland) Amazon Web Services Regions.
1869
1946
  #
1870
- # For more information, see: [Deployment type availability][1] and
1947
+ # For more information, see [Deployment type availability][1] and
1871
1948
  # [File system performance][2] in the *Amazon FSx for OpenZFS User
1872
1949
  # Guide*.
1873
1950
  #
@@ -1882,12 +1959,12 @@ module Aws::FSx
1882
1959
  # measured in megabytes per second (MBps). Valid values depend on the
1883
1960
  # DeploymentType you choose, as follows:
1884
1961
  #
1962
+ # * For `MULTI_AZ_1` and `SINGLE_AZ_2`, valid values are 160, 320,
1963
+ # 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps.
1964
+ #
1885
1965
  # * For `SINGLE_AZ_1`, valid values are 64, 128, 256, 512, 1024, 2048,
1886
1966
  # 3072, or 4096 MBps.
1887
1967
  #
1888
- # * For `SINGLE_AZ_2`, valid values are 160, 320, 640, 1280, 2560,
1889
- # 3840, 5120, 7680, or 10240 MBps.
1890
- #
1891
1968
  # You pay for additional throughput capacity that you provision.
1892
1969
  # @return [Integer]
1893
1970
  #
@@ -1910,12 +1987,12 @@ module Aws::FSx
1910
1987
  #
1911
1988
  # @!attribute [rw] disk_iops_configuration
1912
1989
  # The SSD IOPS (input/output operations per second) configuration for
1913
- # an Amazon FSx for NetApp ONTAP or FSx for OpenZFS file system. By
1914
- # default, Amazon FSx automatically provisions 3 IOPS per GB of
1915
- # storage capacity. You can provision additional IOPS per GB of
1916
- # storage. The configuration consists of the total number of
1917
- # provisioned SSD IOPS and how it is was provisioned, or the mode (by
1918
- # the customer or by Amazon FSx).
1990
+ # an Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server,
1991
+ # or FSx for OpenZFS file system. By default, Amazon FSx automatically
1992
+ # provisions 3 IOPS per GB of storage capacity. You can provision
1993
+ # additional IOPS per GB of storage. The configuration consists of the
1994
+ # total number of provisioned SSD IOPS and how it is was provisioned,
1995
+ # or the mode (by the customer or by Amazon FSx).
1919
1996
  # @return [Types::DiskIopsConfiguration]
1920
1997
  #
1921
1998
  # @!attribute [rw] root_volume_configuration
@@ -1924,6 +2001,29 @@ module Aws::FSx
1924
2001
  # the root volume.
1925
2002
  # @return [Types::OpenZFSCreateRootVolumeConfiguration]
1926
2003
  #
2004
+ # @!attribute [rw] preferred_subnet_id
2005
+ # Required when `DeploymentType` is set to `MULTI_AZ_1`. This
2006
+ # specifies the subnet in which you want the preferred file server to
2007
+ # be located.
2008
+ # @return [String]
2009
+ #
2010
+ # @!attribute [rw] endpoint_ip_address_range
2011
+ # (Multi-AZ only) Specifies the IP address range in which the
2012
+ # endpoints to access your file system will be created. By default in
2013
+ # the Amazon FSx API and Amazon FSx console, Amazon FSx selects an
2014
+ # available /28 IP address range for you from one of the VPC's CIDR
2015
+ # ranges. You can have overlapping endpoint IP addresses for file
2016
+ # systems deployed in the same VPC/route tables.
2017
+ # @return [String]
2018
+ #
2019
+ # @!attribute [rw] route_table_ids
2020
+ # (Multi-AZ only) Specifies the route tables in which Amazon FSx
2021
+ # creates the rules for routing traffic to the correct file server.
2022
+ # You should specify all virtual private cloud (VPC) route tables
2023
+ # associated with the subnets in which your clients are located. By
2024
+ # default, Amazon FSx selects your VPC's default route table.
2025
+ # @return [Array<String>]
2026
+ #
1927
2027
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileSystemOpenZFSConfiguration AWS API Documentation
1928
2028
  #
1929
2029
  class CreateFileSystemOpenZFSConfiguration < Struct.new(
@@ -1935,7 +2035,10 @@ module Aws::FSx
1935
2035
  :throughput_capacity,
1936
2036
  :weekly_maintenance_start_time,
1937
2037
  :disk_iops_configuration,
1938
- :root_volume_configuration)
2038
+ :root_volume_configuration,
2039
+ :preferred_subnet_id,
2040
+ :endpoint_ip_address_range,
2041
+ :route_table_ids)
1939
2042
  SENSITIVE = []
1940
2043
  include Aws::Structure
1941
2044
  end
@@ -2101,15 +2204,15 @@ module Aws::FSx
2101
2204
  #
2102
2205
  # @!attribute [rw] file_system_type_version
2103
2206
  # (Optional) For FSx for Lustre file systems, sets the Lustre version
2104
- # for the file system that you're creating. Valid values are `2.10`
2105
- # and `2.12`:
2207
+ # for the file system that you're creating. Valid values are `2.10`,
2208
+ # `2.12`m and `2.15`:
2106
2209
  #
2107
2210
  # * 2\.10 is supported by the Scratch and Persistent\_1 Lustre
2108
2211
  # deployment types.
2109
2212
  #
2110
- # * 2\.12 is supported by all Lustre deployment types. `2.12` is
2111
- # required when setting FSx for Lustre `DeploymentType` to
2112
- # `PERSISTENT_2`.
2213
+ # * 2\.12 and 2.15 are supported by all Lustre deployment types. `2.12`
2214
+ # or `2.15` is required when setting FSx for Lustre `DeploymentType`
2215
+ # to `PERSISTENT_2`.
2113
2216
  #
2114
2217
  # Default value = `2.10`, except when `DeploymentType` is set to
2115
2218
  # `PERSISTENT_2`, then the default is `2.12`.
@@ -2295,6 +2398,14 @@ module Aws::FSx
2295
2398
  # the Amazon FSx for Windows File Server file system.
2296
2399
  # @return [Types::WindowsAuditLogCreateConfiguration]
2297
2400
  #
2401
+ # @!attribute [rw] disk_iops_configuration
2402
+ # The SSD IOPS (input/output operations per second) configuration for
2403
+ # an Amazon FSx for Windows file system. By default, Amazon FSx
2404
+ # automatically provisions 3 IOPS per GiB of storage capacity. You can
2405
+ # provision additional IOPS per GiB of storage, up to the maximum
2406
+ # limit associated with your chosen throughput capacity.
2407
+ # @return [Types::DiskIopsConfiguration]
2408
+ #
2298
2409
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileSystemWindowsConfiguration AWS API Documentation
2299
2410
  #
2300
2411
  class CreateFileSystemWindowsConfiguration < Struct.new(
@@ -2308,7 +2419,8 @@ module Aws::FSx
2308
2419
  :automatic_backup_retention_days,
2309
2420
  :copy_tags_to_backups,
2310
2421
  :aliases,
2311
- :audit_log_configuration)
2422
+ :audit_log_configuration,
2423
+ :disk_iops_configuration)
2312
2424
  SENSITIVE = []
2313
2425
  include Aws::Structure
2314
2426
  end
@@ -2670,7 +2782,7 @@ module Aws::FSx
2670
2782
  #
2671
2783
  #
2672
2784
  #
2673
- # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.html#privileged-delete
2785
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-enterprise.html#privileged-delete
2674
2786
  # @return [String]
2675
2787
  #
2676
2788
  # @!attribute [rw] retention_period
@@ -2698,7 +2810,7 @@ module Aws::FSx
2698
2810
  #
2699
2811
  #
2700
2812
  # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-compliance.html
2701
- # [2]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.htmlFile
2813
+ # [2]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-enterprise.html
2702
2814
  # @return [String]
2703
2815
  #
2704
2816
  # @!attribute [rw] volume_append_mode_enabled
@@ -3005,8 +3117,8 @@ module Aws::FSx
3005
3117
  # * `DescribeDataRepositoryAssociations`
3006
3118
  #
3007
3119
  # Data repository associations are supported on Amazon File Cache
3008
- # resources and all FSx for Lustre 2.12 and newer file systems,
3009
- # excluding `scratch_1` deployment type.
3120
+ # resources and all FSx for Lustre 2.12 and 2.15 file systems, excluding
3121
+ # `scratch_1` deployment type.
3010
3122
  #
3011
3123
  # @!attribute [rw] association_id
3012
3124
  # The system-generated, unique ID of the data repository association.
@@ -3347,10 +3459,25 @@ module Aws::FSx
3347
3459
  include Aws::Structure
3348
3460
  end
3349
3461
 
3350
- # A description of the data repository task. You use data repository
3351
- # tasks to perform bulk transfer operations between an Amazon FSx for
3352
- # Lustre file system and a linked data repository. An Amazon File Cache
3353
- # resource uses a task to automatically release files from the cache.
3462
+ # A description of the data repository task.
3463
+ #
3464
+ # * You use import and export data repository tasks to perform bulk
3465
+ # transfer operations between an Amazon FSx for Lustre file system and
3466
+ # a linked data repository.
3467
+ #
3468
+ # * You use release data repository tasks to release have been exported
3469
+ # to a linked S3 bucketed files from your Amazon FSx for Lustre file
3470
+ # system.
3471
+ #
3472
+ # * An Amazon File Cache resource uses a task to automatically release
3473
+ # files from the cache.
3474
+ #
3475
+ # To learn more about data repository tasks, see [Data Repository
3476
+ # Tasks][1].
3477
+ #
3478
+ #
3479
+ #
3480
+ # [1]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/data-repository-tasks.html
3354
3481
  #
3355
3482
  # @!attribute [rw] task_id
3356
3483
  # The system-generated, unique 17-digit ID of the data repository
@@ -3395,10 +3522,12 @@ module Aws::FSx
3395
3522
  # * `IMPORT_METADATA_FROM_REPOSITORY` tasks import metadata changes
3396
3523
  # from a linked S3 bucket to your Amazon FSx for Lustre file system.
3397
3524
  #
3525
+ # * `RELEASE_DATA_FROM_FILESYSTEM` tasks release files in your Amazon
3526
+ # FSx for Lustre file system that have been exported to a linked S3
3527
+ # bucket and that meet your specified release criteria.
3528
+ #
3398
3529
  # * `AUTO_RELEASE_DATA` tasks automatically release files from an
3399
3530
  # Amazon File Cache resource.
3400
- #
3401
- # * `RELEASE_DATA_FROM_FILESYSTEM` tasks are not supported.
3402
3531
  # @return [String]
3403
3532
  #
3404
3533
  # @!attribute [rw] creation_time
@@ -3473,6 +3602,12 @@ module Aws::FSx
3473
3602
  # The system-generated, unique ID of the cache.
3474
3603
  # @return [String]
3475
3604
  #
3605
+ # @!attribute [rw] release_configuration
3606
+ # The configuration that specifies the last accessed time criteria for
3607
+ # files that will be released from an Amazon FSx for Lustre file
3608
+ # system.
3609
+ # @return [Types::ReleaseConfiguration]
3610
+ #
3476
3611
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DataRepositoryTask AWS API Documentation
3477
3612
  #
3478
3613
  class DataRepositoryTask < Struct.new(
@@ -3490,7 +3625,8 @@ module Aws::FSx
3490
3625
  :status,
3491
3626
  :report,
3492
3627
  :capacity_to_release,
3493
- :file_cache_id)
3628
+ :file_cache_id,
3629
+ :release_configuration)
3494
3630
  SENSITIVE = []
3495
3631
  include Aws::Structure
3496
3632
  end
@@ -4103,11 +4239,11 @@ module Aws::FSx
4103
4239
  # SnapLock Enterprise volumes with unexpired WORM files. The default
4104
4240
  # value is `false`.
4105
4241
  #
4106
- # For more information, see [ Deleting a SnapLock volume ][1].
4242
+ # For more information, see [ Deleting a SnapLock volume][1].
4107
4243
  #
4108
4244
  #
4109
4245
  #
4110
- # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.html#snaplock-delete-volume
4246
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-delete-volume.html
4111
4247
  # @return [Boolean]
4112
4248
  #
4113
4249
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DeleteVolumeOntapConfiguration AWS API Documentation
@@ -4756,12 +4892,12 @@ module Aws::FSx
4756
4892
  end
4757
4893
 
4758
4894
  # The SSD IOPS (input/output operations per second) configuration for an
4759
- # Amazon FSx for NetApp ONTAP or FSx for OpenZFS file system. By
4760
- # default, Amazon FSx automatically provisions 3 IOPS per GB of storage
4761
- # capacity. You can provision additional IOPS per GB of storage. The
4762
- # configuration consists of the total number of provisioned SSD IOPS and
4763
- # how it is was provisioned, or the mode (by the customer or by Amazon
4764
- # FSx).
4895
+ # Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server, or
4896
+ # FSx for OpenZFS file system. By default, Amazon FSx automatically
4897
+ # provisions 3 IOPS per GB of storage capacity. You can provision
4898
+ # additional IOPS per GB of storage. The configuration consists of the
4899
+ # total number of provisioned SSD IOPS and how it is was provisioned, or
4900
+ # the mode (by the customer or by Amazon FSx).
4765
4901
  #
4766
4902
  # @!attribute [rw] mode
4767
4903
  # Specifies whether the file system is using the `AUTOMATIC` setting
@@ -4782,6 +4918,41 @@ module Aws::FSx
4782
4918
  include Aws::Structure
4783
4919
  end
4784
4920
 
4921
+ # Defines the minimum amount of time since last access for a file to be
4922
+ # eligible for release. Only files that have been exported to S3 and
4923
+ # that were last accessed or modified before this point-in-time are
4924
+ # eligible to be released from the Amazon FSx for Lustre file system.
4925
+ #
4926
+ # @!attribute [rw] unit
4927
+ # The unit of time used by the `Value` parameter to determine if a
4928
+ # file can be released, based on when it was last accessed. `DAYS` is
4929
+ # the only supported value. This is a required parameter.
4930
+ # @return [String]
4931
+ #
4932
+ # @!attribute [rw] value
4933
+ # An integer that represents the minimum amount of time (in days)
4934
+ # since a file was last accessed in the file system. Only exported
4935
+ # files with a `MAX(atime, ctime, mtime)` timestamp that is more than
4936
+ # this amount of time in the past (relative to the task create time)
4937
+ # will be released. The default of `Value` is `0`. This is a required
4938
+ # parameter.
4939
+ #
4940
+ # <note markdown="1"> If an exported file meets the last accessed time criteria, its file
4941
+ # or directory path must also be specified in the `Paths` parameter of
4942
+ # the operation in order for the file to be released.
4943
+ #
4944
+ # </note>
4945
+ # @return [Integer]
4946
+ #
4947
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DurationSinceLastAccess AWS API Documentation
4948
+ #
4949
+ class DurationSinceLastAccess < Struct.new(
4950
+ :unit,
4951
+ :value)
4952
+ SENSITIVE = []
4953
+ include Aws::Structure
4954
+ end
4955
+
4785
4956
  # A description of a specific Amazon File Cache resource, which is a
4786
4957
  # response object from the `DescribeFileCaches` operation.
4787
4958
  #
@@ -5417,8 +5588,8 @@ module Aws::FSx
5417
5588
  # @return [Types::OntapFileSystemConfiguration]
5418
5589
  #
5419
5590
  # @!attribute [rw] file_system_type_version
5420
- # The Lustre version of the Amazon FSx for Lustre file system, either
5421
- # `2.10` or `2.12`.
5591
+ # The Lustre version of the Amazon FSx for Lustre file system, which
5592
+ # is `2.10`, `2.12`, or `2.15`.
5422
5593
  # @return [String]
5423
5594
  #
5424
5595
  # @!attribute [rw] open_zfs_configuration
@@ -5828,11 +5999,10 @@ module Aws::FSx
5828
5999
  #
5829
6000
  # The `PERSISTENT_1` and `PERSISTENT_2` deployment type is used for
5830
6001
  # longer-term storage and workloads and encryption of data in transit.
5831
- # `PERSISTENT_2` is built on Lustre v2.12 and offers higher
5832
- # `PerUnitStorageThroughput` (up to 1000 MB/s/TiB) along with a lower
5833
- # minimum storage capacity requirement (600 GiB). To learn more about
5834
- # FSx for Lustre deployment types, see [ FSx for Lustre deployment
5835
- # options][1].
6002
+ # `PERSISTENT_2` offers higher `PerUnitStorageThroughput` (up to 1000
6003
+ # MB/s/TiB) along with a lower minimum storage capacity requirement
6004
+ # (600 GiB). To learn more about FSx for Lustre deployment types, see
6005
+ # [ FSx for Lustre deployment options][1].
5836
6006
  #
5837
6007
  # The default is `SCRATCH_1`.
5838
6008
  #
@@ -6591,7 +6761,7 @@ module Aws::FSx
6591
6761
  #
6592
6762
  # @!attribute [rw] deployment_type
6593
6763
  # Specifies the file-system deployment type. Amazon FSx for OpenZFS
6594
- # supports
 `SINGLE_AZ_1` and `SINGLE_AZ_2`.
6764
+ # supports
 `MULTI_AZ_1`, `SINGLE_AZ_1`, and `SINGLE_AZ_2`.
6595
6765
  # @return [String]
6596
6766
  #
6597
6767
  # @!attribute [rw] throughput_capacity
@@ -6618,18 +6788,43 @@ module Aws::FSx
6618
6788
  #
6619
6789
  # @!attribute [rw] disk_iops_configuration
6620
6790
  # The SSD IOPS (input/output operations per second) configuration for
6621
- # an Amazon FSx for NetApp ONTAP or FSx for OpenZFS file system. By
6622
- # default, Amazon FSx automatically provisions 3 IOPS per GB of
6623
- # storage capacity. You can provision additional IOPS per GB of
6624
- # storage. The configuration consists of the total number of
6625
- # provisioned SSD IOPS and how it is was provisioned, or the mode (by
6626
- # the customer or by Amazon FSx).
6791
+ # an Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server,
6792
+ # or FSx for OpenZFS file system. By default, Amazon FSx automatically
6793
+ # provisions 3 IOPS per GB of storage capacity. You can provision
6794
+ # additional IOPS per GB of storage. The configuration consists of the
6795
+ # total number of provisioned SSD IOPS and how it is was provisioned,
6796
+ # or the mode (by the customer or by Amazon FSx).
6627
6797
  # @return [Types::DiskIopsConfiguration]
6628
6798
  #
6629
6799
  # @!attribute [rw] root_volume_id
6630
6800
  # The ID of the root volume of the OpenZFS file system.
6631
6801
  # @return [String]
6632
6802
  #
6803
+ # @!attribute [rw] preferred_subnet_id
6804
+ # Required when `DeploymentType` is set to `MULTI_AZ_1`. This
6805
+ # specifies the subnet in which you want the preferred file server to
6806
+ # be located.
6807
+ # @return [String]
6808
+ #
6809
+ # @!attribute [rw] endpoint_ip_address_range
6810
+ # (Multi-AZ only) Specifies the IP address range in which the
6811
+ # endpoints to access your file system will be created. By default in
6812
+ # the Amazon FSx API and Amazon FSx console, Amazon FSx selects an
6813
+ # available /28 IP address range for you from one of the VPC's CIDR
6814
+ # ranges. You can have overlapping endpoint IP addresses for file
6815
+ # systems deployed in the same VPC/route tables.
6816
+ # @return [String]
6817
+ #
6818
+ # @!attribute [rw] route_table_ids
6819
+ # (Multi-AZ only) The VPC route tables in which your file system's
6820
+ # endpoints are created.
6821
+ # @return [Array<String>]
6822
+ #
6823
+ # @!attribute [rw] endpoint_ip_address
6824
+ # The IP address of the endpoint that is used to access data or to
6825
+ # manage the file system.
6826
+ # @return [String]
6827
+ #
6633
6828
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/OpenZFSFileSystemConfiguration AWS API Documentation
6634
6829
  #
6635
6830
  class OpenZFSFileSystemConfiguration < Struct.new(
@@ -6641,7 +6836,11 @@ module Aws::FSx
6641
6836
  :throughput_capacity,
6642
6837
  :weekly_maintenance_start_time,
6643
6838
  :disk_iops_configuration,
6644
- :root_volume_id)
6839
+ :root_volume_id,
6840
+ :preferred_subnet_id,
6841
+ :endpoint_ip_address_range,
6842
+ :route_table_ids,
6843
+ :endpoint_ip_address)
6645
6844
  SENSITIVE = []
6646
6845
  include Aws::Structure
6647
6846
  end
@@ -6839,6 +7038,42 @@ module Aws::FSx
6839
7038
  include Aws::Structure
6840
7039
  end
6841
7040
 
7041
+ # The configuration that specifies a minimum amount of time since last
7042
+ # access for an exported file to be eligible for release from an Amazon
7043
+ # FSx for Lustre file system. Only files that were last accessed before
7044
+ # this point-in-time can be released. For example, if you specify a last
7045
+ # accessed time criteria of 9 days, only files that were last accessed
7046
+ # 9.00001 or more days ago can be released.
7047
+ #
7048
+ # Only file data that has been exported to S3 can be released. Files
7049
+ # that have not yet been exported to S3, such as new or changed files
7050
+ # that have not been exported, are not eligible for release. When files
7051
+ # are released, their metadata stays on the file system, so they can
7052
+ # still be accessed later. Users and applications can access a released
7053
+ # file by reading the file again, which restores data from Amazon S3 to
7054
+ # the FSx for Lustre file system.
7055
+ #
7056
+ # <note markdown="1"> If a file meets the last accessed time criteria, its file or directory
7057
+ # path must also be specified with the `Paths` parameter of the
7058
+ # operation in order for the file to be released.
7059
+ #
7060
+ # </note>
7061
+ #
7062
+ # @!attribute [rw] duration_since_last_access
7063
+ # Defines the point-in-time since an exported file was last accessed,
7064
+ # in order for that file to be eligible for release. Only files that
7065
+ # were last accessed before this point-in-time are eligible to be
7066
+ # released from the file system.
7067
+ # @return [Types::DurationSinceLastAccess]
7068
+ #
7069
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/ReleaseConfiguration AWS API Documentation
7070
+ #
7071
+ class ReleaseConfiguration < Struct.new(
7072
+ :duration_since_last_access)
7073
+ SENSITIVE = []
7074
+ include Aws::Structure
7075
+ end
7076
+
6842
7077
  # @!attribute [rw] file_system_id
6843
7078
  # The globally unique ID of the file system, assigned by Amazon FSx.
6844
7079
  # @return [String]
@@ -7291,7 +7526,7 @@ module Aws::FSx
7291
7526
  #
7292
7527
  #
7293
7528
  #
7294
- # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.html#privileged-delete
7529
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-enterprise.html#privileged-delete
7295
7530
  # @return [String]
7296
7531
  #
7297
7532
  # @!attribute [rw] retention_period
@@ -7319,7 +7554,7 @@ module Aws::FSx
7319
7554
  #
7320
7555
  #
7321
7556
  # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-compliance.html
7322
- # [2]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.htmlFile
7557
+ # [2]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-enterprise.html
7323
7558
  # @return [String]
7324
7559
  #
7325
7560
  # @!attribute [rw] volume_append_mode_enabled
@@ -8249,11 +8484,11 @@ module Aws::FSx
8249
8484
  # megabytes per second
 (MB/s). Valid values depend on the
8250
8485
  # DeploymentType you choose, as follows:
8251
8486
  #
8487
+ # * For `MULTI_AZ_1` and `SINGLE_AZ_2`, valid values are 160, 320,
8488
+ # 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps.
8489
+ #
8252
8490
  # * For `SINGLE_AZ_1`, valid values are 64, 128, 256, 512, 1024, 2048,
8253
8491
  # 3072, or 4096 MB/s.
8254
- #
8255
- # * For `SINGLE_AZ_2`, valid values are 160, 320, 640, 1280, 2560,
8256
- # 3840, 5120, 7680, or 10240 MB/s.
8257
8492
  # @return [Integer]
8258
8493
  #
8259
8494
  # @!attribute [rw] weekly_maintenance_start_time
@@ -8275,14 +8510,27 @@ module Aws::FSx
8275
8510
  #
8276
8511
  # @!attribute [rw] disk_iops_configuration
8277
8512
  # The SSD IOPS (input/output operations per second) configuration for
8278
- # an Amazon FSx for NetApp ONTAP or FSx for OpenZFS file system. By
8279
- # default, Amazon FSx automatically provisions 3 IOPS per GB of
8280
- # storage capacity. You can provision additional IOPS per GB of
8281
- # storage. The configuration consists of the total number of
8282
- # provisioned SSD IOPS and how it is was provisioned, or the mode (by
8283
- # the customer or by Amazon FSx).
8513
+ # an Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server,
8514
+ # or FSx for OpenZFS file system. By default, Amazon FSx automatically
8515
+ # provisions 3 IOPS per GB of storage capacity. You can provision
8516
+ # additional IOPS per GB of storage. The configuration consists of the
8517
+ # total number of provisioned SSD IOPS and how it is was provisioned,
8518
+ # or the mode (by the customer or by Amazon FSx).
8284
8519
  # @return [Types::DiskIopsConfiguration]
8285
8520
  #
8521
+ # @!attribute [rw] add_route_table_ids
8522
+ # (Multi-AZ only) A list of IDs of new virtual private cloud (VPC)
8523
+ # route tables to associate (add) with your Amazon FSx for OpenZFS
8524
+ # file system.
8525
+ # @return [Array<String>]
8526
+ #
8527
+ # @!attribute [rw] remove_route_table_ids
8528
+ # (Multi-AZ only) A list of IDs of existing virtual private cloud
8529
+ # (VPC) route tables to disassociate (remove) from your Amazon FSx for
8530
+ # OpenZFS file system. You can use the API operation to retrieve the
8531
+ # list of VPC route table IDs for a file system.
8532
+ # @return [Array<String>]
8533
+ #
8286
8534
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileSystemOpenZFSConfiguration AWS API Documentation
8287
8535
  #
8288
8536
  class UpdateFileSystemOpenZFSConfiguration < Struct.new(
@@ -8292,7 +8540,9 @@ module Aws::FSx
8292
8540
  :daily_automatic_backup_start_time,
8293
8541
  :throughput_capacity,
8294
8542
  :weekly_maintenance_start_time,
8295
- :disk_iops_configuration)
8543
+ :disk_iops_configuration,
8544
+ :add_route_table_ids,
8545
+ :remove_route_table_ids)
8296
8546
  SENSITIVE = []
8297
8547
  include Aws::Structure
8298
8548
  end
@@ -8387,6 +8637,10 @@ module Aws::FSx
8387
8637
  # The configuration updates for an FSx for OpenZFS file system.
8388
8638
  # @return [Types::UpdateFileSystemOpenZFSConfiguration]
8389
8639
  #
8640
+ # @!attribute [rw] storage_type
8641
+ # Specifies the file system's storage type.
8642
+ # @return [String]
8643
+ #
8390
8644
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileSystemRequest AWS API Documentation
8391
8645
  #
8392
8646
  class UpdateFileSystemRequest < Struct.new(
@@ -8396,7 +8650,8 @@ module Aws::FSx
8396
8650
  :windows_configuration,
8397
8651
  :lustre_configuration,
8398
8652
  :ontap_configuration,
8399
- :open_zfs_configuration)
8653
+ :open_zfs_configuration,
8654
+ :storage_type)
8400
8655
  SENSITIVE = []
8401
8656
  include Aws::Structure
8402
8657
  end
@@ -8467,6 +8722,14 @@ module Aws::FSx
8467
8722
  # the Amazon FSx for Windows File Server file system..
8468
8723
  # @return [Types::WindowsAuditLogCreateConfiguration]
8469
8724
  #
8725
+ # @!attribute [rw] disk_iops_configuration
8726
+ # The SSD IOPS (input/output operations per second) configuration for
8727
+ # an Amazon FSx for Windows file system. By default, Amazon FSx
8728
+ # automatically provisions 3 IOPS per GiB of storage capacity. You can
8729
+ # provision additional IOPS per GiB of storage, up to the maximum
8730
+ # limit associated with your chosen throughput capacity.
8731
+ # @return [Types::DiskIopsConfiguration]
8732
+ #
8470
8733
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileSystemWindowsConfiguration AWS API Documentation
8471
8734
  #
8472
8735
  class UpdateFileSystemWindowsConfiguration < Struct.new(
@@ -8475,7 +8738,8 @@ module Aws::FSx
8475
8738
  :automatic_backup_retention_days,
8476
8739
  :throughput_capacity,
8477
8740
  :self_managed_active_directory_configuration,
8478
- :audit_log_configuration)
8741
+ :audit_log_configuration,
8742
+ :disk_iops_configuration)
8479
8743
  SENSITIVE = []
8480
8744
  include Aws::Structure
8481
8745
  end
@@ -8679,7 +8943,7 @@ module Aws::FSx
8679
8943
  #
8680
8944
  #
8681
8945
  #
8682
- # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/how-snaplock-works.html#privileged-delete
8946
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snaplock-enterprise.html#privileged-delete
8683
8947
  # @return [String]
8684
8948
  #
8685
8949
  # @!attribute [rw] retention_period
@@ -9060,7 +9324,7 @@ module Aws::FSx
9060
9324
  # ARN or Amazon Kinesis Data Firehose delivery stream ARN.
9061
9325
  #
9062
9326
  # The name of the Amazon CloudWatch Logs log group must begin with the
9063
- # `/aws/fsx` prefix. The name of the Amazon Kinesis Data Firehouse
9327
+ # `/aws/fsx` prefix. The name of the Amazon Kinesis Data Firehose
9064
9328
  # delivery stream must begin with the `aws-fsx` prefix.
9065
9329
  #
9066
9330
  # The destination ARN (either CloudWatch Logs log group or Kinesis
@@ -9129,7 +9393,7 @@ module Aws::FSx
9129
9393
  #
9130
9394
  # * The name of the Amazon CloudWatch Logs log group must begin with
9131
9395
  # the `/aws/fsx` prefix. The name of the Amazon Kinesis Data
9132
- # Firehouse delivery stream must begin with the `aws-fsx` prefix.
9396
+ # Firehose delivery stream must begin with the `aws-fsx` prefix.
9133
9397
  #
9134
9398
  # * If you do not provide a destination in `AuditLogDestination`,
9135
9399
  # Amazon FSx will create and use a log stream in the CloudWatch Logs
@@ -9296,6 +9560,14 @@ module Aws::FSx
9296
9560
  # the Amazon FSx for Windows File Server file system.
9297
9561
  # @return [Types::WindowsAuditLogConfiguration]
9298
9562
  #
9563
+ # @!attribute [rw] disk_iops_configuration
9564
+ # The SSD IOPS (input/output operations per second) configuration for
9565
+ # an Amazon FSx for Windows file system. By default, Amazon FSx
9566
+ # automatically provisions 3 IOPS per GiB of storage capacity. You can
9567
+ # provision additional IOPS per GiB of storage, up to the maximum
9568
+ # limit associated with your chosen throughput capacity.
9569
+ # @return [Types::DiskIopsConfiguration]
9570
+ #
9299
9571
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/WindowsFileSystemConfiguration AWS API Documentation
9300
9572
  #
9301
9573
  class WindowsFileSystemConfiguration < Struct.new(
@@ -9312,7 +9584,8 @@ module Aws::FSx
9312
9584
  :automatic_backup_retention_days,
9313
9585
  :copy_tags_to_backups,
9314
9586
  :aliases,
9315
- :audit_log_configuration)
9587
+ :audit_log_configuration,
9588
+ :disk_iops_configuration)
9316
9589
  SENSITIVE = []
9317
9590
  include Aws::Structure
9318
9591
  end