aws-sdk-fsx 1.73.0 → 1.75.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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