aws-sdk-fsx 1.58.0 → 1.60.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.
@@ -345,12 +345,12 @@ module Aws::FSx
345
345
  # Describes a data repository association's automatic export policy.
346
346
  # The `AutoExportPolicy` defines the types of updated objects on the
347
347
  # file system that will be automatically exported to the data
348
- # repository. As you create, modify, or delete files, Amazon FSx
349
- # automatically exports the defined changes asynchronously once your
350
- # application finishes modifying the file.
348
+ # repository. As you create, modify, or delete files, Amazon FSx for
349
+ # Lustre automatically exports the defined changes asynchronously once
350
+ # your application finishes modifying the file.
351
351
  #
352
- # This `AutoExportPolicy` is supported only for file systems with the
353
- # `Persistent_2` deployment type.
352
+ # This `AutoExportPolicy` is supported only for Amazon FSx for Lustre
353
+ # file systems with the `Persistent_2` deployment type.
354
354
  #
355
355
  # @note When making an API call, you may pass AutoExportPolicy
356
356
  # data as a hash:
@@ -362,11 +362,11 @@ module Aws::FSx
362
362
  # @!attribute [rw] events
363
363
  # The `AutoExportPolicy` can have the following event values:
364
364
  #
365
- # * `NEW` - Amazon FSx automatically exports new files and directories
366
- # to the data repository as they are added to the file system.
365
+ # * `NEW` - New files and directories are automatically exported to
366
+ # the data repository as they are added to the file system.
367
367
  #
368
- # * `CHANGED` - Amazon FSx automatically exports changes to files and
369
- # directories on the file system to the data repository.
368
+ # * `CHANGED` - Changes to files and directories on the file system
369
+ # are automatically exported to the data repository.
370
370
  #
371
371
  # * `DELETED` - Files and directories are automatically deleted on the
372
372
  # data repository when they are deleted on the file system.
@@ -385,11 +385,12 @@ module Aws::FSx
385
385
 
386
386
  # Describes the data repository association's automatic import policy.
387
387
  # The AutoImportPolicy defines how Amazon FSx keeps your file metadata
388
- # and directory listings up to date by importing changes to your file
389
- # system as you modify objects in a linked S3 bucket.
388
+ # and directory listings up to date by importing changes to your Amazon
389
+ # FSx for Lustre file system as you modify objects in a linked S3
390
+ # bucket.
390
391
  #
391
- # This `AutoImportPolicy` is supported only for file systems with the
392
- # `Persistent_2` deployment type.
392
+ # The `AutoImportPolicy` is supported only for Amazon FSx for Lustre
393
+ # file systems with the `Persistent_2` deployment type.
393
394
  #
394
395
  # @note When making an API call, you may pass AutoImportPolicy
395
396
  # data as a hash:
@@ -936,7 +937,7 @@ module Aws::FSx
936
937
  #
937
938
  # {
938
939
  # file_system_id: "FileSystemId", # required
939
- # file_system_path: "Namespace", # required
940
+ # file_system_path: "Namespace",
940
941
  # data_repository_path: "ArchivePath", # required
941
942
  # batch_import_meta_data_on_create: false,
942
943
  # imported_file_chunk_size: 1,
@@ -977,9 +978,9 @@ module Aws::FSx
977
978
  # the directory.
978
979
  #
979
980
  # <note markdown="1"> If you specify only a forward slash (`/`) as the file system path,
980
- # you can link only 1 data repository to the file system. You can only
981
- # specify "/" as the file system path for the first data repository
982
- # associated with a file system.
981
+ # you can link only one data repository to the file system. You can
982
+ # only specify "/" as the file system path for the first data
983
+ # repository associated with a file system.
983
984
  #
984
985
  # </note>
985
986
  # @return [String]
@@ -1064,7 +1065,7 @@ module Aws::FSx
1064
1065
  # data as a hash:
1065
1066
  #
1066
1067
  # {
1067
- # type: "EXPORT_TO_REPOSITORY", # required, accepts EXPORT_TO_REPOSITORY, IMPORT_METADATA_FROM_REPOSITORY
1068
+ # type: "EXPORT_TO_REPOSITORY", # required, accepts EXPORT_TO_REPOSITORY, IMPORT_METADATA_FROM_REPOSITORY, RELEASE_DATA_FROM_FILESYSTEM, AUTO_RELEASE_DATA
1068
1069
  # paths: ["DataRepositoryTaskPath"],
1069
1070
  # file_system_id: "FileSystemId", # required
1070
1071
  # report: { # required
@@ -1080,6 +1081,7 @@ module Aws::FSx
1080
1081
  # value: "TagValue", # required
1081
1082
  # },
1082
1083
  # ],
1084
+ # capacity_to_release: 1,
1083
1085
  # }
1084
1086
  #
1085
1087
  # @!attribute [rw] type
@@ -1134,6 +1136,12 @@ module Aws::FSx
1134
1136
  # A list of `Tag` values, with a maximum of 50 elements.
1135
1137
  # @return [Array<Types::Tag>]
1136
1138
  #
1139
+ # @!attribute [rw] capacity_to_release
1140
+ # Specifies the amount of data to release, in GiB, by an Amazon File
1141
+ # Cache `AUTO_RELEASE_DATA` task that automatically releases files
1142
+ # from the cache.
1143
+ # @return [Integer]
1144
+ #
1137
1145
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateDataRepositoryTaskRequest AWS API Documentation
1138
1146
  #
1139
1147
  class CreateDataRepositoryTaskRequest < Struct.new(
@@ -1142,7 +1150,8 @@ module Aws::FSx
1142
1150
  :file_system_id,
1143
1151
  :report,
1144
1152
  :client_request_token,
1145
- :tags)
1153
+ :tags,
1154
+ :capacity_to_release)
1146
1155
  SENSITIVE = []
1147
1156
  include Aws::Structure
1148
1157
  end
@@ -1159,6 +1168,220 @@ module Aws::FSx
1159
1168
  include Aws::Structure
1160
1169
  end
1161
1170
 
