aws-sdk-cloudformation 1.123.0 → 1.124.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8ba1e28ca58dee3beb4c9e311fa9e6a40c45f1d43126694dbdde941570b6b48
-  data.tar.gz: 4bae7c8ab299aebed25035e617ecc30ad8a4966b1688f3c640d4d966155fd25d
+  metadata.gz: 8bdd3d5975dcb139c127173dd3b5d431adb8bc47f62970309be16d8de0ddbc91
+  data.tar.gz: 12c39c5abe49f714f890ac526b813aaf162720af86c9f4ad4b96bf9325890daf
 SHA512:
-  metadata.gz: 6e9f064b61689d3d70baeb2f290a5dab1da6d46afa1232aa9cefa9de075289c49d4c62e3db23d611472cbdad515fceaf786a7c6f8804218c90f01127a2d59a71
-  data.tar.gz: 910a4a68a70d54438f075a61b873980243fbfecb29f65a73cb69dbb9baa2939a663fce59fd128674adf7e492e5a8cd1338e0f2afc8c87ad5e733f01c71f04404
+  metadata.gz: 8c180cd4c785451e040eb3801d43984f573e98fbaeb80bc86303557de9c13ff52ea0b25f8e62b08af71a99b0ed5e0ce2b62221dbd9e0e5b5ae5a41af246a9f6e
+  data.tar.gz: 291d17944972821403dfb86cf76017f83e72ca3be9de2785d1e35eb95167f4d8379081b7cd1393d8b54c4974e0b5d2bd9340b4c4c5744a400f6d1baaaa0c4c24

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.124.0 (2024-11-18)
+------------------
+
+* Feature - This release adds a new API, ListHookResults, that allows retrieving CloudFormation Hooks invocation results for hooks invoked during a create change set operation or Cloud Control API operation
+
 1.123.0 (2024-11-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.123.0
+1.124.0

data/lib/aws-sdk-cloudformation/client.rb

@@ -892,7 +892,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we suggest that you
     #     review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -910,7 +909,6 @@ module Aws::CloudFormation
     #     * [ AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -1347,7 +1345,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -1365,7 +1362,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -1808,7 +1804,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -1826,7 +1821,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -4962,6 +4956,67 @@ module Aws::CloudFormation
       req.send_request(options)
     end
 
+    # Returns summaries of invoked Hooks when a change set or Cloud Control
+    # API operation target is provided.
+    #
+    # @option params [required, String] :target_type
+    #   The type of operation being targeted by the Hook.
+    #
+    # @option params [required, String] :target_id
+    #   The logical ID of the target the operation is acting on by the Hook.
+    #   If the target is a change set, it's the ARN of the change set.
+    #
+    #   If the target is a Cloud Control API operation, this will be the
+    #   `HookRequestToken` returned by the Cloud Control API operation
+    #   request. For more information on the `HookRequestToken`, see
+    #   [ProgressEvent][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
+    #
+    # @option params [String] :next_token
+    #   A string that identifies the next page of events that you want to
+    #   retrieve.
+    #
+    # @return [Types::ListHookResultsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListHookResultsOutput#target_type #target_type} => String
+    #   * {Types::ListHookResultsOutput#target_id #target_id} => String
+    #   * {Types::ListHookResultsOutput#hook_results #hook_results} => Array<Types::HookResultSummary>
+    #   * {Types::ListHookResultsOutput#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_hook_results({
+    #     target_type: "CHANGE_SET", # required, accepts CHANGE_SET, STACK, RESOURCE, CLOUD_CONTROL
+    #     target_id: "HookResultId", # required
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.target_type #=> String, one of "CHANGE_SET", "STACK", "RESOURCE", "CLOUD_CONTROL"
+    #   resp.target_id #=> String
+    #   resp.hook_results #=> Array
+    #   resp.hook_results[0].invocation_point #=> String, one of "PRE_PROVISION"
+    #   resp.hook_results[0].failure_mode #=> String, one of "FAIL", "WARN"
+    #   resp.hook_results[0].type_name #=> String
+    #   resp.hook_results[0].type_version_id #=> String
+    #   resp.hook_results[0].type_configuration_version_id #=> String
+    #   resp.hook_results[0].status #=> String, one of "HOOK_IN_PROGRESS", "HOOK_COMPLETE_SUCCEEDED", "HOOK_COMPLETE_FAILED", "HOOK_FAILED"
+    #   resp.hook_results[0].hook_status_reason #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResults AWS API Documentation
+    #
+    # @overload list_hook_results(params = {})
+    # @param [Hash] params ({})
+    def list_hook_results(params = {}, options = {})
+      req = build_request(:list_hook_results, params)
+      req.send_request(options)
+    end
+
     # Lists all stacks that are importing an exported output value. To
     # modify or remove an exported output value, first use this action to
     # see which stacks are using it. To see the exported output values in
@@ -6201,7 +6256,6 @@ module Aws::CloudFormation
     #
     #     * Public extensions that you have activated in this account and
     #       Region.
-    #
     #   * `PUBLIC`: Extensions that are publicly visible and available to be
     #     activated within any Amazon Web Services account. This includes
     #     extensions from Amazon Web Services, in addition to third-party
@@ -7424,7 +7478,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we suggest that you
     #     review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -7442,7 +7495,6 @@ module Aws::CloudFormation
     #     * [ AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -7911,7 +7963,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -7929,7 +7980,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -8351,7 +8401,7 @@ module Aws::CloudFormation
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.123.0'
+      context[:gem_version] = '1.124.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudformation/client_api.rb

@@ -195,6 +195,10 @@ module Aws::CloudFormation
     HookFailureMode = Shapes::StringShape.new(name: 'HookFailureMode')
     HookInvocationCount = Shapes::IntegerShape.new(name: 'HookInvocationCount')
     HookInvocationPoint = Shapes::StringShape.new(name: 'HookInvocationPoint')
+    HookResultId = Shapes::StringShape.new(name: 'HookResultId')
+    HookResultNotFoundException = Shapes::StructureShape.new(name: 'HookResultNotFoundException', error: {"code"=>"HookResultNotFound", "httpStatusCode"=>404, "senderFault"=>true})
+    HookResultSummaries = Shapes::ListShape.new(name: 'HookResultSummaries')
+    HookResultSummary = Shapes::StructureShape.new(name: 'HookResultSummary')
     HookStatus = Shapes::StringShape.new(name: 'HookStatus')
     HookStatusReason = Shapes::StringShape.new(name: 'HookStatusReason')
     HookTargetType = Shapes::StringShape.new(name: 'HookTargetType')
@@ -234,6 +238,9 @@ module Aws::CloudFormation
     ListExportsOutput = Shapes::StructureShape.new(name: 'ListExportsOutput')
     ListGeneratedTemplatesInput = Shapes::StructureShape.new(name: 'ListGeneratedTemplatesInput')
     ListGeneratedTemplatesOutput = Shapes::StructureShape.new(name: 'ListGeneratedTemplatesOutput')
+    ListHookResultsInput = Shapes::StructureShape.new(name: 'ListHookResultsInput')
+    ListHookResultsOutput = Shapes::StructureShape.new(name: 'ListHookResultsOutput')
+    ListHookResultsTargetType = Shapes::StringShape.new(name: 'ListHookResultsTargetType')
     ListImportsInput = Shapes::StructureShape.new(name: 'ListImportsInput')
     ListImportsOutput = Shapes::StructureShape.new(name: 'ListImportsOutput')
     ListResourceScanRelatedResourcesInput = Shapes::StructureShape.new(name: 'ListResourceScanRelatedResourcesInput')
@@ -1170,6 +1177,19 @@ module Aws::CloudFormation
     GetTemplateSummaryOutput.add_member(:warnings, Shapes::ShapeRef.new(shape: Warnings, location_name: "Warnings"))
     GetTemplateSummaryOutput.struct_class = Types::GetTemplateSummaryOutput
 
+    HookResultNotFoundException.struct_class = Types::HookResultNotFoundException
+
+    HookResultSummaries.member = Shapes::ShapeRef.new(shape: HookResultSummary)
+
+    HookResultSummary.add_member(:invocation_point, Shapes::ShapeRef.new(shape: HookInvocationPoint, location_name: "InvocationPoint"))
+    HookResultSummary.add_member(:failure_mode, Shapes::ShapeRef.new(shape: HookFailureMode, location_name: "FailureMode"))
+    HookResultSummary.add_member(:type_name, Shapes::ShapeRef.new(shape: HookTypeName, location_name: "TypeName"))
+    HookResultSummary.add_member(:type_version_id, Shapes::ShapeRef.new(shape: HookTypeVersionId, location_name: "TypeVersionId"))
+    HookResultSummary.add_member(:type_configuration_version_id, Shapes::ShapeRef.new(shape: HookTypeConfigurationVersionId, location_name: "TypeConfigurationVersionId"))
+    HookResultSummary.add_member(:status, Shapes::ShapeRef.new(shape: HookStatus, location_name: "Status"))
+    HookResultSummary.add_member(:hook_status_reason, Shapes::ShapeRef.new(shape: HookStatusReason, location_name: "HookStatusReason"))
+    HookResultSummary.struct_class = Types::HookResultSummary
+
     ImportStacksToStackSetInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, required: true, location_name: "StackSetName"))
     ImportStacksToStackSetInput.add_member(:stack_ids, Shapes::ShapeRef.new(shape: StackIdList, location_name: "StackIds"))
     ImportStacksToStackSetInput.add_member(:stack_ids_url, Shapes::ShapeRef.new(shape: StackIdsUrl, location_name: "StackIdsUrl"))
