@aws-sdk/client-cloudformation 3.370.0 → 3.373.0

package/dist-cjs/protocols/Aws_query.js

@@ -4211,6 +4211,13 @@ const se_GetTemplateSummaryInput = (input, context) => {
     if (input.CallAs != null) {
         entries["CallAs"] = input.CallAs;
     }
+    if (input.TemplateSummaryConfig != null) {
+        const memberEntries = se_TemplateSummaryConfig(input.TemplateSummaryConfig, context);
+        Object.entries(memberEntries).forEach(([key, value]) => {
+            const loc = `TemplateSummaryConfig.${key}`;
+            entries[loc] = value;
+        });
+    }
     return entries;
 };
 const se_ImportStacksToStackSetInput = (input, context) => {
@@ -5007,6 +5014,13 @@ const se_Tags = (input, context) => {
     }
     return entries;
 };
+const se_TemplateSummaryConfig = (input, context) => {
+    const entries = {};
+    if (input.TreatUnrecognizedResourceTypesAsWarnings != null) {
+        entries["TreatUnrecognizedResourceTypesAsWarnings"] = input.TreatUnrecognizedResourceTypesAsWarnings;
+    }
+    return entries;
+};
 const se_TestTypeInput = (input, context) => {
     const entries = {};
     if (input.Arn != null) {
@@ -6172,6 +6186,9 @@ const de_GetTemplateSummaryOutput = (output, context) => {
         output["ResourceIdentifierSummaries"]["member"] !== undefined) {
         contents.ResourceIdentifierSummaries = de_ResourceIdentifierSummaries((0, smithy_client_1.getArrayIfSingleItem)(output["ResourceIdentifierSummaries"]["member"]), context);
     }
+    if (output["Warnings"] !== undefined) {
+        contents.Warnings = de_Warnings(output["Warnings"], context);
+    }
     return contents;
 };
 const de_Imports = (output, context) => {
@@ -7926,6 +7943,17 @@ const de_ValidateTemplateOutput = (output, context) => {
     }
     return contents;
 };
+const de_Warnings = (output, context) => {
+    const contents = {};
+    if (output.UnrecognizedResourceTypes === "") {
+        contents.UnrecognizedResourceTypes = [];
+    }
+    else if (output["UnrecognizedResourceTypes"] !== undefined &&
+        output["UnrecognizedResourceTypes"]["member"] !== undefined) {
+        contents.UnrecognizedResourceTypes = de_ResourceTypes((0, smithy_client_1.getArrayIfSingleItem)(output["UnrecognizedResourceTypes"]["member"]), context);
+    }
+    return contents;
+};
 const deserializeMetadata = (output) => ({
     httpStatusCode: output.statusCode,
     requestId: output.headers["x-amzn-requestid"] ?? output.headers["x-amzn-request-id"] ?? output.headers["x-amz-request-id"],

package/dist-es/protocols/Aws_query.js

@@ -4068,6 +4068,13 @@ const se_GetTemplateSummaryInput = (input, context) => {
     if (input.CallAs != null) {
         entries["CallAs"] = input.CallAs;
     }
+    if (input.TemplateSummaryConfig != null) {
+        const memberEntries = se_TemplateSummaryConfig(input.TemplateSummaryConfig, context);
+        Object.entries(memberEntries).forEach(([key, value]) => {
+            const loc = `TemplateSummaryConfig.${key}`;
+            entries[loc] = value;
+        });
+    }
     return entries;
 };
 const se_ImportStacksToStackSetInput = (input, context) => {
@@ -4864,6 +4871,13 @@ const se_Tags = (input, context) => {
     }
     return entries;
 };
+const se_TemplateSummaryConfig = (input, context) => {
+    const entries = {};
+    if (input.TreatUnrecognizedResourceTypesAsWarnings != null) {
+        entries["TreatUnrecognizedResourceTypesAsWarnings"] = input.TreatUnrecognizedResourceTypesAsWarnings;
+    }
+    return entries;
+};
 const se_TestTypeInput = (input, context) => {
     const entries = {};
     if (input.Arn != null) {
@@ -6029,6 +6043,9 @@ const de_GetTemplateSummaryOutput = (output, context) => {
         output["ResourceIdentifierSummaries"]["member"] !== undefined) {
         contents.ResourceIdentifierSummaries = de_ResourceIdentifierSummaries(__getArrayIfSingleItem(output["ResourceIdentifierSummaries"]["member"]), context);
     }
+    if (output["Warnings"] !== undefined) {
+        contents.Warnings = de_Warnings(output["Warnings"], context);
+    }
     return contents;
 };
 const de_Imports = (output, context) => {
@@ -7783,6 +7800,17 @@ const de_ValidateTemplateOutput = (output, context) => {
     }
     return contents;
 };
+const de_Warnings = (output, context) => {
+    const contents = {};
+    if (output.UnrecognizedResourceTypes === "") {
+        contents.UnrecognizedResourceTypes = [];
+    }
+    else if (output["UnrecognizedResourceTypes"] !== undefined &&
+        output["UnrecognizedResourceTypes"]["member"] !== undefined) {
+        contents.UnrecognizedResourceTypes = de_ResourceTypes(__getArrayIfSingleItem(output["UnrecognizedResourceTypes"]["member"]), context);
+    }
+    return contents;
+};
 const deserializeMetadata = (output) => ({
     httpStatusCode: output.statusCode,
     requestId: output.headers["x-amzn-requestid"] ?? output.headers["x-amzn-request-id"] ?? output.headers["x-amz-request-id"],

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

@@ -42,6 +42,9 @@ export interface GetTemplateSummaryCommandOutput extends GetTemplateSummaryOutpu
  *   StackName: "STRING_VALUE",
  *   StackSetName: "STRING_VALUE",
  *   CallAs: "SELF" || "DELEGATED_ADMIN",
+ *   TemplateSummaryConfig: { // TemplateSummaryConfig
+ *     TreatUnrecognizedResourceTypesAsWarnings: true || false,
+ *   },
  * };
  * const command = new GetTemplateSummaryCommand(input);
  * const response = await client.send(command);
@@ -84,6 +87,11 @@ export interface GetTemplateSummaryCommandOutput extends GetTemplateSummaryOutpu
  * //       ],
  * //     },
  * //   ],
+ * //   Warnings: { // Warnings
+ * //     UnrecognizedResourceTypes: [
+ * //       "STRING_VALUE",
+ * //     ],
+ * //   },
  * // };
  *
  * ```

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

@@ -1543,31 +1543,31 @@ export interface CreateChangeSetInput {
     IncludeNestedStacks?: boolean;
     /**
      * <p>Determines what action will be taken if stack creation fails. If this parameter is specified, the
-     *    <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API operation must not
-     *    be specified. This must be one of these values:</p>
+     *     <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API operation must not
+     *       be specified. This must be one of these values:</p>
      *          <ul>
      *             <li>
      *                <p>
      *                   <code>DELETE</code> - Deletes the change set if the stack creation fails. This is only valid when the
-     *      <code>ChangeSetType</code> parameter is set to <code>CREATE</code>. If the deletion of the stack fails, the status
-     *      of the stack is <code>DELETE_FAILED</code>.</p>
+     *         <code>ChangeSetType</code> parameter is set to <code>CREATE</code>. If the deletion of the stack fails, the status
+     *         of the stack is <code>DELETE_FAILED</code>.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>DO_NOTHING</code> - if the stack creation fails, do nothing. This is equivalent to specifying
-     *      <code>true</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
-     *      operation.</p>
+     *         <code>true</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
+     *         operation.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>ROLLBACK</code> - if the stack creation fails, roll back the stack. This is equivalent to specifying
-     *      <code>false</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
-     *      operation.</p>
+     *         <code>false</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
+     *         operation.</p>
      *             </li>
      *          </ul>
      *          <p>For nested stacks, when the <code>OnStackFailure</code> parameter is set to <code>DELETE</code> for the change
-     *    set for the parent stack, any failure in a child stack will cause the parent stack creation to fail and all stacks to
-     *    be deleted.</p>
+     *      set for the parent stack, any failure in a child stack will cause the parent stack creation to fail and all stacks to
+     *      be deleted.</p>
      */
     OnStackFailure?: OnStackFailure | string;
 }
@@ -2826,26 +2826,26 @@ export interface DescribeChangeSetOutput {
     RootChangeSetId?: string;
     /**
      * <p>Determines what action will be taken if stack creation fails. When this parameter is specified, the
-     *    <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API operation must not
-     *    be specified. This must be one of these values:</p>
+     *     <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API operation must not
+     *     be specified. This must be one of these values:</p>
      *          <ul>
      *             <li>
      *                <p>
      *                   <code>DELETE</code> - Deletes the change set if the stack creation fails. This is only valid when the
-     *      <code>ChangeSetType</code> parameter is set to <code>CREATE</code>. If the deletion of the stack fails, the status
-     *      of the stack is <code>DELETE_FAILED</code>.</p>
+     *         <code>ChangeSetType</code> parameter is set to <code>CREATE</code>. If the deletion of the stack fails, the status
+     *         of the stack is <code>DELETE_FAILED</code>.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>DO_NOTHING</code> - if the stack creation fails, do nothing. This is equivalent to specifying
-     *      <code>true</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
-     *      operation.</p>
+     *         <code>true</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
+     *         operation.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>ROLLBACK</code> - if the stack creation fails, roll back the stack. This is equivalent to specifying
-     *      <code>false</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
-     *      operation.</p>
+     *         <code>false</code> for the <code>DisableRollback</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html">ExecuteChangeSet</a> API
+     *         operation.</p>
      *             </li>
      *          </ul>
      */
@@ -5316,19 +5316,19 @@ export interface ExecuteChangeSetInput {
     ClientRequestToken?: string;
     /**
      * <p>Preserves the state of previously provisioned resources when an operation
-     *    fails. This parameter can't be specified when
-     *    the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation was
-     *    specified.</p>
+     *     fails. This parameter can't be specified when
+     *     the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation was
+     *     specified.</p>
      *          <ul>
      *             <li>
      *                <p>
      *                   <code>True</code> - if the stack creation fails, do nothing. This is equivalent to specifying
-     *      <code>DO_NOTHING</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation.</p>
+     *         <code>DO_NOTHING</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>False</code> - if the stack creation fails, roll back the stack. This is equivalent to specifying
-     *      <code>ROLLBACK</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation.</p>
+     *         <code>ROLLBACK</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html">CreateChangeSet</a> API operation.</p>
      *             </li>
      *          </ul>
      *          <p>Default: <code>True</code>
@@ -5426,6 +5426,17 @@ export interface GetTemplateOutput {
      */
     StagesAvailable?: (TemplateStage | string)[];
 }
+/**
+ * @public
+ * <p>Options for the <code>GetTemplateSummary</code> API action.</p>
+ */
+export interface TemplateSummaryConfig {
+    /**
+     * <p>If set to <code>True</code>, any unrecognized resource types generate warnings and not an error. Any
+     *    unrecognized resource types are returned in the <code>Warnings</code> output parameter.</p>
+     */
+    TreatUnrecognizedResourceTypesAsWarnings?: boolean;
+}
 /**
  * @public
  * <p>The input for the <a>GetTemplateSummary</a> action.</p>
@@ -5479,6 +5490,10 @@ export interface GetTemplateSummaryInput {
      *          </ul>
      */
     CallAs?: CallAs | string;
+    /**
+     * <p>Specifies options for the <code>GetTemplateSummary</code> API action.</p>
+     */
+    TemplateSummaryConfig?: TemplateSummaryConfig;
 }
 /**
  * @public
@@ -5543,6 +5558,18 @@ export interface ResourceIdentifierSummary {
      */
     ResourceIdentifiers?: string[];
 }
+/**
+ * @public
+ * <p>Contains any warnings returned by the <code>GetTemplateSummary</code> API action.</p>
+ */
+export interface Warnings {
+    /**
+     * <p>A list of all of the unrecognized resource types. This is only returned if the
+     *    <code>TemplateSummaryConfig</code> parameter has the <code>TreatUnrecognizedResourceTypesAsWarning</code>
+     *    configuration set to <code>True</code>.</p>
+     */
+    UnrecognizedResourceTypes?: string[];
+}
 /**
  * @public
  * <p>The output for the <a>GetTemplateSummary</a> action.</p>
@@ -5592,6 +5619,10 @@ export interface GetTemplateSummaryOutput {
      *    is a possible identifier property for an <code>AWS::S3::Bucket</code> resource.</p>
      */
     ResourceIdentifierSummaries?: ResourceIdentifierSummary[];
+    /**
+     * <p>An object containing any warnings returned.</p>
+     */
+    Warnings?: Warnings;
 }
 /**
  * @public

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

@@ -1260,12 +1260,16 @@ export interface GetTemplateOutput {
   TemplateBody?: string;
   StagesAvailable?: (TemplateStage | string)[];
 }
+export interface TemplateSummaryConfig {
+  TreatUnrecognizedResourceTypesAsWarnings?: boolean;
+}
 export interface GetTemplateSummaryInput {
   TemplateBody?: string;
   TemplateURL?: string;
   StackName?: string;
   StackSetName?: string;
   CallAs?: CallAs | string;
+  TemplateSummaryConfig?: TemplateSummaryConfig;
 }
 export interface ParameterConstraints {
   AllowedValues?: string[];
@@ -1283,6 +1287,9 @@ export interface ResourceIdentifierSummary {
   LogicalResourceIds?: string[];
   ResourceIdentifiers?: string[];
 }
+export interface Warnings {
+  UnrecognizedResourceTypes?: string[];
+}
 export interface GetTemplateSummaryOutput {
   Parameters?: ParameterDeclaration[];
   Description?: string;
@@ -1293,6 +1300,7 @@ export interface GetTemplateSummaryOutput {
   Metadata?: string;
   DeclaredTransforms?: string[];
   ResourceIdentifierSummaries?: ResourceIdentifierSummary[];
+  Warnings?: Warnings;
 }
 export interface ImportStacksToStackSetInput {
   StackSetName: string | undefined;

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.370.0",
+  "version": "3.373.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",