Package software.amazon.awscdk.services.dlm

Class CfnLifecyclePolicy

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.dlm.CfnLifecyclePolicy

All Implemented Interfaces:

IInspectable, ITaggable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.89.0 (build 2f74b3e)",
           date="2023-10-26T00:56:06.367Z")
@Stability(Stable)
public class CfnLifecyclePolicy
extends CfnResource
implements IInspectable, ITaggable

Specifies a lifecycle policy, which is used to automate operations on Amazon EBS resources.

The properties are required when you add a lifecycle policy and optional when you update a lifecycle policy.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.dlm.*;
 CfnLifecyclePolicy cfnLifecyclePolicy = CfnLifecyclePolicy.Builder.create(this, "MyCfnLifecyclePolicy")
         .description("description")
         .executionRoleArn("executionRoleArn")
         .policyDetails(PolicyDetailsProperty.builder()
                 .actions(List.of(ActionProperty.builder()
                         .crossRegionCopy(List.of(CrossRegionCopyActionProperty.builder()
                                 .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                                         .encrypted(false)
                                         // the properties below are optional
                                         .cmkArn("cmkArn")
                                         .build())
                                 .target("target")
                                 // the properties below are optional
                                 .retainRule(CrossRegionCopyRetainRuleProperty.builder()
                                         .interval(123)
                                         .intervalUnit("intervalUnit")
                                         .build())
                                 .build()))
                         .name("name")
                         .build()))
                 .eventSource(EventSourceProperty.builder()
                         .type("type")
                         // the properties below are optional
                         .parameters(EventParametersProperty.builder()
                                 .eventType("eventType")
                                 .snapshotOwner(List.of("snapshotOwner"))
                                 // the properties below are optional
                                 .descriptionRegex("descriptionRegex")
                                 .build())
                         .build())
                 .parameters(ParametersProperty.builder()
                         .excludeBootVolume(false)
                         .excludeDataVolumeTags(List.of(CfnTag.builder()
                                 .key("key")
                                 .value("value")
                                 .build()))
                         .noReboot(false)
                         .build())
                 .policyType("policyType")
                 .resourceLocations(List.of("resourceLocations"))
                 .resourceTypes(List.of("resourceTypes"))
                 .schedules(List.of(ScheduleProperty.builder()
                         .archiveRule(ArchiveRuleProperty.builder()
                                 .retainRule(ArchiveRetainRuleProperty.builder()
                                         .retentionArchiveTier(RetentionArchiveTierProperty.builder()
                                                 .count(123)
                                                 .interval(123)
                                                 .intervalUnit("intervalUnit")
                                                 .build())
                                         .build())
                                 .build())
                         .copyTags(false)
                         .createRule(CreateRuleProperty.builder()
                                 .cronExpression("cronExpression")
                                 .interval(123)
                                 .intervalUnit("intervalUnit")
                                 .location("location")
                                 .times(List.of("times"))
                                 .build())
                         .crossRegionCopyRules(List.of(CrossRegionCopyRuleProperty.builder()
                                 .encrypted(false)
                                 // the properties below are optional
                                 .cmkArn("cmkArn")
                                 .copyTags(false)
                                 .deprecateRule(CrossRegionCopyDeprecateRuleProperty.builder()
                                         .interval(123)
                                         .intervalUnit("intervalUnit")
                                         .build())
                                 .retainRule(CrossRegionCopyRetainRuleProperty.builder()
                                         .interval(123)
                                         .intervalUnit("intervalUnit")
                                         .build())
                                 .target("target")
                                 .targetRegion("targetRegion")
                                 .build()))
                         .deprecateRule(DeprecateRuleProperty.builder()
                                 .count(123)
                                 .interval(123)
                                 .intervalUnit("intervalUnit")
                                 .build())
                         .fastRestoreRule(FastRestoreRuleProperty.builder()
                                 .availabilityZones(List.of("availabilityZones"))
                                 .count(123)
                                 .interval(123)
                                 .intervalUnit("intervalUnit")
                                 .build())
                         .name("name")
                         .retainRule(RetainRuleProperty.builder()
                                 .count(123)
                                 .interval(123)
                                 .intervalUnit("intervalUnit")
                                 .build())
                         .shareRules(List.of(ShareRuleProperty.builder()
                                 .targetAccounts(List.of("targetAccounts"))
                                 .unshareInterval(123)
                                 .unshareIntervalUnit("unshareIntervalUnit")
                                 .build()))
                         .tagsToAdd(List.of(CfnTag.builder()
                                 .key("key")
                                 .value("value")
                                 .build()))
                         .variableTags(List.of(CfnTag.builder()
                                 .key("key")
                                 .value("value")
                                 .build()))
                         .build()))
                 .targetTags(List.of(CfnTag.builder()
                         .key("key")
                         .value("value")
                         .build()))
                 .build())
         .state("state")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnLifecyclePolicy.ActionProperty	[Event-based policies only] Specifies an action for an event-based policy.
