We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
Resource Type definition for AWS::DLM::LifecyclePolicy
Using getLifecyclePolicy
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getLifecyclePolicy(args: GetLifecyclePolicyArgs, opts?: InvokeOptions): Promise<GetLifecyclePolicyResult>
function getLifecyclePolicyOutput(args: GetLifecyclePolicyOutputArgs, opts?: InvokeOutputOptions): Output<GetLifecyclePolicyResult>def get_lifecycle_policy(policy_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetLifecyclePolicyResult
def get_lifecycle_policy_output(policy_id: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOutputOptions] = None) -> Output[GetLifecyclePolicyResult]func LookupLifecyclePolicy(ctx *Context, args *LookupLifecyclePolicyArgs, opts ...InvokeOption) (*LookupLifecyclePolicyResult, error)
func LookupLifecyclePolicyOutput(ctx *Context, args *LookupLifecyclePolicyOutputArgs, opts ...InvokeOption) LookupLifecyclePolicyResultOutput> Note: This function is named LookupLifecyclePolicy in the Go SDK.
public static class GetLifecyclePolicy
{
public static Task<GetLifecyclePolicyResult> InvokeAsync(GetLifecyclePolicyArgs args, InvokeOptions? opts = null)
public static Output<GetLifecyclePolicyResult> Invoke(GetLifecyclePolicyInvokeArgs args, InvokeOptions? opts = null)
public static Output<GetLifecyclePolicyResult> Invoke(GetLifecyclePolicyInvokeArgs args, InvokeOutputOptions opts)
}public static CompletableFuture<GetLifecyclePolicyResult> getLifecyclePolicy(GetLifecyclePolicyArgs args, InvokeOptions options)
public static Output<GetLifecyclePolicyResult> getLifecyclePolicy(GetLifecyclePolicyArgs args, InvokeOptions options)
public static Output<GetLifecyclePolicyResult> getLifecyclePolicy(GetLifecyclePolicyArgs args, InvokeOutputOptions options)
fn::invoke:
function: aws-native:dlm:getLifecyclePolicy
arguments:
# arguments dictionarydata "aws-native_dlm_get_lifecycle_policy" "name" {
# arguments
}The following arguments are supported:
- Policy
Id string - The identifier of the lifecycle policy.
- Policy
Id string - The identifier of the lifecycle policy.
- policy_
id string - The identifier of the lifecycle policy.
- policy
Id String - The identifier of the lifecycle policy.
- policy
Id string - The identifier of the lifecycle policy.
- policy_
id str - The identifier of the lifecycle policy.
- policy
Id String - The identifier of the lifecycle policy.
getLifecyclePolicy Result
The following output properties are available:
- Arn string
- The Amazon Resource Name (ARN) of the lifecycle policy.
- bool
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- Create
Interval int - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- Cross
Region List<Pulumi.Copy Targets Aws Native. Dlm. Outputs. Lifecycle Policy Cross Region Copy Target> - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- Default
Policy string - [Default policies only] Specify the type of default policy to create.
- Description string
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- Exclusions
Pulumi.
Aws Native. Dlm. Outputs. Lifecycle Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- Execution
Role stringArn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- Extend
Deletion bool - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- Policy
Details Pulumi.Aws Native. Dlm. Outputs. Lifecycle Policy Policy Details The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- Policy
Id string - The identifier of the lifecycle policy.
- Retain
Interval int - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- State string
- The activation state of the lifecycle policy.
-
List<Pulumi.
Aws Native. Outputs. Tag> - The tags to apply to the lifecycle policy during creation.
- Arn string
- The Amazon Resource Name (ARN) of the lifecycle policy.
- bool
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- Create
Interval int - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- Cross
Region []LifecycleCopy Targets Policy Cross Region Copy Target - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- Default
Policy string - [Default policies only] Specify the type of default policy to create.
- Description string
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- Exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- Execution
Role stringArn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- Extend
Deletion bool - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- Policy
Details LifecyclePolicy Policy Details The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- Policy
Id string - The identifier of the lifecycle policy.
- Retain
Interval int - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- State string
- The activation state of the lifecycle policy.
- Tag
- The tags to apply to the lifecycle policy during creation.
- arn string
- The Amazon Resource Name (ARN) of the lifecycle policy.
- bool
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- create_
interval number - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- cross_
region_ list(object)copy_ targets - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- default_
policy string - [Default policies only] Specify the type of default policy to create.
- description string
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- exclusions object
- [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- execution_
role_ stringarn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- extend_
deletion bool - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- policy_
details object The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- policy_
id string - The identifier of the lifecycle policy.
- retain_
interval number - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- state string
- The activation state of the lifecycle policy.
- list(object)
- The tags to apply to the lifecycle policy during creation.
- arn String
- The Amazon Resource Name (ARN) of the lifecycle policy.
- Boolean
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- create
Interval Integer - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- cross
Region List<LifecycleCopy Targets Policy Cross Region Copy Target> - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- default
Policy String - [Default policies only] Specify the type of default policy to create.
- description String
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- execution
Role StringArn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- extend
Deletion Boolean - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- policy
Details LifecyclePolicy Policy Details The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- policy
Id String - The identifier of the lifecycle policy.
- retain
Interval Integer - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- state String
- The activation state of the lifecycle policy.
- List<Tag>
- The tags to apply to the lifecycle policy during creation.
- arn string
- The Amazon Resource Name (ARN) of the lifecycle policy.
- boolean
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- create
Interval number - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- cross
Region LifecycleCopy Targets Policy Cross Region Copy Target[] - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- default
Policy string - [Default policies only] Specify the type of default policy to create.
- description string
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- execution
Role stringArn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- extend
Deletion boolean - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- policy
Details LifecyclePolicy Policy Details The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- policy
Id string - The identifier of the lifecycle policy.
- retain
Interval number - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- state string
- The activation state of the lifecycle policy.
- Tag[]
- The tags to apply to the lifecycle policy during creation.
- arn str
- The Amazon Resource Name (ARN) of the lifecycle policy.
- bool
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- create_
interval int - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- cross_
region_ Sequence[Lifecyclecopy_ targets Policy Cross Region Copy Target] - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- default_
policy str - [Default policies only] Specify the type of default policy to create.
- description str
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- execution_
role_ strarn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- extend_
deletion bool - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- policy_
details LifecyclePolicy Policy Details The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- policy_
id str - The identifier of the lifecycle policy.
- retain_
interval int - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- state str
- The activation state of the lifecycle policy.
- Sequence[root_Tag]
- The tags to apply to the lifecycle policy during creation.
- arn String
- The Amazon Resource Name (ARN) of the lifecycle policy.
- Boolean
- [Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is false.
- create
Interval Number - [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days.
- cross
Region List<Property Map>Copy Targets - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- default
Policy String - [Default policies only] Specify the type of default policy to create.
- description String
- A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.
- exclusions Property Map
- [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- execution
Role StringArn - The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
- extend
Deletion Boolean - [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
- policy
Details Property Map The configuration details of the lifecycle policy.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- policy
Id String - The identifier of the lifecycle policy.
- retain
Interval Number - [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time.
- state String
- The activation state of the lifecycle policy.
- List<Property Map>
- The tags to apply to the lifecycle policy during creation.
Supporting Types
LifecyclePolicyAction
- Cross
Region List<Pulumi.Copy Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Action> - The rule for copying shared snapshots across Regions.
- Name string
- A descriptive name for the action.
- Cross
Region []LifecycleCopy Policy Cross Region Copy Action - The rule for copying shared snapshots across Regions.
- Name string
- A descriptive name for the action.
- cross_
region_ list(object)copy - The rule for copying shared snapshots across Regions.
- name string
- A descriptive name for the action.
- cross
Region List<LifecycleCopy Policy Cross Region Copy Action> - The rule for copying shared snapshots across Regions.
- name String
- A descriptive name for the action.
- cross
Region LifecycleCopy Policy Cross Region Copy Action[] - The rule for copying shared snapshots across Regions.
- name string
- A descriptive name for the action.
- cross_
region_ Sequence[Lifecyclecopy Policy Cross Region Copy Action] - The rule for copying shared snapshots across Regions.
- name str
- A descriptive name for the action.
- cross
Region List<Property Map>Copy - The rule for copying shared snapshots across Regions.
- name String
- A descriptive name for the action.
LifecyclePolicyArchiveRetainRule
- Retention
Archive Pulumi.Tier Aws Native. Dlm. Inputs. Lifecycle Policy Retention Archive Tier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- Retention
Archive LifecycleTier Policy Retention Archive Tier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- retention_
archive_ objecttier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- retention
Archive LifecycleTier Policy Retention Archive Tier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- retention
Archive LifecycleTier Policy Retention Archive Tier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- retention_
archive_ Lifecycletier Policy Retention Archive Tier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
- retention
Archive Property MapTier - Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots .
LifecyclePolicyArchiveRule
- Retain
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Archive Retain Rule - Information about the retention period for the snapshot archiving rule.
- Retain
Rule LifecyclePolicy Archive Retain Rule - Information about the retention period for the snapshot archiving rule.
- retain_
rule object - Information about the retention period for the snapshot archiving rule.
- retain
Rule LifecyclePolicy Archive Retain Rule - Information about the retention period for the snapshot archiving rule.
- retain
Rule LifecyclePolicy Archive Retain Rule - Information about the retention period for the snapshot archiving rule.
- retain_
rule LifecyclePolicy Archive Retain Rule - Information about the retention period for the snapshot archiving rule.
- retain
Rule Property Map - Information about the retention period for the snapshot archiving rule.
LifecyclePolicyCreateRule
- Cron
Expression string - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- Interval int
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- Interval
Unit string - The interval unit.
- Location string
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- Scripts
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Script> - [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- Times List<string>
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.
- Cron
Expression string - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- Interval int
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- Interval
Unit string - The interval unit.
- Location string
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- Scripts
[]Lifecycle
Policy Script - [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- Times []string
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.
- cron_
expression string - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- interval number
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- interval_
unit string - The interval unit.
- location string
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- scripts list(object)
- [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- times list(string)
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.
- cron
Expression String - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- interval Integer
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- interval
Unit String - The interval unit.
- location String
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- scripts
List<Lifecycle
Policy Script> - [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- times List<String>
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.
- cron
Expression string - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- interval number
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- interval
Unit string - The interval unit.
- location string
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- scripts
Lifecycle
Policy Script[] - [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- times string[]
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.
- cron_
expression str - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- interval int
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- interval_
unit str - The interval unit.
- location str
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- scripts
Sequence[Lifecycle
Policy Script] - [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- times Sequence[str]
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.
- cron
Expression String - The schedule, as a Cron expression. The schedule interval must be between 1 hour and 1 year.
- interval Number
- The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.
- interval
Unit String - The interval unit.
- location String
[Custom snapshot policies only] Specifies the destination for snapshots created by the policy. The allowed destinations depend on the location of the targeted resources.
- If the policy targets resources in a Region, then you must create snapshots in the same Region as the source resource.
- If the policy targets resources in a Local Zone, you can create snapshots in the same Local Zone or in its parent Region.
- If the policy targets resources on an Outpost, then you can create snapshots on the same Outpost or in its parent Region.
Default:
CLOUD- scripts List<Property Map>
- [Custom snapshot policies that target instances only] Specifies pre and/or post scripts for a snapshot lifecycle policy that targets instances. This is useful for creating application-consistent snapshots, or for performing specific administrative tasks before or after Amazon Data Lifecycle Manager initiates snapshot creation.
- times List<String>
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.
LifecyclePolicyCrossRegionCopyAction
- Encryption
Configuration Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Encryption Configuration - The encryption settings for the copied snapshot.
- Target string
- The target Region.
- Retain
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Retain Rule - 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.
- Encryption
Configuration LifecyclePolicy Encryption Configuration - The encryption settings for the copied snapshot.
- Target string
- The target Region.
- Retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - 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.
- encryption_
configuration object - The encryption settings for the copied snapshot.
- target string
- The target Region.
- retain_
rule object - 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.
- encryption
Configuration LifecyclePolicy Encryption Configuration - The encryption settings for the copied snapshot.
- target String
- The target Region.
- retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - 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.
- encryption
Configuration LifecyclePolicy Encryption Configuration - The encryption settings for the copied snapshot.
- target string
- The target Region.
- retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - 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.
- encryption_
configuration LifecyclePolicy Encryption Configuration - The encryption settings for the copied snapshot.
- target str
- The target Region.
- retain_
rule LifecyclePolicy Cross Region Copy Retain Rule - 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.
- encryption
Configuration Property Map - The encryption settings for the copied snapshot.
- target String
- The target Region.
- retain
Rule Property Map - 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.
LifecyclePolicyCrossRegionCopyDeprecateRule
- Interval int
- 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.
- Interval
Unit string - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- Interval int
- 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.
- Interval
Unit string - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval number
- 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.
- interval_
unit string - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval Integer
- 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.
- interval
Unit String - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval number
- 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.
- interval
Unit string - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval int
- 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.
- interval_
unit str - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval Number
- 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.
- interval
Unit String - The unit of time in which to measure the Interval. For example, to deprecate a cross-Region AMI copy after 3 months, specify
Interval=3andIntervalUnit=MONTHS.
LifecyclePolicyCrossRegionCopyRetainRule
- Interval int
- 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.
- Interval
Unit string - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- Interval int
- 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.
- Interval
Unit string - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval number
- 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.
- interval_
unit string - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval Integer
- 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.
- interval
Unit String - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval number
- 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.
- interval
Unit string - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval int
- 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.
- interval_
unit str - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
- interval Number
- 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.
- interval
Unit String - The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify
Interval=3andIntervalUnit=MONTHS.
LifecyclePolicyCrossRegionCopyRule
- Encrypted bool
- 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
falseor if encryption by default is not enabled. - Cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- bool
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- Deprecate
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- Retain
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Retain Rule - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- Target string
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- Target
Region string - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- Encrypted bool
- 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
falseor if encryption by default is not enabled. - Cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- bool
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- Deprecate
Rule LifecyclePolicy Cross Region Copy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- Retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- Target string
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- Target
Region string - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- encrypted bool
- 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
falseor if encryption by default is not enabled. - cmk_
arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- bool
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- deprecate_
rule object - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- retain_
rule object - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- target string
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- target_
region string - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- encrypted Boolean
- 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
falseor if encryption by default is not enabled. - cmk
Arn String - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- Boolean
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- deprecate
Rule LifecyclePolicy Cross Region Copy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- target String
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- target
Region String - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- encrypted boolean
- 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
falseor if encryption by default is not enabled. - cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- boolean
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- deprecate
Rule LifecyclePolicy Cross Region Copy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- retain
Rule LifecyclePolicy Cross Region Copy Retain Rule - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- target string
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- target
Region string - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- encrypted bool
- 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
falseor if encryption by default is not enabled. - cmk_
arn str - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- bool
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- deprecate_
rule LifecyclePolicy Cross Region Copy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- retain_
rule LifecyclePolicy Cross Region Copy Retain Rule - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- target str
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- target_
region str - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
- encrypted Boolean
- 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
falseor if encryption by default is not enabled. - cmk
Arn String - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- Boolean
- Indicates whether to copy all user-defined tags from the source snapshot or AMI to the cross-Region copy.
- deprecate
Rule Property Map - [Custom AMI policies only] The AMI deprecation rule for cross-Region AMI copies created by the rule.
- retain
Rule Property Map - The retention rule that indicates how long the cross-Region snapshot or AMI copies are to be retained in the destination Region.
- target String
- [Custom snapshot policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the snapshot copies.
- target
Region String - [Custom AMI policies only] The target Region or the Amazon Resource Name (ARN) of the target Outpost for the AMI copies.
LifecyclePolicyCrossRegionCopyTarget
- Target
Region string - The target Region, for example
us-east-1.
- Target
Region string - The target Region, for example
us-east-1.
- target_
region string - The target Region, for example
us-east-1.
- target
Region String - The target Region, for example
us-east-1.
- target
Region string - The target Region, for example
us-east-1.
- target_
region str - The target Region, for example
us-east-1.
- target
Region String - The target Region, for example
us-east-1.
LifecyclePolicyDeprecateRule
- Count int
- 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.
- Interval int
- 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.
- Interval
Unit string - The unit of time in which to measure the Interval.
- Count int
- 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.
- Interval int
- 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.
- Interval
Unit string - The unit of time in which to measure the Interval.
- count number
- 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.
- interval number
- 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.
- interval_
unit string - The unit of time in which to measure the Interval.
- count Integer
- 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.
- interval Integer
- 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.
- interval
Unit String - The unit of time in which to measure the Interval.
- count number
- 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.
- interval number
- 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.
- interval
Unit string - The unit of time in which to measure the Interval.
- count int
- 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.
- interval int
- 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.
- interval_
unit str - The unit of time in which to measure the Interval.
- count Number
- 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.
- interval Number
- 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.
- interval
Unit String - The unit of time in which to measure the Interval.
LifecyclePolicyEncryptionConfiguration
- Encrypted bool
- 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
falseor when encryption by default is not enabled. - Cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- Encrypted bool
- 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
falseor when encryption by default is not enabled. - Cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- encrypted bool
- 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
falseor when encryption by default is not enabled. - cmk_
arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- encrypted Boolean
- 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
falseor when encryption by default is not enabled. - cmk
Arn String - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- encrypted boolean
- 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
falseor when encryption by default is not enabled. - cmk
Arn string - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- encrypted bool
- 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
falseor when encryption by default is not enabled. - cmk_
arn str - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
- encrypted Boolean
- 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
falseor when encryption by default is not enabled. - cmk
Arn String - The Amazon Resource Name (ARN) of the AWS KMS key to use for EBS encryption. If this parameter is not specified, the default KMS key for the account is used.
LifecyclePolicyEventParameters
- Event
Type string - The type of event. Currently, only snapshot sharing events are supported.
- Snapshot
Owner List<string> - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- Description
Regex string - 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.
- Event
Type string - The type of event. Currently, only snapshot sharing events are supported.
- Snapshot
Owner []string - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- Description
Regex string - 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.
- event_
type string - The type of event. Currently, only snapshot sharing events are supported.
- snapshot_
owner list(string) - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- description_
regex string - 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.
- event
Type String - The type of event. Currently, only snapshot sharing events are supported.
- snapshot
Owner List<String> - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- description
Regex String - 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.
- event
Type string - The type of event. Currently, only snapshot sharing events are supported.
- snapshot
Owner string[] - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- description
Regex string - 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.
- event_
type str - The type of event. Currently, only snapshot sharing events are supported.
- snapshot_
owner Sequence[str] - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- description_
regex str - 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.
- event
Type String - The type of event. Currently, only snapshot sharing events are supported.
- snapshot
Owner List<String> - The IDs of the AWS accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified AWS accounts shares a snapshot with your account.
- description
Regex String - 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.
LifecyclePolicyEventSource
- Type string
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- Parameters
Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Event Parameters - Information about the event.
- Type string
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- Parameters
Lifecycle
Policy Event Parameters - Information about the event.
- type string
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- parameters object
- Information about the event.
- type String
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- parameters
Lifecycle
Policy Event Parameters - Information about the event.
- type string
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- parameters
Lifecycle
Policy Event Parameters - Information about the event.
- type str
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- parameters
Lifecycle
Policy Event Parameters - Information about the event.
- type String
- The source of the event. Currently only managed Amazon EventBridge events are supported.
- parameters Property Map
- Information about the event.
LifecyclePolicyExclusions
- Exclude
Boot boolVolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. -
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Tag> - [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- Exclude
Volume List<string>Types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- Exclude
Boot boolVolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. -
[]Lifecycle
Policy Tag - [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- Exclude
Volume []stringTypes - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- exclude_
boot_ boolvolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. - list(object)
- [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- exclude_
volume_ list(string)types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- exclude
Boot BooleanVolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. -
List<Lifecycle
Policy Tag> - [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- exclude
Volume List<String>Types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- exclude
Boot booleanVolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. -
Lifecycle
Policy Tag[] - [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- exclude
Volume string[]Types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- exclude_
boot_ boolvolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. -
Sequence[Lifecycle
Policy Tag] - [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- exclude_
volume_ Sequence[str]types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
- exclude
Boot BooleanVolumes - [Default policies for EBS snapshots only] Indicates whether to exclude volumes that are attached to instances as the boot volume. If you exclude boot volumes, only volumes attached as data (non-boot) volumes will be backed up by the policy. To exclude boot volumes, specify
true. - List<Property Map>
- [Default policies for EBS-backed AMIs only] Specifies whether to exclude volumes that have specific tags.
- exclude
Volume List<String>Types - [Default policies for EBS snapshots only] Specifies the volume types to exclude. Volumes of the specified types will not be targeted by the policy.
LifecyclePolicyFastRestoreRule
- Availability
Zone List<string>Ids - The Availability Zone IDs in which to enable fast snapshot restore.
- Availability
Zones List<string> - The Availability Zones in which to enable fast snapshot restore.
- Count int
- The number of snapshots to be enabled with fast snapshot restore.
- Interval int
- 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.
- Interval
Unit string - The unit of time for enabling fast snapshot restore.
- Availability
Zone []stringIds - The Availability Zone IDs in which to enable fast snapshot restore.
- Availability
Zones []string - The Availability Zones in which to enable fast snapshot restore.
- Count int
- The number of snapshots to be enabled with fast snapshot restore.
- Interval int
- 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.
- Interval
Unit string - The unit of time for enabling fast snapshot restore.
- availability_
zone_ list(string)ids - The Availability Zone IDs in which to enable fast snapshot restore.
- availability_
zones list(string) - The Availability Zones in which to enable fast snapshot restore.
- count number
- The number of snapshots to be enabled with fast snapshot restore.
- interval number
- 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.
- interval_
unit string - The unit of time for enabling fast snapshot restore.
- availability
Zone List<String>Ids - The Availability Zone IDs in which to enable fast snapshot restore.
- availability
Zones List<String> - The Availability Zones in which to enable fast snapshot restore.
- count Integer
- The number of snapshots to be enabled with fast snapshot restore.
- interval Integer
- 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.
- interval
Unit String - The unit of time for enabling fast snapshot restore.
- availability
Zone string[]Ids - The Availability Zone IDs in which to enable fast snapshot restore.
- availability
Zones string[] - The Availability Zones in which to enable fast snapshot restore.
- count number
- The number of snapshots to be enabled with fast snapshot restore.
- interval number
- 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.
- interval
Unit string - The unit of time for enabling fast snapshot restore.
- availability_
zone_ Sequence[str]ids - The Availability Zone IDs in which to enable fast snapshot restore.
- availability_
zones Sequence[str] - The Availability Zones in which to enable fast snapshot restore.
- count int
- The number of snapshots to be enabled with fast snapshot restore.
- interval int
- 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.
- interval_
unit str - The unit of time for enabling fast snapshot restore.
- availability
Zone List<String>Ids - The Availability Zone IDs in which to enable fast snapshot restore.
- availability
Zones List<String> - The Availability Zones in which to enable fast snapshot restore.
- count Number
- The number of snapshots to be enabled with fast snapshot restore.
- interval Number
- 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.
- interval
Unit String - The unit of time for enabling fast snapshot restore.
LifecyclePolicyParameters
- Exclude
Boot boolVolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. -
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Tag> - [Custom 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.
- No
Reboot bool [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- Exclude
Boot boolVolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. -
[]Lifecycle
Policy Tag - [Custom 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.
- No
Reboot bool [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- exclude_
boot_ boolvolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. - list(object)
- [Custom 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.
- no_
reboot bool [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- exclude
Boot BooleanVolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. -
List<Lifecycle
Policy Tag> - [Custom 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.
- no
Reboot Boolean [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- exclude
Boot booleanVolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. -
Lifecycle
Policy Tag[] - [Custom 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.
- no
Reboot boolean [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- exclude_
boot_ boolvolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. -
Sequence[Lifecycle
Policy Tag] - [Custom 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.
- no_
reboot bool [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
- exclude
Boot BooleanVolume - [Custom snapshot policies that target instances only] Indicates whether to exclude the root volume from multi-volume snapshot sets. The default is
false. If you specifytrue, then the root volumes attached to targeted instances will be excluded from the multi-volume snapshot sets created by the policy. - List<Property Map>
- [Custom 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.
- no
Reboot Boolean [Custom AMI policies only] Indicates whether targeted instances are rebooted when the lifecycle policy runs.
trueindicates that targeted instances are not rebooted when the policy runs.falseindicates that target instances are rebooted when the policy runs.The default is
true(instances are not rebooted).
LifecyclePolicyPolicyDetails
- Actions
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Action> - [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- bool
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- Create
Interval int [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- Cross
Region List<Pulumi.Copy Targets Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Target> - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- Event
Source Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Event Source - [Event-based policies only] The event that activates the event-based policy.
- Exclusions
Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- Extend
Deletion bool [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- Parameters
Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Parameters [Custom 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.
- Policy
Language string - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- Policy
Type string The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- Resource
Locations List<string> - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - Resource
Type string - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- Resource
Types List<string> - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - Retain
Interval int [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- Schedules
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Schedule> - [Custom 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.
-
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Tag> - [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- Actions
[]Lifecycle
Policy Action - [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- bool
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- Create
Interval int [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- Cross
Region []LifecycleCopy Targets Policy Cross Region Copy Target - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- Event
Source LifecyclePolicy Event Source - [Event-based policies only] The event that activates the event-based policy.
- Exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- Extend
Deletion bool [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- Parameters
Lifecycle
Policy Parameters [Custom 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.
- Policy
Language string - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- Policy
Type string The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- Resource
Locations []string - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - Resource
Type string - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- Resource
Types []string - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - Retain
Interval int [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- Schedules
[]Lifecycle
Policy Schedule - [Custom 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.
-
[]Lifecycle
Policy Tag - [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- actions list(object)
- [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- bool
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- create_
interval number [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- cross_
region_ list(object)copy_ targets - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- event_
source object - [Event-based policies only] The event that activates the event-based policy.
- exclusions object
- [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- extend_
deletion bool [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- parameters object
[Custom 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.
- policy_
language string - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- policy_
type string The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- resource_
locations list(string) - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - resource_
type string - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- resource_
types list(string) - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - retain_
interval number [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- schedules list(object)
- [Custom 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.
- list(object)
- [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- actions
List<Lifecycle
Policy Action> - [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- Boolean
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- create
Interval Integer [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- cross
Region List<LifecycleCopy Targets Policy Cross Region Copy Target> - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- event
Source LifecyclePolicy Event Source - [Event-based policies only] The event that activates the event-based policy.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- extend
Deletion Boolean [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- parameters
Lifecycle
Policy Parameters [Custom 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.
- policy
Language String - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- policy
Type String The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- resource
Locations List<String> - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - resource
Type String - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- resource
Types List<String> - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - retain
Interval Integer [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- schedules
List<Lifecycle
Policy Schedule> - [Custom 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.
-
List<Lifecycle
Policy Tag> - [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- actions
Lifecycle
Policy Action[] - [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- boolean
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- create
Interval number [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- cross
Region LifecycleCopy Targets Policy Cross Region Copy Target[] - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- event
Source LifecyclePolicy Event Source - [Event-based policies only] The event that activates the event-based policy.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- extend
Deletion boolean [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- parameters
Lifecycle
Policy Parameters [Custom 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.
- policy
Language string - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- policy
Type string The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- resource
Locations string[] - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - resource
Type string - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- resource
Types string[] - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - retain
Interval number [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- schedules
Lifecycle
Policy Schedule[] - [Custom 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.
-
Lifecycle
Policy Tag[] - [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- actions
Sequence[Lifecycle
Policy Action] - [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- bool
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- create_
interval int [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- cross_
region_ Sequence[Lifecyclecopy_ targets Policy Cross Region Copy Target] - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- event_
source LifecyclePolicy Event Source - [Event-based policies only] The event that activates the event-based policy.
- exclusions
Lifecycle
Policy Exclusions - [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- extend_
deletion bool [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- parameters
Lifecycle
Policy Parameters [Custom 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.
- policy_
language str - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- policy_
type str The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- resource_
locations Sequence[str] - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - resource_
type str - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- resource_
types Sequence[str] - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - retain_
interval int [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- schedules
Sequence[Lifecycle
Policy Schedule] - [Custom 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.
-
Sequence[Lifecycle
Policy Tag] - [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
- actions List<Property Map>
- [Event-based policies only] The actions to be performed when the event-based policy is activated. You can specify only one action per policy.
- Boolean
[Default policies only] Indicates whether the policy should copy tags from the source resource to the snapshot or AMI. If you do not specify a value, the default is
false.Default:
false- create
Interval Number [Default policies only] Specifies how often the policy should run and create snapshots or AMIs. The creation frequency can range from 1 to 7 days. If you do not specify a value, the default is 1.
Default: 1
- cross
Region List<Property Map>Copy Targets - [Default policies only] Specifies destination Regions for snapshot or AMI copies. You can specify up to 3 destination Regions. If you do not want to create cross-Region copies, omit this parameter.
- event
Source Property Map - [Event-based policies only] The event that activates the event-based policy.
- exclusions Property Map
- [Default policies only] Specifies exclusion parameters for volumes or instances for which you do not want to create snapshots or AMIs. The policy will not create snapshots or AMIs for target resources that match any of the specified exclusion parameters.
- extend
Deletion Boolean [Default policies only] Defines the snapshot or AMI retention behavior for the policy if the source volume or instance is deleted, or if the policy enters the error, disabled, or deleted state.
Default:
false- parameters Property Map
[Custom 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.
- policy
Language String - The type of policy to create. Specify one of the following:
SIMPLIFIED-- To create a default policy.STANDARD-- To create a custom policy.
- policy
Type String The type of policy. Specify
EBS_SNAPSHOT_MANAGEMENTto create a lifecycle policy that manages the lifecycle of Amazon EBS snapshots. SpecifyIMAGE_MANAGEMENTto create a lifecycle policy that manages the lifecycle of EBS-backed AMIs. SpecifyEVENT_BASED_POLICYto create an event-based policy that performs specific actions when a defined event occurs in your AWS account.The default is
EBS_SNAPSHOT_MANAGEMENT.- resource
Locations List<String> - [Custom snapshot and AMI policies only] The location of the resources to backup. If the source resources are located in a Region, specify
CLOUD. - resource
Type String - [Default policies only] Specify the type of default policy to create.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
VOLUME. - To create a default policy for EBS-backed AMIs, that creates EBS-backed AMIs from all instances in the Region that do not have recent backups, specify
INSTANCE.
- To create a default policy for EBS snapshots, that creates snapshots of all volumes in the Region that do not have recent backups, specify
- resource
Types List<String> - [Custom snapshot policies only] The target resource type for snapshot and AMI lifecycle policies. Use
VOLUMEto create snapshots of individual volumes or useINSTANCEto create multi-volume snapshots from the volumes for an instance. - retain
Interval Number [Default policies only] Specifies how long the policy should retain snapshots or AMIs before deleting them. The retention period can range from 2 to 14 days, but it must be greater than the creation frequency to ensure that the policy retains at least 1 snapshot or AMI at any given time. If you do not specify a value, the default is 7.
Default: 7
- schedules List<Property Map>
- [Custom 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.
- List<Property Map>
- [Custom snapshot and AMI policies only] The single tag that identifies targeted resources for this policy.
LifecyclePolicyRetainRule
- Count int
- 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 anArchiveRule. - Interval int
- 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 string - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- Count int
- 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 anArchiveRule. - Interval int
- 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 string - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- count number
- 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 anArchiveRule. - interval number
- 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 string - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- count Integer
- 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 anArchiveRule. - interval Integer
- 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 String - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- count number
- 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 anArchiveRule. - interval number
- 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 string - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- count int
- 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 anArchiveRule. - interval int
- 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 str - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
- count Number
- 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 anArchiveRule. - interval Number
- 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 String - The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
Interval=3andIntervalUnit=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 anArchiveRule.
LifecyclePolicyRetentionArchiveTier
- Count int
- 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.
- Interval int
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- Interval
Unit string - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- Count int
- 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.
- Interval int
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- Interval
Unit string - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- count number
- 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.
- interval number
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- interval_
unit string - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- count Integer
- 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.
- interval Integer
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- interval
Unit String - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- count number
- 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.
- interval number
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- interval
Unit string - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- count int
- 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.
- interval int
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- interval_
unit str - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
- count Number
- 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.
- interval Number
- Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.
- interval
Unit String - The unit of time in which to measure the Interval. For example, to retain snapshots in the archive tier for 6 months, specify
Interval=6andIntervalUnit=MONTHS.
LifecyclePolicySchedule
- Archive
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Archive Rule [Custom 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 .
- bool
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- Create
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Create Rule - The creation rule.
- Cross
Region List<Pulumi.Copy Rules Aws Native. Dlm. Inputs. Lifecycle Policy Cross Region Copy Rule> - Specifies a rule for copying snapshots or AMIs across Regions.
- Deprecate
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- Fast
Restore Pulumi.Rule Aws Native. Dlm. Inputs. Lifecycle Policy Fast Restore Rule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- Name string
- The name of the schedule.
- Retain
Rule Pulumi.Aws Native. Dlm. Inputs. Lifecycle Policy Retain Rule - The retention rule for snapshots or AMIs created by the policy.
-
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Share Rule> - [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
-
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Tag> - The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
-
List<Pulumi.
Aws Native. Dlm. Inputs. Lifecycle Policy Tag> - [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.
- Archive
Rule LifecyclePolicy Archive Rule [Custom 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 .
- bool
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- Create
Rule LifecyclePolicy Create Rule - The creation rule.
- Cross
Region []LifecycleCopy Rules Policy Cross Region Copy Rule - Specifies a rule for copying snapshots or AMIs across Regions.
- Deprecate
Rule LifecyclePolicy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- Fast
Restore LifecycleRule Policy Fast Restore Rule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- Name string
- The name of the schedule.
- Retain
Rule LifecyclePolicy Retain Rule - The retention rule for snapshots or AMIs created by the policy.
-
[]Lifecycle
Policy Share Rule - [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
-
[]Lifecycle
Policy Tag - The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
-
[]Lifecycle
Policy Tag - [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.
- archive_
rule object [Custom 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 .
- bool
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- create_
rule object - The creation rule.
- cross_
region_ list(object)copy_ rules - Specifies a rule for copying snapshots or AMIs across Regions.
- deprecate_
rule object - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- fast_
restore_ objectrule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- name string
- The name of the schedule.
- retain_
rule object - The retention rule for snapshots or AMIs created by the policy.
- list(object)
- [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
- list(object)
- The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
- list(object)
- [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.
- archive
Rule LifecyclePolicy Archive Rule [Custom 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 .
- Boolean
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- create
Rule LifecyclePolicy Create Rule - The creation rule.
- cross
Region List<LifecycleCopy Rules Policy Cross Region Copy Rule> - Specifies a rule for copying snapshots or AMIs across Regions.
- deprecate
Rule LifecyclePolicy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- fast
Restore LifecycleRule Policy Fast Restore Rule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- name String
- The name of the schedule.
- retain
Rule LifecyclePolicy Retain Rule - The retention rule for snapshots or AMIs created by the policy.
-
List<Lifecycle
Policy Share Rule> - [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
-
List<Lifecycle
Policy Tag> - The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
-
List<Lifecycle
Policy Tag> - [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.
- archive
Rule LifecyclePolicy Archive Rule [Custom 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 .
- boolean
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- create
Rule LifecyclePolicy Create Rule - The creation rule.
- cross
Region LifecycleCopy Rules Policy Cross Region Copy Rule[] - Specifies a rule for copying snapshots or AMIs across Regions.
- deprecate
Rule LifecyclePolicy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- fast
Restore LifecycleRule Policy Fast Restore Rule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- name string
- The name of the schedule.
- retain
Rule LifecyclePolicy Retain Rule - The retention rule for snapshots or AMIs created by the policy.
-
Lifecycle
Policy Share Rule[] - [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
-
Lifecycle
Policy Tag[] - The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
-
Lifecycle
Policy Tag[] - [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.
- archive_
rule LifecyclePolicy Archive Rule [Custom 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 .
- bool
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- create_
rule LifecyclePolicy Create Rule - The creation rule.
- cross_
region_ Sequence[Lifecyclecopy_ rules Policy Cross Region Copy Rule] - Specifies a rule for copying snapshots or AMIs across Regions.
- deprecate_
rule LifecyclePolicy Deprecate Rule - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- fast_
restore_ Lifecyclerule Policy Fast Restore Rule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- name str
- The name of the schedule.
- retain_
rule LifecyclePolicy Retain Rule - The retention rule for snapshots or AMIs created by the policy.
-
Sequence[Lifecycle
Policy Share Rule] - [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
-
Sequence[Lifecycle
Policy Tag] - The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
-
Sequence[Lifecycle
Policy Tag] - [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.
- archive
Rule Property Map [Custom 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 .
- Boolean
- Copy all user-defined tags on a source volume to snapshots of the volume created by this policy.
- create
Rule Property Map - The creation rule.
- cross
Region List<Property Map>Copy Rules - Specifies a rule for copying snapshots or AMIs across Regions.
- deprecate
Rule Property Map - [Custom AMI policies only] The AMI deprecation rule for the schedule.
- fast
Restore Property MapRule - [Custom snapshot policies only] The rule for enabling fast snapshot restore.
- name String
- The name of the schedule.
- retain
Rule Property Map - The retention rule for snapshots or AMIs created by the policy.
- List<Property Map>
- [Custom snapshot policies only] The rule for sharing snapshots with other AWS accounts.
- List<Property Map>
- The tags to apply to policy-created resources. These user-defined tags are in addition to the AWS-added lifecycle tags.
- List<Property Map>
- [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.
LifecyclePolicyScript
- Execute
Operation boolOn Script Failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- Execution
Handler string The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- Execution
Handler stringService Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- Execution
Timeout int Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- Maximum
Retry intCount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- Stages List<string>
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- Execute
Operation boolOn Script Failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- Execution
Handler string The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- Execution
Handler stringService Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- Execution
Timeout int Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- Maximum
Retry intCount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- Stages []string
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- execute_
operation_ boolon_ script_ failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- execution_
handler string The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- execution_
handler_ stringservice Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- execution_
timeout number Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- maximum_
retry_ numbercount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- stages list(string)
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- execute
Operation BooleanOn Script Failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- execution
Handler String The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- execution
Handler StringService Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- execution
Timeout Integer Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- maximum
Retry IntegerCount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- stages List<String>
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- execute
Operation booleanOn Script Failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- execution
Handler string The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- execution
Handler stringService Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- execution
Timeout number Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- maximum
Retry numberCount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- stages string[]
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- execute_
operation_ boolon_ script_ failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- execution_
handler str The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- execution_
handler_ strservice Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- execution_
timeout int Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- maximum_
retry_ intcount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- stages Sequence[str]
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
- execute
Operation BooleanOn Script Failure Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.
- To default to crash consistent snapshot if the pre script fails, specify
true. - To skip the instance for snapshot creation if the pre script fails, specify
false.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default:
true- To default to crash consistent snapshot if the pre script fails, specify
- execution
Handler String The SSM document that includes the pre and/or post scripts to run.
If you are automating VSS backups, specify
AWS_VSS_BACKUP. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshotSSM document.If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- execution
Handler StringService Indicates the service used to execute the pre and/or post scripts.
Default:
AWS_SYSTEMS_MANAGER- execution
Timeout Number Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.
Default: 10
- maximum
Retry NumberCount Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.
If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0.Default: 0
- stages List<String>
Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.
- To run a pre script only, specify
PRE. - To run a post script only, specify
POST. - To run both pre and post scripts, specify both
PREandPOST.
Default: PRE and POST
- To run a pre script only, specify
LifecyclePolicyShareRule
- Target
Accounts List<string> - The IDs of the AWS accounts with which to share the snapshots.
- int
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- string
- The unit of time for the automatic unsharing interval.
- Target
Accounts []string - The IDs of the AWS accounts with which to share the snapshots.
- int
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- string
- The unit of time for the automatic unsharing interval.
- target_
accounts list(string) - The IDs of the AWS accounts with which to share the snapshots.
- number
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- string
- The unit of time for the automatic unsharing interval.
- target
Accounts List<String> - The IDs of the AWS accounts with which to share the snapshots.
- Integer
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- String
- The unit of time for the automatic unsharing interval.
- target
Accounts string[] - The IDs of the AWS accounts with which to share the snapshots.
- number
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- string
- The unit of time for the automatic unsharing interval.
- target_
accounts Sequence[str] - The IDs of the AWS accounts with which to share the snapshots.
- int
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- str
- The unit of time for the automatic unsharing interval.
- target
Accounts List<String> - The IDs of the AWS accounts with which to share the snapshots.
- Number
- The period after which snapshots that are shared with other AWS accounts are automatically unshared.
- String
- The unit of time for the automatic unsharing interval.
LifecyclePolicyTag
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi