Struct UpdateOpenZfsVolumeConfiguration

#[non_exhaustive]
pub struct UpdateOpenZfsVolumeConfiguration {
    pub storage_capacity_reservation_gib: Option<i32>,
    pub storage_capacity_quota_gib: Option<i32>,
    pub record_size_kib: Option<i32>,
    pub data_compression_type: Option<OpenZfsDataCompressionType>,
    pub nfs_exports: Option<Vec<OpenZfsNfsExport>>,
    pub user_and_group_quotas: Option<Vec<OpenZfsUserOrGroupQuota>>,
    pub read_only: Option<bool>,
}

Used to specify changes to the OpenZFS configuration for the volume that you are updating.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

storage_capacity_reservation_gib: Option<i32>

The amount of storage in gibibytes (GiB) to reserve from the parent volume. You can't reserve more storage than the parent volume has reserved. You can specify a value of -1 to unset a volume's storage capacity reservation.

storage_capacity_quota_gib: Option<i32>

The maximum amount of storage in gibibytes (GiB) that the volume can use from its parent. You can specify a quota larger than the storage on the parent volume. You can specify a value of -1 to unset a volume's storage capacity quota.

record_size_kib: Option<i32>

Specifies the record size of an OpenZFS volume, in kibibytes (KiB). Valid values are 4, 8, 16, 32, 64, 128, 256, 512, or 1024 KiB. The default is 128 KiB. Most workloads should use the default record size. Database workflows can benefit from a smaller record size, while streaming workflows can benefit from a larger record size. For additional guidance on when to set a custom record size, see Tips for maximizing performance in the Amazon FSx for OpenZFS User Guide.

data_compression_type: Option<OpenZfsDataCompressionType>

Specifies the method used to compress the data on the volume. The compression type is NONE by default.

• NONE - Doesn't compress the data on the volume. NONE is the default.

• ZSTD - Compresses the data in the volume using the Zstandard (ZSTD) compression algorithm. Compared to LZ4, Z-Standard provides a better compression ratio to minimize on-disk storage utilization.

• LZ4 - Compresses the data in the volume using the LZ4 compression algorithm. Compared to Z-Standard, LZ4 is less compute-intensive and delivers higher write throughput speeds.

nfs_exports: Option<Vec<OpenZfsNfsExport>>

The configuration object for mounting a Network File System (NFS) file system.

user_and_group_quotas: Option<Vec<OpenZfsUserOrGroupQuota>>

An object specifying how much storage users or groups can use on the volume.

read_only: Option<bool>

A Boolean value indicating whether the volume is read-only.

Implementations

impl UpdateOpenZfsVolumeConfiguration

pub fn storage_capacity_reservation_gib(&self) -> Option<i32>

The amount of storage in gibibytes (GiB) to reserve from the parent volume. You can't reserve more storage than the parent volume has reserved. You can specify a value of -1 to unset a volume's storage capacity reservation.

pub fn storage_capacity_quota_gib(&self) -> Option<i32>

The maximum amount of storage in gibibytes (GiB) that the volume can use from its parent. You can specify a quota larger than the storage on the parent volume. You can specify a value of -1 to unset a volume's storage capacity quota.

pub fn record_size_kib(&self) -> Option<i32>

Specifies the record size of an OpenZFS volume, in kibibytes (KiB). Valid values are 4, 8, 16, 32, 64, 128, 256, 512, or 1024 KiB. The default is 128 KiB. Most workloads should use the default record size. Database workflows can benefit from a smaller record size, while streaming workflows can benefit from a larger record size. For additional guidance on when to set a custom record size, see Tips for maximizing performance in the Amazon FSx for OpenZFS User Guide.

pub fn data_compression_type(&self) -> Option<&OpenZfsDataCompressionType>

Specifies the method used to compress the data on the volume. The compression type is NONE by default.

• NONE - Doesn't compress the data on the volume. NONE is the default.

• ZSTD - Compresses the data in the volume using the Zstandard (ZSTD) compression algorithm. Compared to LZ4, Z-Standard provides a better compression ratio to minimize on-disk storage utilization.

• LZ4 - Compresses the data in the volume using the LZ4 compression algorithm. Compared to Z-Standard, LZ4 is less compute-intensive and delivers higher write throughput speeds.

pub fn nfs_exports(&self) -> &[OpenZfsNfsExport]

The configuration object for mounting a Network File System (NFS) file system.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .nfs_exports.is_none().

pub fn user_and_group_quotas(&self) -> &[OpenZfsUserOrGroupQuota]

An object specifying how much storage users or groups can use on the volume.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .user_and_group_quotas.is_none().

pub fn read_only(&self) -> Option<bool>

A Boolean value indicating whether the volume is read-only.

impl UpdateOpenZfsVolumeConfiguration

pub fn builder() -> UpdateOpenZfsVolumeConfigurationBuilder

Creates a new builder-style object to manufacture UpdateOpenZfsVolumeConfiguration.

Trait Implementations

impl Clone for UpdateOpenZfsVolumeConfiguration

fn clone(&self) -> UpdateOpenZfsVolumeConfiguration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateOpenZfsVolumeConfiguration

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

Formats the value using the given formatter.

impl PartialEq for UpdateOpenZfsVolumeConfiguration

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for UpdateOpenZfsVolumeConfiguration