Package software.amazon.awscdk.services.dlm

Interface CfnLifecyclePolicy.RetainRuleProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnLifecyclePolicy.RetainRuleProperty.Jsii$Proxy

Enclosing class:

CfnLifecyclePolicy

@Stability(Stable)
public static interface CfnLifecyclePolicy.RetainRuleProperty
extends software.amazon.jsii.JsiiSerializable

[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 of 1 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 of 1 day or more.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.dlm.*;
 RetainRuleProperty retainRuleProperty = RetainRuleProperty.builder()
         .count(123)
         .interval(123)
         .intervalUnit("intervalUnit")
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dlm-lifecyclepolicy-retainrule.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnLifecyclePolicy.RetainRuleProperty.Builder	A builder for CfnLifecyclePolicy.RetainRuleProperty
static final class	CfnLifecyclePolicy.RetainRuleProperty.Jsii$Proxy	An implementation for CfnLifecyclePolicy.RetainRuleProperty

Method Summary

Modifier and Type	Method	Description
static CfnLifecyclePolicy.RetainRuleProperty.Builder	builder()
default Number	getCount()	The number of snapshots to retain for each volume, up to a maximum of 1000.
default Number	getInterval()	The amount of time to retain each snapshot.
default String	getIntervalUnit()	The unit of time for time-based retention.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getCount

@Stability(Stable)
@Nullable
default Number getCount()

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 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dlm-lifecyclepolicy-retainrule.html#cfn-dlm-lifecyclepolicy-retainrule-count

getInterval

@Stability(Stable)
@Nullable
default Number getInterval()

The amount of time to retain each snapshot.

The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dlm-lifecyclepolicy-retainrule.html#cfn-dlm-lifecyclepolicy-retainrule-interval

getIntervalUnit

@Stability(Stable)
@Nullable
default String getIntervalUnit()

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 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dlm-lifecyclepolicy-retainrule.html#cfn-dlm-lifecyclepolicy-retainrule-intervalunit

builder

@Stability(Stable)
static CfnLifecyclePolicy.RetainRuleProperty.Builder builder()

Returns:

a CfnLifecyclePolicy.RetainRuleProperty.Builder of CfnLifecyclePolicy.RetainRuleProperty