@@ -1222,6 +1242,17 @@ module Aws::CloudFormation
     ListGeneratedTemplatesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListGeneratedTemplatesOutput.struct_class = Types::ListGeneratedTemplatesOutput
 
+    ListHookResultsInput.add_member(:target_type, Shapes::ShapeRef.new(shape: ListHookResultsTargetType, required: true, location_name: "TargetType"))
+    ListHookResultsInput.add_member(:target_id, Shapes::ShapeRef.new(shape: HookResultId, required: true, location_name: "TargetId"))
+    ListHookResultsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListHookResultsInput.struct_class = Types::ListHookResultsInput
+
+    ListHookResultsOutput.add_member(:target_type, Shapes::ShapeRef.new(shape: ListHookResultsTargetType, location_name: "TargetType"))
+    ListHookResultsOutput.add_member(:target_id, Shapes::ShapeRef.new(shape: HookResultId, location_name: "TargetId"))
+    ListHookResultsOutput.add_member(:hook_results, Shapes::ShapeRef.new(shape: HookResultSummaries, location_name: "HookResults"))
+    ListHookResultsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListHookResultsOutput.struct_class = Types::ListHookResultsOutput
+
     ListImportsInput.add_member(:export_name, Shapes::ShapeRef.new(shape: ExportName, required: true, location_name: "ExportName"))
     ListImportsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListImportsInput.struct_class = Types::ListImportsInput
