#[non_exhaustive]pub struct AdministrativeAction {
pub administrative_action_type: Option<AdministrativeActionType>,
pub progress_percent: Option<i32>,
pub request_time: Option<DateTime>,
pub status: Option<Status>,
pub target_file_system_values: Option<FileSystem>,
pub failure_details: Option<AdministrativeActionFailureDetails>,
pub target_volume_values: Option<Volume>,
pub target_snapshot_values: Option<Snapshot>,
pub total_transfer_bytes: Option<i64>,
pub remaining_transfer_bytes: Option<i64>,
}
Expand description
Describes a specific Amazon FSx administrative action for the current Windows, Lustre, OpenZFS, or ONTAP file system or volume.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.administrative_action_type: Option<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 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 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 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. -
DOWNLOAD_DATA_FROM_BACKUP
- An FSx for ONTAP backup is being restored to a new volume on a second-generation file system. Once the all the file metadata is loaded onto the volume, you can mount the volume with read-only access. during this process. -
VOLUME_INITIALIZE_WITH_SNAPSHOT
- A volume is being created from a snapshot on a different FSx for OpenZFS file system. You can initiate this from the Amazon FSx console, API (CreateVolume
), or CLI (create-volume
) when using the using theFULL_COPY
strategy. -
VOLUME_UPDATE_WITH_SNAPSHOT
- A volume is being updated from a snapshot on a different FSx for OpenZFS file system. You can initiate this from the Amazon FSx console, API (CopySnapshotAndUpdateVolume
), or CLI (copy-snapshot-and-update-volume
).
progress_percent: Option<i32>
The percentage-complete status of a STORAGE_OPTIMIZATION
or DOWNLOAD_DATA_FROM_BACKUP
administrative action. Does not apply to any other administrative action type.
request_time: Option<DateTime>
The time that the administrative action request was received.
status: Option<Status>
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.For a backup restore to a second-generation FSx for ONTAP file system, indicates that all data has been downloaded to the volume, and clients now have read-write access to volume.
-
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. -
PENDING
- For a backup restore to a second-generation FSx for ONTAP file system, indicates that the file metadata is being downloaded onto the volume. The volume's Lifecycle state is CREATING. -
IN_PROGRESS
- For a backup restore to a second-generation FSx for ONTAP file system, indicates that all metadata has been downloaded to the new volume and client can access data with read-only access while Amazon FSx downloads the file data to the volume. Track the progress of this process with theProgressPercent
element.
target_file_system_values: Option<FileSystem>
The target value for the administration action, provided in the UpdateFileSystem
operation. Returned for FILE_SYSTEM_UPDATE
administrative actions.
failure_details: Option<AdministrativeActionFailureDetails>
Provides information about a failed administrative action.
target_volume_values: Option<Volume>
Describes an Amazon FSx volume.
target_snapshot_values: Option<Snapshot>
A snapshot of an Amazon FSx for OpenZFS volume.
total_transfer_bytes: Option<i64>
The number of bytes that have transferred for the FSx for OpenZFS snapshot that you're copying.
remaining_transfer_bytes: Option<i64>
The remaining bytes to transfer for the FSx for OpenZFS snapshot that you're copying.
Implementations§
Source§impl AdministrativeAction
impl AdministrativeAction
Sourcepub fn administrative_action_type(&self) -> Option<&AdministrativeActionType>
pub fn administrative_action_type(&self) -> Option<&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 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 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 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. -
DOWNLOAD_DATA_FROM_BACKUP
- An FSx for ONTAP backup is being restored to a new volume on a second-generation file system. Once the all the file metadata is loaded onto the volume, you can mount the volume with read-only access. during this process. -
VOLUME_INITIALIZE_WITH_SNAPSHOT
- A volume is being created from a snapshot on a different FSx for OpenZFS file system. You can initiate this from the Amazon FSx console, API (CreateVolume
), or CLI (create-volume
) when using the using theFULL_COPY
strategy. -
VOLUME_UPDATE_WITH_SNAPSHOT
- A volume is being updated from a snapshot on a different FSx for OpenZFS file system. You can initiate this from the Amazon FSx console, API (CopySnapshotAndUpdateVolume
), or CLI (copy-snapshot-and-update-volume
).
Sourcepub fn progress_percent(&self) -> Option<i32>
pub fn progress_percent(&self) -> Option<i32>
The percentage-complete status of a STORAGE_OPTIMIZATION
or DOWNLOAD_DATA_FROM_BACKUP
administrative action. Does not apply to any other administrative action type.
Sourcepub fn request_time(&self) -> Option<&DateTime>
pub fn request_time(&self) -> Option<&DateTime>
The time that the administrative action request was received.
Sourcepub fn status(&self) -> Option<&Status>
pub fn status(&self) -> Option<&Status>
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.For a backup restore to a second-generation FSx for ONTAP file system, indicates that all data has been downloaded to the volume, and clients now have read-write access to volume.
-
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. -
PENDING
- For a backup restore to a second-generation FSx for ONTAP file system, indicates that the file metadata is being downloaded onto the volume. The volume's Lifecycle state is CREATING. -
IN_PROGRESS
- For a backup restore to a second-generation FSx for ONTAP file system, indicates that all metadata has been downloaded to the new volume and client can access data with read-only access while Amazon FSx downloads the file data to the volume. Track the progress of this process with theProgressPercent
element.
Sourcepub fn target_file_system_values(&self) -> Option<&FileSystem>
pub fn target_file_system_values(&self) -> Option<&FileSystem>
The target value for the administration action, provided in the UpdateFileSystem
operation. Returned for FILE_SYSTEM_UPDATE
administrative actions.
Sourcepub fn failure_details(&self) -> Option<&AdministrativeActionFailureDetails>
pub fn failure_details(&self) -> Option<&AdministrativeActionFailureDetails>
Provides information about a failed administrative action.
Sourcepub fn target_volume_values(&self) -> Option<&Volume>
pub fn target_volume_values(&self) -> Option<&Volume>
Describes an Amazon FSx volume.
Sourcepub fn target_snapshot_values(&self) -> Option<&Snapshot>
pub fn target_snapshot_values(&self) -> Option<&Snapshot>
A snapshot of an Amazon FSx for OpenZFS volume.
Sourcepub fn total_transfer_bytes(&self) -> Option<i64>
pub fn total_transfer_bytes(&self) -> Option<i64>
The number of bytes that have transferred for the FSx for OpenZFS snapshot that you're copying.
Sourcepub fn remaining_transfer_bytes(&self) -> Option<i64>
pub fn remaining_transfer_bytes(&self) -> Option<i64>
The remaining bytes to transfer for the FSx for OpenZFS snapshot that you're copying.
Source§impl AdministrativeAction
impl AdministrativeAction
Sourcepub fn builder() -> AdministrativeActionBuilder
pub fn builder() -> AdministrativeActionBuilder
Creates a new builder-style object to manufacture AdministrativeAction
.
Trait Implementations§
Source§impl Clone for AdministrativeAction
impl Clone for AdministrativeAction
Source§fn clone(&self) -> AdministrativeAction
fn clone(&self) -> AdministrativeAction
1.0.0 · Source§const fn clone_from(&mut self, source: &Self)
const fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for AdministrativeAction
impl Debug for AdministrativeAction
Source§impl PartialEq for AdministrativeAction
impl PartialEq for AdministrativeAction
impl StructuralPartialEq for AdministrativeAction
Auto Trait Implementations§
impl Freeze for AdministrativeAction
impl RefUnwindSafe for AdministrativeAction
impl Send for AdministrativeAction
impl Sync for AdministrativeAction
impl Unpin for AdministrativeAction
impl UnwindSafe for AdministrativeAction
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);