Struct aws_sdk_dlm::types::RetainRule
source · #[non_exhaustive]pub struct RetainRule {
pub count: Option<i32>,
pub interval: Option<i32>,
pub interval_unit: Option<RetentionIntervalUnitValues>,
}
Expand description
[Custom snapshot and AMI policies only] Specifies a retention rule for snapshots created by snapshot policies, or for AMIs created by AMI policies.
For snapshot policies that have an ArchiveRule, this retention rule applies to standard tier retention. When the retention threshold is met, snapshots are moved from the standard to the archive tier.
For snapshot policies that do not have an ArchiveRule, snapshots are permanently deleted when this retention threshold is met.
You can retain snapshots based on either a count or a time interval.
-
Count-based retention
You must specify Count. If you specify an ArchiveRule for the schedule, then you can specify a retention count of
0
to archive snapshots immediately after creation. If you specify a FastRestoreRule, ShareRule, or a CrossRegionCopyRule, then you must specify a retention count of1
or more. -
Age-based retention
You must specify Interval and IntervalUnit. If you specify an ArchiveRule for the schedule, then you can specify a retention interval of
0
days to archive snapshots immediately after creation. If you specify a FastRestoreRule, ShareRule, or a CrossRegionCopyRule, then you must specify a retention interval of1
day or more.
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.count: Option<i32>
The number of snapshots to retain for each volume, up to a maximum of 1000. For example if you want to retain a maximum of three snapshots, specify 3
. When the fourth snapshot is created, the oldest retained snapshot is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.
interval: Option<i32>
The amount of time to retain each snapshot. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.
interval_unit: Option<RetentionIntervalUnitValues>
The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify Interval=3
and IntervalUnit=MONTHS
. Once the snapshot has been retained for 3 months, it is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.
Implementations§
source§impl RetainRule
impl RetainRule
sourcepub fn count(&self) -> Option<i32>
pub fn count(&self) -> Option<i32>
The number of snapshots to retain for each volume, up to a maximum of 1000. For example if you want to retain a maximum of three snapshots, specify 3
. When the fourth snapshot is created, the oldest retained snapshot is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.
sourcepub fn interval(&self) -> Option<i32>
pub fn interval(&self) -> Option<i32>
The amount of time to retain each snapshot. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.
sourcepub fn interval_unit(&self) -> Option<&RetentionIntervalUnitValues>
pub fn interval_unit(&self) -> Option<&RetentionIntervalUnitValues>
The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify Interval=3
and IntervalUnit=MONTHS
. Once the snapshot has been retained for 3 months, it is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.
source§impl RetainRule
impl RetainRule
sourcepub fn builder() -> RetainRuleBuilder
pub fn builder() -> RetainRuleBuilder
Creates a new builder-style object to manufacture RetainRule
.
Trait Implementations§
source§impl Clone for RetainRule
impl Clone for RetainRule
source§fn clone(&self) -> RetainRule
fn clone(&self) -> RetainRule
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for RetainRule
impl Debug for RetainRule
source§impl PartialEq for RetainRule
impl PartialEq for RetainRule
source§fn eq(&self, other: &RetainRule) -> bool
fn eq(&self, other: &RetainRule) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for RetainRule
Auto Trait Implementations§
impl Freeze for RetainRule
impl RefUnwindSafe for RetainRule
impl Send for RetainRule
impl Sync for RetainRule
impl Unpin for RetainRule
impl UnwindSafe for RetainRule
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> 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 more