aws-sdk-cloudformation 1.122.0 → 1.124.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f8eb1545fbc0d283589f5ec6d9cb5e0727d379d039ba63c24294206f80d19dd
-  data.tar.gz: 976cf56618dbabc6c72a191a17e4a8306349ac56282b0e6fdab5a92c8799f49f
+  metadata.gz: 8bdd3d5975dcb139c127173dd3b5d431adb8bc47f62970309be16d8de0ddbc91
+  data.tar.gz: 12c39c5abe49f714f890ac526b813aaf162720af86c9f4ad4b96bf9325890daf
 SHA512:
-  metadata.gz: 03cd7755610844fb86f1486aa0819d7a6feb635b1401346a45daf8e9351b2363ed60473e94bbd806d3ead4f04b99c3e6155c2988c6e0d06990bf2a30ee4b2e0f
-  data.tar.gz: 31e8d4878c1b9fa658f7ec36e30226810d3a49b12fb83b084432753267879546be4d499e684854a4cdd2f3c2a21c9c9d94effbe5d3768b1d46aa89ee47298943
+  metadata.gz: 8c180cd4c785451e040eb3801d43984f573e98fbaeb80bc86303557de9c13ff52ea0b25f8e62b08af71a99b0ed5e0ce2b62221dbd9e0e5b5ae5a41af246a9f6e
+  data.tar.gz: 291d17944972821403dfb86cf76017f83e72ca3be9de2785d1e35eb95167f4d8379081b7cd1393d8b54c4974e0b5d2bd9340b4c4c5744a400f6d1baaaa0c4c24

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 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)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.122.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.122.0
+1.124.0

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

@@ -661,9 +661,9 @@ module Aws::CloudFormation
     #   limit resource-level permissions and avoid returning a response when
     #   no parameter is sent in the request:
     #
-    #    `\{ "Version": "2012-10-17", "Statement": [\{ "Effect": "Deny",
+    #    `{ "Version": "2012-10-17", "Statement": [{ "Effect": "Deny",
     #   "Action": "cloudformation:DescribeStacks", "NotResource":
-    #   "arn:aws:cloudformation:*:*:stack/*/*" \}] \}`
+    #   "arn:aws:cloudformation:*:*:stack/*/*" }] }`
     #
     #    </note>
     #
@@ -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].
     #
@@ -3716,10 +3710,9 @@ module Aws::CloudFormation
     #   limit resource-level permissions and avoid returning a response when
     #   no parameter is sent in the request:
     #
-    #    \\\{ "Version": "2012-10-17", "Statement": \[\\\{ "Effect":
+    #    \{ "Version": "2012-10-17", "Statement": \[\{ "Effect":
     #   "Deny", "Action": "cloudformation:DescribeStacks",
-    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" \\}\]
-    #   \\}
+    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" }\] }
     #
     #    </note>
     #
@@ -4399,7 +4392,7 @@ module Aws::CloudFormation
     # @option params [required, String] :generated_template_name
     #   The name or Amazon Resource Name (ARN) of the generated template. The
     #   format is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:generatedtemplate/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}`.
     #   For example,
     #   `arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc
     #   `.
@@ -4963,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&lt;Types::HookResultSummary&gt;
+    #   * {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
@@ -6202,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
@@ -7425,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.
@@ -7443,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].
     #
@@ -7912,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.
@@ -7930,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].
     #
@@ -8352,7 +8401,7 @@ module Aws::CloudFormation
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.122.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].
     #
@@ -373,10 +371,9 @@ module Aws::CloudFormation
     #   limit resource-level permissions and avoid returning a response when
     #   no parameter is sent in the request:
     #
-    #    \\\{ "Version": "2012-10-17", "Statement": \[\\\{ "Effect":
+    #    \{ "Version": "2012-10-17", "Statement": \[\{ "Effect":
     #   "Deny", "Action": "cloudformation:DescribeStacks",
-    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" \\}\]
-    #   \\}
+    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" }\] }
     #
     #    </note>
     #

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

@@ -351,9 +351,9 @@ module Aws::CloudFormation
     #   limit resource-level permissions and avoid returning a response when
     #   no parameter is sent in the request:
     #
-    #    `\{ "Version": "2012-10-17", "Statement": [\{ "Effect": "Deny",
+    #    `{ "Version": "2012-10-17", "Statement": [{ "Effect": "Deny",
     #   "Action": "cloudformation:DescribeStacks", "NotResource":
-    #   "arn:aws:cloudformation:*:*:stack/*/*" \}] \}`
+    #   "arn:aws:cloudformation:*:*:stack/*/*" }] }`
     #
     #    </note>
     #
@@ -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].
     #
@@ -2557,7 +2551,7 @@ module Aws::CloudFormation
     # @!attribute [rw] generated_template_id
     #   The Amazon Resource Name (ARN) of the generated template. The format
     #   is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:generatedtemplate/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}`.
     #   For example,
     #   `arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc
     #   `.
@@ -2743,7 +2737,7 @@ module Aws::CloudFormation
 
     # @!attribute [rw] resource_scan_id
     #   The Amazon Resource Name (ARN) of the resource scan. The format is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:resourceScan/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:resourceScan/${Id}`.
     #   An example is
     #   `arn:aws:cloudformation:us-east-1:123456789012:resourceScan/f5b490f7-7ed4-428a-aa06-31ff25db0772
     #   `.
@@ -3333,10 +3327,9 @@ module Aws::CloudFormation
     #   limit resource-level permissions and avoid returning a response when
     #   no parameter is sent in the request:
     #
-    #    \\\{ "Version": "2012-10-17", "Statement": \[\\\{ "Effect":
+    #    \{ "Version": "2012-10-17", "Statement": \[\{ "Effect":
     #   "Deny", "Action": "cloudformation:DescribeStacks",
-    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" \\}\]
-    #   \\}
+    #   "NotResource": "arn:aws:cloudformation:*:*:stack/*/*" }\] }
     #
     #    </note>
     #
@@ -4132,7 +4125,7 @@ module Aws::CloudFormation
     # @!attribute [rw] generated_template_name
     #   The name or Amazon Resource Name (ARN) of the generated template.
     #   The format is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:generatedtemplate/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}`.
     #   For example,
     #   `arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc
     #   `.
@@ -4442,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.
@@ -4682,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.
@@ -5696,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
@@ -6668,16 +6792,16 @@ module Aws::CloudFormation
     #   entity groups:
     #
     #   * `ResourceReference` entities are `Ref` intrinsic functions that
-    #     refer to resources in the template, such as `\{ "Ref" :
-    #     "MyEC2InstanceResource" \}`.
+    #     refer to resources in the template, such as `{ "Ref" :
+    #     "MyEC2InstanceResource" }`.
     #
     #   * `ParameterReference` entities are `Ref` intrinsic functions that
-    #     get template parameter values, such as `\{ "Ref" :
-    #     "MyPasswordParameter" \}`.
+    #     get template parameter values, such as `{ "Ref" :
+    #     "MyPasswordParameter" }`.
     #
     #   * `ResourceAttribute` entities are `Fn::GetAtt` intrinsic functions
-    #     that get resource attribute values, such as `\{ "Fn::GetAtt" : [
-    #     "MyEC2InstanceResource", "PublicDnsName" ] \}`.
+    #     that get resource attribute values, such as `{ "Fn::GetAtt" : [
+    #     "MyEC2InstanceResource", "PublicDnsName" ] }`.
     #
     #   * `DirectModification` entities are changes that are made directly
     #     to the template.
@@ -7954,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]
     #
@@ -8223,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]
     #
@@ -9726,7 +9848,7 @@ module Aws::CloudFormation
 
     # @!attribute [rw] resource_scan_id
     #   The Amazon Resource Name (ARN) of the resource scan. The format is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:resourceScan/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:resourceScan/${Id}`.
     #   An example is
     #   `arn:aws:cloudformation:us-east-1:123456789012:resourceScan/f5b490f7-7ed4-428a-aa06-31ff25db0772
     #   `.
@@ -9920,7 +10042,7 @@ module Aws::CloudFormation
     # @!attribute [rw] generated_template_id
     #   The Amazon Resource Name (ARN) of the generated template. The format
     #   is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:generatedtemplate/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}`.
     #   For example,
     #   `arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc
     #   `.
@@ -10106,7 +10228,7 @@ module Aws::CloudFormation
     #   in this account and Region.
     #
     #   If a configuration hasn't been set for a specified extension,
-    #   CloudFormation returns `\{\}`.
+    #   CloudFormation returns `{}`.
     #   @return [String]
     #
     # @!attribute [rw] last_updated
@@ -10226,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]
     #
@@ -10536,7 +10657,7 @@ module Aws::CloudFormation
     # @!attribute [rw] generated_template_id
     #   The Amazon Resource Name (ARN) of the generated template. The format
     #   is
-    #   `arn:$\{Partition\}:cloudformation:$\{Region\}:$\{Account\}:generatedtemplate/$\{Id\}`.
+    #   `arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}`.
     #   For example,
     #   `arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc
     #   `.
@@ -10641,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.
@@ -10659,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].
     #
@@ -11080,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.
@@ -11098,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.122.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.122.0
+  version: 1.124.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-18 00:00:00.000000000 Z
+date: 2024-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core