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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-fsx/client.rb +499 -45
- data/lib/aws-sdk-fsx/client_api.rb +239 -3
- data/lib/aws-sdk-fsx/errors.rb +32 -0
- data/lib/aws-sdk-fsx/types.rb +1208 -137
- data/lib/aws-sdk-fsx.rb +1 -1
- metadata +2 -2
data/lib/aws-sdk-fsx/types.rb
CHANGED
@@ -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
|
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
|
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` -
|
366
|
-
#
|
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` -
|
369
|
-
#
|
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
|
389
|
-
# system as you modify objects in a linked S3
|
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
|
-
#
|
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",
|
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
|
981
|
-
# specify "/" as the file system path for the first data
|
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
|
-
#
|
2549
|
-
# not specified, it is automatically set to the root
|
2550
|
-
# security style.
|
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
|
3238
|
-
#
|
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
|
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
|
3275
|
-
# system and the
|
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` -
|
3282
|
-
#
|
3283
|
-
#
|
3284
|
-
#
|
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
|
3303
|
-
# (such as `/ns1/`) or subdirectory (such as
|
3304
|
-
# be mapped 1-1 with `DataRepositoryPath`.
|
3305
|
-
# in the name is required. Two data
|
3306
|
-
# have overlapping file system paths.
|
3307
|
-
# repository is associated with file system
|
3308
|
-
# cannot link another data repository with file
|
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
|
3318
|
-
# specify "/" as the file system path for the first data
|
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
|
3326
|
-
# file system.
|
3327
|
-
#
|
3328
|
-
#
|
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
|
3352
|
-
#
|
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
|
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` -
|
3848
|
+
# * `PENDING` - The task has not started.
|
3532
3849
|
#
|
3533
|
-
# * `EXECUTING` -
|
3850
|
+
# * `EXECUTING` - The task is in process.
|
3534
3851
|
#
|
3535
|
-
# * `FAILED` -
|
3536
|
-
#
|
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` -
|
3857
|
+
# * `SUCCEEDED` - The task has completed successfully.
|
3541
3858
|
#
|
3542
|
-
# * `CANCELED` -
|
3859
|
+
# * `CANCELED` - The task was canceled and it did not complete.
|
3543
3860
|
#
|
3544
|
-
# * `CANCELING` -
|
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
|
-
# *
|
3561
|
-
# Lustre file system
|
3877
|
+
# * `EXPORT_TO_REPOSITORY` tasks export from your Amazon FSx for
|
3878
|
+
# Lustre file system to a linked data repository.
|
3562
3879
|
#
|
3563
|
-
# *
|
3564
|
-
#
|
3565
|
-
#
|
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
|
3893
|
+
# The time the system began processing the task.
|
3575
3894
|
# @return [Time]
|
3576
3895
|
#
|
3577
3896
|
# @!attribute [rw] end_time
|
3578
|
-
# The time
|
3579
|
-
#
|
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
|
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
|
3604
|
-
#
|
3605
|
-
#
|
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,
|
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
|
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
|
-
#
|
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
|
-
#
|
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]
|
4687
|
-
#
|
4688
|
-
#
|
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
|
-
#
|
4693
|
-
#
|
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
|
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
|
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
|
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
|
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.
|
5853
|
-
# logging
|
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
|
-
#
|
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
|
6828
|
-
# events on the data repository are automatically imported to the
|
6829
|
-
# system and an `AutoExportPolicy` that defines which file events
|
6830
|
-
# file system are automatically exported to the data repository.
|
6831
|
-
# events are when files or directories are added, changed, or
|
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
|
#
|