1171
+ # The Amazon File Cache configuration for the cache that you are
1172
+ # creating.
1173
+ #
1174
+ # @note When making an API call, you may pass CreateFileCacheLustreConfiguration
1175
+ # data as a hash:
1176
+ #
1177
+ # {
1178
+ # per_unit_storage_throughput: 1, # required
1179
+ # deployment_type: "CACHE_1", # required, accepts CACHE_1
1180
+ # weekly_maintenance_start_time: "WeeklyTime",
1181
+ # metadata_configuration: { # required
1182
+ # storage_capacity: 1, # required
1183
+ # },
1184
+ # }
1185
+ #
1186
+ # @!attribute [rw] per_unit_storage_throughput
1187
+ # Provisions the amount of read and write throughput for each 1
1188
+ # tebibyte (TiB) of cache storage capacity, in MB/s/TiB. The only
1189
+ # supported value is `1000`.
1190
+ # @return [Integer]
1191
+ #
1192
+ # @!attribute [rw] deployment_type
1193
+ # Specifies the cache deployment type, which must be `CACHE_1`.
1194
+ # @return [String]
1195
+ #
1196
+ # @!attribute [rw] weekly_maintenance_start_time
1197
+ # A recurring weekly time, in the format `D:HH:MM`.
1198
+ #
1199
+ # `D` is the day of the week, for which 1 represents Monday and 7
1200
+ # represents Sunday. For further details, see [the ISO-8601 spec as
1201
+ # described on Wikipedia][1].
1202
+ #
1203
+ # `HH` is the zero-padded hour of the day (0-23), and `MM` is the
1204
+ # zero-padded minute of the hour.
1205
+ #
1206
+ # For example, `1:05:00` specifies maintenance at 5 AM Monday.
1207
+ #
1208
+ #
1209
+ #
1210
+ # [1]: https://en.wikipedia.org/wiki/ISO_week_date
1211
+ # @return [String]
1212
+ #
1213
+ # @!attribute [rw] metadata_configuration
1214
+ # The configuration for a Lustre MDT (Metadata Target) storage volume.
1215
+ # @return [Types::FileCacheLustreMetadataConfiguration]
1216
+ #
1217
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileCacheLustreConfiguration AWS API Documentation
1218
+ #
1219
+ class CreateFileCacheLustreConfiguration < Struct.new(
1220
+ :per_unit_storage_throughput,
1221
+ :deployment_type,
1222
+ :weekly_maintenance_start_time,
1223
+ :metadata_configuration)
1224
+ SENSITIVE = []
1225
+ include Aws::Structure
1226
+ end
1227
+
1228
+ # @note When making an API call, you may pass CreateFileCacheRequest
1229
+ # data as a hash:
1230
+ #
1231
+ # {
1232
+ # client_request_token: "ClientRequestToken",
1233
+ # file_cache_type: "LUSTRE", # required, accepts LUSTRE
1234
+ # file_cache_type_version: "FileSystemTypeVersion", # required
1235
+ # storage_capacity: 1, # required
1236
+ # subnet_ids: ["SubnetId"], # required
1237
+ # security_group_ids: ["SecurityGroupId"],
1238
+ # tags: [
1239
+ # {
1240
+ # key: "TagKey", # required
1241
+ # value: "TagValue", # required
1242
+ # },
1243
+ # ],
1244
+ # copy_tags_to_data_repository_associations: false,
1245
+ # kms_key_id: "KmsKeyId",
1246
+ # lustre_configuration: {
1247
+ # per_unit_storage_throughput: 1, # required
1248
+ # deployment_type: "CACHE_1", # required, accepts CACHE_1
1249
+ # weekly_maintenance_start_time: "WeeklyTime",
1250
+ # metadata_configuration: { # required
1251
+ # storage_capacity: 1, # required
1252
+ # },
1253
+ # },
1254
+ # data_repository_associations: [
1255
+ # {
1256
+ # file_cache_path: "Namespace", # required
1257
+ # data_repository_path: "ArchivePath", # required
1258
+ # data_repository_subdirectories: ["Namespace"],
1259
+ # nfs: {
1260
+ # version: "NFS3", # required, accepts NFS3
1261
+ # dns_ips: ["IpAddress"],
1262
+ # },
1263
+ # },
1264
+ # ],
1265
+ # }
1266
+ #
1267
+ # @!attribute [rw] client_request_token
1268
+ # An idempotency token for resource creation, in a string of up to 64
1269
+ # ASCII characters. This token is automatically filled on your behalf
1270
+ # when you use the Command Line Interface (CLI) or an Amazon Web
1271
+ # Services SDK.
1272
+ #
1273
+ # By using the idempotent operation, you can retry a `CreateFileCache`
1274
+ # operation without the risk of creating an extra cache. This approach
1275
+ # can be useful when an initial call fails in a way that makes it
1276
+ # unclear whether a cache was created. Examples are if a transport
1277
+ # level timeout occurred, or your connection was reset. If you use the
1278
+ # same client request token and the initial call created a cache, the
1279
+ # client receives success as long as the parameters are the same.
1280
+ #
1281
+ # **A suitable default value is auto-generated.** You should normally
1282
+ # not need to pass this option.
1283
+ # @return [String]
1284
+ #
1285
+ # @!attribute [rw] file_cache_type
1286
+ # The type of cache that you're creating, which must be `LUSTRE`.
1287
+ # @return [String]
1288
+ #
1289
+ # @!attribute [rw] file_cache_type_version
1290
+ # Sets the Lustre version for the cache that you're creating, which
1291
+ # must be `2.12`.
1292
+ # @return [String]
1293
+ #
1294
+ # @!attribute [rw] storage_capacity
1295
+ # The storage capacity of the cache in gibibytes (GiB). Valid values
1296
+ # are 1200 GiB, 2400 GiB, and increments of 2400 GiB.
1297
+ # @return [Integer]
1298
+ #
1299
+ # @!attribute [rw] subnet_ids
1300
+ # A list of subnet IDs that the cache will be accessible from. You can
1301
+ # specify only one subnet ID in a call to the `CreateFileCache`
1302
+ # operation.
1303
+ # @return [Array<String>]
1304
+ #
1305
+ # @!attribute [rw] security_group_ids
1306
+ # A list of IDs specifying the security groups to apply to all network
1307
+ # interfaces created for Amazon File Cache access. This list isn't
1308
+ # returned in later requests to describe the cache.
1309
+ # @return [Array<String>]
1310
+ #
1311
+ # @!attribute [rw] tags
1312
+ # A list of `Tag` values, with a maximum of 50 elements.
1313
+ # @return [Array<Types::Tag>]
1314
+ #
1315
+ # @!attribute [rw] copy_tags_to_data_repository_associations
1316
+ # A boolean flag indicating whether tags for the cache should be
1317
+ # copied to data repository associations. This value defaults to
1318
+ # false.
1319
+ # @return [Boolean]
1320
+ #
1321
+ # @!attribute [rw] kms_key_id
1322
+ # Specifies the ID of the Key Management Service (KMS) key to use for
1323
+ # encrypting data on an Amazon File Cache. If a `KmsKeyId` isn't
1324
+ # specified, the Amazon FSx-managed KMS key for your account is used.
1325
+ # For more information, see [Encrypt][1] in the *Key Management
1326
+ # Service API Reference*.
1327
+ #
1328
+ #
1329
+ #
1330
+ # [1]: https://docs.aws.amazon.com/kms/latest/APIReference/API_Encrypt.html
1331
+ # @return [String]
1332
+ #
1333
+ # @!attribute [rw] lustre_configuration
1334
+ # The configuration for the Amazon File Cache resource being created.
1335
+ # @return [Types::CreateFileCacheLustreConfiguration]
1336
+ #
1337
+ # @!attribute [rw] data_repository_associations
1338
+ # A list of up to 8 configurations for data repository associations
1339
+ # (DRAs) to be created during the cache creation. The DRAs link the
1340
+ # cache to either an Amazon S3 data repository or a Network File
1341
+ # System (NFS) data repository that supports the NFSv3 protocol.
1342
+ #
1343
+ # The DRA configurations must meet the following requirements:
1344
+ #
1345
+ # * All configurations on the list must be of the same data repository
1346
+ # type, either all S3 or all NFS. A cache can't link to different
1347
+ # data repository types at the same time.
1348
+ #
1349
+ # * An NFS DRA must link to an NFS file system that supports the NFSv3
1350
+ # protocol.
1351
+ #
1352
+ # DRA automatic import and automatic export is not supported.
1353
+ # @return [Array<Types::FileCacheDataRepositoryAssociation>]
1354
+ #
1355
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileCacheRequest AWS API Documentation
1356
+ #
1357
+ class CreateFileCacheRequest < Struct.new(
1358
+ :client_request_token,
1359
+ :file_cache_type,
1360
+ :file_cache_type_version,
1361
+ :storage_capacity,
1362
+ :subnet_ids,
1363
+ :security_group_ids,
1364
+ :tags,
1365
+ :copy_tags_to_data_repository_associations,
1366
+ :kms_key_id,
1367
+ :lustre_configuration,
1368
+ :data_repository_associations)
1369
+ SENSITIVE = []
1370
+ include Aws::Structure
1371
+ end
1372
+
1373
+ # @!attribute [rw] file_cache
1374
+ # A description of the cache that was created.
1375
+ # @return [Types::FileCacheCreating]
1376
+ #
1377
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileCacheResponse AWS API Documentation
1378
+ #
1379
+ class CreateFileCacheResponse < Struct.new(
1380
+ :file_cache)
1381
+ SENSITIVE = []
1382
+ include Aws::Structure
1383
+ end
1384
+
1162
1385
  # The request object for the `CreateFileSystemFromBackup` operation.
1163
1386
  #
1164
1387
  # @note When making an API call, you may pass CreateFileSystemFromBackupRequest
@@ -1260,6 +1483,7 @@ module Aws::FSx
1260
1483
  # read_only: false,
1261
1484
  # },
1262
1485
  # },
1486
+ # storage_capacity: 1,
1263
1487
  # }
1264
1488
  #
1265
1489
  # @!attribute [rw] backup_id
@@ -1390,6 +1614,19 @@ module Aws::FSx
1390
1614
  # The OpenZFS configuration for the file system that's being created.
1391
1615
  # @return [Types::CreateFileSystemOpenZFSConfiguration]
1392
1616
  #
1617
+ # @!attribute [rw] storage_capacity
1618
+ # Sets the storage capacity of the OpenZFS file system that you're
1619
+ # creating from a backup, in gibibytes (GiB). Valid values are from 64
1620
+ # GiB up to 524,288 GiB (512 TiB). However, the value that you specify
1621
+ # must be equal to or greater than the backup's storage capacity
1622
+ # value. If you don't use the `StorageCapacity` parameter, the
1623
+ # default is the backup's `StorageCapacity` value.
1624
+ #
1625
+ # If used to create a file system other than OpenZFS, you must provide
1626
+ # a value that matches the backup's `StorageCapacity` value. If you
1627
+ # provide any other value, Amazon FSx responds with a 400 Bad Request.
1628
+ # @return [Integer]
1629
+ #
1393
1630
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateFileSystemFromBackupRequest AWS API Documentation
1394
1631
  #
1395
1632
  class CreateFileSystemFromBackupRequest < Struct.new(
@@ -1403,7 +1640,8 @@ module Aws::FSx
1403
1640
  :storage_type,
1404
1641
  :kms_key_id,
1405
1642
  :file_system_type_version,
1406
- :open_zfs_configuration)
1643
+ :open_zfs_configuration,
1644
+ :storage_capacity)
1407
1645
  SENSITIVE = []
1408
1646
  include Aws::Structure
1409
1647
  end
@@ -2545,9 +2783,12 @@ module Aws::FSx
2545
2783
  # @return [String]
2546
2784
  #
2547
2785
  # @!attribute [rw] security_style
2548
- # The security style for the volume. If a volume's security style is
2549
- # not specified, it is automatically set to the root volume's
2550
- # security style. Specify one of the following values:
2786
+ # Specifies the security style for the volume. If a volume's security
2787
+ # style is not specified, it is automatically set to the root
2788
+ # volume's security style. The security style determines the type of
2789
+ # permissions that FSx for ONTAP uses to control data access. For more
2790
+ # information, see [Volume security style][1] in the *Amazon FSx for
2791
+ # NetApp ONTAP User Guide*. Specify one of the following values:
2551
2792
  #
2552
2793
  # * `UNIX` if the file system is managed by a UNIX administrator, the
2553
2794
  # majority of users are NFS clients, and an application accessing
@@ -2559,6 +2800,10 @@ module Aws::FSx
2559
2800
  #
2560
2801
  # * `MIXED` if the file system is managed by both UNIX and Windows
2561
2802
  # administrators and users consist of both NFS and SMB clients.
2803
+ #
2804
+ #
2805
+ #
2806
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-security-style
2562
2807
  # @return [String]
2563
2808
  #
2564
2809
  # @!attribute [rw] size_in_megabytes
@@ -3234,8 +3479,9 @@ module Aws::FSx
3234
3479
  end
3235
3480
 
3236
3481
  # The configuration of a data repository association that links an
3237
- # Amazon FSx for Lustre file system to an Amazon S3 bucket. The data
3238
- # repository association configuration object is returned in the
3482
+ # Amazon FSx for Lustre file system to an Amazon S3 bucket or an Amazon
3483
+ # File Cache resource to an Amazon S3 bucket or an NFS file system. The
3484
+ # data repository association configuration object is returned in the
3239
3485
  # response of the following operations:
3240
3486
  #
3241
3487
  # * `CreateDataRepositoryAssociation`
@@ -3244,8 +3490,9 @@ module Aws::FSx
3244
3490
  #
3245
3491
  # * `DescribeDataRepositoryAssociations`
3246
3492
  #
3247
- # Data repository associations are supported only for file systems with
3248
- # the `Persistent_2` deployment type.
3493
+ # Data repository associations are supported only for an Amazon FSx for
3494
+ # Lustre file system with the `Persistent_2` deployment type and for an
3495
+ # Amazon File Cache resource.
3249
3496
  #
3250
3497
  # @!attribute [rw] association_id
3251
3498
  # The system-generated, unique ID of the data repository association.
@@ -3271,17 +3518,17 @@ module Aws::FSx
3271
3518
  # Describes the state of a data repository association. The lifecycle
3272
3519
  # can have the following values:
3273
3520
  #
3274
- # * `CREATING` - The data repository association between the FSx file
3275
- # system and the S3 data repository is being created. The data
3521
+ # * `CREATING` - The data repository association between the file
3522
+ # system or cache and the data repository is being created. The data
3276
3523
  # repository is unavailable.
3277
3524
  #
3278
3525
  # * `AVAILABLE` - The data repository association is available for
3279
3526
  # use.
3280
3527
  #
3281
- # * `MISCONFIGURED` - Amazon FSx cannot automatically import updates
3282
- # from the S3 bucket or automatically export updates to the S3
3283
- # bucket until the data repository association configuration is
3284
- # corrected.
3528
+ # * `MISCONFIGURED` - The data repository association is
3529
+ # misconfigured. Until the configuration is corrected, automatic
3530
+ # import and automatic export will not work (only for Amazon FSx for
3531
+ # Lustre).
3285
3532
  #
3286
3533
  # * `UPDATING` - The data repository association is undergoing a
3287
3534
  # customer initiated update that might affect its availability.
@@ -3299,14 +3546,14 @@ module Aws::FSx
3299
3546
  # @return [Types::DataRepositoryFailureDetails]
3300
3547
  #
3301
3548
  # @!attribute [rw] file_system_path
3302
- # A path on the file system that points to a high-level directory
3303
- # (such as `/ns1/`) or subdirectory (such as `/ns1/subdir/`) that will
3304
- # be mapped 1-1 with `DataRepositoryPath`. The leading forward slash
3305
- # in the name is required. Two data repository associations cannot
3306
- # have overlapping file system paths. For example, if a data
3307
- # repository is associated with file system path `/ns1/`, then you
3308
- # cannot link another data repository with file system path
3309
- # `/ns1/ns2`.
3549
+ # A path on the Amazon FSx for Lustre file system that points to a
3550
+ # high-level directory (such as `/ns1/`) or subdirectory (such as
3551
+ # `/ns1/subdir/`) that will be mapped 1-1 with `DataRepositoryPath`.
3552
+ # The leading forward slash in the name is required. Two data
3553
+ # repository associations cannot have overlapping file system paths.
3554
+ # For example, if a data repository is associated with file system
3555
+ # path `/ns1/`, then you cannot link another data repository with file
3556
+ # system path `/ns1/ns2`.
3310
3557
  #
3311
3558
  # This path specifies where in your file system files will be exported
3312
3559
  # from or imported to. This file system directory can be linked to
@@ -3314,24 +3561,49 @@ module Aws::FSx
3314
3561
  # the directory.
3315
3562
  #
3316
3563
  # <note markdown="1"> If you specify only a forward slash (`/`) as the file system path,
3317
- # you can link only 1 data repository to the file system. You can only
3318
- # specify "/" as the file system path for the first data repository
3319
- # associated with a file system.
3564
+ # you can link only one data repository to the file system. You can
3565
+ # only specify "/" as the file system path for the first data
3566
+ # repository associated with a file system.
3320
3567
  #
3321
3568
  # </note>
3322
3569
  # @return [String]
3323
3570
  #
3324
3571
  # @!attribute [rw] data_repository_path
3325
- # The path to the Amazon S3 data repository that will be linked to the
3326
- # file system. The path can be an S3 bucket or prefix in the format
3327
- # `s3://myBucket/myPrefix/`. This path specifies where in the S3 data
3328
- # repository files will be imported from or exported to.
3572
+ # The path to the data repository that will be linked to the cache or
3573
+ # file system.
3574
+ #
3575
+ # * For Amazon File Cache, the path can be an NFS data repository that
3576
+ # will be linked to the cache. The path can be in one of two
3577
+ # formats:
3578
+ #
3579
+ # * If you are not using the `DataRepositorySubdirectories`
3580
+ # parameter, the path is to an NFS Export directory (or one of its
3581
+ # subdirectories) in the format
3582
+ # `nsf://nfs-domain-name/exportpath`. You can therefore link a
3583
+ # single NFS Export to a single data repository association.
3584
+ #
3585
+ # * If you are using the `DataRepositorySubdirectories` parameter,
3586
+ # the path is the domain name of the NFS file system in the format
3587
+ # `nfs://filer-domain-name`, which indicates the root of the
3588
+ # subdirectories specified with the `DataRepositorySubdirectories`
3589
+ # parameter.
3590
+ #
3591
+ # * For Amazon File Cache, the path can be an S3 bucket or prefix in
3592
+ # the format `s3://myBucket/myPrefix/`.
3593
+ #
3594
+ # * For Amazon FSx for Lustre, the path can be an S3 bucket or prefix
3595
+ # in the format `s3://myBucket/myPrefix/`.
3329
3596
  # @return [String]
3330
3597
  #
3331
3598
  # @!attribute [rw] batch_import_meta_data_on_create
3332
3599
  # A boolean flag indicating whether an import data repository task to
3333
3600
  # import metadata should run after the data repository association is
3334
3601
  # created. The task runs if this flag is set to `true`.
3602
+ #
3603
+ # <note markdown="1"> `BatchImportMetaDataOnCreate` is not supported for data repositories
3604
+ # linked to an Amazon File Cache resource.
3605
+ #
3606
+ # </note>
3335
3607
  # @return [Boolean]
3336
3608
  #
3337
3609
  # @!attribute [rw] imported_file_chunk_size
@@ -3339,7 +3611,7 @@ module Aws::FSx
3339
3611
  # stripe count and maximum amount of data per file (in MiB) stored on
3340
3612
  # a single physical disk. The maximum number of disks that a single
3341
3613
  # file can be striped across is limited by the total number of disks
3342
- # that make up the file system.
3614
+ # that make up the file system or cache.
3343
3615
  #
3344
3616
  # The default chunk size is 1,024 MiB (1 GiB) and can go as high as
3345
3617
  # 512,000 MiB (500 GiB). Amazon S3 objects have a maximum size of 5
@@ -3348,11 +3620,8 @@ module Aws::FSx
3348
3620
  #
3349
3621
  # @!attribute [rw] s3
3350
3622
  # The configuration for an Amazon S3 data repository linked to an
3351
- # Amazon FSx Lustre file system with a data repository association.
3352
- # The configuration defines which file events (new, changed, or
3353
- # deleted files or directories) are automatically imported from the
3354
- # linked data repository to the file system or automatically exported
3355
- # from the file system to the data repository.
3623
+ # Amazon FSx for Lustre file system with a data repository
3624
+ # association.
3356
3625
  # @return [Types::S3DataRepositoryConfiguration]
3357
3626
  #
3358
3627
  # @!attribute [rw] tags
@@ -3364,6 +3633,49 @@ module Aws::FSx
3364
3633
  # 1970-01-01T00:00:00Z), also known as Unix time.
3365
3634
  # @return [Time]
3366
3635
  #
3636
+ # @!attribute [rw] file_cache_id
3637
+ # The globally unique ID of the Amazon File Cache resource.
3638
+ # @return [String]
3639
+ #
3640
+ # @!attribute [rw] file_cache_path
3641
+ # A path on the Amazon File Cache that points to a high-level
3642
+ # directory (such as `/ns1/`) or subdirectory (such as `/ns1/subdir/`)
3643
+ # that will be mapped 1-1 with `DataRepositoryPath`. The leading
3644
+ # forward slash in the path is required. Two data repository
3645
+ # associations cannot have overlapping cache paths. For example, if a
3646
+ # data repository is associated with cache path `/ns1/`, then you
3647
+ # cannot link another data repository with cache path `/ns1/ns2`.
3648
+ #
3649
+ # This path specifies the directory in your cache where files will be
3650
+ # exported from. This cache directory can be linked to only one data
3651
+ # repository (S3 or NFS) and no other data repository can be linked to
3652
+ # the directory.
3653
+ #
3654
+ # <note markdown="1"> The cache path can only be set to root (/) on an NFS DRA when
3655
+ # `DataRepositorySubdirectories` is specified. If you specify root (/)
3656
+ # as the cache path, you can create only one DRA on the cache.
3657
+ #
3658
+ # The cache path cannot be set to root (/) for an S3 DRA.
3659
+ #
3660
+ # </note>
3661
+ # @return [String]
3662
+ #
3663
+ # @!attribute [rw] data_repository_subdirectories
3664
+ # For Amazon File Cache, a list of NFS Exports that will be linked
3665
+ # with an NFS data repository association. All the subdirectories must
3666
+ # be on a single NFS file system. The Export paths are in the format
3667
+ # `/exportpath1`. To use this parameter, you must configure
3668
+ # `DataRepositoryPath` as the domain name of the NFS file system. The
3669
+ # NFS file system domain name in effect is the root of the
3670
+ # subdirectories. Note that `DataRepositorySubdirectories` is not
3671
+ # supported for S3 data repositories.
3672
+ # @return [Array<String>]
3673
+ #
3674
+ # @!attribute [rw] nfs
3675
+ # The configuration for an NFS data repository linked to an Amazon
3676
+ # File Cache resource with a data repository association.
3677
+ # @return [Types::NFSDataRepositoryConfiguration]
3678
+ #
3367
3679
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DataRepositoryAssociation AWS API Documentation
3368
3680
  #
3369
3681
  class DataRepositoryAssociation < Struct.new(
@@ -3378,7 +3690,11 @@ module Aws::FSx
3378
3690
  :imported_file_chunk_size,
3379
3691
  :s3,
3380
3692
  :tags,
3381
- :creation_time)
3693
+ :creation_time,
3694
+ :file_cache_id,
3695
+ :file_cache_path,
3696
+ :data_repository_subdirectories,
3697
+ :nfs)
3382
3698
  SENSITIVE = []
3383
3699
  include Aws::Structure
3384
3700
  end
@@ -3517,8 +3833,9 @@ module Aws::FSx
3517
3833
  end
3518
3834
 
3519
3835
  # A description of the data repository task. You use data repository
