AdministrativeAction
Describes a specific Amazon FSx administrative action for the current Windows, Lustre, or OpenZFS file system.
Contents
- AdministrativeActionType
-
Describes the type of administrative action, as follows:
-
FILE_SYSTEM_UPDATE
- A file system update administrative action initiated from the Amazon FSx console, API (UpdateFileSystem
), or CLI (update-file-system
). -
THROUGHPUT_OPTIMIZATION
- After theFILE_SYSTEM_UPDATE
task to increase a file system's throughput capacity has been completed successfully, aTHROUGHPUT_OPTIMIZATION
task starts.You can track the storage-optimization progress using the
ProgressPercent
property. WhenTHROUGHPUT_OPTIMIZATION
has been completed successfully, the parentFILE_SYSTEM_UPDATE
action status changes toCOMPLETED
. For more information, see Managing throughput capacity in the Amazon FSx for Windows File Server User Guide. -
STORAGE_OPTIMIZATION
- After theFILE_SYSTEM_UPDATE
task to increase a file system's storage capacity has been completed successfully, aSTORAGE_OPTIMIZATION
task starts.-
For Windows and ONTAP, storage optimization is the process of migrating the file system data to newer larger disks.
-
For Lustre, storage optimization consists of rebalancing the data across the existing and newly added file servers.
You can track the storage-optimization progress using the
ProgressPercent
property. WhenSTORAGE_OPTIMIZATION
has been completed successfully, the parentFILE_SYSTEM_UPDATE
action status changes toCOMPLETED
. For more information, see Managing storage capacity in the Amazon FSx for Windows File Server User Guide, Managing storage and throughput capacity in the Amazon FSx for Lustre User Guide, and Managing storage capacity and provisioned IOPS in the Amazon FSx for NetApp ONTAP User Guide. -
-
FILE_SYSTEM_ALIAS_ASSOCIATION
- A file system update to associate a new Domain Name System (DNS) alias with the file system. For more information, see AssociateFileSystemAliases. -
FILE_SYSTEM_ALIAS_DISASSOCIATION
- A file system update to disassociate a DNS alias from the file system. For more information, see DisassociateFileSystemAliases. -
IOPS_OPTIMIZATION
- After theFILE_SYSTEM_UPDATE
task to increase a file system's throughput capacity has been completed successfully, aIOPS_OPTIMIZATION
task starts.You can track the storage-optimization progress using the
ProgressPercent
property. WhenIOPS_OPTIMIZATION
has been completed successfully, the parentFILE_SYSTEM_UPDATE
action status changes toCOMPLETED
. For more information, see Managing provisioned SSD IOPS in the Amazon FSx for Windows File Server User Guide. -
STORAGE_TYPE_OPTIMIZATION
- After theFILE_SYSTEM_UPDATE
task to increase a file system's throughput capacity has been completed successfully, aSTORAGE_TYPE_OPTIMIZATION
task starts.You can track the storage-optimization progress using the
ProgressPercent
property. WhenSTORAGE_TYPE_OPTIMIZATION
has been completed successfully, the parentFILE_SYSTEM_UPDATE
action status changes toCOMPLETED
. -
VOLUME_UPDATE
- A volume update to an Amazon FSx for NetApp ONTAP or Amazon FSx for OpenZFS volume initiated from the Amazon FSx console, API (UpdateVolume
), or CLI (update-volume
). -
VOLUME_RESTORE
- An Amazon FSx for OpenZFS volume is returned to the state saved by the specified snapshot, initiated from an API (RestoreVolumeFromSnapshot
) or CLI (restore-volume-from-snapshot
). -
SNAPSHOT_UPDATE
- A snapshot update to an Amazon FSx for OpenZFS volume initiated from the Amazon FSx console, API (UpdateSnapshot
), or CLI (update-snapshot
). -
RELEASE_NFS_V3_LOCKS
- Tracks the release of Network File System (NFS) V3 locks on an Amazon FSx for OpenZFS file system.
Type: String
Valid Values:
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
Required: No
-
- FailureDetails
-
Provides information about a failed administrative action.
Type: AdministrativeActionFailureDetails object
Required: No
- ProgressPercent
-
The percentage-complete status of a
STORAGE_OPTIMIZATION
administrative action. Does not apply to any other administrative action type.Type: Integer
Valid Range: Minimum value of 0. Maximum value of 100.
Required: No
- RequestTime
-
The time that the administrative action request was received.
Type: Timestamp
Required: No
- Status
-
Describes the status of the administrative action, as follows:
-
FAILED
- Amazon FSx failed to process the administrative action successfully. -
IN_PROGRESS
- Amazon FSx is processing the administrative action. -
PENDING
- Amazon FSx is waiting to process the administrative action. -
COMPLETED
- Amazon FSx has finished processing the administrative task. -
UPDATED_OPTIMIZING
- For a storage-capacity increase update, Amazon FSx has updated the file system with the new storage capacity, and is now performing the storage-optimization process.
Type: String
Valid Values:
FAILED | IN_PROGRESS | PENDING | COMPLETED | UPDATED_OPTIMIZING
Required: No
-
- TargetFileSystemValues
-
Describes the target value for the administration action, provided in the
UpdateFileSystem
operation. Returned forFILE_SYSTEM_UPDATE
administrative actions.Type: FileSystem object
Required: No
- TargetSnapshotValues
-
A snapshot of an Amazon FSx for OpenZFS volume.
Type: Snapshot object
Required: No
- TargetVolumeValues
-
Describes an Amazon FSx for NetApp ONTAP or Amazon FSx for OpenZFS volume.
Type: Volume object
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: