/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include namespace Aws { namespace Utils { namespace Json { class JsonValue; class JsonView; } // namespace Json } // namespace Utils namespace DLM { namespace Model { /** *

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

See Also:

AWS API * Reference

*/ class RetainRule { public: AWS_DLM_API RetainRule(); AWS_DLM_API RetainRule(Aws::Utils::Json::JsonView jsonValue); AWS_DLM_API RetainRule& operator=(Aws::Utils::Json::JsonView jsonValue); AWS_DLM_API Aws::Utils::Json::JsonValue Jsonize() const; /** *

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.

*/ inline int GetCount() const{ return m_count; } /** *

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.

*/ inline bool CountHasBeenSet() const { return m_countHasBeenSet; } /** *

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.

*/ inline void SetCount(int value) { m_countHasBeenSet = true; m_count = value; } /** *

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.

*/ inline RetainRule& WithCount(int value) { SetCount(value); return *this;} /** *

The amount of time to retain each snapshot. The maximum is 100 years. This is * equivalent to 1200 months, 5200 weeks, or 36500 days.

*/ inline int GetInterval() const{ return m_interval; } /** *

The amount of time to retain each snapshot. The maximum is 100 years. This is * equivalent to 1200 months, 5200 weeks, or 36500 days.

*/ inline bool IntervalHasBeenSet() const { return m_intervalHasBeenSet; } /** *

The amount of time to retain each snapshot. The maximum is 100 years. This is * equivalent to 1200 months, 5200 weeks, or 36500 days.

*/ inline void SetInterval(int value) { m_intervalHasBeenSet = true; m_interval = value; } /** *

The amount of time to retain each snapshot. The maximum is 100 years. This is * equivalent to 1200 months, 5200 weeks, or 36500 days.

*/ inline RetainRule& WithInterval(int value) { SetInterval(value); return *this;} /** *

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.

*/ inline const RetentionIntervalUnitValues& GetIntervalUnit() const{ return m_intervalUnit; } /** *

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.

*/ inline bool IntervalUnitHasBeenSet() const { return m_intervalUnitHasBeenSet; } /** *

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.

*/ inline void SetIntervalUnit(const RetentionIntervalUnitValues& value) { m_intervalUnitHasBeenSet = true; m_intervalUnit = value; } /** *

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.

*/ inline void SetIntervalUnit(RetentionIntervalUnitValues&& value) { m_intervalUnitHasBeenSet = true; m_intervalUnit = std::move(value); } /** *

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.

*/ inline RetainRule& WithIntervalUnit(const RetentionIntervalUnitValues& value) { SetIntervalUnit(value); return *this;} /** *

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.

*/ inline RetainRule& WithIntervalUnit(RetentionIntervalUnitValues&& value) { SetIntervalUnit(std::move(value)); return *this;} private: int m_count; bool m_countHasBeenSet = false; int m_interval; bool m_intervalHasBeenSet = false; RetentionIntervalUnitValues m_intervalUnit; bool m_intervalUnitHasBeenSet = false; }; } // namespace Model } // namespace DLM } // namespace Aws