feat(client-cloudformation): ListHookResults API now supports retrieving invocation results for all CloudFormation Hooks (previously limited to create change set and Cloud Control operations) with new optional parameters for filtering by Hook status and ARN.

Author: awstools

clients/client-cloudformation/src/CloudFormation.ts

@@ -1337,6 +1337,7 @@ export interface CloudFormation {
   /**
    * @see {@link ListHookResultsCommand}
    */
+  listHookResults(): Promise<ListHookResultsCommandOutput>;
   listHookResults(
     args: ListHookResultsCommandInput,
     options?: __HttpHandlerOptions

clients/client-cloudformation/src/commands/ActivateTypeCommand.ts

@@ -28,10 +28,18 @@ export interface ActivateTypeCommandInput extends ActivateTypeInput {}
 export interface ActivateTypeCommandOutput extends ActivateTypeOutput, __MetadataBearer {}
 
 /**
- * <p>Activates a public third-party extension, making it available for use in stack templates.
- *       Once you have activated a public third-party extension in your account and Region, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html">SetTypeConfiguration</a> to specify configuration properties for the extension. For
- *       more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html">Using public
- *         extensions</a> in the <i>CloudFormation User Guide</i>.</p>
+ * <p>Activates a public third-party extension, such as a resource or module, to make it
+ *       available for use in stack templates in your current account and Region. It can also create
+ *       CloudFormation Hooks, which allow you to evaluate resource configurations before CloudFormation
+ *       provisions them. Hooks integrate with both CloudFormation and Cloud Control API operations.</p>
+ *          <p>After you activate an extension, you can use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html">SetTypeConfiguration</a> to set specific properties for the extension.</p>
+ *          <p>To see which extensions have been activated, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListTypes.html">ListTypes</a>. To see
+ *       configuration details for an extension, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html">DescribeType</a>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public-activate-extension.html">Activate a
+ *         third-party public extension in your account</a> in the
+ *         <i>CloudFormation User Guide</i>. For information about creating Hooks, see the
+ *         <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/what-is-cloudformation-hooks.html">CloudFormation
+ *         Hooks User Guide</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cloudformation/src/commands/BatchDescribeTypeConfigurationsCommand.ts

@@ -34,7 +34,7 @@ export interface BatchDescribeTypeConfigurationsCommandOutput
 
 /**
  * <p>Returns configuration data for the specified CloudFormation extensions, from the CloudFormation
- *       registry for the account and Region.</p>
+ *       registry in your current account and Region.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html">Edit configuration
  *         data for extensions in your account</a> in the
  *       <i>CloudFormation User Guide</i>.</p>

clients/client-cloudformation/src/commands/ContinueUpdateRollbackCommand.ts

@@ -28,16 +28,18 @@ export interface ContinueUpdateRollbackCommandInput extends ContinueUpdateRollba
 export interface ContinueUpdateRollbackCommandOutput extends ContinueUpdateRollbackOutput, __MetadataBearer {}
 
 /**
- * <p>For a specified stack that's in the <code>UPDATE_ROLLBACK_FAILED</code> state, continues
- *       rolling it back to the <code>UPDATE_ROLLBACK_COMPLETE</code> state. Depending on the cause of
- *       the failure, you can manually <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed">fix the error</a> and continue the rollback. By continuing the rollback, you can return
- *       your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and then try
+ * <p>Continues rolling back a stack from <code>UPDATE_ROLLBACK_FAILED</code> to
+ *         <code>UPDATE_ROLLBACK_COMPLETE</code> state. Depending on the cause of the failure, you can
+ *       manually fix the error and continue the rollback. By continuing the rollback, you can return
+ *       your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state) and then try
  *       to update the stack again.</p>
- *          <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when CloudFormation can't roll
- *       back all changes after a failed stack update. For example, you might have a stack that's
- *       rolling back to an old database instance that was deleted outside of CloudFormation. Because
- *       CloudFormation doesn't know the database was deleted, it assumes that the database instance still
- *       exists and attempts to roll back to it, causing the update rollback to fail.</p>
+ *          <p>A stack enters the <code>UPDATE_ROLLBACK_FAILED</code> state when CloudFormation can't roll
+ *       back all changes after a failed stack update. For example, this might occur when a stack
+ *       attempts to roll back to an old database that was deleted outside of CloudFormation. Because
+ *       CloudFormation doesn't know the instance was deleted, it assumes the instance still exists and
+ *       attempts to roll back to it, causing the update rollback to fail.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-continueupdaterollback.html">Continue rolling back an update</a> in the <i>CloudFormation User Guide</i>. For
+ *       information for troubleshooting a failed update rollback, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed">Update rollback failed</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cloudformation/src/commands/CreateStackInstancesCommand.ts

@@ -122,14 +122,14 @@ export interface CreateStackInstancesCommandOutput extends CreateStackInstancesO
  *  <p>The specified operation ID already exists.</p>
  *
  * @throws {@link OperationInProgressException} (client fault)
- *  <p>Another operation is currently in progress for this stack set. Only one operation can be performed for a stack
+ *  <p>Another operation is currently in progress for this StackSet. Only one operation can be performed for a stack
  *    set at a given time.</p>
  *
  * @throws {@link StackSetNotFoundException} (client fault)
- *  <p>The specified stack set doesn't exist.</p>
+ *  <p>The specified StackSet doesn't exist.</p>
  *
  * @throws {@link StaleRequestException} (client fault)
- *  <p>Another operation has been performed on this stack set since the specified operation was performed.</p>
+ *  <p>Another operation has been performed on this StackSet since the specified operation was performed.</p>
  *
  * @throws {@link CloudFormationServiceException}
  * <p>Base exception class for all service exceptions from CloudFormation service.</p>

clients/client-cloudformation/src/commands/CreateStackSetCommand.ts

@@ -28,7 +28,7 @@ export interface CreateStackSetCommandInput extends CreateStackSetInput {}
 export interface CreateStackSetCommandOutput extends CreateStackSetOutput, __MetadataBearer {}
 
 /**
- * <p>Creates a stack set.</p>
+ * <p>Creates a StackSet.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cloudformation/src/commands/DeactivateTypeCommand.ts

@@ -28,12 +28,15 @@ export interface DeactivateTypeCommandInput extends DeactivateTypeInput {}
 export interface DeactivateTypeCommandOutput extends DeactivateTypeOutput, __MetadataBearer {}
 
 /**
- * <p>Deactivates a public extension that was previously activated in this account and
- *       Region.</p>
+ * <p>Deactivates a public third-party extension, such as a resource or module, or a CloudFormation
+ *       Hook when you no longer use it.</p>
+ *          <p>Deactivating an extension deletes the configuration details that are associated with it.
+ *       To temporary disable a CloudFormation Hook instead, you can use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html">SetTypeConfiguration</a>.</p>
  *          <p>Once deactivated, an extension can't be used in any CloudFormation operation. This includes
  *       stack update operations where the stack template includes the extension, even if no updates
  *       are being made to the extension. In addition, deactivated extensions aren't automatically
  *       updated if a new version of the extension is released.</p>
+ *          <p>To see which extensions are currently activated, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListTypes.html">ListTypes</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cloudformation/src/commands/DeleteStackInstancesCommand.ts

@@ -107,14 +107,14 @@ export interface DeleteStackInstancesCommandOutput extends DeleteStackInstancesO
  *  <p>The specified operation ID already exists.</p>
  *
  * @throws {@link OperationInProgressException} (client fault)
- *  <p>Another operation is currently in progress for this stack set. Only one operation can be performed for a stack
+ *  <p>Another operation is currently in progress for this StackSet. Only one operation can be performed for a stack
  *    set at a given time.</p>
  *
  * @throws {@link StackSetNotFoundException} (client fault)
- *  <p>The specified stack set doesn't exist.</p>
+ *  <p>The specified StackSet doesn't exist.</p>
  *
  * @throws {@link StaleRequestException} (client fault)
- *  <p>Another operation has been performed on this stack set since the specified operation was performed.</p>
+ *  <p>Another operation has been performed on this StackSet since the specified operation was performed.</p>
  *
  * @throws {@link CloudFormationServiceException}
  * <p>Base exception class for all service exceptions from CloudFormation service.</p>

clients/client-cloudformation/src/commands/DeleteStackSetCommand.ts

@@ -28,8 +28,8 @@ export interface DeleteStackSetCommandInput extends DeleteStackSetInput {}
 export interface DeleteStackSetCommandOutput extends DeleteStackSetOutput, __MetadataBearer {}
 
 /**
- * <p>Deletes a stack set. Before you can delete a stack set, all its member stack instances
- *       must be deleted. For more information about how to complete this, see <a>DeleteStackInstances</a>.</p>
+ * <p>Deletes a StackSet. Before you can delete a StackSet, all its member stack instances must
+ *       be deleted. For more information about how to complete this, see <a>DeleteStackInstances</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,12 +53,12 @@ export interface DeleteStackSetCommandOutput extends DeleteStackSetOutput, __Met
  * @see {@link CloudFormationClientResolvedConfig | config} for CloudFormationClient's `config` shape.
  *
  * @throws {@link OperationInProgressException} (client fault)
- *  <p>Another operation is currently in progress for this stack set. Only one operation can be performed for a stack
+ *  <p>Another operation is currently in progress for this StackSet. Only one operation can be performed for a stack
  *    set at a given time.</p>
  *
  * @throws {@link StackSetNotEmptyException} (client fault)
- *  <p>You can't yet delete this stack set, because it still contains one or more stack instances. Delete all stack
- *    instances from the stack set before deleting the stack set.</p>
+ *  <p>You can't yet delete this StackSet, because it still contains one or more stack instances. Delete all stack
+ *    instances from the StackSet before deleting the StackSet.</p>
  *
  * @throws {@link CloudFormationServiceException}
  * <p>Base exception class for all service exceptions from CloudFormation service.</p>

clients/client-cloudformation/src/commands/DeregisterTypeCommand.ts

@@ -39,6 +39,9 @@ export interface DeregisterTypeCommandOutput extends DeregisterTypeOutput, __Met
  *       of that extension. If you do deregister the default version of an extension, the extension
  *       type itself is deregistered as well and marked as deprecated.</p>
  *          <p>To view the deprecation status of an extension or extension version, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html">DescribeType</a>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-private-deregister-extension.html">Remove
+ *         third-party private extensions from your account</a> in the
+ *         <i>CloudFormation User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript