Skip to content

Commit 9326b4d

Browse files
author
awstools
committed
feat(client-fsx): For FSx for Lustre, add new data repository task type, RELEASE_DATA_FROM_FILESYSTEM, to release files that have been archived to S3. For FSx for Windows, enable support for configuring and updating SSD IOPS, and for updating storage type. For FSx for OpenZFS, add new deployment type, MULTI_AZ_1.
1 parent 5571771 commit 9326b4d

23 files changed

+1280
-395
lines changed

‎clients/client-fsx/src/commands/CancelDataRepositoryTaskCommand.ts

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,18 +37,21 @@ export interface CancelDataRepositoryTaskCommandOutput extends CancelDataReposit
3737
/**
3838
* @public
3939
* <p>Cancels an existing Amazon FSx for Lustre data repository task if that task is in either the
40-
* <code>PENDING</code> or <code>EXECUTING</code> state. When you cancel a task, Amazon FSx does the following.</p>
40+
* <code>PENDING</code> or <code>EXECUTING</code> state. When you cancel am export task, Amazon FSx
41+
* does the following.</p>
4142
* <ul>
4243
* <li>
4344
* <p>Any files that FSx has already exported are not reverted.</p>
4445
* </li>
4546
* <li>
46-
* <p>FSx continues to export any files that are "in-flight" when the cancel operation is received.</p>
47+
* <p>FSx continues to export any files that are in-flight when the cancel operation is received.</p>
4748
* </li>
4849
* <li>
4950
* <p>FSx does not export any files that have not yet been exported.</p>
5051
* </li>
5152
* </ul>
53+
* <p>For a release task, Amazon FSx will stop releasing files upon cancellation. Any files that
54+
* have already been released will remain in the released state.</p>
5255
* @example
5356
* Use a bare-bones client and the command you need to make an API call.
5457
* ```javascript

‎clients/client-fsx/src/commands/CopyBackupCommand.ts

Lines changed: 26 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,10 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
157157
* // FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
158158
* // AuditLogDestination: "STRING_VALUE",
159159
* // },
160+
* // DiskIopsConfiguration: { // DiskIopsConfiguration
161+
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
162+
* // Iops: Number("long"),
163+
* // },
160164
* // },
161165
* // LustreConfiguration: { // LustreFileSystemConfiguration
162166
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
@@ -191,7 +195,7 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
191195
* // },
192196
* // AdministrativeActions: [ // AdministrativeActions
193197
* // { // AdministrativeAction
194-
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE",
198+
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION",
195199
* // ProgressPercent: Number("int"),
196200
* // RequestTime: new Date("TIMESTAMP"),
197201
* // Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING",
@@ -251,6 +255,10 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
251255
* // FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
252256
* // AuditLogDestination: "STRING_VALUE",
253257
* // },
258+
* // DiskIopsConfiguration: {
259+
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
260+
* // Iops: Number("long"),
261+
* // },
254262
* // },
255263
* // LustreConfiguration: {
256264
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
@@ -285,7 +293,7 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
285293
* // },
286294
* // AdministrativeActions: [
287295
* // {
288-
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE",
296+
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION",
289297
* // ProgressPercent: Number("int"),
290298
* // RequestTime: new Date("TIMESTAMP"),
291299
* // Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING",
@@ -418,7 +426,7 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
418426
* // ],
419427
* // },
420428
* // },
421-
* // DiskIopsConfiguration: { // DiskIopsConfiguration
429+
* // DiskIopsConfiguration: {
422430
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
423431
* // Iops: Number("long"),
424432
* // },
@@ -436,14 +444,20 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
436444
* // CopyTagsToBackups: true || false,
437445
* // CopyTagsToVolumes: true || false,
438446
* // DailyAutomaticBackupStartTime: "STRING_VALUE",
439-
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2",
447+
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_1",
440448
* // ThroughputCapacity: Number("int"),
441449
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
442450
* // DiskIopsConfiguration: {
443451
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
444452
* // Iops: Number("long"),
445453
* // },
446454
* // RootVolumeId: "STRING_VALUE",
455+
* // PreferredSubnetId: "STRING_VALUE",
456+
* // EndpointIpAddressRange: "STRING_VALUE",
457+
* // RouteTableIds: [
458+
* // "STRING_VALUE",
459+
* // ],
460+
* // EndpointIpAddress: "STRING_VALUE",
447461
* // },
448462
* // },
449463
* // FailureDetails: {
@@ -589,14 +603,17 @@ export interface CopyBackupCommandOutput extends CopyBackupResponse, __MetadataB
589603
* // CopyTagsToBackups: true || false,
590604
* // CopyTagsToVolumes: true || false,
591605
* // DailyAutomaticBackupStartTime: "STRING_VALUE",
592-
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2",
606+
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_1",
593607
* // ThroughputCapacity: Number("int"),
594608
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
595-
* // DiskIopsConfiguration: {
596-
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
597-
* // Iops: Number("long"),
598-
* // },
609+
* // DiskIopsConfiguration: "<DiskIopsConfiguration>",
599610
* // RootVolumeId: "STRING_VALUE",
611+
* // PreferredSubnetId: "STRING_VALUE",
612+
* // EndpointIpAddressRange: "STRING_VALUE",
613+
* // RouteTableIds: [
614+
* // "STRING_VALUE",
615+
* // ],
616+
* // EndpointIpAddress: "STRING_VALUE",
600617
* // },
601618
* // },
602619
* // DirectoryInformation: { // ActiveDirectoryBackupAttributes

‎clients/client-fsx/src/commands/CreateBackupCommand.ts

Lines changed: 26 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,10 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
190190
* // FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
191191
* // AuditLogDestination: "STRING_VALUE",
192192
* // },
193+
* // DiskIopsConfiguration: { // DiskIopsConfiguration
194+
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
195+
* // Iops: Number("long"),
196+
* // },
193197
* // },
194198
* // LustreConfiguration: { // LustreFileSystemConfiguration
195199
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
@@ -224,7 +228,7 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
224228
* // },
225229
* // AdministrativeActions: [ // AdministrativeActions
226230
* // { // AdministrativeAction
227-
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE",
231+
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION",
228232
* // ProgressPercent: Number("int"),
229233
* // RequestTime: new Date("TIMESTAMP"),
230234
* // Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING",
@@ -284,6 +288,10 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
284288
* // FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
285289
* // AuditLogDestination: "STRING_VALUE",
286290
* // },
291+
* // DiskIopsConfiguration: {
292+
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
293+
* // Iops: Number("long"),
294+
* // },
287295
* // },
288296
* // LustreConfiguration: {
289297
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
@@ -318,7 +326,7 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
318326
* // },
319327
* // AdministrativeActions: [
320328
* // {
321-
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE",
329+
* // AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION",
322330
* // ProgressPercent: Number("int"),
323331
* // RequestTime: new Date("TIMESTAMP"),
324332
* // Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING",
@@ -451,7 +459,7 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
451459
* // ],
452460
* // },
453461
* // },
454-
* // DiskIopsConfiguration: { // DiskIopsConfiguration
462+
* // DiskIopsConfiguration: {
455463
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
456464
* // Iops: Number("long"),
457465
* // },
@@ -469,14 +477,20 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
469477
* // CopyTagsToBackups: true || false,
470478
* // CopyTagsToVolumes: true || false,
471479
* // DailyAutomaticBackupStartTime: "STRING_VALUE",
472-
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2",
480+
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_1",
473481
* // ThroughputCapacity: Number("int"),
474482
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
475483
* // DiskIopsConfiguration: {
476484
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
477485
* // Iops: Number("long"),
478486
* // },
479487
* // RootVolumeId: "STRING_VALUE",
488+
* // PreferredSubnetId: "STRING_VALUE",
489+
* // EndpointIpAddressRange: "STRING_VALUE",
490+
* // RouteTableIds: [
491+
* // "STRING_VALUE",
492+
* // ],
493+
* // EndpointIpAddress: "STRING_VALUE",
480494
* // },
481495
* // },
482496
* // FailureDetails: {
@@ -622,14 +636,17 @@ export interface CreateBackupCommandOutput extends CreateBackupResponse, __Metad
622636
* // CopyTagsToBackups: true || false,
623637
* // CopyTagsToVolumes: true || false,
624638
* // DailyAutomaticBackupStartTime: "STRING_VALUE",
625-
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2",
639+
* // DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_1",
626640
* // ThroughputCapacity: Number("int"),
627641
* // WeeklyMaintenanceStartTime: "STRING_VALUE",
628-
* // DiskIopsConfiguration: {
629-
* // Mode: "AUTOMATIC" || "USER_PROVISIONED",
630-
* // Iops: Number("long"),
631-
* // },
642+
* // DiskIopsConfiguration: "<DiskIopsConfiguration>",
632643
* // RootVolumeId: "STRING_VALUE",
644+
* // PreferredSubnetId: "STRING_VALUE",
645+
* // EndpointIpAddressRange: "STRING_VALUE",
646+
* // RouteTableIds: [
647+
* // "STRING_VALUE",
648+
* // ],
649+
* // EndpointIpAddress: "STRING_VALUE",
633650
* // },
634651
* // },
635652
* // DirectoryInformation: { // ActiveDirectoryBackupAttributes

‎clients/client-fsx/src/commands/CreateDataRepositoryTaskCommand.ts

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,18 @@ export interface CreateDataRepositoryTaskCommandOutput extends CreateDataReposit
3636

3737
/**
3838
* @public
39-
* <p>Creates an Amazon FSx for Lustre data repository task. You use data repository tasks
40-
* to perform bulk operations between your Amazon FSx file system and its linked data
41-
* repositories. An example of a data repository task is exporting any data and metadata
42-
* changes, including POSIX metadata, to files, directories, and symbolic links (symlinks)
43-
* from your FSx file system to a linked data repository. A <code>CreateDataRepositoryTask</code>
44-
* operation will fail if a data repository is not linked to the FSx file system. To learn
45-
* more about data repository tasks, see
39+
* <p>Creates an Amazon FSx for Lustre data repository task.
40+
* A <code>CreateDataRepositoryTask</code> operation will fail if a data
41+
* repository is not linked to the FSx file system.</p>
42+
* <p>You use import and export data repository tasks to perform bulk operations between your
43+
* FSx for Lustre file system and its linked data repositories. An example of a data repository
44+
* task is exporting any data and metadata changes, including POSIX metadata, to files, directories,
45+
* and symbolic links (symlinks) from your FSx file system to a linked data repository.</p>
46+
* <p>You use release data repository tasks to release data from your file system for files that
47+
* are archived to S3. The metadata of released files remains on the file system so users or applications
48+
* can still access released files by reading the files again, which will restore data from
49+
* Amazon S3 to the FSx for Lustre file system.</p>
50+
* <p>To learn more about data repository tasks, see
4651
* <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/data-repository-tasks.html">Data Repository Tasks</a>.
4752
* To learn more about linking a data repository to your file system, see
4853
* <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html">Linking your file system to an S3 bucket</a>.</p>
@@ -72,6 +77,12 @@ export interface CreateDataRepositoryTaskCommandOutput extends CreateDataReposit
7277
* },
7378
* ],
7479
* CapacityToRelease: Number("long"),
80+
* ReleaseConfiguration: { // ReleaseConfiguration
81+
* DurationSinceLastAccess: { // DurationSinceLastAccess
82+
* Unit: "DAYS",
83+
* Value: Number("long"),
84+
* },
85+
* },
7586
* };
7687
* const command = new CreateDataRepositoryTaskCommand(input);
7788
* const response = await client.send(command);
@@ -112,6 +123,12 @@ export interface CreateDataRepositoryTaskCommandOutput extends CreateDataReposit
112123
* // },
113124
* // CapacityToRelease: Number("long"),
114125
* // FileCacheId: "STRING_VALUE",
126+
* // ReleaseConfiguration: { // ReleaseConfiguration
127+
* // DurationSinceLastAccess: { // DurationSinceLastAccess
128+
* // Unit: "DAYS",
129+
* // Value: Number("long"),
130+
* // },
131+
* // },
115132
* // },
116133
* // };
117134
*

0 commit comments

Comments
 (0)