3520
- # tasks to perform bulk transfer operations between your Amazon FSx file
3521
- # system and a linked data repository.
3836
+ # tasks to perform bulk transfer operations between an Amazon FSx for
3837
+ # Lustre file system and a linked data repository. An Amazon File Cache
3838
+ # resource uses a task to automatically release files from the cache.
3522
3839
  #
3523
3840
  # @!attribute [rw] task_id
3524
3841
  # The system-generated, unique 17-digit ID of the data repository
@@ -3528,20 +3845,20 @@ module Aws::FSx
3528
3845
  # @!attribute [rw] lifecycle
3529
3846
  # The lifecycle status of the data repository task, as follows:
3530
3847
  #
3531
- # * `PENDING` - Amazon FSx has not started the task.
3848
+ # * `PENDING` - The task has not started.
3532
3849
  #
3533
- # * `EXECUTING` - Amazon FSx is processing the task.
3850
+ # * `EXECUTING` - The task is in process.
3534
3851
  #
3535
- # * `FAILED` - Amazon FSx was not able to complete the task. For
3536
- # example, there may be files the task failed to process. The
3852
+ # * `FAILED` - The task was not able to be completed. For example,
3853
+ # there may be files the task failed to process. The
3537
3854
  # DataRepositoryTaskFailureDetails property provides more
3538
3855
  # information about task failures.
3539
3856
  #
3540
- # * `SUCCEEDED` - FSx completed the task successfully.
3857
+ # * `SUCCEEDED` - The task has completed successfully.
3541
3858
  #
3542
- # * `CANCELED` - Amazon FSx canceled the task and it did not complete.
3859
+ # * `CANCELED` - The task was canceled and it did not complete.
3543
3860
  #
3544
- # * `CANCELING` - FSx is in process of canceling the task.
3861
+ # * `CANCELING` - The task is in process of being canceled.
3545
3862
  #
3546
3863
  # <note markdown="1"> You cannot delete an FSx for Lustre file system if there are data
3547
3864
  # repository tasks for the file system in the `PENDING` or `EXECUTING`
@@ -3557,12 +3874,14 @@ module Aws::FSx
3557
3874
  # @!attribute [rw] type
3558
3875
  # The type of data repository task.
3559
3876
  #
3560
- # * The `EXPORT_TO_REPOSITORY` data repository task exports from your
3561
- # Lustre file system from to a linked S3 bucket.
3877
+ # * `EXPORT_TO_REPOSITORY` tasks export from your Amazon FSx for
3878
+ # Lustre file system to a linked data repository.
3562
3879
  #
3563
- # * The `IMPORT_METADATA_FROM_REPOSITORY` data repository task imports
3564
- # metadata changes from a linked S3 bucket to your Lustre file
3565
- # system.
3880
+ # * `IMPORT_METADATA_FROM_REPOSITORY` tasks import metadata changes
3881
+ # from a linked S3 bucket to your Amazon FSx for Lustre file system.
3882
+ #
3883
+ # * `AUTO_RELEASE_DATA` tasks automatically release files from an
3884
+ # Amazon File Cache resource.
3566
3885
  # @return [String]
3567
3886
  #
3568
3887
  # @!attribute [rw] creation_time
@@ -3571,12 +3890,12 @@ module Aws::FSx
3571
3890
  # @return [Time]
3572
3891
  #
3573
3892
  # @!attribute [rw] start_time
3574
- # The time that Amazon FSx began processing the task.
3893
+ # The time the system began processing the task.
3575
3894
  # @return [Time]
3576
3895
  #
3577
3896
  # @!attribute [rw] end_time
3578
- # The time that Amazon FSx completed processing the task, populated
3579
- # after the task is complete.
3897
+ # The time the system completed processing the task, populated after
3898
+ # the task is complete.
3580
3899
  # @return [Time]
3581
3900
  #
3582
3901
  # @!attribute [rw] resource_arn
@@ -3596,14 +3915,13 @@ module Aws::FSx
3596
3915
  # @return [Array<Types::Tag>]
3597
3916
  #
3598
3917
  # @!attribute [rw] file_system_id
3599
- # The globally unique ID of the file system, assigned by Amazon FSx.
3918
+ # The globally unique ID of the file system.
3600
3919
  # @return [String]
3601
3920
  #
3602
3921
  # @!attribute [rw] paths
3603
- # An array of paths on the Amazon FSx for Lustre file system that
3604
- # specify the data for the data repository task to process. For
3605
- # example, in an EXPORT\_TO\_REPOSITORY task, the paths specify which
3606
- # data to export to the linked data repository.
3922
+ # An array of paths that specify the data for the data repository task
3923
+ # to process. For example, in an EXPORT\_TO\_REPOSITORY task, the
3924
+ # paths specify which data to export to the linked data repository.
3607
3925
  #
3608
3926
  # (Default) If `Paths` is not specified, Amazon FSx uses the file
3609
3927
  # system root directory.
@@ -3628,6 +3946,16 @@ module Aws::FSx
3628
3946
  # gets generated for a task using the `Enabled` parameter.
3629
3947
  # @return [Types::CompletionReport]
3630
3948
  #
3949
+ # @!attribute [rw] capacity_to_release
3950
+ # Specifies the amount of data to release, in GiB, by an Amazon File
3951
+ # Cache AUTO\_RELEASE\_DATA task that automatically releases files
3952
+ # from the cache.
3953
+ # @return [Integer]
3954
+ #
3955
+ # @!attribute [rw] file_cache_id
3956
+ # The system-generated, unique ID of the cache.
3957
+ # @return [String]
3958
+ #
3631
3959
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DataRepositoryTask AWS API Documentation
3632
3960
  #
3633
3961
  class DataRepositoryTask < Struct.new(
@@ -3643,7 +3971,9 @@ module Aws::FSx
3643
3971
  :paths,
3644
3972
  :failure_details,
3645
3973
  :status,
3646
- :report)
3974
+ :report,
3975
+ :capacity_to_release,
3976
+ :file_cache_id)
3647
3977
  SENSITIVE = []
3648
3978
  include Aws::Structure
3649
3979
  end
@@ -3704,7 +4034,7 @@ module Aws::FSx
3704
4034
  # data as a hash:
3705
4035
  #
3706
4036
  # {
3707
- # name: "file-system-id", # accepts file-system-id, task-lifecycle, data-repository-association-id
4037
+ # name: "file-system-id", # accepts file-system-id, task-lifecycle, data-repository-association-id, file-cache-id
3708
4038
  # values: ["DataRepositoryTaskFilterValue"],
3709
4039
  # }
3710
4040
  #
@@ -3773,13 +4103,20 @@ module Aws::FSx
3773
4103
  # The time at which the task status was last updated.
3774
4104
  # @return [Time]
3775
4105
  #
4106
+ # @!attribute [rw] released_capacity
4107
+ # The total amount of data, in GiB, released by an Amazon File Cache
4108
+ # AUTO\_RELEASE\_DATA task that automatically releases files from the
4109
+ # cache.
4110
+ # @return [Integer]
4111
+ #
3776
4112
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DataRepositoryTaskStatus AWS API Documentation
3777
4113
  #
3778
4114
  class DataRepositoryTaskStatus < Struct.new(
3779
4115
  :total_count,
3780
4116
  :succeeded_count,
3781
4117
  :failed_count,
3782
- :last_updated_time)
4118
+ :last_updated_time,
4119
+ :released_capacity)
3783
4120
  SENSITIVE = []
3784
4121
  include Aws::Structure
3785
4122
  end
@@ -3842,7 +4179,7 @@ module Aws::FSx
3842
4179
  # {
3843
4180
  # association_id: "DataRepositoryAssociationId", # required
3844
4181
  # client_request_token: "ClientRequestToken",
3845
- # delete_data_in_file_system: false, # required
4182
+ # delete_data_in_file_system: false,
3846
4183
  # }
3847
4184
  #
3848
4185
  # @!attribute [rw] association_id
@@ -3898,6 +4235,56 @@ module Aws::FSx
3898
4235
  include Aws::Structure
3899
4236
  end
3900
4237
 
4238
+ # @note When making an API call, you may pass DeleteFileCacheRequest
4239
+ # data as a hash:
4240
+ #
4241
+ # {
4242
+ # file_cache_id: "FileCacheId", # required
4243
+ # client_request_token: "ClientRequestToken",
4244
+ # }
4245
+ #
4246
+ # @!attribute [rw] file_cache_id
4247
+ # The ID of the cache that's being deleted.
4248
+ # @return [String]
4249
+ #
4250
+ # @!attribute [rw] client_request_token
4251
+ # (Optional) An idempotency token for resource creation, in a string
4252
+ # of up to 64 ASCII characters. This token is automatically filled on
4253
+ # your behalf when you use the Command Line Interface (CLI) or an
4254
+ # Amazon Web Services SDK.
4255
+ #
4256
+ # **A suitable default value is auto-generated.** You should normally
4257
+ # not need to pass this option.
4258
+ # @return [String]
4259
+ #
4260
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DeleteFileCacheRequest AWS API Documentation
4261
+ #
4262
+ class DeleteFileCacheRequest < Struct.new(
4263
+ :file_cache_id,
4264
+ :client_request_token)
4265
+ SENSITIVE = []
4266
+ include Aws::Structure
4267
+ end
4268
+
4269
+ # @!attribute [rw] file_cache_id
4270
+ # The ID of the cache that's being deleted.
4271
+ # @return [String]
4272
+ #
4273
+ # @!attribute [rw] lifecycle
4274
+ # The cache lifecycle for the deletion request. If the
4275
+ # `DeleteFileCache` operation is successful, this status is
4276
+ # `DELETING`.
4277
+ # @return [String]
4278
+ #
4279
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DeleteFileCacheResponse AWS API Documentation
4280
+ #
4281
+ class DeleteFileCacheResponse < Struct.new(
4282
+ :file_cache_id,
4283
+ :lifecycle)
4284
+ SENSITIVE = []
4285
+ include Aws::Structure
4286
+ end
4287
+
3901
4288
  # The configuration object for the Amazon FSx for Lustre file system
3902
4289
  # being deleted in the `DeleteFileSystem` operation.
3903
4290
  #
