@aws-sdk/client-cloudformation 3.379.1 → 3.380.0

package/dist-cjs/endpoint/ruleset.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ruleSet = void 0;
 const s = "required", t = "fn", u = "argv", v = "ref";
 const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = "getAttr", g = { [s]: false, "type": "String" }, h = { [s]: true, "default": false, "type": "Boolean" }, i = { [v]: "Endpoint" }, j = { [t]: "booleanEquals", [u]: [{ [v]: "UseFIPS" }, true] }, k = { [t]: "booleanEquals", [u]: [{ [v]: "UseDualStack" }, true] }, l = {}, m = { [t]: "booleanEquals", [u]: [true, { [t]: f, [u]: [{ [v]: e }, "supportsFIPS"] }] }, n = { [v]: e }, o = { [t]: "booleanEquals", [u]: [true, { [t]: f, [u]: [n, "supportsDualStack"] }] }, p = [j], q = [k], r = [{ [v]: "Region" }];
-const _data = { version: "1.0", parameters: { Region: g, UseDualStack: h, UseFIPS: h, Endpoint: g }, rules: [{ conditions: [{ [t]: a, [u]: [i] }], type: b, rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: i, properties: l, headers: l }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [t]: a, [u]: r }], type: b, rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: e }], type: b, rules: [{ conditions: [j, k], type: b, rules: [{ conditions: [m, o], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: p, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ conditions: [{ [t]: "stringEquals", [u]: ["aws-us-gov", { [t]: f, [u]: [n, "name"] }] }], endpoint: { url: "https://cloudformation.{Region}.amazonaws.com", properties: l, headers: l }, type: d }, { endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: q, type: b, rules: [{ conditions: [o], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
+const _data = { version: "1.0", parameters: { Region: g, UseDualStack: h, UseFIPS: h, Endpoint: g }, rules: [{ conditions: [{ [t]: a, [u]: [i] }], type: b, rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: i, properties: l, headers: l }, type: d }] }, { conditions: [{ [t]: a, [u]: r }], type: b, rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: e }], type: b, rules: [{ conditions: [j, k], type: b, rules: [{ conditions: [m, o], type: b, rules: [{ endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: p, type: b, rules: [{ conditions: [m], type: b, rules: [{ conditions: [{ [t]: "stringEquals", [u]: ["aws-us-gov", { [t]: f, [u]: [n, "name"] }] }], endpoint: { url: "https://cloudformation.{Region}.amazonaws.com", properties: l, headers: l }, type: d }, { endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: q, type: b, rules: [{ conditions: [o], type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] };
 exports.ruleSet = _data;

package/dist-cjs/protocols/Aws_query.js

@@ -3645,6 +3645,9 @@ const se_CreateStackInput = (input, context) => {
     if (input.EnableTerminationProtection != null) {
         entries["EnableTerminationProtection"] = input.EnableTerminationProtection;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_CreateStackInstancesInput = (input, context) => {
@@ -4222,6 +4225,9 @@ const se_ExecuteChangeSetInput = (input, context) => {
     if (input.DisableRollback != null) {
         entries["DisableRollback"] = input.DisableRollback;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_GetStackPolicyInput = (input, context) => {
@@ -4880,6 +4886,9 @@ const se_RollbackStackInput = (input, context) => {
     if (input.ClientRequestToken != null) {
         entries["ClientRequestToken"] = input.ClientRequestToken;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_RollbackTrigger = (input, context) => {
@@ -5264,6 +5273,9 @@ const se_UpdateStackInput = (input, context) => {
     if (input.ClientRequestToken != null) {
         entries["ClientRequestToken"] = input.ClientRequestToken;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_UpdateStackInstancesInput = (input, context) => {
@@ -7020,6 +7032,9 @@ const de_Stack = (output, context) => {
     if (output["DriftInformation"] !== undefined) {
         contents.DriftInformation = de_StackDriftInformation(output["DriftInformation"], context);
     }
+    if (output["RetainExceptOnCreate"] !== undefined) {
+        contents.RetainExceptOnCreate = (0, smithy_client_1.parseBoolean)(output["RetainExceptOnCreate"]);
+    }
     return contents;
 };
 const de_StackDriftInformation = (output, context) => {

package/dist-es/endpoint/ruleset.js

@@ -1,4 +1,4 @@
 const s = "required", t = "fn", u = "argv", v = "ref";
 const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = "getAttr", g = { [s]: false, "type": "String" }, h = { [s]: true, "default": false, "type": "Boolean" }, i = { [v]: "Endpoint" }, j = { [t]: "booleanEquals", [u]: [{ [v]: "UseFIPS" }, true] }, k = { [t]: "booleanEquals", [u]: [{ [v]: "UseDualStack" }, true] }, l = {}, m = { [t]: "booleanEquals", [u]: [true, { [t]: f, [u]: [{ [v]: e }, "supportsFIPS"] }] }, n = { [v]: e }, o = { [t]: "booleanEquals", [u]: [true, { [t]: f, [u]: [n, "supportsDualStack"] }] }, p = [j], q = [k], r = [{ [v]: "Region" }];
-const _data = { version: "1.0", parameters: { Region: g, UseDualStack: h, UseFIPS: h, Endpoint: g }, rules: [{ conditions: [{ [t]: a, [u]: [i] }], type: b, rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: i, properties: l, headers: l }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [t]: a, [u]: r }], type: b, rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: e }], type: b, rules: [{ conditions: [j, k], type: b, rules: [{ conditions: [m, o], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: p, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ conditions: [{ [t]: "stringEquals", [u]: ["aws-us-gov", { [t]: f, [u]: [n, "name"] }] }], endpoint: { url: "https://cloudformation.{Region}.amazonaws.com", properties: l, headers: l }, type: d }, { endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: q, type: b, rules: [{ conditions: [o], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
+const _data = { version: "1.0", parameters: { Region: g, UseDualStack: h, UseFIPS: h, Endpoint: g }, rules: [{ conditions: [{ [t]: a, [u]: [i] }], type: b, rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: i, properties: l, headers: l }, type: d }] }, { conditions: [{ [t]: a, [u]: r }], type: b, rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: e }], type: b, rules: [{ conditions: [j, k], type: b, rules: [{ conditions: [m, o], type: b, rules: [{ endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: p, type: b, rules: [{ conditions: [m], type: b, rules: [{ conditions: [{ [t]: "stringEquals", [u]: ["aws-us-gov", { [t]: f, [u]: [n, "name"] }] }], endpoint: { url: "https://cloudformation.{Region}.amazonaws.com", properties: l, headers: l }, type: d }, { endpoint: { url: "https://cloudformation-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: q, type: b, rules: [{ conditions: [o], type: b, rules: [{ endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: d }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { endpoint: { url: "https://cloudformation.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: d }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] };
 export const ruleSet = _data;

package/dist-es/protocols/Aws_query.js

@@ -3500,6 +3500,9 @@ const se_CreateStackInput = (input, context) => {
     if (input.EnableTerminationProtection != null) {
         entries["EnableTerminationProtection"] = input.EnableTerminationProtection;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_CreateStackInstancesInput = (input, context) => {
@@ -4077,6 +4080,9 @@ const se_ExecuteChangeSetInput = (input, context) => {
     if (input.DisableRollback != null) {
         entries["DisableRollback"] = input.DisableRollback;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_GetStackPolicyInput = (input, context) => {
@@ -4735,6 +4741,9 @@ const se_RollbackStackInput = (input, context) => {
     if (input.ClientRequestToken != null) {
         entries["ClientRequestToken"] = input.ClientRequestToken;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_RollbackTrigger = (input, context) => {
@@ -5119,6 +5128,9 @@ const se_UpdateStackInput = (input, context) => {
     if (input.ClientRequestToken != null) {
         entries["ClientRequestToken"] = input.ClientRequestToken;
     }
+    if (input.RetainExceptOnCreate != null) {
+        entries["RetainExceptOnCreate"] = input.RetainExceptOnCreate;
+    }
     return entries;
 };
 const se_UpdateStackInstancesInput = (input, context) => {
@@ -6875,6 +6887,9 @@ const de_Stack = (output, context) => {
     if (output["DriftInformation"] !== undefined) {
         contents.DriftInformation = de_StackDriftInformation(output["DriftInformation"], context);
     }
+    if (output["RetainExceptOnCreate"] !== undefined) {
+        contents.RetainExceptOnCreate = __parseBoolean(output["RetainExceptOnCreate"]);
+    }
     return contents;
 };
 const de_StackDriftInformation = (output, context) => {

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

@@ -75,6 +75,7 @@ export interface CreateStackCommandOutput extends CreateStackOutput, __MetadataB
  *   ],
  *   ClientRequestToken: "STRING_VALUE",
  *   EnableTerminationProtection: true || false,
+ *   RetainExceptOnCreate: true || false,
  * };
  * const command = new CreateStackCommand(input);
  * const response = await client.send(command);

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

@@ -99,6 +99,7 @@ export interface DescribeStacksCommandOutput extends DescribeStacksOutput, __Met
  * //         StackDriftStatus: "DRIFTED" || "IN_SYNC" || "UNKNOWN" || "NOT_CHECKED", // required
  * //         LastCheckTimestamp: new Date("TIMESTAMP"),
  * //       },
+ * //       RetainExceptOnCreate: true || false,
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

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

@@ -42,6 +42,7 @@ export interface ExecuteChangeSetCommandOutput extends ExecuteChangeSetOutput, _
  *   StackName: "STRING_VALUE",
  *   ClientRequestToken: "STRING_VALUE",
  *   DisableRollback: true || false,
+ *   RetainExceptOnCreate: true || false,
  * };
  * const command = new ExecuteChangeSetCommand(input);
  * const response = await client.send(command);

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

@@ -66,6 +66,7 @@ export interface RollbackStackCommandOutput extends RollbackStackOutput, __Metad
  *   StackName: "STRING_VALUE", // required
  *   RoleARN: "STRING_VALUE",
  *   ClientRequestToken: "STRING_VALUE",
+ *   RetainExceptOnCreate: true || false,
  * };
  * const command = new RollbackStackCommand(input);
  * const response = await client.send(command);

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

@@ -79,6 +79,7 @@ export interface UpdateStackCommandOutput extends UpdateStackOutput, __MetadataB
  *   ],
  *   DisableRollback: true || false,
  *   ClientRequestToken: "STRING_VALUE",
+ *   RetainExceptOnCreate: true || false,
  * };
  * const command = new UpdateStackCommand(input);
  * const response = await client.send(command);

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

@@ -285,6 +285,9 @@ export interface ActivateTypeOutput {
 export declare class CFNRegistryException extends __BaseException {
     readonly name: "CFNRegistryException";
     readonly $fault: "client";
+    /**
+     * <p>An message with details about the error that occurred.</p>
+     */
     Message?: string;
     /**
      * @internal
@@ -298,6 +301,9 @@ export declare class CFNRegistryException extends __BaseException {
 export declare class TypeNotFoundException extends __BaseException {
     readonly name: "TypeNotFoundException";
     readonly $fault: "client";
+    /**
+     * <p>An message with details about the error that occurred.</p>
+     */
     Message?: string;
     /**
      * @internal
@@ -462,6 +468,9 @@ export interface BatchDescribeTypeConfigurationsOutput {
 export declare class TypeConfigurationNotFoundException extends __BaseException {
     readonly name: "TypeConfigurationNotFoundException";
     readonly $fault: "client";
+    /**
+     * <p>An message with details about the error that occurred.</p>
+     */
     Message?: string;
     /**
      * @internal
@@ -1858,6 +1867,14 @@ export interface CreateStackInput {
      *    stack.</p>
      */
     EnableTerminationProtection?: boolean;
+    /**
+     * <p>This deletion policy deletes newly created resources, but retains existing resources, when a stack operation is
+     *     rolled back. This ensures new, empty, and unused resources are deleted, while critical resources and their data are
+     *     retained. <code>RetainExceptOnCreate</code> can be specified for any resource that supports the
+     *     <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
+     *     DeletionPolicy</a> attribute.</p>
+     */
+    RetainExceptOnCreate?: boolean;
 }
 /**
  * @public
@@ -4255,6 +4272,14 @@ export interface Stack {
      *    information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to Stacks and Resources</a>.</p>
      */
     DriftInformation?: StackDriftInformation;
+    /**
+     * <p>This deletion policy deletes newly created resources, but retains existing resources, when a stack operation is
+     *    rolled back. This ensures new, empty, and unused resources are deleted, while critical resources and their data are
+     *    retained. <code>RetainExceptOnCreate</code> can be specified for any resource that supports the
+     *    <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
+     *    DeletionPolicy</a> attribute.</p>
+     */
+    RetainExceptOnCreate?: boolean;
 }
 /**
  * @public
@@ -5335,6 +5360,14 @@ export interface ExecuteChangeSetInput {
      *          </p>
      */
     DisableRollback?: boolean;
+    /**
+     * <p>This deletion policy deletes newly created resources, but retains existing resources, when a stack operation is
+     *     rolled back. This ensures new, empty, and unused resources are deleted, while critical resources and their data are
+     *     retained. <code>RetainExceptOnCreate</code> can be specified for any resource that supports the
+     *     <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
+     *     DeletionPolicy</a> attribute.</p>
+     */
+    RetainExceptOnCreate?: boolean;
 }
 /**
  * @public
@@ -7588,6 +7621,14 @@ export interface RollbackStackInput {
      * <p>A unique identifier for this <code>RollbackStack</code> request.</p>
      */
     ClientRequestToken?: string;
+    /**
+     * <p>This deletion policy deletes newly created resources, but retains existing resources, when a stack operation is
+     *     rolled back. This ensures new, empty, and unused resources are deleted, while critical resources and their data are
+     *     retained. <code>RetainExceptOnCreate</code> can be specified for any resource that supports the
+     *     <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
+     *     DeletionPolicy</a> attribute.</p>
+     */
+    RetainExceptOnCreate?: boolean;
 }
 /**
  * @public
@@ -8059,6 +8100,14 @@ export interface UpdateStackInput {
      *     <code>Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002</code>.</p>
      */
     ClientRequestToken?: string;
+    /**
+     * <p>This deletion policy deletes newly created resources, but retains existing resources, when a stack operation is
+     *   rolled back. This ensures new, empty, and unused resources are deleted, while critical resources and their data are
+     *   retained. <code>RetainExceptOnCreate</code> can be specified for any resource that supports the
+     *   <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
+     *   DeletionPolicy</a> attribute.</p>
+     */
+    RetainExceptOnCreate?: boolean;
 }
 /**
  * @public

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

@@ -444,6 +444,7 @@ export interface CreateStackInput {
   Tags?: Tag[];
   ClientRequestToken?: string;
   EnableTerminationProtection?: boolean;
+  RetainExceptOnCreate?: boolean;
 }
 export interface CreateStackOutput {
   StackId?: string;
@@ -1009,6 +1010,7 @@ export interface Stack {
   ParentId?: string;
   RootId?: string;
   DriftInformation?: StackDriftInformation;
+  RetainExceptOnCreate?: boolean;
 }
 export interface DescribeStacksOutput {
   Stacks?: Stack[];
@@ -1238,6 +1240,7 @@ export interface ExecuteChangeSetInput {
   StackName?: string;
   ClientRequestToken?: string;
   DisableRollback?: boolean;
+  RetainExceptOnCreate?: boolean;
 }
 export interface ExecuteChangeSetOutput {}
 export interface GetStackPolicyInput {
@@ -1699,6 +1702,7 @@ export interface RollbackStackInput {
   StackName: string | undefined;
   RoleARN?: string;
   ClientRequestToken?: string;
+  RetainExceptOnCreate?: boolean;
 }
 export interface RollbackStackOutput {
   StackId?: string;
@@ -1771,6 +1775,7 @@ export interface UpdateStackInput {
   Tags?: Tag[];
   DisableRollback?: boolean;
   ClientRequestToken?: string;
+  RetainExceptOnCreate?: boolean;
 }
 export interface UpdateStackOutput {
   StackId?: string;

package/package.json

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