Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
- Service Configuration
- Errors
- Waiters
- Operations
- Types
- EventSourceValues
- EventTypeValues
- GettablePolicyStateValues
- IntervalUnitValues
- LocationValues
- PolicyTypeValues
- ResourceLocationValues
- ResourceTypeValues
- RetentionIntervalUnitValues
- SettablePolicyStateValues
- Action
- ArchiveRetainRule
- ArchiveRule
- CreateRule
- CrossRegionCopyAction
- CrossRegionCopyDeprecateRule
- CrossRegionCopyRetainRule
- CrossRegionCopyRule
- DeprecateRule
- EncryptionConfiguration
- EventParameters
- EventSource
- FastRestoreRule
- LifecyclePolicy
- LifecyclePolicySummary
- Parameters
- PolicyDetails
- RetainRule
- RetentionArchiveTier
- Schedule
- ShareRule
- Tag
Derived from API version 2018-01-12
of the AWS service descriptions, licensed under Apache 2.0.
Amazon Data Lifecycle Manager
With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create lifecycle policies, which are used to automate operations on the specified resources.
Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager with Amazon EBS, see Amazon Data Lifecycle Manager in the Amazon EC2 User Guide.
Synopsis
- defaultService :: Service
- _InternalServerException :: AsError a => Fold a ServiceError
- _InvalidRequestException :: AsError a => Fold a ServiceError
- _LimitExceededException :: AsError a => Fold a ServiceError
- _ResourceNotFoundException :: AsError a => Fold a ServiceError
- data CreateLifecyclePolicy = CreateLifecyclePolicy' (Maybe (HashMap Text Text)) Text Text SettablePolicyStateValues PolicyDetails
- newCreateLifecyclePolicy :: Text -> Text -> SettablePolicyStateValues -> PolicyDetails -> CreateLifecyclePolicy
- data CreateLifecyclePolicyResponse = CreateLifecyclePolicyResponse' (Maybe Text) Int
- newCreateLifecyclePolicyResponse :: Int -> CreateLifecyclePolicyResponse
- data DeleteLifecyclePolicy = DeleteLifecyclePolicy' Text
- newDeleteLifecyclePolicy :: Text -> DeleteLifecyclePolicy
- data DeleteLifecyclePolicyResponse = DeleteLifecyclePolicyResponse' Int
- newDeleteLifecyclePolicyResponse :: Int -> DeleteLifecyclePolicyResponse
- data GetLifecyclePolicies = GetLifecyclePolicies' (Maybe [Text]) (Maybe (NonEmpty ResourceTypeValues)) (Maybe GettablePolicyStateValues) (Maybe [Text]) (Maybe (NonEmpty Text))
- newGetLifecyclePolicies :: GetLifecyclePolicies
- data GetLifecyclePoliciesResponse = GetLifecyclePoliciesResponse' (Maybe [LifecyclePolicySummary]) Int
- newGetLifecyclePoliciesResponse :: Int -> GetLifecyclePoliciesResponse
- data GetLifecyclePolicy = GetLifecyclePolicy' Text
- newGetLifecyclePolicy :: Text -> GetLifecyclePolicy
- data GetLifecyclePolicyResponse = GetLifecyclePolicyResponse' (Maybe LifecyclePolicy) Int
- newGetLifecyclePolicyResponse :: Int -> GetLifecyclePolicyResponse
- data ListTagsForResource = ListTagsForResource' Text
- newListTagsForResource :: Text -> ListTagsForResource
- data ListTagsForResourceResponse = ListTagsForResourceResponse' (Maybe (HashMap Text Text)) Int
- newListTagsForResourceResponse :: Int -> ListTagsForResourceResponse
- data TagResource = TagResource' Text (HashMap Text Text)
- newTagResource :: Text -> TagResource
- data TagResourceResponse = TagResourceResponse' Int
- newTagResourceResponse :: Int -> TagResourceResponse
- data UntagResource = UntagResource' Text (NonEmpty Text)
- newUntagResource :: Text -> NonEmpty Text -> UntagResource
- data UntagResourceResponse = UntagResourceResponse' Int
- newUntagResourceResponse :: Int -> UntagResourceResponse
- data UpdateLifecyclePolicy = UpdateLifecyclePolicy' (Maybe Text) (Maybe Text) (Maybe PolicyDetails) (Maybe SettablePolicyStateValues) Text
- newUpdateLifecyclePolicy :: Text -> UpdateLifecyclePolicy
- data UpdateLifecyclePolicyResponse = UpdateLifecyclePolicyResponse' Int
- newUpdateLifecyclePolicyResponse :: Int -> UpdateLifecyclePolicyResponse
- newtype EventSourceValues where
- newtype EventTypeValues where
- EventTypeValues' { }
- pattern EventTypeValues_ShareSnapshot :: EventTypeValues
- newtype GettablePolicyStateValues where
- newtype IntervalUnitValues where
- newtype LocationValues where
- LocationValues' { }
- pattern LocationValues_CLOUD :: LocationValues
- pattern LocationValues_OUTPOST_LOCAL :: LocationValues
- newtype PolicyTypeValues where
- newtype ResourceLocationValues where
- newtype ResourceTypeValues where
- newtype RetentionIntervalUnitValues where
- RetentionIntervalUnitValues' { }
- pattern RetentionIntervalUnitValues_DAYS :: RetentionIntervalUnitValues
- pattern RetentionIntervalUnitValues_MONTHS :: RetentionIntervalUnitValues
- pattern RetentionIntervalUnitValues_WEEKS :: RetentionIntervalUnitValues
- pattern RetentionIntervalUnitValues_YEARS :: RetentionIntervalUnitValues
- newtype SettablePolicyStateValues where
- data Action = Action' Text [CrossRegionCopyAction]
- newAction :: Text -> Action
- data ArchiveRetainRule = ArchiveRetainRule' RetentionArchiveTier
- newArchiveRetainRule :: RetentionArchiveTier -> ArchiveRetainRule
- data ArchiveRule = ArchiveRule' ArchiveRetainRule
- newArchiveRule :: ArchiveRetainRule -> ArchiveRule
- data CreateRule = CreateRule' (Maybe Text) (Maybe Natural) (Maybe IntervalUnitValues) (Maybe LocationValues) (Maybe [Text])
- newCreateRule :: CreateRule
- data CrossRegionCopyAction = CrossRegionCopyAction' (Maybe CrossRegionCopyRetainRule) Text EncryptionConfiguration
- newCrossRegionCopyAction :: Text -> EncryptionConfiguration -> CrossRegionCopyAction
- data CrossRegionCopyDeprecateRule = CrossRegionCopyDeprecateRule' (Maybe Natural) (Maybe RetentionIntervalUnitValues)
- newCrossRegionCopyDeprecateRule :: CrossRegionCopyDeprecateRule
- data CrossRegionCopyRetainRule = CrossRegionCopyRetainRule' (Maybe Natural) (Maybe RetentionIntervalUnitValues)
- newCrossRegionCopyRetainRule :: CrossRegionCopyRetainRule
- data CrossRegionCopyRule = CrossRegionCopyRule' (Maybe Text) (Maybe Bool) (Maybe CrossRegionCopyDeprecateRule) (Maybe CrossRegionCopyRetainRule) (Maybe Text) (Maybe Text) Bool
- newCrossRegionCopyRule :: Bool -> CrossRegionCopyRule
- data DeprecateRule = DeprecateRule' (Maybe Natural) (Maybe Natural) (Maybe RetentionIntervalUnitValues)
- newDeprecateRule :: DeprecateRule
- data EncryptionConfiguration = EncryptionConfiguration' (Maybe Text) Bool
- newEncryptionConfiguration :: Bool -> EncryptionConfiguration
- data EventParameters = EventParameters' EventTypeValues [Text] Text
- newEventParameters :: EventTypeValues -> Text -> EventParameters
- data EventSource = EventSource' (Maybe EventParameters) EventSourceValues
- newEventSource :: EventSourceValues -> EventSource
- data FastRestoreRule = FastRestoreRule' (Maybe Natural) (Maybe Natural) (Maybe RetentionIntervalUnitValues) (NonEmpty Text)
- newFastRestoreRule :: NonEmpty Text -> FastRestoreRule
- data LifecyclePolicy = LifecyclePolicy' (Maybe ISO8601) (Maybe ISO8601) (Maybe Text) (Maybe Text) (Maybe Text) (Maybe PolicyDetails) (Maybe Text) (Maybe GettablePolicyStateValues) (Maybe Text) (Maybe (HashMap Text Text))
- newLifecyclePolicy :: LifecyclePolicy
- data LifecyclePolicySummary = LifecyclePolicySummary' (Maybe Text) (Maybe Text) (Maybe PolicyTypeValues) (Maybe GettablePolicyStateValues) (Maybe (HashMap Text Text))
- newLifecyclePolicySummary :: LifecyclePolicySummary
- data Parameters = Parameters' (Maybe Bool) (Maybe [Tag]) (Maybe Bool)
- newParameters :: Parameters
- data PolicyDetails = PolicyDetails' (Maybe (NonEmpty Action)) (Maybe EventSource) (Maybe Parameters) (Maybe PolicyTypeValues) (Maybe (NonEmpty ResourceLocationValues)) (Maybe (NonEmpty ResourceTypeValues)) (Maybe (NonEmpty Schedule)) (Maybe (NonEmpty Tag))
- newPolicyDetails :: PolicyDetails
- data RetainRule = RetainRule' (Maybe Natural) (Maybe Natural) (Maybe RetentionIntervalUnitValues)
- newRetainRule :: RetainRule
- data RetentionArchiveTier = RetentionArchiveTier' (Maybe Natural) (Maybe Natural) (Maybe RetentionIntervalUnitValues)
- newRetentionArchiveTier :: RetentionArchiveTier
- data Schedule = Schedule' (Maybe ArchiveRule) (Maybe Bool) (Maybe CreateRule) (Maybe [CrossRegionCopyRule]) (Maybe DeprecateRule) (Maybe FastRestoreRule) (Maybe Text) (Maybe RetainRule) (Maybe [ShareRule]) (Maybe [Tag]) (Maybe [Tag])
- newSchedule :: Schedule
- data ShareRule = ShareRule' (Maybe Natural) (Maybe RetentionIntervalUnitValues) (NonEmpty Text)
- newShareRule :: NonEmpty Text -> ShareRule
- data Tag = Tag' Text Text
- newTag :: Text -> Text -> Tag
Service Configuration
defaultService :: Service Source #
API version 2018-01-12
of the Amazon Data Lifecycle Manager SDK configuration.
Errors
Error matchers are designed for use with the functions provided by
Control.Exception.Lens.
This allows catching (and rethrowing) service specific errors returned
by DLM
.
InternalServerException
_InternalServerException :: AsError a => Fold a ServiceError Source #
The service failed in an unexpected way.
InvalidRequestException
_InvalidRequestException :: AsError a => Fold a ServiceError Source #
Bad request. The request is missing required parameters or has invalid parameters.
LimitExceededException
_LimitExceededException :: AsError a => Fold a ServiceError Source #
The request failed because a limit was exceeded.
ResourceNotFoundException
_ResourceNotFoundException :: AsError a => Fold a ServiceError Source #
A requested resource was not found.
Waiters
Waiters poll by repeatedly sending a request until some remote success condition
configured by the Wait
specification is fulfilled. The Wait
specification
determines how many attempts should be made, in addition to delay and retry strategies.
Operations
Some AWS operations return results that are incomplete and require subsequent
requests in order to obtain the entire result set. The process of sending
subsequent requests to continue where a previous request left off is called
pagination. For example, the ListObjects
operation of Amazon S3 returns up to
1000 objects at a time, and you must send subsequent requests with the
appropriate Marker in order to retrieve the next page of results.
Operations that have an AWSPager
instance can transparently perform subsequent
requests, correctly setting Markers and other request facets to iterate through
the entire result set of a truncated API operation. Operations which support
this have an additional note in the documentation.
Many operations have the ability to filter results on the server side. See the individual operation parameters for details.
CreateLifecyclePolicy
data CreateLifecyclePolicy Source #
See: newCreateLifecyclePolicy
smart constructor.
CreateLifecyclePolicy' (Maybe (HashMap Text Text)) Text Text SettablePolicyStateValues PolicyDetails |
Instances
newCreateLifecyclePolicy Source #
Create a value of CreateLifecyclePolicy
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
CreateLifecyclePolicy
, createLifecyclePolicy_tags
- The tags to apply to the lifecycle policy during creation.
CreateLifecyclePolicy
, createLifecyclePolicy_executionRoleArn
- The Amazon Resource Name (ARN) of the IAM role used to run the
operations specified by the lifecycle policy.
CreateLifecyclePolicy
, createLifecyclePolicy_description
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$
are supported.
CreateLifecyclePolicy
, createLifecyclePolicy_state
- The desired activation state of the lifecycle policy after creation.
CreateLifecyclePolicy
, createLifecyclePolicy_policyDetails
- The configuration details of the lifecycle policy.
data CreateLifecyclePolicyResponse Source #
See: newCreateLifecyclePolicyResponse
smart constructor.
Instances
newCreateLifecyclePolicyResponse Source #
Create a value of CreateLifecyclePolicyResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
CreateLifecyclePolicyResponse
, createLifecyclePolicyResponse_policyId
- The identifier of the lifecycle policy.
$sel:httpStatus:CreateLifecyclePolicyResponse'
, createLifecyclePolicyResponse_httpStatus
- The response's http status code.
DeleteLifecyclePolicy
data DeleteLifecyclePolicy Source #
See: newDeleteLifecyclePolicy
smart constructor.
Instances
newDeleteLifecyclePolicy Source #
Create a value of DeleteLifecyclePolicy
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
DeleteLifecyclePolicy
, deleteLifecyclePolicy_policyId
- The identifier of the lifecycle policy.
data DeleteLifecyclePolicyResponse Source #
See: newDeleteLifecyclePolicyResponse
smart constructor.
Instances
newDeleteLifecyclePolicyResponse Source #
Create a value of DeleteLifecyclePolicyResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:DeleteLifecyclePolicyResponse'
, deleteLifecyclePolicyResponse_httpStatus
- The response's http status code.
GetLifecyclePolicies
data GetLifecyclePolicies Source #
See: newGetLifecyclePolicies
smart constructor.
GetLifecyclePolicies' (Maybe [Text]) (Maybe (NonEmpty ResourceTypeValues)) (Maybe GettablePolicyStateValues) (Maybe [Text]) (Maybe (NonEmpty Text)) |
Instances
newGetLifecyclePolicies :: GetLifecyclePolicies Source #
Create a value of GetLifecyclePolicies
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:policyIds:GetLifecyclePolicies'
, getLifecyclePolicies_policyIds
- The identifiers of the data lifecycle policies.
GetLifecyclePolicies
, getLifecyclePolicies_resourceTypes
- The resource type.
GetLifecyclePolicies
, getLifecyclePolicies_state
- The activation state.
GetLifecyclePolicies
, getLifecyclePolicies_tagsToAdd
- The tags to add to objects created by the policy.
Tags are strings in the format key=value
.
These user-defined tags are added in addition to the Amazon Web Services-added lifecycle tags.
GetLifecyclePolicies
, getLifecyclePolicies_targetTags
- The target tag for a policy.
Tags are strings in the format key=value
.
data GetLifecyclePoliciesResponse Source #
See: newGetLifecyclePoliciesResponse
smart constructor.
Instances
newGetLifecyclePoliciesResponse Source #
Create a value of GetLifecyclePoliciesResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:policies:GetLifecyclePoliciesResponse'
, getLifecyclePoliciesResponse_policies
- Summary information about the lifecycle policies.
$sel:httpStatus:GetLifecyclePoliciesResponse'
, getLifecyclePoliciesResponse_httpStatus
- The response's http status code.
GetLifecyclePolicy
data GetLifecyclePolicy Source #
See: newGetLifecyclePolicy
smart constructor.
Instances
newGetLifecyclePolicy Source #
Create a value of GetLifecyclePolicy
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
GetLifecyclePolicy
, getLifecyclePolicy_policyId
- The identifier of the lifecycle policy.
data GetLifecyclePolicyResponse Source #
See: newGetLifecyclePolicyResponse
smart constructor.
Instances
newGetLifecyclePolicyResponse Source #
Create a value of GetLifecyclePolicyResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:policy:GetLifecyclePolicyResponse'
, getLifecyclePolicyResponse_policy
- Detailed information about the lifecycle policy.
$sel:httpStatus:GetLifecyclePolicyResponse'
, getLifecyclePolicyResponse_httpStatus
- The response's http status code.
ListTagsForResource
data ListTagsForResource Source #
See: newListTagsForResource
smart constructor.
Instances
newListTagsForResource Source #
Create a value of ListTagsForResource
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:resourceArn:ListTagsForResource'
, listTagsForResource_resourceArn
- The Amazon Resource Name (ARN) of the resource.
data ListTagsForResourceResponse Source #
See: newListTagsForResourceResponse
smart constructor.
Instances
newListTagsForResourceResponse Source #
Create a value of ListTagsForResourceResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
ListTagsForResourceResponse
, listTagsForResourceResponse_tags
- Information about the tags.
$sel:httpStatus:ListTagsForResourceResponse'
, listTagsForResourceResponse_httpStatus
- The response's http status code.
TagResource
data TagResource Source #
See: newTagResource
smart constructor.
Instances
Create a value of TagResource
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:resourceArn:TagResource'
, tagResource_resourceArn
- The Amazon Resource Name (ARN) of the resource.
TagResource
, tagResource_tags
- One or more tags.
data TagResourceResponse Source #
See: newTagResourceResponse
smart constructor.
Instances
newTagResourceResponse Source #
Create a value of TagResourceResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:TagResourceResponse'
, tagResourceResponse_httpStatus
- The response's http status code.
UntagResource
data UntagResource Source #
See: newUntagResource
smart constructor.
Instances
Create a value of UntagResource
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:resourceArn:UntagResource'
, untagResource_resourceArn
- The Amazon Resource Name (ARN) of the resource.
$sel:tagKeys:UntagResource'
, untagResource_tagKeys
- The tag keys.
data UntagResourceResponse Source #
See: newUntagResourceResponse
smart constructor.
Instances
newUntagResourceResponse Source #
Create a value of UntagResourceResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:UntagResourceResponse'
, untagResourceResponse_httpStatus
- The response's http status code.
UpdateLifecyclePolicy
data UpdateLifecyclePolicy Source #
See: newUpdateLifecyclePolicy
smart constructor.
UpdateLifecyclePolicy' (Maybe Text) (Maybe Text) (Maybe PolicyDetails) (Maybe SettablePolicyStateValues) Text |
Instances
newUpdateLifecyclePolicy Source #
Create a value of UpdateLifecyclePolicy
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
UpdateLifecyclePolicy
, updateLifecyclePolicy_description
- A description of the lifecycle policy.
UpdateLifecyclePolicy
, updateLifecyclePolicy_executionRoleArn
- The Amazon Resource Name (ARN) of the IAM role used to run the
operations specified by the lifecycle policy.
UpdateLifecyclePolicy
, updateLifecyclePolicy_policyDetails
- The configuration of the lifecycle policy. You cannot update the policy
type or the resource type.
UpdateLifecyclePolicy
, updateLifecyclePolicy_state
- The desired activation state of the lifecycle policy after creation.
UpdateLifecyclePolicy
, updateLifecyclePolicy_policyId
- The identifier of the lifecycle policy.
data UpdateLifecyclePolicyResponse Source #
See: newUpdateLifecyclePolicyResponse
smart constructor.
Instances
newUpdateLifecyclePolicyResponse Source #
Create a value of UpdateLifecyclePolicyResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:UpdateLifecyclePolicyResponse'
, updateLifecyclePolicyResponse_httpStatus
- The response's http status code.
Types
EventSourceValues
newtype EventSourceValues Source #
pattern EventSourceValues_MANAGED_CWE :: EventSourceValues |
Instances
EventTypeValues
newtype EventTypeValues Source #
pattern EventTypeValues_ShareSnapshot :: EventTypeValues |
Instances
GettablePolicyStateValues
newtype GettablePolicyStateValues Source #
Instances
IntervalUnitValues
newtype IntervalUnitValues Source #
pattern IntervalUnitValues_HOURS :: IntervalUnitValues |
Instances
LocationValues
newtype LocationValues Source #
pattern LocationValues_CLOUD :: LocationValues | |
pattern LocationValues_OUTPOST_LOCAL :: LocationValues |
Instances
PolicyTypeValues
newtype PolicyTypeValues Source #
pattern PolicyTypeValues_EBS_SNAPSHOT_MANAGEMENT :: PolicyTypeValues | |
pattern PolicyTypeValues_EVENT_BASED_POLICY :: PolicyTypeValues | |
pattern PolicyTypeValues_IMAGE_MANAGEMENT :: PolicyTypeValues |
Instances
ResourceLocationValues
newtype ResourceLocationValues Source #
pattern ResourceLocationValues_CLOUD :: ResourceLocationValues | |
pattern ResourceLocationValues_OUTPOST :: ResourceLocationValues |
Instances
ResourceTypeValues
newtype ResourceTypeValues Source #
pattern ResourceTypeValues_INSTANCE :: ResourceTypeValues | |
pattern ResourceTypeValues_VOLUME :: ResourceTypeValues |
Instances
RetentionIntervalUnitValues
newtype RetentionIntervalUnitValues Source #
Instances
SettablePolicyStateValues
newtype SettablePolicyStateValues Source #
pattern SettablePolicyStateValues_DISABLED :: SettablePolicyStateValues | |
pattern SettablePolicyStateValues_ENABLED :: SettablePolicyStateValues |
Instances
Action
[Event-based policies only] Specifies an action for an event-based policy.
See: newAction
smart constructor.
Instances
FromJSON Action Source # | |
ToJSON Action Source # | |
Defined in Amazonka.DLM.Types.Action | |
Generic Action Source # | |
Read Action Source # | |
Show Action Source # | |
NFData Action Source # | |
Defined in Amazonka.DLM.Types.Action | |
Eq Action Source # | |
Hashable Action Source # | |
Defined in Amazonka.DLM.Types.Action | |
type Rep Action Source # | |
Defined in Amazonka.DLM.Types.Action type Rep Action = D1 ('MetaData "Action" "Amazonka.DLM.Types.Action" "amazonka-dlm-2.0-KlPkRzsIoa0q62N0Ereji" 'False) (C1 ('MetaCons "Action'" 'PrefixI 'True) (S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "crossRegionCopy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [CrossRegionCopyAction]))) |
Create a value of Action
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:name:Action'
, action_name
- A descriptive name for the action.
$sel:crossRegionCopy:Action'
, action_crossRegionCopy
- The rule for copying shared snapshots across Regions.
ArchiveRetainRule
data ArchiveRetainRule Source #
[Snapshot policies only] Specifies information about the archive storage tier retention period.
See: newArchiveRetainRule
smart constructor.
Instances
Create a value of ArchiveRetainRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:retentionArchiveTier:ArchiveRetainRule'
, archiveRetainRule_retentionArchiveTier
- Information about retention period in the Amazon EBS Snapshots Archive.
For more information, see
Archive Amazon EBS snapshots.
ArchiveRule
data ArchiveRule Source #
[Snapshot policies only] Specifies a snapshot archiving rule for a schedule.
See: newArchiveRule
smart constructor.
Instances
Create a value of ArchiveRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:retainRule:ArchiveRule'
, archiveRule_retainRule
- Information about the retention period for the snapshot archiving rule.
CreateRule
data CreateRule Source #
[Snapshot and AMI policies only] Specifies when the policy should create snapshots or AMIs.
- You must specify either CronExpression, or Interval, IntervalUnit, and Times.
- If you need to specify an ArchiveRule for the schedule, then you must specify a creation frequency of at least 28 days.
See: newCreateRule
smart constructor.
CreateRule' (Maybe Text) (Maybe Natural) (Maybe IntervalUnitValues) (Maybe LocationValues) (Maybe [Text]) |
Instances
newCreateRule :: CreateRule Source #
Create a value of CreateRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:cronExpression:CreateRule'
, createRule_cronExpression
- The schedule, as a Cron expression. The schedule interval must be
between 1 hour and 1 year. For more information, see
Cron expressions
in the Amazon CloudWatch User Guide.
$sel:interval:CreateRule'
, createRule_interval
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6,
8, 12, and 24.
$sel:intervalUnit:CreateRule'
, createRule_intervalUnit
- The interval unit.
$sel:location:CreateRule'
, createRule_location
- [Snapshot policies only] Specifies the destination for snapshots
created by the policy. To create snapshots in the same Region as the
source resource, specify CLOUD
. To create snapshots on the same
Outpost as the source resource, specify OUTPOST_LOCAL
. If you omit
this parameter, CLOUD
is used by default.
If the policy targets resources in an Amazon Web Services Region, then you must create snapshots in the same Region as the source resource. If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost as the source resource, or in the Region of that Outpost.
$sel:times:CreateRule'
, createRule_times
- The time, in UTC, to start the operation. The supported format is hh:mm.
The operation occurs within a one-hour window following the specified time. If you do not specify a time, Amazon Data Lifecycle Manager selects a time within the next 24 hours.
CrossRegionCopyAction
data CrossRegionCopyAction Source #
[Event-based policies only] Specifies a cross-Region copy action for event-based policies.
To specify a cross-Region copy rule for snapshot and AMI policies, use CrossRegionCopyRule.
See: newCrossRegionCopyAction
smart constructor.
Instances
newCrossRegionCopyAction Source #
Create a value of CrossRegionCopyAction
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:retainRule:CrossRegionCopyAction'
, crossRegionCopyAction_retainRule
- Undocumented member.
$sel:target:CrossRegionCopyAction'
, crossRegionCopyAction_target
- The target Region.
$sel:encryptionConfiguration:CrossRegionCopyAction'
, crossRegionCopyAction_encryptionConfiguration
- The encryption settings for the copied snapshot.
CrossRegionCopyDeprecateRule
data CrossRegionCopyDeprecateRule Source #
[AMI policies only] Specifies an AMI deprecation rule for cross-Region AMI copies created by an AMI policy.
See: newCrossRegionCopyDeprecateRule
smart constructor.
Instances
newCrossRegionCopyDeprecateRule :: CrossRegionCopyDeprecateRule Source #
Create a value of CrossRegionCopyDeprecateRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:interval:CrossRegionCopyDeprecateRule'
, crossRegionCopyDeprecateRule_interval
- The period after which to deprecate the cross-Region AMI copies. The
period must be less than or equal to the cross-Region AMI copy retention
period, and it can't be greater than 10 years. This is equivalent to
120 months, 520 weeks, or 3650 days.
$sel:intervalUnit:CrossRegionCopyDeprecateRule'
, crossRegionCopyDeprecateRule_intervalUnit
- The unit of time in which to measure the Interval. For example, to
deprecate a cross-Region AMI copy after 3 months, specify Interval=3
and IntervalUnit=MONTHS
.
CrossRegionCopyRetainRule
data CrossRegionCopyRetainRule Source #
Specifies a retention rule for cross-Region snapshot copies created by snapshot or event-based policies, or cross-Region AMI copies created by AMI policies. After the retention period expires, the cross-Region copy is deleted.
See: newCrossRegionCopyRetainRule
smart constructor.
Instances
newCrossRegionCopyRetainRule :: CrossRegionCopyRetainRule Source #
Create a value of CrossRegionCopyRetainRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:interval:CrossRegionCopyRetainRule'
, crossRegionCopyRetainRule_interval
- The amount of time to retain a cross-Region snapshot or AMI copy. The
maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or
36500 days.
$sel:intervalUnit:CrossRegionCopyRetainRule'
, crossRegionCopyRetainRule_intervalUnit
- The unit of time for time-based retention. For example, to retain a
cross-Region copy for 3 months, specify Interval=3
and
IntervalUnit=MONTHS
.
CrossRegionCopyRule
data CrossRegionCopyRule Source #
[Snapshot and AMI policies only] Specifies a cross-Region copy rule for snapshot and AMI policies.
To specify a cross-Region copy action for event-based polices, use CrossRegionCopyAction.
See: newCrossRegionCopyRule
smart constructor.
CrossRegionCopyRule' (Maybe Text) (Maybe Bool) (Maybe CrossRegionCopyDeprecateRule) (Maybe CrossRegionCopyRetainRule) (Maybe Text) (Maybe Text) Bool |
Instances
newCrossRegionCopyRule Source #
Create a value of CrossRegionCopyRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:cmkArn:CrossRegionCopyRule'
, crossRegionCopyRule_cmkArn
- The Amazon Resource Name (ARN) of the KMS key to use for EBS encryption.
If this parameter is not specified, the default KMS key for the account
is used.
$sel:copyTags:CrossRegionCopyRule'
, crossRegionCopyRule_copyTags
- Indicates whether to copy all user-defined tags from the source snapshot
or AMI to the cross-Region copy.
$sel:deprecateRule:CrossRegionCopyRule'
, crossRegionCopyRule_deprecateRule
- [AMI policies only] The AMI deprecation rule for cross-Region AMI
copies created by the rule.
$sel:retainRule:CrossRegionCopyRule'
, crossRegionCopyRule_retainRule
- The retention rule that indicates how long the cross-Region snapshot or
AMI copies are to be retained in the destination Region.
$sel:target:CrossRegionCopyRule'
, crossRegionCopyRule_target
- The target Region or the Amazon Resource Name (ARN) of the target
Outpost for the snapshot copies.
Use this parameter instead of TargetRegion. Do not specify both.
$sel:targetRegion:CrossRegionCopyRule'
, crossRegionCopyRule_targetRegion
- Avoid using this parameter when creating new policies. Instead, use
Target to specify a target Region or a target Outpost for snapshot
copies.
For policies created before the Target parameter was introduced, this parameter indicates the target Region for snapshot copies.
$sel:encrypted:CrossRegionCopyRule'
, crossRegionCopyRule_encrypted
- To encrypt a copy of an unencrypted snapshot if encryption by default is
not enabled, enable encryption using this parameter. Copies of encrypted
snapshots are encrypted, even if this parameter is false or if
encryption by default is not enabled.
DeprecateRule
data DeprecateRule Source #
[AMI policies only] Specifies an AMI deprecation rule for AMIs created by an AMI lifecycle policy.
For age-based schedules, you must specify Interval and IntervalUnit. For count-based schedules, you must specify Count.
See: newDeprecateRule
smart constructor.
Instances
newDeprecateRule :: DeprecateRule Source #
Create a value of DeprecateRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:count:DeprecateRule'
, deprecateRule_count
- If the schedule has a count-based retention rule, this parameter
specifies the number of oldest AMIs to deprecate. The count must be less
than or equal to the schedule's retention count, and it can't be
greater than 1000.
$sel:interval:DeprecateRule'
, deprecateRule_interval
- If the schedule has an age-based retention rule, this parameter
specifies the period after which to deprecate AMIs created by the
schedule. The period must be less than or equal to the schedule's
retention period, and it can't be greater than 10 years. This is
equivalent to 120 months, 520 weeks, or 3650 days.
$sel:intervalUnit:DeprecateRule'
, deprecateRule_intervalUnit
- The unit of time in which to measure the Interval.
EncryptionConfiguration
data EncryptionConfiguration Source #
[Event-based policies only] Specifies the encryption settings for cross-Region snapshot copies created by event-based policies.
See: newEncryptionConfiguration
smart constructor.
Instances
newEncryptionConfiguration Source #
Create a value of EncryptionConfiguration
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:cmkArn:EncryptionConfiguration'
, encryptionConfiguration_cmkArn
- The Amazon Resource Name (ARN) of the KMS key to use for EBS encryption.
If this parameter is not specified, the default KMS key for the account
is used.
$sel:encrypted:EncryptionConfiguration'
, encryptionConfiguration_encrypted
- To encrypt a copy of an unencrypted snapshot when encryption by default
is not enabled, enable encryption using this parameter. Copies of
encrypted snapshots are encrypted, even if this parameter is false or
when encryption by default is not enabled.
EventParameters
data EventParameters Source #
[Event-based policies only] Specifies an event that activates an event-based policy.
See: newEventParameters
smart constructor.
Instances
:: EventTypeValues | |
-> Text | |
-> EventParameters |
Create a value of EventParameters
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:eventType:EventParameters'
, eventParameters_eventType
- The type of event. Currently, only snapshot sharing events are
supported.
$sel:snapshotOwner:EventParameters'
, eventParameters_snapshotOwner
- The IDs of the Amazon Web Services accounts that can trigger policy by
sharing snapshots with your account. The policy only runs if one of the
specified Amazon Web Services accounts shares a snapshot with your
account.
$sel:descriptionRegex:EventParameters'
, eventParameters_descriptionRegex
- The snapshot description that can trigger the policy. The description
pattern is specified using a regular expression. The policy runs only if
a snapshot with a description that matches the specified pattern is
shared with your account.
For example, specifying
^.*Created for policy: policy-1234567890abcdef0.*$
configures the
policy to run only if snapshots created by policy
policy-1234567890abcdef0
are shared with your account.
EventSource
data EventSource Source #
[Event-based policies only] Specifies an event that activates an event-based policy.
See: newEventSource
smart constructor.
Instances
Create a value of EventSource
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:parameters:EventSource'
, eventSource_parameters
- Information about the event.
$sel:type':EventSource'
, eventSource_type
- The source of the event. Currently only managed CloudWatch Events rules
are supported.
FastRestoreRule
data FastRestoreRule Source #
[Snapshot policies only] Specifies a rule for enabling fast snapshot restore for snapshots created by snapshot policies. You can enable fast snapshot restore based on either a count or a time interval.
See: newFastRestoreRule
smart constructor.
FastRestoreRule' (Maybe Natural) (Maybe Natural) (Maybe RetentionIntervalUnitValues) (NonEmpty Text) |
Instances
Create a value of FastRestoreRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:count:FastRestoreRule'
, fastRestoreRule_count
- The number of snapshots to be enabled with fast snapshot restore.
$sel:interval:FastRestoreRule'
, fastRestoreRule_interval
- The amount of time to enable fast snapshot restore. The maximum is 100
years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.
$sel:intervalUnit:FastRestoreRule'
, fastRestoreRule_intervalUnit
- The unit of time for enabling fast snapshot restore.
$sel:availabilityZones:FastRestoreRule'
, fastRestoreRule_availabilityZones
- The Availability Zones in which to enable fast snapshot restore.
LifecyclePolicy
data LifecyclePolicy Source #
[All policy types] Detailed information about a snapshot, AMI, or event-based lifecycle policy.
See: newLifecyclePolicy
smart constructor.
LifecyclePolicy' (Maybe ISO8601) (Maybe ISO8601) (Maybe Text) (Maybe Text) (Maybe Text) (Maybe PolicyDetails) (Maybe Text) (Maybe GettablePolicyStateValues) (Maybe Text) (Maybe (HashMap Text Text)) |
Instances
newLifecyclePolicy :: LifecyclePolicy Source #
Create a value of LifecyclePolicy
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:dateCreated:LifecyclePolicy'
, lifecyclePolicy_dateCreated
- The local date and time when the lifecycle policy was created.
$sel:dateModified:LifecyclePolicy'
, lifecyclePolicy_dateModified
- The local date and time when the lifecycle policy was last modified.
$sel:description:LifecyclePolicy'
, lifecyclePolicy_description
- The description of the lifecycle policy.
$sel:executionRoleArn:LifecyclePolicy'
, lifecyclePolicy_executionRoleArn
- The Amazon Resource Name (ARN) of the IAM role used to run the
operations specified by the lifecycle policy.
$sel:policyArn:LifecyclePolicy'
, lifecyclePolicy_policyArn
- The Amazon Resource Name (ARN) of the policy.
$sel:policyDetails:LifecyclePolicy'
, lifecyclePolicy_policyDetails
- The configuration of the lifecycle policy
$sel:policyId:LifecyclePolicy'
, lifecyclePolicy_policyId
- The identifier of the lifecycle policy.
$sel:state:LifecyclePolicy'
, lifecyclePolicy_state
- The activation state of the lifecycle policy.
$sel:statusMessage:LifecyclePolicy'
, lifecyclePolicy_statusMessage
- The description of the status.
$sel:tags:LifecyclePolicy'
, lifecyclePolicy_tags
- The tags.
LifecyclePolicySummary
data LifecyclePolicySummary Source #
Summary information about a lifecycle policy.
See: newLifecyclePolicySummary
smart constructor.
LifecyclePolicySummary' (Maybe Text) (Maybe Text) (Maybe PolicyTypeValues) (Maybe GettablePolicyStateValues) (Maybe (HashMap Text Text)) |
Instances
newLifecyclePolicySummary :: LifecyclePolicySummary Source #
Create a value of LifecyclePolicySummary
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:description:LifecyclePolicySummary'
, lifecyclePolicySummary_description
- The description of the lifecycle policy.
$sel:policyId:LifecyclePolicySummary'
, lifecyclePolicySummary_policyId
- The identifier of the lifecycle policy.
$sel:policyType:LifecyclePolicySummary'
, lifecyclePolicySummary_policyType
- The type of policy. EBS_SNAPSHOT_MANAGEMENT
indicates that the policy
manages the lifecycle of Amazon EBS snapshots. IMAGE_MANAGEMENT
indicates that the policy manages the lifecycle of EBS-backed AMIs.
EVENT_BASED_POLICY
indicates that the policy automates cross-account
snapshot copies for snapshots that are shared with your account.
$sel:state:LifecyclePolicySummary'
, lifecyclePolicySummary_state
- The activation state of the lifecycle policy.
$sel:tags:LifecyclePolicySummary'
, lifecyclePolicySummary_tags
- The tags.
Parameters
data Parameters Source #
[Snapshot and AMI policies only] Specifies optional parameters for snapshot and AMI policies. The set of valid parameters depends on the combination of policy type and target resource type.
If you choose to exclude boot volumes and you specify tags that
consequently exclude all of the additional data volumes attached to an
instance, then Amazon Data Lifecycle Manager will not create any
snapshots for the affected instance, and it will emit a
SnapshotsCreateFailed
Amazon CloudWatch metric. For more information,
see
Monitor your policies using Amazon CloudWatch.
See: newParameters
smart constructor.
Instances
newParameters :: Parameters Source #
Create a value of Parameters
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:excludeBootVolume:Parameters'
, parameters_excludeBootVolume
- [Snapshot policies that target instances only] Indicates whether to
exclude the root volume from multi-volume snapshot sets. The default is
false
. If you specify true
, then the root volumes attached to
targeted instances will be excluded from the multi-volume snapshot sets
created by the policy.
$sel:excludeDataVolumeTags:Parameters'
, parameters_excludeDataVolumeTags
- [Snapshot policies that target instances only] The tags used to
identify data (non-root) volumes to exclude from multi-volume snapshot
sets.
If you create a snapshot lifecycle policy that targets instances and you specify tags for this parameter, then data volumes with the specified tags that are attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy.
$sel:noReboot:Parameters'
, parameters_noReboot
- [AMI policies only] Indicates whether targeted instances are
rebooted when the lifecycle policy runs. true
indicates that targeted
instances are not rebooted when the policy runs. false
indicates that
target instances are rebooted when the policy runs. The default is
true
(instances are not rebooted).
PolicyDetails
data PolicyDetails Source #
[All policy types] Specifies the configuration of a lifecycle policy.
See: newPolicyDetails
smart constructor.
PolicyDetails' (Maybe (NonEmpty Action)) (Maybe EventSource) (Maybe Parameters) (Maybe PolicyTypeValues) (Maybe (NonEmpty ResourceLocationValues)) (Maybe (NonEmpty ResourceTypeValues)) (Maybe (NonEmpty Schedule)) (Maybe (NonEmpty Tag)) |
Instances
newPolicyDetails :: PolicyDetails Source #
Create a value of PolicyDetails
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:actions:PolicyDetails'
, policyDetails_actions
- [Event-based policies only] The actions to be performed when the
event-based policy is activated. You can specify only one action per
policy.
$sel:eventSource:PolicyDetails'
, policyDetails_eventSource
- [Event-based policies only] The event that activates the event-based
policy.
PolicyDetails
, policyDetails_parameters
- [Snapshot and AMI policies only] A set of optional parameters for
snapshot and AMI lifecycle policies.
If you are modifying a policy that was created or previously modified using the Amazon Data Lifecycle Manager console, then you must include this parameter and specify either the default values or the new values that you require. You can't omit this parameter or set its values to null.
$sel:policyType:PolicyDetails'
, policyDetails_policyType
- [All policy types] The valid target resource types and actions a
policy can manage. Specify EBS_SNAPSHOT_MANAGEMENT
to create a
lifecycle policy that manages the lifecycle of Amazon EBS snapshots.
Specify IMAGE_MANAGEMENT
to create a lifecycle policy that manages the
lifecycle of EBS-backed AMIs. Specify EVENT_BASED_POLICY
to create an
event-based policy that performs specific actions when a defined event
occurs in your Amazon Web Services account.
The default is EBS_SNAPSHOT_MANAGEMENT
.
$sel:resourceLocations:PolicyDetails'
, policyDetails_resourceLocations
- [Snapshot and AMI policies only] The location of the resources to
backup. If the source resources are located in an Amazon Web Services
Region, specify CLOUD
. If the source resources are located on an
Outpost in your account, specify OUTPOST
.
If you specify OUTPOST
, Amazon Data Lifecycle Manager backs up all
resources of the specified type with matching target tags across all of
the Outposts in your account.
$sel:resourceTypes:PolicyDetails'
, policyDetails_resourceTypes
- [Snapshot policies only] The target resource type for snapshot and
AMI lifecycle policies. Use VOLUME
to create snapshots of individual
volumes or use INSTANCE
to create multi-volume snapshots from the
volumes for an instance.
$sel:schedules:PolicyDetails'
, policyDetails_schedules
- [Snapshot and AMI policies only] The schedules of policy-defined
actions for snapshot and AMI lifecycle policies. A policy can have up to
four schedules—one mandatory schedule and up to three optional
schedules.
$sel:targetTags:PolicyDetails'
, policyDetails_targetTags
- [Snapshot and AMI policies only] The single tag that identifies
targeted resources for this policy.
RetainRule
data RetainRule Source #
[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.
See: newRetainRule
smart constructor.
Instances
newRetainRule :: RetainRule Source #
Create a value of RetainRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:count:RetainRule'
, retainRule_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.
$sel:interval:RetainRule'
, retainRule_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.
$sel:intervalUnit:RetainRule'
, retainRule_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.
RetentionArchiveTier
data RetentionArchiveTier Source #
[Snapshot policies only] Describes the retention rule for archived snapshots. Once the archive retention threshold is met, the snapshots are permanently deleted from the archive tier.
The archive retention rule must retain snapshots in the archive tier for a minimum of 90 days.
For count-based schedules, you must specify Count. For age-based schedules, you must specify Interval and IntervalUnit.
For more information about using snapshot archiving, see Considerations for snapshot lifecycle policies.
See: newRetentionArchiveTier
smart constructor.
Instances
newRetentionArchiveTier :: RetentionArchiveTier Source #
Create a value of RetentionArchiveTier
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:count:RetentionArchiveTier'
, retentionArchiveTier_count
- The maximum number of snapshots to retain in the archive storage tier
for each volume. The count must ensure that each snapshot remains in the
archive tier for at least 90 days. For example, if the schedule creates
snapshots every 30 days, you must specify a count of 3 or more to ensure
that each snapshot is archived for at least 90 days.
$sel:interval:RetentionArchiveTier'
, retentionArchiveTier_interval
- Specifies the period of time to retain snapshots in the archive tier.
After this period expires, the snapshot is permanently deleted.
$sel:intervalUnit:RetentionArchiveTier'
, retentionArchiveTier_intervalUnit
- The unit of time in which to measure the Interval. For example, to
retain a snapshots in the archive tier for 6 months, specify
Interval=6
and IntervalUnit=MONTHS
.
Schedule
[Snapshot and AMI policies only] Specifies a schedule for a snapshot or AMI lifecycle policy.
See: newSchedule
smart constructor.
Schedule' (Maybe ArchiveRule) (Maybe Bool) (Maybe CreateRule) (Maybe [CrossRegionCopyRule]) (Maybe DeprecateRule) (Maybe FastRestoreRule) (Maybe Text) (Maybe RetainRule) (Maybe [ShareRule]) (Maybe [Tag]) (Maybe [Tag]) |
Instances
newSchedule :: Schedule Source #
Create a value of Schedule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:archiveRule:Schedule'
, schedule_archiveRule
- [Snapshot policies that target volumes only] The snapshot archiving
rule for the schedule. When you specify an archiving rule, snapshots are
automatically moved from the standard tier to the archive tier once the
schedule's retention threshold is met. Snapshots are then retained in
the archive tier for the archive retention period that you specify.
For more information about using snapshot archiving, see Considerations for snapshot lifecycle policies.
Schedule
, schedule_copyTags
- Copy all user-defined tags on a source volume to snapshots of the volume
created by this policy.
$sel:createRule:Schedule'
, schedule_createRule
- The creation rule.
$sel:crossRegionCopyRules:Schedule'
, schedule_crossRegionCopyRules
- Specifies a rule for copying snapshots or AMIs across regions.
You can't specify cross-Region copy rules for policies that create snapshots on an Outpost. If the policy creates snapshots in a Region, then snapshots can be copied to up to three Regions or Outposts.
Schedule
, schedule_deprecateRule
- [AMI policies only] The AMI deprecation rule for the schedule.
$sel:fastRestoreRule:Schedule'
, schedule_fastRestoreRule
- [Snapshot policies only] The rule for enabling fast snapshot
restore.
$sel:name:Schedule'
, schedule_name
- The name of the schedule.
Schedule
, schedule_retainRule
- The retention rule for snapshots or AMIs created by the policy.
$sel:shareRules:Schedule'
, schedule_shareRules
- [Snapshot policies only] The rule for sharing snapshots with other
Amazon Web Services accounts.
$sel:tagsToAdd:Schedule'
, schedule_tagsToAdd
- The tags to apply to policy-created resources. These user-defined tags
are in addition to the Amazon Web Services-added lifecycle tags.
$sel:variableTags:Schedule'
, schedule_variableTags
- [AMI policies and snapshot policies that target instances only] A
collection of key/value pairs with values determined dynamically when
the policy is executed. Keys may be any valid Amazon EC2 tag key. Values
must be in one of the two following formats: $(instance-id)
or
$(timestamp)
. Variable tags are only valid for EBS Snapshot Management
– Instance policies.
ShareRule
[Snapshot policies only] Specifies a rule for sharing snapshots across Amazon Web Services accounts.
See: newShareRule
smart constructor.
Instances
Create a value of ShareRule
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:unshareInterval:ShareRule'
, shareRule_unshareInterval
- The period after which snapshots that are shared with other Amazon Web
Services accounts are automatically unshared.
$sel:unshareIntervalUnit:ShareRule'
, shareRule_unshareIntervalUnit
- The unit of time for the automatic unsharing interval.
$sel:targetAccounts:ShareRule'
, shareRule_targetAccounts
- The IDs of the Amazon Web Services accounts with which to share the
snapshots.
Tag
Specifies a tag for a resource.
See: newTag
smart constructor.
Instances
FromJSON Tag Source # | |
ToJSON Tag Source # | |
Defined in Amazonka.DLM.Types.Tag | |
Generic Tag Source # | |
Read Tag Source # | |
Show Tag Source # | |
NFData Tag Source # | |
Defined in Amazonka.DLM.Types.Tag | |
Eq Tag Source # | |
Hashable Tag Source # | |
Defined in Amazonka.DLM.Types.Tag | |
type Rep Tag Source # | |
Defined in Amazonka.DLM.Types.Tag type Rep Tag = D1 ('MetaData "Tag" "Amazonka.DLM.Types.Tag" "amazonka-dlm-2.0-KlPkRzsIoa0q62N0Ereji" 'False) (C1 ('MetaCons "Tag'" 'PrefixI 'True) (S1 ('MetaSel ('Just "key") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "value") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))) |
Create a value of Tag
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:key:Tag'
, tag_key
- The tag key.
$sel:value:Tag'
, tag_value
- The tag value.