@@ -4470,7 +4857,7 @@ module Aws::FSx
4470
4857
  # backup_ids: ["BackupId"],
4471
4858
  # filters: [
4472
4859
  # {
4473
- # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type
4860
+ # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type, file-cache-id, file-cache-type
4474
4861
  # values: ["FilterValue"],
4475
4862
  # },
4476
4863
  # ],
@@ -4542,7 +4929,7 @@ module Aws::FSx
4542
4929
  # association_ids: ["DataRepositoryAssociationId"],
4543
4930
  # filters: [
4544
4931
  # {
4545
- # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type
4932
+ # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type, file-cache-id, file-cache-type
4546
4933
  # values: ["FilterValue"],
4547
4934
  # },
4548
4935
  # ],
@@ -4583,7 +4970,7 @@ module Aws::FSx
4583
4970
  end
4584
4971
 
4585
4972
  # @!attribute [rw] associations
4586
- # An array of one ore more data repository association descriptions.
4973
+ # An array of one or more data repository association descriptions.
4587
4974
  # @return [Array<Types::DataRepositoryAssociation>]
4588
4975
  #
4589
4976
  # @!attribute [rw] next_token
@@ -4609,7 +4996,7 @@ module Aws::FSx
4609
4996
  # task_ids: ["TaskId"],
4610
4997
  # filters: [
4611
4998
  # {
4612
- # name: "file-system-id", # accepts file-system-id, task-lifecycle, data-repository-association-id
4999
+ # name: "file-system-id", # accepts file-system-id, task-lifecycle, data-repository-association-id, file-cache-id
4613
5000
  # values: ["DataRepositoryTaskFilterValue"],
4614
5001
  # },
4615
5002
  # ],
@@ -4671,26 +5058,81 @@ module Aws::FSx
4671
5058
  include Aws::Structure
4672
5059
  end
4673
5060
 
4674
- # The request object for `DescribeFileSystemAliases` operation.
4675
- #
4676
- # @note When making an API call, you may pass DescribeFileSystemAliasesRequest
5061
+ # @note When making an API call, you may pass DescribeFileCachesRequest
4677
5062
  # data as a hash:
4678
5063
  #
4679
5064
  # {
4680
- # client_request_token: "ClientRequestToken",
4681
- # file_system_id: "FileSystemId", # required
5065
+ # file_cache_ids: ["FileCacheId"],
4682
5066
  # max_results: 1,
4683
5067
  # next_token: "NextToken",
4684
5068
  # }
4685
5069
  #
4686
- # @!attribute [rw] client_request_token
4687
- # (Optional) An idempotency token for resource creation, in a string
4688
- # of up to 64 ASCII characters. This token is automatically filled on
4689
- # your behalf when you use the Command Line Interface (CLI) or an
4690
- # Amazon Web Services SDK.
5070
+ # @!attribute [rw] file_cache_ids
5071
+ # IDs of the caches whose descriptions you want to retrieve (String).
5072
+ # @return [Array<String>]
4691
5073
  #
4692
- # **A suitable default value is auto-generated.** You should normally
4693
- # not need to pass this option.
5074
+ # @!attribute [rw] max_results
5075
+ # The maximum number of resources to return in the response. This
5076
+ # value must be an integer greater than zero.
5077
+ # @return [Integer]
5078
+ #
5079
+ # @!attribute [rw] next_token
5080
+ # (Optional) Opaque pagination token returned from a previous
5081
+ # operation (String). If present, this token indicates from what point
5082
+ # you can continue processing the request, where the previous
5083
+ # `NextToken` value left off.
5084
+ # @return [String]
5085
+ #
5086
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DescribeFileCachesRequest AWS API Documentation
5087
+ #
5088
+ class DescribeFileCachesRequest < Struct.new(
5089
+ :file_cache_ids,
5090
+ :max_results,
5091
+ :next_token)
5092
+ SENSITIVE = []
5093
+ include Aws::Structure
5094
+ end
5095
+
5096
+ # @!attribute [rw] file_caches
5097
+ # The response object for the `DescribeFileCaches` operation.
5098
+ # @return [Array<Types::FileCache>]
5099
+ #
5100
+ # @!attribute [rw] next_token
5101
+ # (Optional) Opaque pagination token returned from a previous
5102
+ # operation (String). If present, this token indicates from what point
5103
+ # you can continue processing the request, where the previous
5104
+ # `NextToken` value left off.
5105
+ # @return [String]
5106
+ #
5107
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DescribeFileCachesResponse AWS API Documentation
5108
+ #
5109
+ class DescribeFileCachesResponse < Struct.new(
5110
+ :file_caches,
5111
+ :next_token)
5112
+ SENSITIVE = []
5113
+ include Aws::Structure
5114
+ end
5115
+
5116
+ # The request object for `DescribeFileSystemAliases` operation.
5117
+ #
5118
+ # @note When making an API call, you may pass DescribeFileSystemAliasesRequest
5119
+ # data as a hash:
5120
+ #
5121
+ # {
5122
+ # client_request_token: "ClientRequestToken",
5123
+ # file_system_id: "FileSystemId", # required
5124
+ # max_results: 1,
5125
+ # next_token: "NextToken",
5126
+ # }
5127
+ #
5128
+ # @!attribute [rw] client_request_token
5129
+ # (Optional) An idempotency token for resource creation, in a string
5130
+ # of up to 64 ASCII characters. This token is automatically filled on
5131
+ # your behalf when you use the Command Line Interface (CLI) or an
5132
+ # Amazon Web Services SDK.
5133
+ #
5134
+ # **A suitable default value is auto-generated.** You should normally
5135
+ # not need to pass this option.
4694
5136
  # @return [String]
4695
5137
  #
4696
5138
  # @!attribute [rw] file_system_id
@@ -5105,6 +5547,515 @@ module Aws::FSx
5105
5547
  include Aws::Structure
5106
5548
  end
5107
5549
 
