Enum aws_sdk_fsx::types::AdministrativeActionType

#[non_exhaustive]
pub enum AdministrativeActionType {
    FileSystemAliasAssociation,
    FileSystemAliasDisassociation,
    FileSystemUpdate,
    IopsOptimization,
    MisconfiguredStateRecovery,
    ReleaseNfsV3Locks,
    SnapshotUpdate,
    StorageOptimization,
    StorageTypeOptimization,
    ThroughputOptimization,
    VolumeInitializeWithSnapshot,
    VolumeRestore,
    VolumeUpdate,
    VolumeUpdateWithSnapshot,
    Unknown(UnknownVariantValue),
}

When writing a match expression against AdministrativeActionType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature.

Here is an example of how you can make a match expression forward-compatible:

# let administrativeactiontype = unimplemented!();
match administrativeactiontype {
    AdministrativeActionType::FileSystemAliasAssociation => { /* ... */ },
    AdministrativeActionType::FileSystemAliasDisassociation => { /* ... */ },
    AdministrativeActionType::FileSystemUpdate => { /* ... */ },
    AdministrativeActionType::IopsOptimization => { /* ... */ },
    AdministrativeActionType::MisconfiguredStateRecovery => { /* ... */ },
    AdministrativeActionType::ReleaseNfsV3Locks => { /* ... */ },
    AdministrativeActionType::SnapshotUpdate => { /* ... */ },
    AdministrativeActionType::StorageOptimization => { /* ... */ },
    AdministrativeActionType::StorageTypeOptimization => { /* ... */ },
    AdministrativeActionType::ThroughputOptimization => { /* ... */ },
    AdministrativeActionType::VolumeInitializeWithSnapshot => { /* ... */ },
    AdministrativeActionType::VolumeRestore => { /* ... */ },
    AdministrativeActionType::VolumeUpdate => { /* ... */ },
    AdministrativeActionType::VolumeUpdateWithSnapshot => { /* ... */ },
    other @ _ if other.as_str() == "NewFeature" => { /* handles a case for `NewFeature` */ },
    _ => { /* ... */ },
}

The above code demonstrates that when administrativeactiontype represents NewFeature, the execution path will lead to the second last match arm, even though the enum does not contain a variant AdministrativeActionType::NewFeature in the current version of SDK. The reason is that the variable other, created by the @ operator, is bound to AdministrativeActionType::Unknown(UnknownVariantValue("NewFeature".to_owned())) and calling as_str on it yields "NewFeature". This match expression is forward-compatible when executed with a newer version of SDK where the variant AdministrativeActionType::NewFeature is defined. Specifically, when administrativeactiontype represents NewFeature, the execution path will hit the second last match arm as before by virtue of calling as_str on AdministrativeActionType::NewFeature also yielding "NewFeature".

Explicitly matching on the Unknown variant should be avoided for two reasons:

• The inner data UnknownVariantValue is opaque, and no further information can be extracted.
• It might inadvertently shadow other intended match arms.

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 the FILE_SYSTEM_UPDATE task to increase a file system's throughput capacity has been completed successfully, a THROUGHPUT_OPTIMIZATION task starts.

  You can track the storage-optimization progress using the ProgressPercent property. When THROUGHPUT_OPTIMIZATION has been completed successfully, the parent FILE_SYSTEM_UPDATE action status changes to COMPLETED. For more information, see Managing throughput capacity in the Amazon FSx for Windows File Server User Guide.

• STORAGE_OPTIMIZATION - After the FILE_SYSTEM_UPDATE task to increase a file system's storage capacity has been completed successfully, a STORAGE_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. When STORAGE_OPTIMIZATION has been completed successfully, the parent FILE_SYSTEM_UPDATE action status changes to COMPLETED. 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 the FILE_SYSTEM_UPDATE task to increase a file system's throughput capacity has been completed successfully, a IOPS_OPTIMIZATION task starts.

  You can track the storage-optimization progress using the ProgressPercent property. When IOPS_OPTIMIZATION has been completed successfully, the parent FILE_SYSTEM_UPDATE action status changes to COMPLETED. For more information, see Managing provisioned SSD IOPS in the Amazon FSx for Windows File Server User Guide.

• STORAGE_TYPE_OPTIMIZATION - After the FILE_SYSTEM_UPDATE task to increase a file system's throughput capacity has been completed successfully, a STORAGE_TYPE_OPTIMIZATION task starts.

  You can track the storage-optimization progress using the ProgressPercent property. When STORAGE_TYPE_OPTIMIZATION has been completed successfully, the parent FILE_SYSTEM_UPDATE action status changes to COMPLETED.

• 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.

• 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 the FULL_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).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

FileSystemAliasAssociation

FileSystemAliasDisassociation

FileSystemUpdate

IopsOptimization

MisconfiguredStateRecovery

ReleaseNfsV3Locks

SnapshotUpdate

StorageOptimization

StorageTypeOptimization

ThroughputOptimization

VolumeInitializeWithSnapshot

VolumeRestore

VolumeUpdate

VolumeUpdateWithSnapshot

Unknown(UnknownVariantValue)

👎Deprecated: Don’t directly match on Unknown. See the docs on this enum for the correct way to handle unknown variants.

Unknown contains new variants that have been added since this code was generated.

Implementations

impl AdministrativeActionType

pub fn as_str(&self) -> &str

Returns the &str value of the enum member.

pub const fn values() -> &'static [&'static str]

Returns all the &str representations of the enum members.

impl AdministrativeActionType

pub fn try_parse(value: &str) -> Result<Self, UnknownVariantError>

Parses the enum value while disallowing unknown variants.

Unknown variants will result in an error.

Trait Implementations

impl AsRef<str> for AdministrativeActionType

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for AdministrativeActionType

fn clone(&self) -> AdministrativeActionType

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AdministrativeActionType

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for AdministrativeActionType

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&str> for AdministrativeActionType

fn from(s: &str) -> Self

Converts to this type from the input type.

impl FromStr for AdministrativeActionType

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, <Self as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for AdministrativeActionType

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for AdministrativeActionType

fn cmp(&self, other: &AdministrativeActionType) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for AdministrativeActionType

fn eq(&self, other: &AdministrativeActionType) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for AdministrativeActionType

fn partial_cmp(&self, other: &AdministrativeActionType) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for AdministrativeActionType

impl StructuralPartialEq for AdministrativeActionType