static interface	CfnLifecyclePolicy.ArchiveRetainRuleProperty	[Snapshot policies only] Specifies information about the archive storage tier retention period.
static interface	CfnLifecyclePolicy.ArchiveRuleProperty	[Snapshot policies only] Specifies a snapshot archiving rule for a schedule.
static final class	CfnLifecyclePolicy.Builder	A fluent builder for CfnLifecyclePolicy.
static interface	CfnLifecyclePolicy.CreateRuleProperty	[Snapshot and AMI policies only] Specifies when the policy should create snapshots or AMIs.
static interface	CfnLifecyclePolicy.CrossRegionCopyActionProperty	[Event-based policies only] Specifies a cross-Region copy action for event-based policies.
static interface	CfnLifecyclePolicy.CrossRegionCopyDeprecateRuleProperty	[AMI policies only] Specifies an AMI deprecation rule for cross-Region AMI copies created by an AMI policy.
static interface	CfnLifecyclePolicy.CrossRegionCopyRetainRuleProperty	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.
static interface	CfnLifecyclePolicy.CrossRegionCopyRuleProperty	[Snapshot and AMI policies only] Specifies a cross-Region copy rule for a snapshot and AMI policies.
static interface	CfnLifecyclePolicy.DeprecateRuleProperty	[AMI policies only] Specifies an AMI deprecation rule for AMIs created by an AMI lifecycle policy.
static interface	CfnLifecyclePolicy.EncryptionConfigurationProperty	[Event-based policies only] Specifies the encryption settings for cross-Region snapshot copies created by event-based policies.
static interface	CfnLifecyclePolicy.EventParametersProperty	[Event-based policies only] Specifies an event that activates an event-based policy.
static interface	CfnLifecyclePolicy.EventSourceProperty	[Event-based policies only] Specifies an event that activates an event-based policy.
static interface	CfnLifecyclePolicy.FastRestoreRuleProperty	[Snapshot policies only] Specifies a rule for enabling fast snapshot restore for snapshots created by snapshot policies.
static interface	CfnLifecyclePolicy.ParametersProperty	[Snapshot and AMI policies only] Specifies optional parameters for snapshot and AMI policies.
static interface	CfnLifecyclePolicy.PolicyDetailsProperty	[All policy types] Specifies the configuration of a lifecycle policy.
static interface	CfnLifecyclePolicy.RetainRuleProperty	[Snapshot and AMI policies only] Specifies a retention rule for snapshots created by snapshot policies, or for AMIs created by AMI policies.
static interface	CfnLifecyclePolicy.RetentionArchiveTierProperty	[Snapshot policies only] Describes the retention rule for archived snapshots.
static interface	CfnLifecyclePolicy.ScheduleProperty	[Snapshot and AMI policies only] Specifies a schedule for a snapshot or AMI lifecycle policy.
static interface	CfnLifecyclePolicy.ShareRuleProperty	[Snapshot policies only] Specifies a rule for sharing snapshots across AWS accounts .

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable

ITaggable.Jsii$Default, ITaggable.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CFN_RESOURCE_TYPE_NAME	The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CfnLifecyclePolicy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnLifecyclePolicy(software.amazon.jsii.JsiiObjectRef objRef)
	CfnLifecyclePolicy(software.constructs.Construct scope, String id)
	CfnLifecyclePolicy(software.constructs.Construct scope, String id, CfnLifecyclePolicyProps props)

Method Summary

Modifier and Type	Method	Description
String	getAttrArn()	The Amazon Resource Name (ARN) of the lifecycle policy.
String	getAttrId()
protected Map<String,Object>	getCfnProperties()
String	getDescription()	A description of the lifecycle policy.
String	getExecutionRoleArn()	The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
Object	getPolicyDetails()	The configuration details of the lifecycle policy.
String	getState()	The activation state of the lifecycle policy.
TagManager	getTags()	Tag Manager which manages the tags for this resource.
List<CfnTag>	getTagsRaw()	The tags to apply to the lifecycle policy during creation.
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setDescription(String value)	A description of the lifecycle policy.
void	setExecutionRoleArn(String value)	The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.
void	setPolicyDetails(IResolvable value)	The configuration details of the lifecycle policy.
void	setPolicyDetails(CfnLifecyclePolicy.PolicyDetailsProperty value)	The configuration details of the lifecycle policy.
void	setState(String value)	The activation state of the lifecycle policy.
void	setTagsRaw(List<CfnTag> value)	The tags to apply to the lifecycle policy during creation.

Methods inherited from class software.amazon.awscdk.CfnResource

addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_RESOURCE_TYPE_NAME

@Stability(Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Details

CfnLifecyclePolicy

protected CfnLifecyclePolicy(software.amazon.jsii.JsiiObjectRef objRef)

CfnLifecyclePolicy

protected CfnLifecyclePolicy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnLifecyclePolicy

@Stability(Stable)
public CfnLifecyclePolicy(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 CfnLifecyclePolicyProps props)

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

props - Resource properties.

CfnLifecyclePolicy

@Stability(Stable)
public CfnLifecyclePolicy(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

Method Details

inspect

@Stability(Stable)
public void inspect(@NotNull
 TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - tree inspector to collect and process attributes. This parameter is required.

renderProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> renderProperties(@NotNull
 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrArn

@Stability(Stable)
@NotNull
public String getAttrArn()

The Amazon Resource Name (ARN) of the lifecycle policy.

getAttrId

@Stability(Stable)
@NotNull
public String getAttrId()

getCfnProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getTags

@Stability(Stable)
@NotNull
public TagManager getTags()

Tag Manager which manages the tags for this resource.

Specified by:

getTags in interface ITaggable

getDescription

@Stability(Stable)
@Nullable
public String getDescription()

A description of the lifecycle policy.

setDescription

@Stability(Stable)
public void setDescription(@Nullable
 String value)

A description of the lifecycle policy.

getExecutionRoleArn

@Stability(Stable)
@Nullable
public String getExecutionRoleArn()

The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.

setExecutionRoleArn

@Stability(Stable)
public void setExecutionRoleArn(@Nullable
 String value)

The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.

getPolicyDetails

@Stability(Stable)
@Nullable
public Object getPolicyDetails()

The configuration details of the lifecycle policy.

setPolicyDetails

@Stability(Stable)
public void setPolicyDetails(@Nullable
 IResolvable value)

The configuration details of the lifecycle policy.

setPolicyDetails

@Stability(Stable)
public void setPolicyDetails(@Nullable
 CfnLifecyclePolicy.PolicyDetailsProperty value)

The configuration details of the lifecycle policy.

getState

@Stability(Stable)
@Nullable
public String getState()

The activation state of the lifecycle policy.

setState

@Stability(Stable)
public void setState(@Nullable
 String value)

The activation state of the lifecycle policy.

getTagsRaw

@Stability(Stable)
@Nullable
public List<CfnTag> getTagsRaw()

The tags to apply to the lifecycle policy during creation.

setTagsRaw

@Stability(Stable)
public void setTagsRaw(@Nullable
 List<CfnTag> value)

The tags to apply to the lifecycle policy during creation.