5550
+ # A description of a specific Amazon File Cache resource, which is a
5551
+ # response object from the `DescribeFileCaches` operation.
5552
+ #
5553
+ # @!attribute [rw] owner_id
5554
+ # An Amazon Web Services account ID. This ID is a 12-digit number that
5555
+ # you use to construct Amazon Resource Names (ARNs) for resources.
5556
+ # @return [String]
5557
+ #
5558
+ # @!attribute [rw] creation_time
5559
+ # The time that the resource was created, in seconds (since
5560
+ # 1970-01-01T00:00:00Z), also known as Unix time.
5561
+ # @return [Time]
5562
+ #
5563
+ # @!attribute [rw] file_cache_id
5564
+ # The system-generated, unique ID of the cache.
5565
+ # @return [String]
5566
+ #
5567
+ # @!attribute [rw] file_cache_type
5568
+ # The type of cache, which must be `LUSTRE`.
5569
+ # @return [String]
5570
+ #
5571
+ # @!attribute [rw] file_cache_type_version
5572
+ # The Lustre version of the cache, which must be `2.12`.
5573
+ # @return [String]
5574
+ #
5575
+ # @!attribute [rw] lifecycle
5576
+ # The lifecycle status of the cache. The following are the possible
5577
+ # values and what they mean:
5578
+ #
5579
+ # * `AVAILABLE` - The cache is in a healthy state, and is reachable
5580
+ # and available for use.
5581
+ #
5582
+ # * `CREATING` - The new cache is being created.
5583
+ #
5584
+ # * `DELETING` - An existing cache is being deleted.
5585
+ #
5586
+ # * `UPDATING` - The cache is undergoing a customer-initiated update.
5587
+ #
5588
+ # * `FAILED` - An existing cache has experienced an unrecoverable
5589
+ # failure. When creating a new cache, the cache was unable to be
5590
+ # created.
5591
+ # @return [String]
5592
+ #
5593
+ # @!attribute [rw] failure_details
5594
+ # A structure providing details of any failures that occurred.
5595
+ # @return [Types::FileCacheFailureDetails]
5596
+ #
5597
+ # @!attribute [rw] storage_capacity
5598
+ # The storage capacity of the cache in gibibytes (GiB).
5599
+ # @return [Integer]
5600
+ #
5601
+ # @!attribute [rw] vpc_id
5602
+ # The ID of your virtual private cloud (VPC). For more information,
5603
+ # see [VPC and subnets][1] in the *Amazon VPC User Guide*.
5604
+ #
5605
+ #
5606
+ #
5607
+ # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Subnets.html
5608
+ # @return [String]
5609
+ #
5610
+ # @!attribute [rw] subnet_ids
5611
+ # A list of subnet IDs that the cache will be accessible from. You can
5612
+ # specify only one subnet ID in a call to the `CreateFileCache`
5613
+ # operation.
5614
+ # @return [Array<String>]
5615
+ #
5616
+ # @!attribute [rw] network_interface_ids
5617
+ # A list of network interface IDs.
5618
+ # @return [Array<String>]
5619
+ #
5620
+ # @!attribute [rw] dns_name
5621
+ # The Domain Name System (DNS) name for the cache.
5622
+ # @return [String]
5623
+ #
5624
+ # @!attribute [rw] kms_key_id
5625
+ # Specifies the ID of the Key Management Service (KMS) key to use for
5626
+ # encrypting data on an Amazon File Cache. If a `KmsKeyId` isn't
5627
+ # specified, the Amazon FSx-managed KMS key for your account is used.
5628
+ # For more information, see [Encrypt][1] in the *Key Management
5629
+ # Service API Reference*.
5630
+ #
5631
+ #
5632
+ #
5633
+ # [1]: https://docs.aws.amazon.com/kms/latest/APIReference/API_Encrypt.html
5634
+ # @return [String]
5635
+ #
5636
+ # @!attribute [rw] resource_arn
5637
+ # The Amazon Resource Name (ARN) for a given resource. ARNs uniquely
5638
+ # identify Amazon Web Services resources. We require an ARN when you
5639
+ # need to specify a resource unambiguously across all of Amazon Web
5640
+ # Services. For more information, see [Amazon Resource Names
5641
+ # (ARNs)][1] in the *Amazon Web Services General Reference*.
5642
+ #
5643
+ #
5644
+ #
5645
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
5646
+ # @return [String]
5647
+ #
5648
+ # @!attribute [rw] lustre_configuration
5649
+ # The configuration for the Amazon File Cache resource.
5650
+ # @return [Types::FileCacheLustreConfiguration]
5651
+ #
5652
+ # @!attribute [rw] data_repository_association_ids
5653
+ # A list of IDs of data repository associations that are associated
5654
+ # with this cache.
5655
+ # @return [Array<String>]
5656
+ #
5657
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCache AWS API Documentation
5658
+ #
5659
+ class FileCache < Struct.new(
5660
+ :owner_id,
5661
+ :creation_time,
5662
+ :file_cache_id,
5663
+ :file_cache_type,
5664
+ :file_cache_type_version,
5665
+ :lifecycle,
5666
+ :failure_details,
5667
+ :storage_capacity,
5668
+ :vpc_id,
5669
+ :subnet_ids,
5670
+ :network_interface_ids,
5671
+ :dns_name,
5672
+ :kms_key_id,
5673
+ :resource_arn,
5674
+ :lustre_configuration,
5675
+ :data_repository_association_ids)
5676
+ SENSITIVE = []
5677
+ include Aws::Structure
5678
+ end
5679
+
5680
+ # The response object for the Amazon File Cache resource being created
5681
+ # in the `CreateFileCache` operation.
5682
+ #
5683
+ # @!attribute [rw] owner_id
5684
+ # An Amazon Web Services account ID. This ID is a 12-digit number that
5685
+ # you use to construct Amazon Resource Names (ARNs) for resources.
5686
+ # @return [String]
5687
+ #
5688
+ # @!attribute [rw] creation_time
5689
+ # The time that the resource was created, in seconds (since
5690
+ # 1970-01-01T00:00:00Z), also known as Unix time.
5691
+ # @return [Time]
5692
+ #
5693
+ # @!attribute [rw] file_cache_id
5694
+ # The system-generated, unique ID of the cache.
5695
+ # @return [String]
5696
+ #
5697
+ # @!attribute [rw] file_cache_type
5698
+ # The type of cache, which must be `LUSTRE`.
5699
+ # @return [String]
5700
+ #
5701
+ # @!attribute [rw] file_cache_type_version
5702
+ # The Lustre version of the cache, which must be `2.12`.
5703
+ # @return [String]
5704
+ #
5705
+ # @!attribute [rw] lifecycle
5706
+ # The lifecycle status of the cache. The following are the possible
5707
+ # values and what they mean:
5708
+ #
5709
+ # * `AVAILABLE` - The cache is in a healthy state, and is reachable
5710
+ # and available for use.
5711
+ #
5712
+ # * `CREATING` - The new cache is being created.
5713
+ #
5714
+ # * `DELETING` - An existing cache is being deleted.
5715
+ #
5716
+ # * `UPDATING` - The cache is undergoing a customer-initiated update.
5717
+ #
5718
+ # * `FAILED` - An existing cache has experienced an unrecoverable
5719
+ # failure. When creating a new cache, the cache was unable to be
5720
+ # created.
5721
+ # @return [String]
5722
+ #
5723
+ # @!attribute [rw] failure_details
5724
+ # A structure providing details of any failures that occurred.
5725
+ # @return [Types::FileCacheFailureDetails]
5726
+ #
5727
+ # @!attribute [rw] storage_capacity
5728
+ # The storage capacity of the cache in gibibytes (GiB).
5729
+ # @return [Integer]
5730
+ #
5731
+ # @!attribute [rw] vpc_id
5732
+ # The ID of your virtual private cloud (VPC). For more information,
5733
+ # see [VPC and subnets][1] in the *Amazon VPC User Guide*.
5734
+ #
5735
+ #
5736
+ #
5737
+ # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Subnets.html
5738
+ # @return [String]
5739
+ #
5740
+ # @!attribute [rw] subnet_ids
5741
+ # A list of subnet IDs that the cache will be accessible from. You can
5742
+ # specify only one subnet ID in a call to the `CreateFileCache`
5743
+ # operation.
5744
+ # @return [Array<String>]
5745
+ #
5746
+ # @!attribute [rw] network_interface_ids
5747
+ # A list of network interface IDs.
5748
+ # @return [Array<String>]
5749
+ #
5750
+ # @!attribute [rw] dns_name
5751
+ # The Domain Name System (DNS) name for the cache.
5752
+ # @return [String]
5753
+ #
5754
+ # @!attribute [rw] kms_key_id
5755
+ # Specifies the ID of the Key Management Service (KMS) key to use for
5756
+ # encrypting data on an Amazon File Cache. If a `KmsKeyId` isn't
5757
+ # specified, the Amazon FSx-managed KMS key for your account is used.
5758
+ # For more information, see [Encrypt][1] in the *Key Management
5759
+ # Service API Reference*.
5760
+ #
5761
+ #
5762
+ #
5763
+ # [1]: https://docs.aws.amazon.com/kms/latest/APIReference/API_Encrypt.html
5764
+ # @return [String]
5765
+ #
5766
+ # @!attribute [rw] resource_arn
5767
+ # The Amazon Resource Name (ARN) for a given resource. ARNs uniquely
5768
+ # identify Amazon Web Services resources. We require an ARN when you
5769
+ # need to specify a resource unambiguously across all of Amazon Web
5770
+ # Services. For more information, see [Amazon Resource Names
5771
+ # (ARNs)][1] in the *Amazon Web Services General Reference*.
5772
+ #
5773
+ #
5774
+ #
5775
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
5776
+ # @return [String]
5777
+ #
5778
+ # @!attribute [rw] tags
5779
+ # A list of `Tag` values, with a maximum of 50 elements.
5780
+ # @return [Array<Types::Tag>]
5781
+ #
5782
+ # @!attribute [rw] copy_tags_to_data_repository_associations
5783
+ # A boolean flag indicating whether tags for the cache should be
5784
+ # copied to data repository associations.
5785
+ # @return [Boolean]
5786
+ #
5787
+ # @!attribute [rw] lustre_configuration
5788
+ # The configuration for the Amazon File Cache resource.
5789
+ # @return [Types::FileCacheLustreConfiguration]
5790
+ #
5791
+ # @!attribute [rw] data_repository_association_ids
5792
+ # A list of IDs of data repository associations that are associated
5793
+ # with this cache.
5794
+ # @return [Array<String>]
5795
+ #
5796
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheCreating AWS API Documentation
5797
+ #
5798
+ class FileCacheCreating < Struct.new(
5799
+ :owner_id,
5800
+ :creation_time,
5801
+ :file_cache_id,
5802
+ :file_cache_type,
5803
+ :file_cache_type_version,
5804
+ :lifecycle,
5805
+ :failure_details,
5806
+ :storage_capacity,
5807
+ :vpc_id,
5808
+ :subnet_ids,
5809
+ :network_interface_ids,
5810
+ :dns_name,
5811
+ :kms_key_id,
5812
+ :resource_arn,
5813
+ :tags,
5814
+ :copy_tags_to_data_repository_associations,
5815
+ :lustre_configuration,
5816
+ :data_repository_association_ids)
5817
+ SENSITIVE = []
5818
+ include Aws::Structure
5819
+ end
5820
+
5821
+ # The configuration for a data repository association (DRA) to be
5822
+ # created during the Amazon File Cache resource creation. The DRA links
5823
+ # the cache to either an Amazon S3 bucket or prefix, or a Network File
5824
+ # System (NFS) data repository that supports the NFSv3 protocol.
5825
+ #
5826
+ # The DRA does not support automatic import or automatic export.
5827
+ #
5828
+ # @note When making an API call, you may pass FileCacheDataRepositoryAssociation
5829
+ # data as a hash:
5830
+ #
5831
+ # {
5832
+ # file_cache_path: "Namespace", # required
5833
+ # data_repository_path: "ArchivePath", # required
5834
+ # data_repository_subdirectories: ["Namespace"],
5835
+ # nfs: {
5836
+ # version: "NFS3", # required, accepts NFS3
5837
+ # dns_ips: ["IpAddress"],
5838
+ # },
5839
+ # }
5840
+ #
5841
+ # @!attribute [rw] file_cache_path
5842
+ # A path on the cache that points to a high-level directory (such as
5843
+ # `/ns1/`) or subdirectory (such as `/ns1/subdir/`) that will be
5844
+ # mapped 1-1 with `DataRepositoryPath`. The leading forward slash in
5845
+ # the name is required. Two data repository associations cannot have
5846
+ # overlapping cache paths. For example, if a data repository is
5847
+ # associated with cache path `/ns1/`, then you cannot link another
5848
+ # data repository with cache path `/ns1/ns2`.
5849
+ #
5850
+ # This path specifies where in your cache files will be exported from.
5851
+ # This cache directory can be linked to only one data repository, and
5852
+ # no data repository other can be linked to the directory.
5853
+ #
5854
+ # <note markdown="1"> The cache path can only be set to root (/) on an NFS DRA when
5855
+ # `DataRepositorySubdirectories` is specified. If you specify root (/)
5856
+ # as the cache path, you can create only one DRA on the cache.
5857
+ #
5858
+ # The cache path cannot be set to root (/) for an S3 DRA.
5859
+ #
5860
+ # </note>
5861
+ # @return [String]
5862
+ #
5863
+ # @!attribute [rw] data_repository_path
5864
+ # The path to the S3 or NFS data repository that links to the cache.
5865
+ # You must provide one of the following paths:
5866
+ #
5867
+ # * The path can be an NFS data repository that links to the cache.
5868
+ # The path can be in one of two formats:
5869
+ #
5870
+ # * If you are not using the `DataRepositorySubdirectories`
5871
+ # parameter, the path is to an NFS Export directory (or one of its
5872
+ # subdirectories) in the format
5873
+ # `nsf://nfs-domain-name/exportpath`. You can therefore link a
5874
+ # single NFS Export to a single data repository association.
5875
+ #
5876
+ # * If you are using the `DataRepositorySubdirectories` parameter,
5877
+ # the path is the domain name of the NFS file system in the format
5878
+ # `nfs://filer-domain-name`, which indicates the root of the
5879
+ # subdirectories specified with the `DataRepositorySubdirectories`
5880
+ # parameter.
5881
+ #
5882
+ # * The path can be an S3 bucket or prefix in the format
5883
+ # `s3://myBucket/myPrefix/`.
5884
+ # @return [String]
5885
+ #
5886
+ # @!attribute [rw] data_repository_subdirectories
5887
+ # A list of NFS Exports that will be linked with this data repository
5888
+ # association. The Export paths are in the format `/exportpath1`. To
5889
+ # use this parameter, you must configure `DataRepositoryPath` as the
5890
+ # domain name of the NFS file system. The NFS file system domain name
5891
+ # in effect is the root of the subdirectories. Note that
5892
+ # `DataRepositorySubdirectories` is not supported for S3 data
5893
+ # repositories.
5894
+ # @return [Array<String>]
5895
+ #
5896
+ # @!attribute [rw] nfs
5897
+ # The configuration for a data repository association that links an
5898
+ # Amazon File Cache resource to an NFS data repository.
5899
+ # @return [Types::FileCacheNFSConfiguration]
5900
+ #
5901
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheDataRepositoryAssociation AWS API Documentation
5902
+ #
5903
+ class FileCacheDataRepositoryAssociation < Struct.new(
5904
+ :file_cache_path,
5905
+ :data_repository_path,
5906
+ :data_repository_subdirectories,
5907
+ :nfs)
5908
+ SENSITIVE = []
5909
+ include Aws::Structure
5910
+ end
5911
+
5912
+ # A structure providing details of any failures that occurred.
5913
+ #
5914
+ # @!attribute [rw] message
5915
+ # A message describing any failures that occurred.
5916
+ # @return [String]
5917
+ #
5918
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheFailureDetails AWS API Documentation
5919
+ #
5920
+ class FileCacheFailureDetails < Struct.new(
5921
+ :message)
5922
+ SENSITIVE = []
5923
+ include Aws::Structure
5924
+ end
5925
+
5926
+ # The configuration for the Amazon File Cache resource.
5927
+ #
5928
+ # @!attribute [rw] per_unit_storage_throughput
5929
+ # Per unit storage throughput represents the megabytes per second of
5930
+ # read or write throughput per 1 tebibyte of storage provisioned.
5931
+ # Cache throughput capacity is equal to Storage capacity (TiB) *
5932
+ # PerUnitStorageThroughput (MB/s/TiB). The only supported value is
5933
+ # `1000`.
5934
+ # @return [Integer]
5935
+ #
5936
+ # @!attribute [rw] deployment_type
5937
+ # The deployment type of the Amazon File Cache resource, which must be
5938
+ # `CACHE_1`.
5939
+ # @return [String]
5940
+ #
5941
+ # @!attribute [rw] mount_name
5942
+ # You use the `MountName` value when mounting the cache. If you pass a
5943
+ # cache ID to the `DescribeFileCaches` operation, it returns the the
5944
+ # `MountName` value as part of the cache's description.
5945
+ # @return [String]
5946
+ #
5947
+ # @!attribute [rw] weekly_maintenance_start_time
5948
+ # A recurring weekly time, in the format `D:HH:MM`.
5949
+ #
5950
+ # `D` is the day of the week, for which 1 represents Monday and 7
5951
+ # represents Sunday. For further details, see [the ISO-8601 spec as
5952
+ # described on Wikipedia][1].
5953
+ #
5954
+ # `HH` is the zero-padded hour of the day (0-23), and `MM` is the
5955
+ # zero-padded minute of the hour.
5956
+ #
5957
+ # For example, `1:05:00` specifies maintenance at 5 AM Monday.
5958
+ #
5959
+ #
5960
+ #
5961
+ # [1]: https://en.wikipedia.org/wiki/ISO_week_date
5962
+ # @return [String]
5963
+ #
5964
+ # @!attribute [rw] metadata_configuration
5965
+ # The configuration for a Lustre MDT (Metadata Target) storage volume.
5966
+ # @return [Types::FileCacheLustreMetadataConfiguration]
5967
+ #
5968
+ # @!attribute [rw] log_configuration
5969
+ # The configuration for Lustre logging used to write the enabled
5970
+ # logging events for your Amazon File Cache resource to Amazon
5971
+ # CloudWatch Logs.
5972
+ # @return [Types::LustreLogConfiguration]
5973
+ #
5974
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheLustreConfiguration AWS API Documentation
5975
+ #
5976
+ class FileCacheLustreConfiguration < Struct.new(
5977
+ :per_unit_storage_throughput,
5978
+ :deployment_type,
5979
+ :mount_name,
5980
+ :weekly_maintenance_start_time,
5981
+ :metadata_configuration,
5982
+ :log_configuration)
5983
+ SENSITIVE = []
5984
+ include Aws::Structure
5985
+ end
5986
+
5987
+ # The configuration for a Lustre MDT (Metadata Target) storage volume.
5988
+ # The metadata on Amazon File Cache is managed by a Lustre Metadata
5989
+ # Server (MDS) while the actual metadata is persisted on an MDT.
5990
+ #
5991
+ # @note When making an API call, you may pass FileCacheLustreMetadataConfiguration
5992
+ # data as a hash:
5993
+ #
5994
+ # {
5995
+ # storage_capacity: 1, # required
5996
+ # }
5997
+ #
5998
+ # @!attribute [rw] storage_capacity
5999
+ # The storage capacity of the Lustre MDT (Metadata Target) storage
6000
+ # volume in gibibytes (GiB). The only supported value is `2400` GiB.
6001
+ # @return [Integer]
6002
+ #
6003
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheLustreMetadataConfiguration AWS API Documentation
6004
+ #
6005
+ class FileCacheLustreMetadataConfiguration < Struct.new(
6006
+ :storage_capacity)
6007
+ SENSITIVE = []
6008
+ include Aws::Structure
6009
+ end
6010
+
6011
+ # The configuration for an NFS data repository association (DRA) created
6012
+ # during the creation of the Amazon File Cache resource.
6013
+ #
6014
+ # @note When making an API call, you may pass FileCacheNFSConfiguration
6015
+ # data as a hash:
6016
+ #
6017
+ # {
6018
+ # version: "NFS3", # required, accepts NFS3
6019
+ # dns_ips: ["IpAddress"],
6020
+ # }
6021
+ #
6022
+ # @!attribute [rw] version
6023
+ # The version of the NFS (Network File System) protocol of the NFS
6024
+ # data repository. The only supported value is `NFS3`, which indicates
6025
+ # that the data repository must support the NFSv3 protocol.
6026
+ # @return [String]
6027
+ #
6028
+ # @!attribute [rw] dns_ips
6029
+ # A list of up to 2 IP addresses of DNS servers used to resolve the
6030
+ # NFS file system domain name. The provided IP addresses can either be
6031
+ # the IP addresses of a DNS forwarder or resolver that the customer
6032
+ # manages and runs inside the customer VPC, or the IP addresses of the
6033
+ # on-premises DNS servers.
6034
+ # @return [Array<String>]
6035
+ #
6036
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheNFSConfiguration AWS API Documentation
6037
+ #
6038
+ class FileCacheNFSConfiguration < Struct.new(
6039
+ :version,
6040
+ :dns_ips)
6041
+ SENSITIVE = []
6042
+ include Aws::Structure
6043
+ end
6044
+
6045
+ # No caches were found based upon supplied parameters.
6046
+ #
6047
+ # @!attribute [rw] message
6048
+ # A detailed error message.
6049
+ # @return [String]
6050
+ #
6051
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileCacheNotFound AWS API Documentation
6052
+ #
6053
+ class FileCacheNotFound < Struct.new(
6054
+ :message)
6055
+ SENSITIVE = []
6056
+ include Aws::Structure
6057
+ end
6058
+
5108
6059
  # A description of a specific Amazon FSx file system.
5109
6060
  #
5110
6061
  # @!attribute [rw] owner_id
@@ -5155,8 +6106,7 @@ module Aws::FSx
5155
6106
  # @return [String]
5156
6107
  #
5157
6108
  # @!attribute [rw] failure_details
5158
- # A structure providing details of any failures that occurred when
5159
- # creating a file system.
6109
+ # A structure providing details of any failures that occurred.
5160
6110
  # @return [Types::FileSystemFailureDetails]
5161
6111
  #
5162
6112
  # @!attribute [rw] storage_capacity
@@ -5343,12 +6293,10 @@ module Aws::FSx
5343
6293
  include Aws::Structure
5344
6294
  end
5345
6295
 
5346
- # A structure providing details of any failures that occurred when
5347
- # creating a file system.
6296
+ # A structure providing details of any failures that occurred.
5348
6297
  #
5349
6298
  # @!attribute [rw] message
5350
- # A message describing any failures that occurred during file system
5351
- # creation.
6299
+ # A message describing any failures that occurred.
5352
6300
  # @return [String]
5353
6301
  #
5354
6302
  # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/FileSystemFailureDetails AWS API Documentation
@@ -5381,7 +6329,7 @@ module Aws::FSx
5381
6329
  # data as a hash:
5382
6330
  #
5383
6331
  # {
5384
- # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type
6332
+ # name: "file-system-id", # accepts file-system-id, backup-type, file-system-type, volume-id, data-repository-type, file-cache-id, file-cache-type
5385
6333
  # values: ["FilterValue"],
5386
6334
  # }
5387
6335
  #
@@ -5808,16 +6756,8 @@ module Aws::FSx
5808
6756
  end
5809
6757
 
5810
6758
  # The configuration for Lustre logging used to write the enabled logging
5811
- # events for your file system to Amazon CloudWatch Logs.
5812
- #
5813
- # When logging is enabled, Lustre logs error and warning events from
5814
- # data repository operations such as automatic export and data
5815
- # repository tasks. To learn more about Lustre logging, see [Logging
5816
- # with Amazon CloudWatch Logs][1].
5817
- #
5818
- #
5819
- #
5820
- # [1]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/cw-event-logging.html
6759
+ # events for your Amazon FSx for Lustre file system or Amazon File Cache
6760
+ # resource to Amazon CloudWatch Logs.
5821
6761
  #
