@aws-sdk/client-dlm 3.181.0 → 3.182.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.182.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.181.0...v3.182.0) (2022-09-30)
+
+
+### Features
+
+* **client-dlm:** This release adds support for archival of single-volume snapshots created by Amazon Data Lifecycle Manager policies ([a88a887](https://github.com/aws/aws-sdk-js-v3/commit/a88a88710933a67d956f02e85d6cf11296143410))
+
+
+
+
+
 # [3.181.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.180.0...v3.181.0) (2022-09-29)
 
 

package/README.md

@@ -14,9 +14,9 @@ AWS SDK for JavaScript DLM Client for Node.js, Browser and React Native.
 <p>With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create
 lifecycle policies, which are used to automate operations on the specified
 resources.</p>
-<p>Amazon DLM supports Amazon EBS volumes and snapshots. For information about using Amazon DLM
-with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">Automating the Amazon EBS
-Snapshot Lifecycle</a> in the <i>Amazon EC2 User Guide</i>.</p>
+<p>Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager
+with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">
+Amazon Data Lifecycle Manager</a> in the <i>Amazon EC2 User Guide</i>.</p>
 
 ## Installing
 

package/dist-cjs/models/models_0.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateLifecyclePolicyResponseFilterSensitiveLog = exports.UpdateLifecyclePolicyRequestFilterSensitiveLog = exports.UntagResourceResponseFilterSensitiveLog = exports.UntagResourceRequestFilterSensitiveLog = exports.TagResourceResponseFilterSensitiveLog = exports.TagResourceRequestFilterSensitiveLog = exports.ListTagsForResourceResponseFilterSensitiveLog = exports.ListTagsForResourceRequestFilterSensitiveLog = exports.GetLifecyclePolicyResponseFilterSensitiveLog = exports.LifecyclePolicyFilterSensitiveLog = exports.GetLifecyclePolicyRequestFilterSensitiveLog = exports.GetLifecyclePoliciesResponseFilterSensitiveLog = exports.LifecyclePolicySummaryFilterSensitiveLog = exports.GetLifecyclePoliciesRequestFilterSensitiveLog = exports.DeleteLifecyclePolicyResponseFilterSensitiveLog = exports.DeleteLifecyclePolicyRequestFilterSensitiveLog = exports.CreateLifecyclePolicyResponseFilterSensitiveLog = exports.CreateLifecyclePolicyRequestFilterSensitiveLog = exports.PolicyDetailsFilterSensitiveLog = exports.ScheduleFilterSensitiveLog = exports.ShareRuleFilterSensitiveLog = exports.RetainRuleFilterSensitiveLog = exports.FastRestoreRuleFilterSensitiveLog = exports.DeprecateRuleFilterSensitiveLog = exports.CrossRegionCopyRuleFilterSensitiveLog = exports.CrossRegionCopyDeprecateRuleFilterSensitiveLog = exports.CreateRuleFilterSensitiveLog = exports._ParametersFilterSensitiveLog = exports.TagFilterSensitiveLog = exports.EventSourceFilterSensitiveLog = exports.EventParametersFilterSensitiveLog = exports.ActionFilterSensitiveLog = exports.CrossRegionCopyActionFilterSensitiveLog = exports.CrossRegionCopyRetainRuleFilterSensitiveLog = exports.EncryptionConfigurationFilterSensitiveLog = exports.GettablePolicyStateValues = exports.ResourceNotFoundException = exports.LimitExceededException = exports.InvalidRequestException = exports.InternalServerException = exports.SettablePolicyStateValues = exports.LocationValues = exports.IntervalUnitValues = exports.ResourceTypeValues = exports.ResourceLocationValues = exports.PolicyTypeValues = exports.EventSourceValues = exports.EventTypeValues = exports.RetentionIntervalUnitValues = void 0;
+exports.UntagResourceResponseFilterSensitiveLog = exports.UntagResourceRequestFilterSensitiveLog = exports.TagResourceResponseFilterSensitiveLog = exports.TagResourceRequestFilterSensitiveLog = exports.ListTagsForResourceResponseFilterSensitiveLog = exports.ListTagsForResourceRequestFilterSensitiveLog = exports.GetLifecyclePolicyResponseFilterSensitiveLog = exports.LifecyclePolicyFilterSensitiveLog = exports.GetLifecyclePolicyRequestFilterSensitiveLog = exports.GetLifecyclePoliciesResponseFilterSensitiveLog = exports.LifecyclePolicySummaryFilterSensitiveLog = exports.GetLifecyclePoliciesRequestFilterSensitiveLog = exports.DeleteLifecyclePolicyResponseFilterSensitiveLog = exports.DeleteLifecyclePolicyRequestFilterSensitiveLog = exports.CreateLifecyclePolicyResponseFilterSensitiveLog = exports.CreateLifecyclePolicyRequestFilterSensitiveLog = exports.PolicyDetailsFilterSensitiveLog = exports.ScheduleFilterSensitiveLog = exports.ShareRuleFilterSensitiveLog = exports.RetainRuleFilterSensitiveLog = exports.FastRestoreRuleFilterSensitiveLog = exports.DeprecateRuleFilterSensitiveLog = exports.CrossRegionCopyRuleFilterSensitiveLog = exports.CrossRegionCopyDeprecateRuleFilterSensitiveLog = exports.CreateRuleFilterSensitiveLog = exports._ParametersFilterSensitiveLog = exports.TagFilterSensitiveLog = exports.EventSourceFilterSensitiveLog = exports.EventParametersFilterSensitiveLog = exports.ArchiveRuleFilterSensitiveLog = exports.ArchiveRetainRuleFilterSensitiveLog = exports.RetentionArchiveTierFilterSensitiveLog = exports.ActionFilterSensitiveLog = exports.CrossRegionCopyActionFilterSensitiveLog = exports.CrossRegionCopyRetainRuleFilterSensitiveLog = exports.EncryptionConfigurationFilterSensitiveLog = exports.GettablePolicyStateValues = exports.ResourceNotFoundException = exports.LimitExceededException = exports.InvalidRequestException = exports.InternalServerException = exports.SettablePolicyStateValues = exports.LocationValues = exports.IntervalUnitValues = exports.ResourceTypeValues = exports.ResourceLocationValues = exports.PolicyTypeValues = exports.EventSourceValues = exports.EventTypeValues = exports.RetentionIntervalUnitValues = void 0;
+exports.UpdateLifecyclePolicyResponseFilterSensitiveLog = exports.UpdateLifecyclePolicyRequestFilterSensitiveLog = void 0;
 const DLMServiceException_1 = require("./DLMServiceException");
 var RetentionIntervalUnitValues;
 (function (RetentionIntervalUnitValues) {
@@ -134,6 +135,18 @@ const ActionFilterSensitiveLog = (obj) => ({
     ...obj,
 });
 exports.ActionFilterSensitiveLog = ActionFilterSensitiveLog;
+const RetentionArchiveTierFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
+exports.RetentionArchiveTierFilterSensitiveLog = RetentionArchiveTierFilterSensitiveLog;
+const ArchiveRetainRuleFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
+exports.ArchiveRetainRuleFilterSensitiveLog = ArchiveRetainRuleFilterSensitiveLog;
+const ArchiveRuleFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
+exports.ArchiveRuleFilterSensitiveLog = ArchiveRuleFilterSensitiveLog;
 const EventParametersFilterSensitiveLog = (obj) => ({
     ...obj,
 });

package/dist-cjs/protocols/Aws_restJson1.js

@@ -585,6 +585,18 @@ const serializeAws_restJson1ActionList = (input, context) => {
         return serializeAws_restJson1Action(entry, context);
     });
 };
+const serializeAws_restJson1ArchiveRetainRule = (input, context) => {
+    return {
+        ...(input.RetentionArchiveTier != null && {
+            RetentionArchiveTier: serializeAws_restJson1RetentionArchiveTier(input.RetentionArchiveTier, context),
+        }),
+    };
+};
+const serializeAws_restJson1ArchiveRule = (input, context) => {
+    return {
+        ...(input.RetainRule != null && { RetainRule: serializeAws_restJson1ArchiveRetainRule(input.RetainRule, context) }),
+    };
+};
 const serializeAws_restJson1AvailabilityZoneList = (input, context) => {
     return input
         .filter((e) => e != null)
@@ -744,8 +756,16 @@ const serializeAws_restJson1RetainRule = (input, context) => {
         ...(input.IntervalUnit != null && { IntervalUnit: input.IntervalUnit }),
     };
 };
+const serializeAws_restJson1RetentionArchiveTier = (input, context) => {
+    return {
+        ...(input.Count != null && { Count: input.Count }),
+        ...(input.Interval != null && { Interval: input.Interval }),
+        ...(input.IntervalUnit != null && { IntervalUnit: input.IntervalUnit }),
+    };
+};
 const serializeAws_restJson1Schedule = (input, context) => {
     return {
+        ...(input.ArchiveRule != null && { ArchiveRule: serializeAws_restJson1ArchiveRule(input.ArchiveRule, context) }),
         ...(input.CopyTags != null && { CopyTags: input.CopyTags }),
         ...(input.CreateRule != null && { CreateRule: serializeAws_restJson1CreateRule(input.CreateRule, context) }),
         ...(input.CrossRegionCopyRules != null && {
@@ -867,6 +887,18 @@ const deserializeAws_restJson1ActionList = (output, context) => {
     });
     return retVal;
 };
+const deserializeAws_restJson1ArchiveRetainRule = (output, context) => {
+    return {
+        RetentionArchiveTier: output.RetentionArchiveTier != null
+            ? deserializeAws_restJson1RetentionArchiveTier(output.RetentionArchiveTier, context)
+            : undefined,
+    };
+};
+const deserializeAws_restJson1ArchiveRule = (output, context) => {
+    return {
+        RetainRule: output.RetainRule != null ? deserializeAws_restJson1ArchiveRetainRule(output.RetainRule, context) : undefined,
+    };
+};
 const deserializeAws_restJson1AvailabilityZoneList = (output, context) => {
     const retVal = (output || [])
         .filter((e) => e != null)
@@ -1110,8 +1142,16 @@ const deserializeAws_restJson1RetainRule = (output, context) => {
         IntervalUnit: (0, smithy_client_1.expectString)(output.IntervalUnit),
     };
 };
+const deserializeAws_restJson1RetentionArchiveTier = (output, context) => {
+    return {
+        Count: (0, smithy_client_1.expectInt32)(output.Count),
+        Interval: (0, smithy_client_1.expectInt32)(output.Interval),
+        IntervalUnit: (0, smithy_client_1.expectString)(output.IntervalUnit),
+    };
+};
 const deserializeAws_restJson1Schedule = (output, context) => {
     return {
+        ArchiveRule: output.ArchiveRule != null ? deserializeAws_restJson1ArchiveRule(output.ArchiveRule, context) : undefined,
         CopyTags: (0, smithy_client_1.expectBoolean)(output.CopyTags),
         CreateRule: output.CreateRule != null ? deserializeAws_restJson1CreateRule(output.CreateRule, context) : undefined,
         CrossRegionCopyRules: output.CrossRegionCopyRules != null

package/dist-es/models/models_0.js

@@ -116,6 +116,9 @@ export var EncryptionConfigurationFilterSensitiveLog = function (obj) { return (
 export var CrossRegionCopyRetainRuleFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var CrossRegionCopyActionFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var ActionFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
+export var RetentionArchiveTierFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
+export var ArchiveRetainRuleFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
+export var ArchiveRuleFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var EventParametersFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var EventSourceFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var TagFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };

package/dist-es/protocols/Aws_restJson1.js

@@ -793,6 +793,14 @@ var serializeAws_restJson1ActionList = function (input, context) {
         return serializeAws_restJson1Action(entry, context);
     });
 };
+var serializeAws_restJson1ArchiveRetainRule = function (input, context) {
+    return __assign({}, (input.RetentionArchiveTier != null && {
+        RetentionArchiveTier: serializeAws_restJson1RetentionArchiveTier(input.RetentionArchiveTier, context),
+    }));
+};
+var serializeAws_restJson1ArchiveRule = function (input, context) {
+    return __assign({}, (input.RetainRule != null && { RetainRule: serializeAws_restJson1ArchiveRetainRule(input.RetainRule, context) }));
+};
 var serializeAws_restJson1AvailabilityZoneList = function (input, context) {
     return input
         .filter(function (e) { return e != null; })
@@ -892,8 +900,11 @@ var serializeAws_restJson1ResourceTypeValuesList = function (input, context) {
 var serializeAws_restJson1RetainRule = function (input, context) {
     return __assign(__assign(__assign({}, (input.Count != null && { Count: input.Count })), (input.Interval != null && { Interval: input.Interval })), (input.IntervalUnit != null && { IntervalUnit: input.IntervalUnit }));
 };
+var serializeAws_restJson1RetentionArchiveTier = function (input, context) {
+    return __assign(__assign(__assign({}, (input.Count != null && { Count: input.Count })), (input.Interval != null && { Interval: input.Interval })), (input.IntervalUnit != null && { IntervalUnit: input.IntervalUnit }));
+};
 var serializeAws_restJson1Schedule = function (input, context) {
-    return __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.CopyTags != null && { CopyTags: input.CopyTags })), (input.CreateRule != null && { CreateRule: serializeAws_restJson1CreateRule(input.CreateRule, context) })), (input.CrossRegionCopyRules != null && {
+    return __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.ArchiveRule != null && { ArchiveRule: serializeAws_restJson1ArchiveRule(input.ArchiveRule, context) })), (input.CopyTags != null && { CopyTags: input.CopyTags })), (input.CreateRule != null && { CreateRule: serializeAws_restJson1CreateRule(input.CreateRule, context) })), (input.CrossRegionCopyRules != null && {
         CrossRegionCopyRules: serializeAws_restJson1CrossRegionCopyRules(input.CrossRegionCopyRules, context),
     })), (input.DeprecateRule != null && {
         DeprecateRule: serializeAws_restJson1DeprecateRule(input.DeprecateRule, context),
@@ -996,6 +1007,18 @@ var deserializeAws_restJson1ActionList = function (output, context) {
     });
     return retVal;
 };
+var deserializeAws_restJson1ArchiveRetainRule = function (output, context) {
+    return {
+        RetentionArchiveTier: output.RetentionArchiveTier != null
+            ? deserializeAws_restJson1RetentionArchiveTier(output.RetentionArchiveTier, context)
+            : undefined,
+    };
+};
+var deserializeAws_restJson1ArchiveRule = function (output, context) {
+    return {
+        RetainRule: output.RetainRule != null ? deserializeAws_restJson1ArchiveRetainRule(output.RetainRule, context) : undefined,
+    };
+};
 var deserializeAws_restJson1AvailabilityZoneList = function (output, context) {
     var retVal = (output || [])
         .filter(function (e) { return e != null; })
@@ -1239,8 +1262,16 @@ var deserializeAws_restJson1RetainRule = function (output, context) {
         IntervalUnit: __expectString(output.IntervalUnit),
     };
 };
+var deserializeAws_restJson1RetentionArchiveTier = function (output, context) {
+    return {
+        Count: __expectInt32(output.Count),
+        Interval: __expectInt32(output.Interval),
+        IntervalUnit: __expectString(output.IntervalUnit),
+    };
+};
 var deserializeAws_restJson1Schedule = function (output, context) {
     return {
+        ArchiveRule: output.ArchiveRule != null ? deserializeAws_restJson1ArchiveRule(output.ArchiveRule, context) : undefined,
         CopyTags: __expectBoolean(output.CopyTags),
         CreateRule: output.CreateRule != null ? deserializeAws_restJson1CreateRule(output.CreateRule, context) : undefined,
         CrossRegionCopyRules: output.CrossRegionCopyRules != null

package/dist-types/DLM.d.ts

@@ -13,9 +13,9 @@ import { DLMClient } from "./DLMClient";
  * 		       <p>With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create
  * 			lifecycle policies, which are used to automate operations on the specified
  * 			resources.</p>
- * 		       <p>Amazon DLM supports Amazon EBS volumes and snapshots. For information about using Amazon DLM
- * 			with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">Automating the Amazon EBS
- * 				Snapshot Lifecycle</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ * 		       <p>Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager
+ * 			with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">
+ * 				Amazon Data Lifecycle Manager</a> in the <i>Amazon EC2 User Guide</i>.</p>
  */
 export declare class DLM extends DLMClient {
     /**
@@ -28,6 +28,8 @@ export declare class DLM extends DLMClient {
     /**
      * <p>Deletes the specified lifecycle policy and halts the automated operations that the
      * 			policy specified.</p>
+     * 		       <p>For more information about deleting a policy, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#delete">Delete lifecycle
+     * 			policies</a>.</p>
      */
     deleteLifecyclePolicy(args: DeleteLifecyclePolicyCommandInput, options?: __HttpHandlerOptions): Promise<DeleteLifecyclePolicyCommandOutput>;
     deleteLifecyclePolicy(args: DeleteLifecyclePolicyCommandInput, cb: (err: any, data?: DeleteLifecyclePolicyCommandOutput) => void): void;
@@ -65,6 +67,8 @@ export declare class DLM extends DLMClient {
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     /**
      * <p>Updates the specified lifecycle policy.</p>
+     * 		       <p>For more information about updating a policy, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#modify">Modify lifecycle
+     * 			policies</a>.</p>
      */
     updateLifecyclePolicy(args: UpdateLifecyclePolicyCommandInput, options?: __HttpHandlerOptions): Promise<UpdateLifecyclePolicyCommandOutput>;
     updateLifecyclePolicy(args: UpdateLifecyclePolicyCommandInput, cb: (err: any, data?: UpdateLifecyclePolicyCommandOutput) => void): void;

package/dist-types/DLMClient.d.ts

@@ -138,9 +138,9 @@ export interface DLMClientResolvedConfig extends DLMClientResolvedConfigType {
  * 		       <p>With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create
  * 			lifecycle policies, which are used to automate operations on the specified
  * 			resources.</p>
- * 		       <p>Amazon DLM supports Amazon EBS volumes and snapshots. For information about using Amazon DLM
- * 			with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">Automating the Amazon EBS
- * 				Snapshot Lifecycle</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ * 		       <p>Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager
+ * 			with Amazon EBS, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html">
+ * 				Amazon Data Lifecycle Manager</a> in the <i>Amazon EC2 User Guide</i>.</p>
  */
 export declare class DLMClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, DLMClientResolvedConfig> {
     /**

package/dist-types/commands/DeleteLifecyclePolicyCommand.d.ts

@@ -9,6 +9,8 @@ export interface DeleteLifecyclePolicyCommandOutput extends DeleteLifecyclePolic
 /**
  * <p>Deletes the specified lifecycle policy and halts the automated operations that the
  * 			policy specified.</p>
+ * 		       <p>For more information about deleting a policy, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#delete">Delete lifecycle
+ * 			policies</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateLifecyclePolicyCommand.d.ts

@@ -8,6 +8,8 @@ export interface UpdateLifecyclePolicyCommandOutput extends UpdateLifecyclePolic
 }
 /**
  * <p>Updates the specified lifecycle policy.</p>
+ * 		       <p>For more information about updating a policy, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#modify">Modify lifecycle
+ * 			policies</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/models/models_0.d.ts

@@ -80,6 +80,63 @@ export interface Action {
      */
     CrossRegionCopy: CrossRegionCopyAction[] | undefined;
 }
+/**
+ * <p>
+ *             <b>[Snapshot policies only]</b> Describes the retention rule for archived snapshots. Once the archive
+ * 			retention threshold is met, the snapshots are permanently deleted from the archive tier.</p>
+ * 		       <note>
+ * 			         <p>The archive retention rule must retain snapshots in the archive tier for a minimum
+ * 				of 90 days.</p>
+ * 		       </note>
+ *
+ * 		       <p>For <b>count-based schedules</b>, you must specify <b>Count</b>. For <b>age-based
+ * 				schedules</b>, you must specify <b>Interval</b> and
+ * 				<b> IntervalUnit</b>.</p>
+ * 		       <p>For more information about using snapshot archiving, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive">Considerations for
+ * 			snapshot lifecycle policies</a>.</p>
+ */
+export interface RetentionArchiveTier {
+    /**
+     * <p>The maximum number of snapshots to retain in the archive storage tier for each volume.
+     * 			The count must ensure that each snapshot remains in the archive tier for at least
+     * 		90 days. For example, if the schedule creates snapshots every 30 days, you must specify a
+     * 		count of 3 or more to ensure that each snapshot is archived for at least 90 days.</p>
+     */
+    Count?: number;
+    /**
+     * <p>Specifies the period of time to retain snapshots in the archive tier. After this period
+     * 			expires, the snapshot is permanently deleted.</p>
+     */
+    Interval?: number;
+    /**
+     * <p>The unit of time in which to measure the <b>Interval</b>. For
+     * 			example, to retain a snapshots in the archive tier for 6 months, specify <code>Interval=6</code>
+     * 			and <code>IntervalUnit=MONTHS</code>.</p>
+     */
+    IntervalUnit?: RetentionIntervalUnitValues | string;
+}
+/**
+ * <p>
+ *             <b>[Snapshot policies only]</b> Specifies information about the archive storage tier retention period.</p>
+ */
+export interface ArchiveRetainRule {
+    /**
+     * <p>Information about retention period in the Amazon EBS Snapshots Archive. For more information, see
+     * 			<a href="https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/snapshot-archive.html">Archive Amazon
+     * 				EBS snapshots</a>.</p>
+     */
+    RetentionArchiveTier: RetentionArchiveTier | undefined;
+}
+/**
+ * <p>
+ *             <b>[Snapshot policies only]</b> Specifies a snapshot archiving rule for a schedule.</p>
+ */
+export interface ArchiveRule {
+    /**
+     * <p>Information about the retention period for the snapshot archiving rule.</p>
+     */
+    RetainRule: ArchiveRetainRule | undefined;
+}
 export declare enum EventTypeValues {
     SHARE_SNAPSHOT = "shareSnapshot"
 }
@@ -143,7 +200,7 @@ export interface Tag {
  * 			set of valid parameters depends on the combination of policy type and target resource
  * 			type.</p>
  * 		       <p>If you choose to exclude boot volumes and you specify tags that consequently exclude
- * 			all of the additional data volumes attached to an instance, then Amazon DLM will not create
+ * 			all of the additional data volumes attached to an instance, then Amazon Data Lifecycle Manager will not create
  * 			any snapshots for the affected instance, and it will emit a <code>SnapshotsCreateFailed</code>
  * 			Amazon CloudWatch metric. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitor-dlm-cw-metrics.html">Monitor your policies
  * 				using Amazon CloudWatch</a>.</p>
@@ -198,10 +255,19 @@ export declare enum LocationValues {
 /**
  * <p>
  *             <b>[Snapshot and AMI policies only]</b> Specifies when the policy should create snapshots or AMIs.</p>
- * 		       <important>
- * 			         <p>You must specify either a Cron expression or an interval, interval unit, and start
- * 			time. You cannot specify both.</p>
- * 		       </important>
+ * 		       <note>
+ * 			         <ul>
+ *                <li>
+ * 					             <p>You must specify either <b>CronExpression</b>, or
+ * 						<b>Interval</b>, <b>IntervalUnit</b>,
+ * 						and <b>Times</b>.</p>
+ * 				           </li>
+ *                <li>
+ * 					             <p>If you need to specify an <a>ArchiveRule</a> for the schedule, then you must
+ * 						specify a creation frequency of at least 28 days.</p>
+ * 				           </li>
+ *             </ul>
+ * 		       </note>
  */
 export interface CreateRule {
     /**
@@ -217,8 +283,7 @@ export interface CreateRule {
      */
     Location?: LocationValues | string;
     /**
-     * <p>The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and
-     * 			24.</p>
+     * <p>The interval between snapshots. The supported values are 1, 2, 3, 4, 6, 8, 12, and 24.</p>
      */
     Interval?: number;
     /**
@@ -228,7 +293,7 @@ export interface CreateRule {
     /**
      * <p>The time, in UTC, to start the operation. The supported format is hh:mm.</p>
      * 		       <p>The operation occurs within a one-hour window following the specified time. If you do
-     * 			not specify a time, Amazon DLM selects a time within the next 24 hours.</p>
+     * 			not specify a time, Amazon Data Lifecycle Manager selects a time within the next 24 hours.</p>
      */
     Times?: string[];
     /**
@@ -338,8 +403,8 @@ export interface DeprecateRule {
 /**
  * <p>
  *             <b>[Snapshot policies only]</b> Specifies a rule for enabling fast snapshot restore for snapshots created by
- * 			snaspshot policies. You can enable fast snapshot restore based on either a count or a time
- * 			interval.</p>
+ * 			snapshot policies. You can enable fast snapshot restore based on either a count or a
+ * 			time interval.</p>
  */
 export interface FastRestoreRule {
     /**
@@ -362,14 +427,48 @@ export interface FastRestoreRule {
 }
 /**
  * <p>
- *             <b>[Snapshot and AMI policies only]</b> Specifies a retention rule for snapshots created by snapshot policies
- * 			or for AMIs created by AMI policies. You can retain snapshots based on either a count or a time interval.</p>
- * 		       <p>You must specify either <b>Count</b>, or <b>Interval</b>
- * 			and <b>IntervalUnit</b>.</p>
+ *             <b>[Snapshot and AMI policies only]</b> Specifies a retention rule for snapshots created by snapshot policies, or for AMIs
+ * 			created by AMI policies.</p>
+ *
+ * 		       <note>
+ * 			         <p>For snapshot policies that have an <a>ArchiveRule</a>, this retention rule
+ * 				applies to standard tier retention. When the retention threshold is met, snapshots
+ * 				are moved from the standard to the archive tier.</p>
+ * 			         <p>For snapshot policies that do not have an <b>ArchiveRule</b>, snapshots
+ * 				are permanently deleted when this retention threshold is met.</p>
+ * 		       </note>
+ *
+ * 		       <p>You can retain snapshots based on either a count or a time interval.</p>
+ * 		       <ul>
+ *             <li>
+ * 				           <p>
+ *                   <b>Count-based retention</b>
+ *                </p>
+ * 				           <p>You must specify <b>Count</b>.
+ * 					If you specify an <a>ArchiveRule</a> for the schedule, then you can specify a retention count of
+ * 					<code>0</code> to archive snapshots immediately after creation. If you specify a <a>FastRestoreRule</a>,
+ * 					<a>ShareRule</a>, or a <a>CrossRegionCopyRule</a>, then you must specify a retention count
+ * 					of <code>1</code> or more.</p>
+ * 			         </li>
+ *             <li>
+ * 				           <p>
+ *                   <b>Age-based retention</b>
+ *                </p>
+ * 				           <p>You must specify <b>Interval</b>
+ * 					and <b>IntervalUnit</b>. If you specify an <a>ArchiveRule</a> for the
+ * 					schedule, then you can specify a retention interval of <code>0</code> days to archive snapshots immediately
+ * 					after creation. If you specify a <a>FastRestoreRule</a>, <a>ShareRule</a>, or a
+ * 					<a>CrossRegionCopyRule</a>, then you must specify a retention interval of <code>1</code> day or
+ * 					more.</p>
+ * 			         </li>
+ *          </ul>
  */
 export interface RetainRule {
     /**
-     * <p>The number of snapshots to retain for each volume, up to a maximum of 1000.</p>
+     * <p>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 <code>3</code>. When the fourth snapshot is created, the
+     * 			oldest retained snapshot is deleted, or it is moved to the archive tier if you have specified an
+     * 			<a>ArchiveRule</a>.</p>
      */
     Count?: number;
     /**
@@ -378,7 +477,10 @@ export interface RetainRule {
      */
     Interval?: number;
     /**
-     * <p>The unit of time for time-based retention.</p>
+     * <p>The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify
+     * 			<code>Interval=3</code> and <code>IntervalUnit=MONTHS</code>. Once the snapshot has been retained for
+     * 			3 months, it is deleted, or it is moved to the archive tier if you have specified an
+     * 			<a>ArchiveRule</a>.</p>
      */
     IntervalUnit?: RetentionIntervalUnitValues | string;
 }
@@ -461,6 +563,16 @@ export interface Schedule {
      *             <b>[AMI policies only]</b> The AMI deprecation rule for the schedule.</p>
      */
     DeprecateRule?: DeprecateRule;
+    /**
+     * <p>
+     *             <b>[Snapshot policies that target volumes only]</b> 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. </p>
+     * 		       <p>For more information about using snapshot archiving, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive">Considerations for
+     * 				snapshot lifecycle policies</a>.</p>
+     */
+    ArchiveRule?: ArchiveRule;
 }
 /**
  * <p>
@@ -844,6 +956,18 @@ export declare const CrossRegionCopyActionFilterSensitiveLog: (obj: CrossRegionC
  * @internal
  */
 export declare const ActionFilterSensitiveLog: (obj: Action) => any;
+/**
+ * @internal
+ */
+export declare const RetentionArchiveTierFilterSensitiveLog: (obj: RetentionArchiveTier) => any;
+/**
+ * @internal
+ */
+export declare const ArchiveRetainRuleFilterSensitiveLog: (obj: ArchiveRetainRule) => any;
+/**
+ * @internal
+ */
+export declare const ArchiveRuleFilterSensitiveLog: (obj: ArchiveRule) => any;
 /**
  * @internal
  */

package/dist-types/ts3.4/models/models_0.d.ts

@@ -23,6 +23,17 @@ export interface Action {
   Name: string | undefined;
   CrossRegionCopy: CrossRegionCopyAction[] | undefined;
 }
+export interface RetentionArchiveTier {
+  Count?: number;
+  Interval?: number;
+  IntervalUnit?: RetentionIntervalUnitValues | string;
+}
+export interface ArchiveRetainRule {
+  RetentionArchiveTier: RetentionArchiveTier | undefined;
+}
+export interface ArchiveRule {
+  RetainRule: ArchiveRetainRule | undefined;
+}
 export declare enum EventTypeValues {
   SHARE_SNAPSHOT = "shareSnapshot",
 }
@@ -119,6 +130,7 @@ export interface Schedule {
   CrossRegionCopyRules?: CrossRegionCopyRule[];
   ShareRules?: ShareRule[];
   DeprecateRule?: DeprecateRule;
+  ArchiveRule?: ArchiveRule;
 }
 export interface PolicyDetails {
   PolicyType?: PolicyTypeValues | string;
@@ -263,6 +275,13 @@ export declare const CrossRegionCopyActionFilterSensitiveLog: (
   obj: CrossRegionCopyAction
 ) => any;
 export declare const ActionFilterSensitiveLog: (obj: Action) => any;
+export declare const RetentionArchiveTierFilterSensitiveLog: (
+  obj: RetentionArchiveTier
+) => any;
+export declare const ArchiveRetainRuleFilterSensitiveLog: (
+  obj: ArchiveRetainRule
+) => any;
+export declare const ArchiveRuleFilterSensitiveLog: (obj: ArchiveRule) => any;
 export declare const EventParametersFilterSensitiveLog: (
   obj: EventParameters
 ) => any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-dlm",
   "description": "AWS SDK for JavaScript Dlm Client for Node.js, Browser and React Native",
-  "version": "3.181.0",
+  "version": "3.182.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",