feat(client-cloudformation): Added support for UNKNOWN drift status.

awstools · awstools · commit 80c8e5fb703d · 2025-06-30T18:36:45.000Z
diff --git a/clients/client-cloudformation/src/commands/CreateStackInstancesCommand.ts b/clients/client-cloudformation/src/commands/CreateStackInstancesCommand.ts
@@ -32,6 +32,24 @@ export interface CreateStackInstancesCommandOutput extends CreateStackInstancesO
  *       stack instance refers to a stack in a specific account and Region. You must specify at least
  *       one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you must
  *       specify at least one value for <code>Regions</code>.</p>
+ *          <note>
+ *             <p>The maximum number of organizational unit (OUs) supported by a
+ *           <code>CreateStackInstances</code> operation is 50.</p>
+ *             <p>If you need more than 50, consider the following options:</p>
+ *             <ul>
+ *                <li>
+ *                   <p>
+ *                      <i>Batch processing:</i> If you don't want to expose your OU
+ *             hierarchy, split up the operations into multiple calls with less than 50 OUs
+ *             each.</p>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <i>Parent OU strategy:</i> If you don't mind exposing the OU
+ *             hierarchy, target a parent OU that contains all desired child OUs.</p>
+ *                </li>
+ *             </ul>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/DeleteStackInstancesCommand.ts b/clients/client-cloudformation/src/commands/DeleteStackInstancesCommand.ts
@@ -29,6 +29,24 @@ export interface DeleteStackInstancesCommandOutput extends DeleteStackInstancesO
 
 /**
  * <p>Deletes stack instances for the specified accounts, in the specified Amazon Web Services Regions.</p>
+ *          <note>
+ *             <p>The maximum number of organizational unit (OUs) supported by a
+ *           <code>DeleteStackInstances</code> operation is 50.</p>
+ *             <p>If you need more than 50, consider the following options:</p>
+ *             <ul>
+ *                <li>
+ *                   <p>
+ *                      <i>Batch processing:</i> If you don't want to expose your OU
+ *             hierarchy, split up the operations into multiple calls with less than 50 OUs
+ *             each.</p>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <i>Parent OU strategy:</i> If you don't mind exposing the OU
+ *             hierarchy, target a parent OU that contains all desired child OUs.</p>
+ *                </li>
+ *             </ul>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/DescribeStackResourceCommand.ts b/clients/client-cloudformation/src/commands/DescribeStackResourceCommand.ts
@@ -56,7 +56,7 @@ export interface DescribeStackResourceCommandOutput extends DescribeStackResourc
  * //     Description: "STRING_VALUE",
  * //     Metadata: "STRING_VALUE",
  * //     DriftInformation: { // StackResourceDriftInformation
- * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //       LastCheckTimestamp: new Date("TIMESTAMP"),
  * //     },
  * //     ModuleInfo: { // ModuleInfo
diff --git a/clients/client-cloudformation/src/commands/DescribeStackResourceDriftsCommand.ts b/clients/client-cloudformation/src/commands/DescribeStackResourceDriftsCommand.ts
@@ -48,7 +48,7 @@ export interface DescribeStackResourceDriftsCommandOutput extends DescribeStackR
  * const input = { // DescribeStackResourceDriftsInput
  *   StackName: "STRING_VALUE", // required
  *   StackResourceDriftStatusFilters: [ // StackResourceDriftStatusFilters
- *     "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED",
+ *     "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN",
  *   ],
  *   NextToken: "STRING_VALUE",
  *   MaxResults: Number("int"),
@@ -78,12 +78,13 @@ export interface DescribeStackResourceDriftsCommandOutput extends DescribeStackR
  * //           DifferenceType: "ADD" || "REMOVE" || "NOT_EQUAL", // required
  * //         },
  * //       ],
- * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //       Timestamp: new Date("TIMESTAMP"), // required
  * //       ModuleInfo: { // ModuleInfo
  * //         TypeHierarchy: "STRING_VALUE",
  * //         LogicalIdHierarchy: "STRING_VALUE",
  * //       },
+ * //       DriftStatusReason: "STRING_VALUE",
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",
diff --git a/clients/client-cloudformation/src/commands/DescribeStackResourcesCommand.ts b/clients/client-cloudformation/src/commands/DescribeStackResourcesCommand.ts
@@ -72,7 +72,7 @@ export interface DescribeStackResourcesCommandOutput extends DescribeStackResour
  * //       ResourceStatusReason: "STRING_VALUE",
  * //       Description: "STRING_VALUE",
  * //       DriftInformation: { // StackResourceDriftInformation
- * //         StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //         StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //         LastCheckTimestamp: new Date("TIMESTAMP"),
  * //       },
  * //       ModuleInfo: { // ModuleInfo
diff --git a/clients/client-cloudformation/src/commands/DescribeStackSetCommand.ts b/clients/client-cloudformation/src/commands/DescribeStackSetCommand.ts
@@ -29,6 +29,10 @@ export interface DescribeStackSetCommandOutput extends DescribeStackSetOutput, _
 
 /**
  * <p>Returns the description of the specified StackSet.</p>
+ *          <note>
+ *             <p>This API provides <i>strongly consistent</i> reads meaning it will always
+ *         return the most up-to-date data.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/DescribeStackSetOperationCommand.ts b/clients/client-cloudformation/src/commands/DescribeStackSetOperationCommand.ts
@@ -29,6 +29,10 @@ export interface DescribeStackSetOperationCommandOutput extends DescribeStackSet
 
 /**
  * <p>Returns the description of the specified StackSet operation.</p>
+ *          <note>
+ *             <p>This API provides <i>strongly consistent</i> reads meaning it will always
+ *         return the most up-to-date data.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/DetectStackResourceDriftCommand.ts b/clients/client-cloudformation/src/commands/DetectStackResourceDriftCommand.ts
@@ -75,12 +75,13 @@ export interface DetectStackResourceDriftCommandOutput extends DetectStackResour
  * //         DifferenceType: "ADD" || "REMOVE" || "NOT_EQUAL", // required
  * //       },
  * //     ],
- * //     StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //     StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //     Timestamp: new Date("TIMESTAMP"), // required
  * //     ModuleInfo: { // ModuleInfo
  * //       TypeHierarchy: "STRING_VALUE",
  * //       LogicalIdHierarchy: "STRING_VALUE",
  * //     },
+ * //     DriftStatusReason: "STRING_VALUE",
  * //   },
  * // };
  *
diff --git a/clients/client-cloudformation/src/commands/ListStackInstanceResourceDriftsCommand.ts b/clients/client-cloudformation/src/commands/ListStackInstanceResourceDriftsCommand.ts
@@ -51,7 +51,7 @@ export interface ListStackInstanceResourceDriftsCommandOutput
  *   NextToken: "STRING_VALUE",
  *   MaxResults: Number("int"),
  *   StackInstanceResourceDriftStatuses: [ // StackResourceDriftStatusFilters
- *     "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED",
+ *     "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN",
  *   ],
  *   StackInstanceAccount: "STRING_VALUE", // required
  *   StackInstanceRegion: "STRING_VALUE", // required
@@ -81,7 +81,7 @@ export interface ListStackInstanceResourceDriftsCommandOutput
  * //           DifferenceType: "ADD" || "REMOVE" || "NOT_EQUAL", // required
  * //         },
  * //       ],
- * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //       StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //       Timestamp: new Date("TIMESTAMP"), // required
  * //     },
  * //   ],
diff --git a/clients/client-cloudformation/src/commands/ListStackResourcesCommand.ts b/clients/client-cloudformation/src/commands/ListStackResourcesCommand.ts
@@ -53,7 +53,7 @@ export interface ListStackResourcesCommandOutput extends ListStackResourcesOutpu
  * //       ResourceStatus: "CREATE_IN_PROGRESS" || "CREATE_FAILED" || "CREATE_COMPLETE" || "DELETE_IN_PROGRESS" || "DELETE_FAILED" || "DELETE_COMPLETE" || "DELETE_SKIPPED" || "UPDATE_IN_PROGRESS" || "UPDATE_FAILED" || "UPDATE_COMPLETE" || "IMPORT_FAILED" || "IMPORT_COMPLETE" || "IMPORT_IN_PROGRESS" || "IMPORT_ROLLBACK_IN_PROGRESS" || "IMPORT_ROLLBACK_FAILED" || "IMPORT_ROLLBACK_COMPLETE" || "EXPORT_FAILED" || "EXPORT_COMPLETE" || "EXPORT_IN_PROGRESS" || "EXPORT_ROLLBACK_IN_PROGRESS" || "EXPORT_ROLLBACK_FAILED" || "EXPORT_ROLLBACK_COMPLETE" || "UPDATE_ROLLBACK_IN_PROGRESS" || "UPDATE_ROLLBACK_COMPLETE" || "UPDATE_ROLLBACK_FAILED" || "ROLLBACK_IN_PROGRESS" || "ROLLBACK_COMPLETE" || "ROLLBACK_FAILED", // required
  * //       ResourceStatusReason: "STRING_VALUE",
  * //       DriftInformation: { // StackResourceDriftInformationSummary
- * //         StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED", // required
+ * //         StackResourceDriftStatus: "IN_SYNC" || "MODIFIED" || "DELETED" || "NOT_CHECKED" || "UNKNOWN", // required
  * //         LastCheckTimestamp: new Date("TIMESTAMP"),
  * //       },
  * //       ModuleInfo: { // ModuleInfo
diff --git a/clients/client-cloudformation/src/commands/ListStackSetOperationResultsCommand.ts b/clients/client-cloudformation/src/commands/ListStackSetOperationResultsCommand.ts
@@ -31,6 +31,10 @@ export interface ListStackSetOperationResultsCommandOutput
 
 /**
  * <p>Returns summary information about the results of a stack set operation.</p>
+ *          <note>
+ *             <p>This API provides <i>eventually consistent</i> reads meaning it may take
+ *         some time but will eventually return the most up-to-date data.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/ListStackSetOperationsCommand.ts b/clients/client-cloudformation/src/commands/ListStackSetOperationsCommand.ts
@@ -29,6 +29,10 @@ export interface ListStackSetOperationsCommandOutput extends ListStackSetOperati
 
 /**
  * <p>Returns summary information about operations performed on a stack set.</p>
+ *          <note>
+ *             <p>This API provides <i>eventually consistent</i> reads meaning it may take
+ *         some time but will eventually return the most up-to-date data.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/ListStackSetsCommand.ts b/clients/client-cloudformation/src/commands/ListStackSetsCommand.ts
@@ -29,6 +29,10 @@ export interface ListStackSetsCommandOutput extends ListStackSetsOutput, __Metad
 
 /**
  * <p>Returns summary information about stack sets that are associated with the user.</p>
+ *          <note>
+ *             <p>This API provides <i>strongly consistent</i> reads meaning it will always
+ *         return the most up-to-date data.</p>
+ *          </note>
  *          <ul>
  *             <li>
  *                <p>[Self-managed permissions] If you set the <code>CallAs</code> parameter to
diff --git a/clients/client-cloudformation/src/commands/UpdateStackInstancesCommand.ts b/clients/client-cloudformation/src/commands/UpdateStackInstancesCommand.ts
@@ -42,6 +42,24 @@ export interface UpdateStackInstancesCommandOutput extends UpdateStackInstancesO
  *       parameter value specified in the stack set. Once a stack instance has been updated with the
  *       new parameter, you can then override the parameter value using
  *         <code>UpdateStackInstances</code>.</p>
+ *          <note>
+ *             <p>The maximum number of organizational unit (OUs) supported by a
+ *           <code>UpdateStackInstances</code> operation is 50.</p>
+ *             <p>If you need more than 50, consider the following options:</p>
+ *             <ul>
+ *                <li>
+ *                   <p>
+ *                      <i>Batch processing:</i> If you don't want to expose your OU
+ *             hierarchy, split up the operations into multiple calls with less than 50 OUs
+ *             each.</p>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <i>Parent OU strategy:</i> If you don't mind exposing the OU
+ *             hierarchy, target a parent OU that contains all desired child OUs.</p>
+ *                </li>
+ *             </ul>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/commands/UpdateStackSetCommand.ts b/clients/client-cloudformation/src/commands/UpdateStackSetCommand.ts
@@ -34,6 +34,24 @@ export interface UpdateStackSetCommandOutput extends UpdateStackSetOutput, __Met
  *       partially, below or above a specified failure tolerance), the stack set is updated with your
  *       changes. Subsequent <a>CreateStackInstances</a> calls on the specified stack set
  *       use the updated stack set.</p>
+ *          <note>
+ *             <p>The maximum number of organizational unit (OUs) supported by a
+ *           <code>UpdateStackSet</code> operation is 50.</p>
+ *             <p>If you need more than 50, consider the following options:</p>
+ *             <ul>
+ *                <li>
+ *                   <p>
+ *                      <i>Batch processing:</i> If you don't want to expose your OU
+ *             hierarchy, split up the operations into multiple calls with less than 50 OUs
+ *             each.</p>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <i>Parent OU strategy:</i> If you don't mind exposing the OU
+ *             hierarchy, target a parent OU that contains all desired child OUs.</p>
+ *                </li>
+ *             </ul>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-cloudformation/src/models/models_0.ts b/clients/client-cloudformation/src/models/models_0.ts
diff --git a/clients/client-cloudformation/src/models/models_1.ts b/clients/client-cloudformation/src/models/models_1.ts
diff --git a/clients/client-cloudformation/src/protocols/Aws_query.ts b/clients/client-cloudformation/src/protocols/Aws_query.ts
diff --git a/codegen/sdk-codegen/aws-models/cloudformation.json b/codegen/sdk-codegen/aws-models/cloudformation.json