5822
6762
  # @!attribute [rw] level
5823
6763
  # The data repository events that are logged by Amazon FSx.
@@ -5829,6 +6769,9 @@ module Aws::FSx
5829
6769
  # * `WARN_ERROR` - both warning events and error events are logged.
5830
6770
  #
5831
6771
  # * `DISABLED` - logging of data repository events is turned off.
6772
+ #
6773
+ # Note that Amazon File Cache uses a default setting of `WARN_ERROR`,
6774
+ # which can't be changed.
5832
6775
  # @return [String]
5833
6776
  #
5834
6777
  # @!attribute [rw] destination
@@ -5849,22 +6792,12 @@ module Aws::FSx
5849
6792
  end
5850
6793
 
5851
6794
  # The Lustre logging configuration used when creating or updating an
5852
- # Amazon FSx for Lustre file system. Lustre logging writes the enabled
5853
- # logging events for your file system to Amazon CloudWatch Logs.
5854
- #
5855
- # Error and warning events can be logged from the following data
5856
- # repository operations:
5857
- #
5858
- # * Automatic export
6795
+ # Amazon FSx for Lustre file system. An Amazon File Cache is created
6796
+ # with Lustre logging enabled by default, with a setting of `WARN_ERROR`
6797
+ # for the logging events. which can't be changed.
5859
6798
  #
5860
- # * Data repository tasks
5861
- #
5862
- # To learn more about Lustre logging, see [Logging to Amazon CloudWatch
5863
- # Logs][1].
5864
- #
5865
- #
5866
- #
5867
- # [1]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/cw-event-logging.html
6799
+ # Lustre logging writes the enabled logging events for your file system
6800
+ # or cache to Amazon CloudWatch Logs.
5868
6801
  #
5869
6802
  # @note When making an API call, you may pass LustreLogCreateConfiguration
5870
6803
  # data as a hash:
@@ -5902,7 +6835,8 @@ module Aws::FSx
5902
6835
  #
5903
6836
  # * If you do not provide a destination, Amazon FSx will create and
5904
6837
  # use a log stream in the CloudWatch Logs `/aws/fsx/lustre` log
5905
- # group.
6838
+ # group (for Amazon FSx for Lustre) or `/aws/fsx/filecache` (for
6839
+ # Amazon File Cache).
5906
6840
  #
5907
6841
  # * If `Destination` is provided and the resource does not exist, the
5908
6842
  # request will fail with a `BadRequest` error.
@@ -5982,6 +6916,20 @@ module Aws::FSx
5982
6916
  include Aws::Structure
5983
6917
  end
5984
6918
 
6919
+ # A cache configuration is required for this operation.
6920
+ #
6921
+ # @!attribute [rw] message
6922
+ # A detailed error message.
6923
+ # @return [String]
6924
+ #
6925
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/MissingFileCacheConfiguration AWS API Documentation
6926
+ #
6927
+ class MissingFileCacheConfiguration < Struct.new(
6928
+ :message)
6929
+ SENSITIVE = []
6930
+ include Aws::Structure
6931
+ end
6932
+
5985
6933
  # A file system configuration is required for this operation.
5986
6934
  #
5987
6935
  # @!attribute [rw] message
@@ -6010,6 +6958,38 @@ module Aws::FSx
6010
6958
  include Aws::Structure
6011
6959
  end
6012
6960
 
6961
+ # The configuration for a data repository association that links an
6962
+ # Amazon File Cache resource to an NFS data repository.
6963
+ #
6964
+ # @!attribute [rw] version
6965
+ # The version of the NFS (Network File System) protocol of the NFS
6966
+ # data repository. Currently, the only supported value is `NFS3`,
6967
+ # which indicates that the data repository must support the NFSv3
6968
+ # protocol.
6969
+ # @return [String]
6970
+ #
6971
+ # @!attribute [rw] dns_ips
6972
+ # A list of up to 2 IP addresses of DNS servers used to resolve the
6973
+ # NFS file system domain name. The provided IP addresses can either be
6974
+ # the IP addresses of a DNS forwarder or resolver that the customer
6975
+ # manages and runs inside the customer VPC, or the IP addresses of the
6976
+ # on-premises DNS servers.
6977
+ # @return [Array<String>]
6978
+ #
6979
+ # @!attribute [rw] auto_export_policy
6980
+ # This parameter is not supported for Amazon File Cache.
6981
+ # @return [Types::AutoExportPolicy]
6982
+ #
6983
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/NFSDataRepositoryConfiguration AWS API Documentation
6984
+ #
6985
+ class NFSDataRepositoryConfiguration < Struct.new(
6986
+ :version,
6987
+ :dns_ips,
6988
+ :auto_export_policy)
6989
+ SENSITIVE = []
6990
+ include Aws::Structure
6991
+ end
6992
+
6013
6993
  # The resource specified for the tagging operation is not a resource
6014
6994
  # type owned by Amazon FSx. Use the API of the relevant service to
6015
6995
  # perform the operation.
@@ -6823,13 +7803,19 @@ module Aws::FSx
6823
7803
  end
6824
7804
 
6825
7805
  # The configuration for an Amazon S3 data repository linked to an Amazon
6826
- # FSx Lustre file system with a data repository association. The
6827
- # configuration consists of an `AutoImportPolicy` that defines file
6828
- # events on the data repository are automatically imported to the file
6829
- # system and an `AutoExportPolicy` that defines which file events on the
6830
- # file system are automatically exported to the data repository. File
6831
- # events are when files or directories are added, changed, or deleted on
6832
- # the file system or the data repository.
7806
+ # FSx for Lustre file system with a data repository association. The
7807
+ # configuration consists of an `AutoImportPolicy` that defines which
7808
+ # file events on the data repository are automatically imported to the
7809
+ # file system and an `AutoExportPolicy` that defines which file events
7810
+ # on the file system are automatically exported to the data repository.
7811
+ # File events are when files or directories are added, changed, or
7812
+ # deleted on the file system or the data repository.
7813
+ #
7814
+ # <note markdown="1"> Data repository associations on Amazon File Cache don't use
7815
+ # `S3DataRepositoryConfiguration` because they don't support automatic
7816
+ # import or automatic export.
7817
+ #
7818
+ # </note>
6833
7819
  #
6834
7820
  # @note When making an API call, you may pass S3DataRepositoryConfiguration
6835
7821
  # data as a hash:
@@ -7684,6 +8670,91 @@ module Aws::FSx
7684
8670
  include Aws::Structure
7685
8671
  end
7686
8672
 
8673
+ # The configuration update for an Amazon File Cache resource.
8674
+ #
8675
+ # @note When making an API call, you may pass UpdateFileCacheLustreConfiguration
8676
+ # data as a hash:
8677
+ #
8678
+ # {
8679
+ # weekly_maintenance_start_time: "WeeklyTime",
8680
+ # }
8681
+ #
8682
+ # @!attribute [rw] weekly_maintenance_start_time
8683
+ # A recurring weekly time, in the format `D:HH:MM`.
8684
+ #
8685
+ # `D` is the day of the week, for which 1 represents Monday and 7
8686
+ # represents Sunday. For further details, see [the ISO-8601 spec as
8687
+ # described on Wikipedia][1].
8688
+ #
8689
+ # `HH` is the zero-padded hour of the day (0-23), and `MM` is the
8690
+ # zero-padded minute of the hour.
8691
+ #
8692
+ # For example, `1:05:00` specifies maintenance at 5 AM Monday.
8693
+ #
8694
+ #
8695
+ #
8696
+ # [1]: https://en.wikipedia.org/wiki/ISO_week_date
8697
+ # @return [String]
8698
+ #
8699
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileCacheLustreConfiguration AWS API Documentation
8700
+ #
8701
+ class UpdateFileCacheLustreConfiguration < Struct.new(
8702
+ :weekly_maintenance_start_time)
8703
+ SENSITIVE = []
8704
+ include Aws::Structure
8705
+ end
8706
+
8707
+ # @note When making an API call, you may pass UpdateFileCacheRequest
8708
+ # data as a hash:
8709
+ #
8710
+ # {
8711
+ # file_cache_id: "FileCacheId", # required
8712
+ # client_request_token: "ClientRequestToken",
8713
+ # lustre_configuration: {
8714
+ # weekly_maintenance_start_time: "WeeklyTime",
8715
+ # },
8716
+ # }
8717
+ #
8718
+ # @!attribute [rw] file_cache_id
8719
+ # The ID of the cache that you are updating.
8720
+ # @return [String]
8721
+ #
8722
+ # @!attribute [rw] client_request_token
8723
+ # (Optional) An idempotency token for resource creation, in a string
8724
+ # of up to 64 ASCII characters. This token is automatically filled on
8725
+ # your behalf when you use the Command Line Interface (CLI) or an
8726
+ # Amazon Web Services SDK.
8727
+ #
8728
+ # **A suitable default value is auto-generated.** You should normally
8729
+ # not need to pass this option.
8730
+ # @return [String]
8731
+ #
8732
+ # @!attribute [rw] lustre_configuration
8733
+ # The configuration updates for an Amazon File Cache resource.
8734
+ # @return [Types::UpdateFileCacheLustreConfiguration]
8735
+ #
8736
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileCacheRequest AWS API Documentation
8737
+ #
8738
+ class UpdateFileCacheRequest < Struct.new(
8739
+ :file_cache_id,
8740
+ :client_request_token,
8741
+ :lustre_configuration)
8742
+ SENSITIVE = []
8743
+ include Aws::Structure
8744
+ end
8745
+
8746
+ # @!attribute [rw] file_cache
8747
+ # A description of the cache that was updated.
8748
+ # @return [Types::FileCache]
8749
+ #
8750
+ # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/UpdateFileCacheResponse AWS API Documentation
8751
+ #
8752
+ class UpdateFileCacheResponse < Struct.new(
8753
+ :file_cache)
8754
+ SENSITIVE = []
8755
+ include Aws::Structure
8756
+ end
8757
+
7687
8758
  # The configuration object for Amazon FSx for Lustre file systems used
7688
8759
  # in the `UpdateFileSystem` operation.
7689
8760
  #