#[non_exhaustive]pub struct Builder { /* private fields */ }
Expand description
A builder for CreateOpenZfsVolumeConfiguration
Implementations
sourceimpl Builder
impl Builder
sourcepub fn parent_volume_id(self, input: impl Into<String>) -> Self
pub fn parent_volume_id(self, input: impl Into<String>) -> Self
The ID of the volume to use as the parent volume of the volume that you are creating.
sourcepub fn set_parent_volume_id(self, input: Option<String>) -> Self
pub fn set_parent_volume_id(self, input: Option<String>) -> Self
The ID of the volume to use as the parent volume of the volume that you are creating.
sourcepub fn storage_capacity_reservation_gi_b(self, input: i32) -> Self
pub fn storage_capacity_reservation_gi_b(self, input: i32) -> Self
Specifies the amount of storage in gibibytes (GiB) to reserve from the parent volume. Setting StorageCapacityReservationGiB
guarantees that the specified amount of storage space on the parent volume will always be available for the volume. You can't reserve more storage than the parent volume has. To not specify a storage capacity reservation, set this to 0
or -1
. For more information, see Volume properties in the Amazon FSx for OpenZFS User Guide.
sourcepub fn set_storage_capacity_reservation_gi_b(self, input: Option<i32>) -> Self
pub fn set_storage_capacity_reservation_gi_b(self, input: Option<i32>) -> Self
Specifies the amount of storage in gibibytes (GiB) to reserve from the parent volume. Setting StorageCapacityReservationGiB
guarantees that the specified amount of storage space on the parent volume will always be available for the volume. You can't reserve more storage than the parent volume has. To not specify a storage capacity reservation, set this to 0
or -1
. For more information, see Volume properties in the Amazon FSx for OpenZFS User Guide.
sourcepub fn storage_capacity_quota_gi_b(self, input: i32) -> Self
pub fn storage_capacity_quota_gi_b(self, input: i32) -> Self
Sets the maximum storage size in gibibytes (GiB) for the volume. You can specify a quota that is larger than the storage on the parent volume. A volume quota limits the amount of storage that the volume can consume to the configured amount, but does not guarantee the space will be available on the parent volume. To guarantee quota space, you must also set StorageCapacityReservationGiB
. To not specify a storage capacity quota, set this to -1
.
For more information, see Volume properties in the Amazon FSx for OpenZFS User Guide.
sourcepub fn set_storage_capacity_quota_gi_b(self, input: Option<i32>) -> Self
pub fn set_storage_capacity_quota_gi_b(self, input: Option<i32>) -> Self
Sets the maximum storage size in gibibytes (GiB) for the volume. You can specify a quota that is larger than the storage on the parent volume. A volume quota limits the amount of storage that the volume can consume to the configured amount, but does not guarantee the space will be available on the parent volume. To guarantee quota space, you must also set StorageCapacityReservationGiB
. To not specify a storage capacity quota, set this to -1
.
For more information, see Volume properties in the Amazon FSx for OpenZFS User Guide.
sourcepub fn record_size_ki_b(self, input: i32) -> Self
pub fn record_size_ki_b(self, input: i32) -> Self
Specifies the suggested block size for a volume in a ZFS dataset, in kibibytes (KiB). Valid values are 4, 8, 16, 32, 64, 128, 256, 512, or 1024 KiB. The default is 128 KiB. We recommend using the default setting for the majority of use cases. Generally, workloads that write in fixed small or large record sizes may benefit from setting a custom record size, like database workloads (small record size) or media streaming workloads (large record size). For additional guidance on when to set a custom record size, see ZFS Record size in the Amazon FSx for OpenZFS User Guide.
sourcepub fn set_record_size_ki_b(self, input: Option<i32>) -> Self
pub fn set_record_size_ki_b(self, input: Option<i32>) -> Self
Specifies the suggested block size for a volume in a ZFS dataset, in kibibytes (KiB). Valid values are 4, 8, 16, 32, 64, 128, 256, 512, or 1024 KiB. The default is 128 KiB. We recommend using the default setting for the majority of use cases. Generally, workloads that write in fixed small or large record sizes may benefit from setting a custom record size, like database workloads (small record size) or media streaming workloads (large record size). For additional guidance on when to set a custom record size, see ZFS Record size in the Amazon FSx for OpenZFS User Guide.
sourcepub fn data_compression_type(self, input: OpenZfsDataCompressionType) -> Self
pub fn data_compression_type(self, input: OpenZfsDataCompressionType) -> Self
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. ZSTD compression provides a higher level of data compression and higher read throughput performance than LZ4 compression. -
LZ4
- Compresses the data in the volume using the LZ4 compression algorithm. LZ4 compression provides a lower level of compression and higher write throughput performance than ZSTD compression.
For more information about volume compression types and the performance of your Amazon FSx for OpenZFS file system, see Tips for maximizing performance File system and volume settings in the Amazon FSx for OpenZFS User Guide.
sourcepub fn set_data_compression_type(
self,
input: Option<OpenZfsDataCompressionType>
) -> Self
pub fn set_data_compression_type(
self,
input: Option<OpenZfsDataCompressionType>
) -> Self
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. ZSTD compression provides a higher level of data compression and higher read throughput performance than LZ4 compression. -
LZ4
- Compresses the data in the volume using the LZ4 compression algorithm. LZ4 compression provides a lower level of compression and higher write throughput performance than ZSTD compression.
For more information about volume compression types and the performance of your Amazon FSx for OpenZFS file system, see Tips for maximizing performance File system and volume settings in the Amazon FSx for OpenZFS User Guide.
A Boolean value indicating whether tags for the volume should be copied to snapshots. This value defaults to false
. If it's set to true
, all tags for the volume are copied to snapshots where the user doesn't specify tags. If this value is true
, and you specify one or more tags, only the specified tags are copied to snapshots. If you specify one or more tags when creating the snapshot, no tags are copied from the volume, regardless of this value.
A Boolean value indicating whether tags for the volume should be copied to snapshots. This value defaults to false
. If it's set to true
, all tags for the volume are copied to snapshots where the user doesn't specify tags. If this value is true
, and you specify one or more tags, only the specified tags are copied to snapshots. If you specify one or more tags when creating the snapshot, no tags are copied from the volume, regardless of this value.
sourcepub fn origin_snapshot(
self,
input: CreateOpenZfsOriginSnapshotConfiguration
) -> Self
pub fn origin_snapshot(
self,
input: CreateOpenZfsOriginSnapshotConfiguration
) -> Self
The configuration object that specifies the snapshot to use as the origin of the data for the volume.
sourcepub fn set_origin_snapshot(
self,
input: Option<CreateOpenZfsOriginSnapshotConfiguration>
) -> Self
pub fn set_origin_snapshot(
self,
input: Option<CreateOpenZfsOriginSnapshotConfiguration>
) -> Self
The configuration object that specifies the snapshot to use as the origin of the data for the volume.
sourcepub fn read_only(self, input: bool) -> Self
pub fn read_only(self, input: bool) -> Self
A Boolean value indicating whether the volume is read-only.
sourcepub fn set_read_only(self, input: Option<bool>) -> Self
pub fn set_read_only(self, input: Option<bool>) -> Self
A Boolean value indicating whether the volume is read-only.
sourcepub fn nfs_exports(self, input: OpenZfsNfsExport) -> Self
pub fn nfs_exports(self, input: OpenZfsNfsExport) -> Self
Appends an item to nfs_exports
.
To override the contents of this collection use set_nfs_exports
.
The configuration object for mounting a Network File System (NFS) file system.
sourcepub fn set_nfs_exports(self, input: Option<Vec<OpenZfsNfsExport>>) -> Self
pub fn set_nfs_exports(self, input: Option<Vec<OpenZfsNfsExport>>) -> Self
The configuration object for mounting a Network File System (NFS) file system.
sourcepub fn user_and_group_quotas(self, input: OpenZfsUserOrGroupQuota) -> Self
pub fn user_and_group_quotas(self, input: OpenZfsUserOrGroupQuota) -> Self
Appends an item to user_and_group_quotas
.
To override the contents of this collection use set_user_and_group_quotas
.
An object specifying how much storage users or groups can use on the volume.
sourcepub fn set_user_and_group_quotas(
self,
input: Option<Vec<OpenZfsUserOrGroupQuota>>
) -> Self
pub fn set_user_and_group_quotas(
self,
input: Option<Vec<OpenZfsUserOrGroupQuota>>
) -> Self
An object specifying how much storage users or groups can use on the volume.
sourcepub fn build(self) -> CreateOpenZfsVolumeConfiguration
pub fn build(self) -> CreateOpenZfsVolumeConfiguration
Consumes the builder and constructs a CreateOpenZfsVolumeConfiguration
Trait Implementations
impl StructuralPartialEq for Builder
Auto Trait Implementations
impl RefUnwindSafe for Builder
impl Send for Builder
impl Sync for Builder
impl Unpin for Builder
impl UnwindSafe for Builder
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more