@@ -2723,6 +2754,15 @@ module Aws::CloudFormation
         )
       end)
 
+      api.add_operation(:list_hook_results, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListHookResults"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListHookResultsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListHookResultsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: HookResultNotFoundException)
+      end)
+
       api.add_operation(:list_imports, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListImports"
         o.http_method = "POST"

data/lib/aws-sdk-cloudformation/errors.rb

@@ -33,6 +33,7 @@ module Aws::CloudFormation
   # * {ConcurrentResourcesLimitExceededException}
   # * {CreatedButModifiedException}
   # * {GeneratedTemplateNotFoundException}
+  # * {HookResultNotFoundException}
   # * {InsufficientCapabilitiesException}
   # * {InvalidChangeSetStatusException}
   # * {InvalidOperationException}
@@ -126,6 +127,16 @@ module Aws::CloudFormation
       end
     end
 
+    class HookResultNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::HookResultNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class InsufficientCapabilitiesException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-cloudformation/resource.rb

@@ -148,7 +148,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -166,7 +165,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #

data/lib/aws-sdk-cloudformation/stack.rb

@@ -540,7 +540,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -558,7 +557,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -902,7 +900,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities, CloudFormation
     #       returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we suggest that you
     #     review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -920,7 +917,6 @@ module Aws::CloudFormation
     #     * [ AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #

data/lib/aws-sdk-cloudformation/types.rb

@@ -777,7 +777,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities,
     #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we suggest that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -795,7 +794,6 @@ module Aws::CloudFormation
     #     * [ AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -1176,7 +1174,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities,
     #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -1194,7 +1191,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -1611,7 +1607,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities,
     #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -1629,7 +1624,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -4441,6 +4435,66 @@ module Aws::CloudFormation
       include Aws::Structure
     end
 
+    # The specified target doesn't have any requested Hook invocations.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookResultNotFoundException AWS API Documentation
+    #
+    class HookResultNotFoundException < Aws::EmptyStructure; end
+
+    # Describes a Hook invocation, its status, and the reason for its
+    # status.
+    #
+    # @!attribute [rw] invocation_point
+    #   The exact point in the provisioning logic where the Hook runs.
+    #   @return [String]
+    #
+    # @!attribute [rw] failure_mode
+    #   The failure mode of the invocation. The following are potential
+    #   modes:
+    #
+    #   * `FAIL`: If the hook invocation returns a failure, then the
+    #     requested target operation should fail.
+    #
+    #   * `WARN`: If the hook invocation returns a failure, then the
+    #     requested target operation should warn.
+    #   @return [String]
+    #
+    # @!attribute [rw] type_name
+    #   The type name of the Hook being invoked.
+    #   @return [String]
+    #
+    # @!attribute [rw] type_version_id
+    #   The version of the Hook being invoked.
+    #   @return [String]
+    #
+    # @!attribute [rw] type_configuration_version_id
+    #   The version of the Hook type configuration.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The state of the Hook invocation.
+    #   @return [String]
+    #
+    # @!attribute [rw] hook_status_reason
+    #   A description of the Hook results status. For example, if the Hook
+    #   result is in a `FAILED` state, this may contain additional
+    #   information for the `FAILED` state.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookResultSummary AWS API Documentation
+    #
+    class HookResultSummary < Struct.new(
+      :invocation_point,
+      :failure_mode,
+      :type_name,
+      :type_version_id,
+      :type_configuration_version_id,
+      :status,
+      :hook_status_reason)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] stack_set_name
     #   The name of the stack set. The name must be unique in the Region
     #   where you create your stack set.
@@ -4681,6 +4735,78 @@ module Aws::CloudFormation
       include Aws::Structure
     end
 
+    # @!attribute [rw] target_type
+    #   The type of operation being targeted by the Hook.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_id
+    #   The logical ID of the target the operation is acting on by the Hook.
+    #   If the target is a change set, it's the ARN of the change set.
+    #
+    #   If the target is a Cloud Control API operation, this will be the
+    #   `HookRequestToken` returned by the Cloud Control API operation
+    #   request. For more information on the `HookRequestToken`, see
+    #   [ProgressEvent][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   A string that identifies the next page of events that you want to
+    #   retrieve.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsInput AWS API Documentation
+    #
+    class ListHookResultsInput < Struct.new(
+      :target_type,
+      :target_id,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] target_type
+    #   The type of operation being targeted by the Hook.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_id
+    #   The logical ID of the target the operation is acting on by the Hook.
+    #   If the target is a change set, it's the ARN of the change set.
+    #
+    #   If the target is a Cloud Control API operation, this will be the
+    #   `HooksRequestToken` returned by the Cloud Control API operation
+    #   request. For more information on the `HooksRequestToken`, see
+    #   [ProgressEvent][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
+    #   @return [String]
+    #
+    # @!attribute [rw] hook_results
+    #   A list of `HookResultSummary` structures that provides the status
+    #   and Hook status reason for each Hook invocation for the specified
+    #   target.
+    #   @return [Array<Types::HookResultSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   Pagination token, `null` or empty if no more results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsOutput AWS API Documentation
+    #
+    class ListHookResultsOutput < Struct.new(
+      :target_type,
+      :target_id,
+      :hook_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] export_name
     #   The name of the exported output value. CloudFormation returns the
     #   stack names that are importing this value.
@@ -5695,7 +5821,6 @@ module Aws::CloudFormation
     #
     #     * Public extensions that you have activated in this account and
     #       Region.
-    #
     #   * `PUBLIC`: Extensions that are publicly visible and available to be
     #     activated within any Amazon Web Services account. This includes
     #     extensions from Amazon Web Services, in addition to third-party
@@ -7953,7 +8078,6 @@ module Aws::CloudFormation
     #     * The stack was part of a `CreateStackSet` or `UpdateStackSet`
     #       operation that failed or was stopped before the stack was
     #       created or updated.
-    #
     #   * `CURRENT`: The stack is currently up to date with the stack set.
     #   @return [String]
     #
@@ -8222,7 +8346,6 @@ module Aws::CloudFormation
     #     * The stack was part of a `CreateStackSet` or `UpdateStackSet`
     #       operation that failed or was stopped before the stack was
     #       created or updated.
-    #
     #   * `CURRENT`: The stack is currently up to date with the stack set.
     #   @return [String]
     #
@@ -10225,7 +10348,6 @@ module Aws::CloudFormation
     #
     #     * Public extensions from publishers other than Amazon, whether
     #       activated or not.
-    #
     #   * `AWS_TYPES`: Extensions available for use from Amazon.
     #   @return [String]
     #
@@ -10640,7 +10762,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities,
     #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we suggest that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -10658,7 +10779,6 @@ module Aws::CloudFormation
     #     * [ AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #
@@ -11079,7 +11199,6 @@ module Aws::CloudFormation
     #
     #     * If you don't specify either of these capabilities,
     #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
@@ -11097,7 +11216,6 @@ module Aws::CloudFormation
     #     * [AWS::IAM::User][6]
     #
     #     * [AWS::IAM::UserToGroupAddition][7]
-    #
     #     For more information, see [Acknowledging IAM resources in
     #     CloudFormation templates][8].
     #

data/lib/aws-sdk-cloudformation.rb

@@ -59,7 +59,7 @@ module Aws::CloudFormation
   autoload :StackResource, 'aws-sdk-cloudformation/stack_resource'
   autoload :StackResourceSummary, 'aws-sdk-cloudformation/stack_resource_summary'
 
-  GEM_VERSION = '1.123.0'
+  GEM_VERSION = '1.124.0'
 
 end
 

data/sig/client.rbs

@@ -929,6 +929,21 @@ module Aws
                                     ) -> _ListGeneratedTemplatesResponseSuccess
                                   | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListGeneratedTemplatesResponseSuccess
 
+      interface _ListHookResultsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListHookResultsOutput]
+        def target_type: () -> ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
+        def target_id: () -> ::String
+        def hook_results: () -> ::Array[Types::HookResultSummary]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudFormation/Client.html#list_hook_results-instance_method
+      def list_hook_results: (
+                               target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL"),
+                               target_id: ::String,
+                               ?next_token: ::String
+                             ) -> _ListHookResultsResponseSuccess
+                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListHookResultsResponseSuccess
+
       interface _ListImportsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListImportsOutput]
         def imports: () -> ::Array[::String]

data/sig/errors.rbs

@@ -24,6 +24,8 @@ module Aws
       end
       class GeneratedTemplateNotFoundException < ::Aws::Errors::ServiceError
       end
+      class HookResultNotFoundException < ::Aws::Errors::ServiceError
+      end
       class InsufficientCapabilitiesException < ::Aws::Errors::ServiceError
       end
       class InvalidChangeSetStatusException < ::Aws::Errors::ServiceError

data/sig/types.rbs

@@ -764,6 +764,20 @@ module Aws::CloudFormation
       SENSITIVE: []
     end
 
+    class HookResultNotFoundException < Aws::EmptyStructure
+    end
+
+    class HookResultSummary
+      attr_accessor invocation_point: ("PRE_PROVISION")
+      attr_accessor failure_mode: ("FAIL" | "WARN")
+      attr_accessor type_name: ::String
+      attr_accessor type_version_id: ::String
+      attr_accessor type_configuration_version_id: ::String
+      attr_accessor status: ("HOOK_IN_PROGRESS" | "HOOK_COMPLETE_SUCCEEDED" | "HOOK_COMPLETE_FAILED" | "HOOK_FAILED")
+      attr_accessor hook_status_reason: ::String
+      SENSITIVE: []
+    end
+
     class ImportStacksToStackSetInput
       attr_accessor stack_set_name: ::String
       attr_accessor stack_ids: ::Array[::String]
@@ -830,6 +844,21 @@ module Aws::CloudFormation
       SENSITIVE: []
     end
 
+    class ListHookResultsInput
+      attr_accessor target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
+      attr_accessor target_id: ::String
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class ListHookResultsOutput
+      attr_accessor target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
+      attr_accessor target_id: ::String
+      attr_accessor hook_results: ::Array[Types::HookResultSummary]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListImportsInput
       attr_accessor export_name: ::String
       attr_accessor next_token: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.123.0
+  version: 1.124.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-06 00:00:00.000000000 Z
+date: 2024-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core