aws-sdk-cloudformation 1.123.0 → 1.124.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c8ba1e28ca58dee3beb4c9e311fa9e6a40c45f1d43126694dbdde941570b6b48
4
- data.tar.gz: 4bae7c8ab299aebed25035e617ecc30ad8a4966b1688f3c640d4d966155fd25d
3
+ metadata.gz: 8bdd3d5975dcb139c127173dd3b5d431adb8bc47f62970309be16d8de0ddbc91
4
+ data.tar.gz: 12c39c5abe49f714f890ac526b813aaf162720af86c9f4ad4b96bf9325890daf
5
5
  SHA512:
6
- metadata.gz: 6e9f064b61689d3d70baeb2f290a5dab1da6d46afa1232aa9cefa9de075289c49d4c62e3db23d611472cbdad515fceaf786a7c6f8804218c90f01127a2d59a71
7
- data.tar.gz: 910a4a68a70d54438f075a61b873980243fbfecb29f65a73cb69dbb9baa2939a663fce59fd128674adf7e492e5a8cd1338e0f2afc8c87ad5e733f01c71f04404
6
+ metadata.gz: 8c180cd4c785451e040eb3801d43984f573e98fbaeb80bc86303557de9c13ff52ea0b25f8e62b08af71a99b0ed5e0ce2b62221dbd9e0e5b5ae5a41af246a9f6e
7
+ data.tar.gz: 291d17944972821403dfb86cf76017f83e72ca3be9de2785d1e35eb95167f4d8379081b7cd1393d8b54c4974e0b5d2bd9340b4c4c5744a400f6d1baaaa0c4c24
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.124.0 (2024-11-18)
5
+ ------------------
6
+
7
+ * 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
8
+
4
9
  1.123.0 (2024-11-06)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.123.0
1
+ 1.124.0
@@ -892,7 +892,6 @@ module Aws::CloudFormation
892
892
  #
893
893
  # * If you don't specify either of these capabilities, CloudFormation
894
894
  # returns an `InsufficientCapabilities` error.
895
- #
896
895
  # If your stack template contains these resources, we suggest that you
897
896
  # review all permissions associated with them and edit their
898
897
  # permissions if necessary.
@@ -910,7 +909,6 @@ module Aws::CloudFormation
910
909
  # * [ AWS::IAM::User][6]
911
910
  #
912
911
  # * [AWS::IAM::UserToGroupAddition][7]
913
- #
914
912
  # For more information, see [Acknowledging IAM resources in
915
913
  # CloudFormation templates][8].
916
914
  #
@@ -1347,7 +1345,6 @@ module Aws::CloudFormation
1347
1345
  #
1348
1346
  # * If you don't specify either of these capabilities, CloudFormation
1349
1347
  # returns an `InsufficientCapabilities` error.
1350
- #
1351
1348
  # If your stack template contains these resources, we recommend that
1352
1349
  # you review all permissions associated with them and edit their
1353
1350
  # permissions if necessary.
@@ -1365,7 +1362,6 @@ module Aws::CloudFormation
1365
1362
  # * [AWS::IAM::User][6]
1366
1363
  #
1367
1364
  # * [AWS::IAM::UserToGroupAddition][7]
1368
- #
1369
1365
  # For more information, see [Acknowledging IAM resources in
1370
1366
  # CloudFormation templates][8].
1371
1367
  #
@@ -1808,7 +1804,6 @@ module Aws::CloudFormation
1808
1804
  #
1809
1805
  # * If you don't specify either of these capabilities, CloudFormation
1810
1806
  # returns an `InsufficientCapabilities` error.
1811
- #
1812
1807
  # If your stack template contains these resources, we recommend that
1813
1808
  # you review all permissions associated with them and edit their
1814
1809
  # permissions if necessary.
@@ -1826,7 +1821,6 @@ module Aws::CloudFormation
1826
1821
  # * [AWS::IAM::User][6]
1827
1822
  #
1828
1823
  # * [AWS::IAM::UserToGroupAddition][7]
1829
- #
1830
1824
  # For more information, see [Acknowledging IAM resources in
1831
1825
  # CloudFormation templates][8].
1832
1826
  #
@@ -4962,6 +4956,67 @@ module Aws::CloudFormation
4962
4956
  req.send_request(options)
4963
4957
  end
4964
4958
 
4959
+ # Returns summaries of invoked Hooks when a change set or Cloud Control
4960
+ # API operation target is provided.
4961
+ #
4962
+ # @option params [required, String] :target_type
4963
+ # The type of operation being targeted by the Hook.
4964
+ #
4965
+ # @option params [required, String] :target_id
4966
+ # The logical ID of the target the operation is acting on by the Hook.
4967
+ # If the target is a change set, it's the ARN of the change set.
4968
+ #
4969
+ # If the target is a Cloud Control API operation, this will be the
4970
+ # `HookRequestToken` returned by the Cloud Control API operation
4971
+ # request. For more information on the `HookRequestToken`, see
4972
+ # [ProgressEvent][1].
4973
+ #
4974
+ #
4975
+ #
4976
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
4977
+ #
4978
+ # @option params [String] :next_token
4979
+ # A string that identifies the next page of events that you want to
4980
+ # retrieve.
4981
+ #
4982
+ # @return [Types::ListHookResultsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4983
+ #
4984
+ # * {Types::ListHookResultsOutput#target_type #target_type} => String
4985
+ # * {Types::ListHookResultsOutput#target_id #target_id} => String
4986
+ # * {Types::ListHookResultsOutput#hook_results #hook_results} => Array<Types::HookResultSummary>
4987
+ # * {Types::ListHookResultsOutput#next_token #next_token} => String
4988
+ #
4989
+ # @example Request syntax with placeholder values
4990
+ #
4991
+ # resp = client.list_hook_results({
4992
+ # target_type: "CHANGE_SET", # required, accepts CHANGE_SET, STACK, RESOURCE, CLOUD_CONTROL
4993
+ # target_id: "HookResultId", # required
4994
+ # next_token: "NextToken",
4995
+ # })
4996
+ #
4997
+ # @example Response structure
4998
+ #
4999
+ # resp.target_type #=> String, one of "CHANGE_SET", "STACK", "RESOURCE", "CLOUD_CONTROL"
5000
+ # resp.target_id #=> String
5001
+ # resp.hook_results #=> Array
5002
+ # resp.hook_results[0].invocation_point #=> String, one of "PRE_PROVISION"
5003
+ # resp.hook_results[0].failure_mode #=> String, one of "FAIL", "WARN"
5004
+ # resp.hook_results[0].type_name #=> String
5005
+ # resp.hook_results[0].type_version_id #=> String
5006
+ # resp.hook_results[0].type_configuration_version_id #=> String
5007
+ # resp.hook_results[0].status #=> String, one of "HOOK_IN_PROGRESS", "HOOK_COMPLETE_SUCCEEDED", "HOOK_COMPLETE_FAILED", "HOOK_FAILED"
5008
+ # resp.hook_results[0].hook_status_reason #=> String
5009
+ # resp.next_token #=> String
5010
+ #
5011
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResults AWS API Documentation
5012
+ #
5013
+ # @overload list_hook_results(params = {})
5014
+ # @param [Hash] params ({})
5015
+ def list_hook_results(params = {}, options = {})
5016
+ req = build_request(:list_hook_results, params)
5017
+ req.send_request(options)
5018
+ end
5019
+
4965
5020
  # Lists all stacks that are importing an exported output value. To
4966
5021
  # modify or remove an exported output value, first use this action to
4967
5022
  # see which stacks are using it. To see the exported output values in
@@ -6201,7 +6256,6 @@ module Aws::CloudFormation
6201
6256
  #
6202
6257
  # * Public extensions that you have activated in this account and
6203
6258
  # Region.
6204
- #
6205
6259
  # * `PUBLIC`: Extensions that are publicly visible and available to be
6206
6260
  # activated within any Amazon Web Services account. This includes
6207
6261
  # extensions from Amazon Web Services, in addition to third-party
@@ -7424,7 +7478,6 @@ module Aws::CloudFormation
7424
7478
  #
7425
7479
  # * If you don't specify either of these capabilities, CloudFormation
7426
7480
  # returns an `InsufficientCapabilities` error.
7427
- #
7428
7481
  # If your stack template contains these resources, we suggest that you
7429
7482
  # review all permissions associated with them and edit their
7430
7483
  # permissions if necessary.
@@ -7442,7 +7495,6 @@ module Aws::CloudFormation
7442
7495
  # * [ AWS::IAM::User][6]
7443
7496
  #
7444
7497
  # * [AWS::IAM::UserToGroupAddition][7]
7445
- #
7446
7498
  # For more information, see [Acknowledging IAM resources in
7447
7499
  # CloudFormation templates][8].
7448
7500
  #
@@ -7911,7 +7963,6 @@ module Aws::CloudFormation
7911
7963
  #
7912
7964
  # * If you don't specify either of these capabilities, CloudFormation
7913
7965
  # returns an `InsufficientCapabilities` error.
7914
- #
7915
7966
  # If your stack template contains these resources, we recommend that
7916
7967
  # you review all permissions associated with them and edit their
7917
7968
  # permissions if necessary.
@@ -7929,7 +7980,6 @@ module Aws::CloudFormation
7929
7980
  # * [AWS::IAM::User][6]
7930
7981
  #
7931
7982
  # * [AWS::IAM::UserToGroupAddition][7]
7932
- #
7933
7983
  # For more information, see [Acknowledging IAM resources in
7934
7984
  # CloudFormation templates][8].
7935
7985
  #
@@ -8351,7 +8401,7 @@ module Aws::CloudFormation
8351
8401
  tracer: tracer
8352
8402
  )
8353
8403
  context[:gem_name] = 'aws-sdk-cloudformation'
8354
- context[:gem_version] = '1.123.0'
8404
+ context[:gem_version] = '1.124.0'
8355
8405
  Seahorse::Client::Request.new(handlers, context)
8356
8406
  end
8357
8407
 
@@ -195,6 +195,10 @@ module Aws::CloudFormation
195
195
  HookFailureMode = Shapes::StringShape.new(name: 'HookFailureMode')
196
196
  HookInvocationCount = Shapes::IntegerShape.new(name: 'HookInvocationCount')
197
197
  HookInvocationPoint = Shapes::StringShape.new(name: 'HookInvocationPoint')
198
+ HookResultId = Shapes::StringShape.new(name: 'HookResultId')
199
+ HookResultNotFoundException = Shapes::StructureShape.new(name: 'HookResultNotFoundException', error: {"code"=>"HookResultNotFound", "httpStatusCode"=>404, "senderFault"=>true})
200
+ HookResultSummaries = Shapes::ListShape.new(name: 'HookResultSummaries')
201
+ HookResultSummary = Shapes::StructureShape.new(name: 'HookResultSummary')
198
202
  HookStatus = Shapes::StringShape.new(name: 'HookStatus')
199
203
  HookStatusReason = Shapes::StringShape.new(name: 'HookStatusReason')
200
204
  HookTargetType = Shapes::StringShape.new(name: 'HookTargetType')
@@ -234,6 +238,9 @@ module Aws::CloudFormation
234
238
  ListExportsOutput = Shapes::StructureShape.new(name: 'ListExportsOutput')
235
239
  ListGeneratedTemplatesInput = Shapes::StructureShape.new(name: 'ListGeneratedTemplatesInput')
236
240
  ListGeneratedTemplatesOutput = Shapes::StructureShape.new(name: 'ListGeneratedTemplatesOutput')
241
+ ListHookResultsInput = Shapes::StructureShape.new(name: 'ListHookResultsInput')
242
+ ListHookResultsOutput = Shapes::StructureShape.new(name: 'ListHookResultsOutput')
243
+ ListHookResultsTargetType = Shapes::StringShape.new(name: 'ListHookResultsTargetType')
237
244
  ListImportsInput = Shapes::StructureShape.new(name: 'ListImportsInput')
238
245
  ListImportsOutput = Shapes::StructureShape.new(name: 'ListImportsOutput')
239
246
  ListResourceScanRelatedResourcesInput = Shapes::StructureShape.new(name: 'ListResourceScanRelatedResourcesInput')
@@ -1170,6 +1177,19 @@ module Aws::CloudFormation
1170
1177
  GetTemplateSummaryOutput.add_member(:warnings, Shapes::ShapeRef.new(shape: Warnings, location_name: "Warnings"))
1171
1178
  GetTemplateSummaryOutput.struct_class = Types::GetTemplateSummaryOutput
1172
1179
 
1180
+ HookResultNotFoundException.struct_class = Types::HookResultNotFoundException
1181
+
1182
+ HookResultSummaries.member = Shapes::ShapeRef.new(shape: HookResultSummary)
1183
+
1184
+ HookResultSummary.add_member(:invocation_point, Shapes::ShapeRef.new(shape: HookInvocationPoint, location_name: "InvocationPoint"))
1185
+ HookResultSummary.add_member(:failure_mode, Shapes::ShapeRef.new(shape: HookFailureMode, location_name: "FailureMode"))
1186
+ HookResultSummary.add_member(:type_name, Shapes::ShapeRef.new(shape: HookTypeName, location_name: "TypeName"))
1187
+ HookResultSummary.add_member(:type_version_id, Shapes::ShapeRef.new(shape: HookTypeVersionId, location_name: "TypeVersionId"))
1188
+ HookResultSummary.add_member(:type_configuration_version_id, Shapes::ShapeRef.new(shape: HookTypeConfigurationVersionId, location_name: "TypeConfigurationVersionId"))
1189
+ HookResultSummary.add_member(:status, Shapes::ShapeRef.new(shape: HookStatus, location_name: "Status"))
1190
+ HookResultSummary.add_member(:hook_status_reason, Shapes::ShapeRef.new(shape: HookStatusReason, location_name: "HookStatusReason"))
1191
+ HookResultSummary.struct_class = Types::HookResultSummary
1192
+
1173
1193
  ImportStacksToStackSetInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, required: true, location_name: "StackSetName"))
1174
1194
  ImportStacksToStackSetInput.add_member(:stack_ids, Shapes::ShapeRef.new(shape: StackIdList, location_name: "StackIds"))
1175
1195
  ImportStacksToStackSetInput.add_member(:stack_ids_url, Shapes::ShapeRef.new(shape: StackIdsUrl, location_name: "StackIdsUrl"))
@@ -1222,6 +1242,17 @@ module Aws::CloudFormation
1222
1242
  ListGeneratedTemplatesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1223
1243
  ListGeneratedTemplatesOutput.struct_class = Types::ListGeneratedTemplatesOutput
1224
1244
 
1245
+ ListHookResultsInput.add_member(:target_type, Shapes::ShapeRef.new(shape: ListHookResultsTargetType, required: true, location_name: "TargetType"))
1246
+ ListHookResultsInput.add_member(:target_id, Shapes::ShapeRef.new(shape: HookResultId, required: true, location_name: "TargetId"))
1247
+ ListHookResultsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1248
+ ListHookResultsInput.struct_class = Types::ListHookResultsInput
1249
+
1250
+ ListHookResultsOutput.add_member(:target_type, Shapes::ShapeRef.new(shape: ListHookResultsTargetType, location_name: "TargetType"))
1251
+ ListHookResultsOutput.add_member(:target_id, Shapes::ShapeRef.new(shape: HookResultId, location_name: "TargetId"))
1252
+ ListHookResultsOutput.add_member(:hook_results, Shapes::ShapeRef.new(shape: HookResultSummaries, location_name: "HookResults"))
1253
+ ListHookResultsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1254
+ ListHookResultsOutput.struct_class = Types::ListHookResultsOutput
1255
+
1225
1256
  ListImportsInput.add_member(:export_name, Shapes::ShapeRef.new(shape: ExportName, required: true, location_name: "ExportName"))
1226
1257
  ListImportsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1227
1258
  ListImportsInput.struct_class = Types::ListImportsInput
@@ -2723,6 +2754,15 @@ module Aws::CloudFormation
2723
2754
  )
2724
2755
  end)
2725
2756
 
2757
+ api.add_operation(:list_hook_results, Seahorse::Model::Operation.new.tap do |o|
2758
+ o.name = "ListHookResults"
2759
+ o.http_method = "POST"
2760
+ o.http_request_uri = "/"
2761
+ o.input = Shapes::ShapeRef.new(shape: ListHookResultsInput)
2762
+ o.output = Shapes::ShapeRef.new(shape: ListHookResultsOutput)
2763
+ o.errors << Shapes::ShapeRef.new(shape: HookResultNotFoundException)
2764
+ end)
2765
+
2726
2766
  api.add_operation(:list_imports, Seahorse::Model::Operation.new.tap do |o|
2727
2767
  o.name = "ListImports"
2728
2768
  o.http_method = "POST"
@@ -33,6 +33,7 @@ module Aws::CloudFormation
33
33
  # * {ConcurrentResourcesLimitExceededException}
34
34
  # * {CreatedButModifiedException}
35
35
  # * {GeneratedTemplateNotFoundException}
36
+ # * {HookResultNotFoundException}
36
37
  # * {InsufficientCapabilitiesException}
37
38
  # * {InvalidChangeSetStatusException}
38
39
  # * {InvalidOperationException}
@@ -126,6 +127,16 @@ module Aws::CloudFormation
126
127
  end
127
128
  end
128
129
 
130
+ class HookResultNotFoundException < ServiceError
131
+
132
+ # @param [Seahorse::Client::RequestContext] context
133
+ # @param [String] message
134
+ # @param [Aws::CloudFormation::Types::HookResultNotFoundException] data
135
+ def initialize(context, message, data = Aws::EmptyStructure.new)
136
+ super(context, message, data)
137
+ end
138
+ end
139
+
129
140
  class InsufficientCapabilitiesException < ServiceError
130
141
 
131
142
  # @param [Seahorse::Client::RequestContext] context
@@ -148,7 +148,6 @@ module Aws::CloudFormation
148
148
  #
149
149
  # * If you don't specify either of these capabilities, CloudFormation
150
150
  # returns an `InsufficientCapabilities` error.
151
- #
152
151
  # If your stack template contains these resources, we recommend that
153
152
  # you review all permissions associated with them and edit their
154
153
  # permissions if necessary.
@@ -166,7 +165,6 @@ module Aws::CloudFormation
166
165
  # * [AWS::IAM::User][6]
167
166
  #
168
167
  # * [AWS::IAM::UserToGroupAddition][7]
169
- #
170
168
  # For more information, see [Acknowledging IAM resources in
171
169
  # CloudFormation templates][8].
172
170
  #
@@ -540,7 +540,6 @@ module Aws::CloudFormation
540
540
  #
541
541
  # * If you don't specify either of these capabilities, CloudFormation
542
542
  # returns an `InsufficientCapabilities` error.
543
- #
544
543
  # If your stack template contains these resources, we recommend that
545
544
  # you review all permissions associated with them and edit their
546
545
  # permissions if necessary.
@@ -558,7 +557,6 @@ module Aws::CloudFormation
558
557
  # * [AWS::IAM::User][6]
559
558
  #
560
559
  # * [AWS::IAM::UserToGroupAddition][7]
561
- #
562
560
  # For more information, see [Acknowledging IAM resources in
563
561
  # CloudFormation templates][8].
564
562
  #
@@ -902,7 +900,6 @@ module Aws::CloudFormation
902
900
  #
903
901
  # * If you don't specify either of these capabilities, CloudFormation
904
902
  # returns an `InsufficientCapabilities` error.
905
- #
906
903
  # If your stack template contains these resources, we suggest that you
907
904
  # review all permissions associated with them and edit their
908
905
  # permissions if necessary.
@@ -920,7 +917,6 @@ module Aws::CloudFormation
920
917
  # * [ AWS::IAM::User][6]
921
918
  #
922
919
  # * [AWS::IAM::UserToGroupAddition][7]
923
- #
924
920
  # For more information, see [Acknowledging IAM resources in
925
921
  # CloudFormation templates][8].
926
922
  #
@@ -777,7 +777,6 @@ module Aws::CloudFormation
777
777
  #
778
778
  # * If you don't specify either of these capabilities,
779
779
  # CloudFormation returns an `InsufficientCapabilities` error.
780
- #
781
780
  # If your stack template contains these resources, we suggest that
782
781
  # you review all permissions associated with them and edit their
783
782
  # permissions if necessary.
@@ -795,7 +794,6 @@ module Aws::CloudFormation
795
794
  # * [ AWS::IAM::User][6]
796
795
  #
797
796
  # * [AWS::IAM::UserToGroupAddition][7]
798
- #
799
797
  # For more information, see [Acknowledging IAM resources in
800
798
  # CloudFormation templates][8].
801
799
  #
@@ -1176,7 +1174,6 @@ module Aws::CloudFormation
1176
1174
  #
1177
1175
  # * If you don't specify either of these capabilities,
1178
1176
  # CloudFormation returns an `InsufficientCapabilities` error.
1179
- #
1180
1177
  # If your stack template contains these resources, we recommend that
1181
1178
  # you review all permissions associated with them and edit their
1182
1179
  # permissions if necessary.
@@ -1194,7 +1191,6 @@ module Aws::CloudFormation
1194
1191
  # * [AWS::IAM::User][6]
1195
1192
  #
1196
1193
  # * [AWS::IAM::UserToGroupAddition][7]
1197
- #
1198
1194
  # For more information, see [Acknowledging IAM resources in
1199
1195
  # CloudFormation templates][8].
1200
1196
  #
@@ -1611,7 +1607,6 @@ module Aws::CloudFormation
1611
1607
  #
1612
1608
  # * If you don't specify either of these capabilities,
1613
1609
  # CloudFormation returns an `InsufficientCapabilities` error.
1614
- #
1615
1610
  # If your stack template contains these resources, we recommend that
1616
1611
  # you review all permissions associated with them and edit their
1617
1612
  # permissions if necessary.
@@ -1629,7 +1624,6 @@ module Aws::CloudFormation
1629
1624
  # * [AWS::IAM::User][6]
1630
1625
  #
1631
1626
  # * [AWS::IAM::UserToGroupAddition][7]
1632
- #
1633
1627
  # For more information, see [Acknowledging IAM resources in
1634
1628
  # CloudFormation templates][8].
1635
1629
  #
@@ -4441,6 +4435,66 @@ module Aws::CloudFormation
4441
4435
  include Aws::Structure
4442
4436
  end
4443
4437
 
4438
+ # The specified target doesn't have any requested Hook invocations.
4439
+ #
4440
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookResultNotFoundException AWS API Documentation
4441
+ #
4442
+ class HookResultNotFoundException < Aws::EmptyStructure; end
4443
+
4444
+ # Describes a Hook invocation, its status, and the reason for its
4445
+ # status.
4446
+ #
4447
+ # @!attribute [rw] invocation_point
4448
+ # The exact point in the provisioning logic where the Hook runs.
4449
+ # @return [String]
4450
+ #
4451
+ # @!attribute [rw] failure_mode
4452
+ # The failure mode of the invocation. The following are potential
4453
+ # modes:
4454
+ #
4455
+ # * `FAIL`: If the hook invocation returns a failure, then the
4456
+ # requested target operation should fail.
4457
+ #
4458
+ # * `WARN`: If the hook invocation returns a failure, then the
4459
+ # requested target operation should warn.
4460
+ # @return [String]
4461
+ #
4462
+ # @!attribute [rw] type_name
4463
+ # The type name of the Hook being invoked.
4464
+ # @return [String]
4465
+ #
4466
+ # @!attribute [rw] type_version_id
4467
+ # The version of the Hook being invoked.
4468
+ # @return [String]
4469
+ #
4470
+ # @!attribute [rw] type_configuration_version_id
4471
+ # The version of the Hook type configuration.
4472
+ # @return [String]
4473
+ #
4474
+ # @!attribute [rw] status
4475
+ # The state of the Hook invocation.
4476
+ # @return [String]
4477
+ #
4478
+ # @!attribute [rw] hook_status_reason
4479
+ # A description of the Hook results status. For example, if the Hook
4480
+ # result is in a `FAILED` state, this may contain additional
4481
+ # information for the `FAILED` state.
4482
+ # @return [String]
4483
+ #
4484
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookResultSummary AWS API Documentation
4485
+ #
4486
+ class HookResultSummary < Struct.new(
4487
+ :invocation_point,
4488
+ :failure_mode,
4489
+ :type_name,
4490
+ :type_version_id,
4491
+ :type_configuration_version_id,
4492
+ :status,
4493
+ :hook_status_reason)
4494
+ SENSITIVE = []
4495
+ include Aws::Structure
4496
+ end
4497
+
4444
4498
  # @!attribute [rw] stack_set_name
4445
4499
  # The name of the stack set. The name must be unique in the Region
4446
4500
  # where you create your stack set.
@@ -4681,6 +4735,78 @@ module Aws::CloudFormation
4681
4735
  include Aws::Structure
4682
4736
  end
4683
4737
 
4738
+ # @!attribute [rw] target_type
4739
+ # The type of operation being targeted by the Hook.
4740
+ # @return [String]
4741
+ #
4742
+ # @!attribute [rw] target_id
4743
+ # The logical ID of the target the operation is acting on by the Hook.
4744
+ # If the target is a change set, it's the ARN of the change set.
4745
+ #
4746
+ # If the target is a Cloud Control API operation, this will be the
4747
+ # `HookRequestToken` returned by the Cloud Control API operation
4748
+ # request. For more information on the `HookRequestToken`, see
4749
+ # [ProgressEvent][1].
4750
+ #
4751
+ #
4752
+ #
4753
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
4754
+ # @return [String]
4755
+ #
4756
+ # @!attribute [rw] next_token
4757
+ # A string that identifies the next page of events that you want to
4758
+ # retrieve.
4759
+ # @return [String]
4760
+ #
4761
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsInput AWS API Documentation
4762
+ #
4763
+ class ListHookResultsInput < Struct.new(
4764
+ :target_type,
4765
+ :target_id,
4766
+ :next_token)
4767
+ SENSITIVE = []
4768
+ include Aws::Structure
4769
+ end
4770
+
4771
+ # @!attribute [rw] target_type
4772
+ # The type of operation being targeted by the Hook.
4773
+ # @return [String]
4774
+ #
4775
+ # @!attribute [rw] target_id
4776
+ # The logical ID of the target the operation is acting on by the Hook.
4777
+ # If the target is a change set, it's the ARN of the change set.
4778
+ #
4779
+ # If the target is a Cloud Control API operation, this will be the
4780
+ # `HooksRequestToken` returned by the Cloud Control API operation
4781
+ # request. For more information on the `HooksRequestToken`, see
4782
+ # [ProgressEvent][1].
4783
+ #
4784
+ #
4785
+ #
4786
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
4787
+ # @return [String]
4788
+ #
4789
+ # @!attribute [rw] hook_results
4790
+ # A list of `HookResultSummary` structures that provides the status
4791
+ # and Hook status reason for each Hook invocation for the specified
4792
+ # target.
4793
+ # @return [Array<Types::HookResultSummary>]
4794
+ #
4795
+ # @!attribute [rw] next_token
4796
+ # Pagination token, `null` or empty if no more results.
4797
+ # @return [String]
4798
+ #
4799
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsOutput AWS API Documentation
4800
+ #
4801
+ class ListHookResultsOutput < Struct.new(
4802
+ :target_type,
4803
+ :target_id,
4804
+ :hook_results,
4805
+ :next_token)
4806
+ SENSITIVE = []
4807
+ include Aws::Structure
4808
+ end
4809
+
4684
4810
  # @!attribute [rw] export_name
4685
4811
  # The name of the exported output value. CloudFormation returns the
4686
4812
  # stack names that are importing this value.
@@ -5695,7 +5821,6 @@ module Aws::CloudFormation
5695
5821
  #
5696
5822
  # * Public extensions that you have activated in this account and
5697
5823
  # Region.
5698
- #
5699
5824
  # * `PUBLIC`: Extensions that are publicly visible and available to be
5700
5825
  # activated within any Amazon Web Services account. This includes
5701
5826
  # extensions from Amazon Web Services, in addition to third-party
@@ -7953,7 +8078,6 @@ module Aws::CloudFormation
7953
8078
  # * The stack was part of a `CreateStackSet` or `UpdateStackSet`
7954
8079
  # operation that failed or was stopped before the stack was
7955
8080
  # created or updated.
7956
- #
7957
8081
  # * `CURRENT`: The stack is currently up to date with the stack set.
7958
8082
  # @return [String]
7959
8083
  #
@@ -8222,7 +8346,6 @@ module Aws::CloudFormation
8222
8346
  # * The stack was part of a `CreateStackSet` or `UpdateStackSet`
8223
8347
  # operation that failed or was stopped before the stack was
8224
8348
  # created or updated.
8225
- #
8226
8349
  # * `CURRENT`: The stack is currently up to date with the stack set.
8227
8350
  # @return [String]
8228
8351
  #
@@ -10225,7 +10348,6 @@ module Aws::CloudFormation
10225
10348
  #
10226
10349
  # * Public extensions from publishers other than Amazon, whether
10227
10350
  # activated or not.
10228
- #
10229
10351
  # * `AWS_TYPES`: Extensions available for use from Amazon.
10230
10352
  # @return [String]
10231
10353
  #
@@ -10640,7 +10762,6 @@ module Aws::CloudFormation
10640
10762
  #
10641
10763
  # * If you don't specify either of these capabilities,
10642
10764
  # CloudFormation returns an `InsufficientCapabilities` error.
10643
- #
10644
10765
  # If your stack template contains these resources, we suggest that
10645
10766
  # you review all permissions associated with them and edit their
10646
10767
  # permissions if necessary.
@@ -10658,7 +10779,6 @@ module Aws::CloudFormation
10658
10779
  # * [ AWS::IAM::User][6]
10659
10780
  #
10660
10781
  # * [AWS::IAM::UserToGroupAddition][7]
10661
- #
10662
10782
  # For more information, see [Acknowledging IAM resources in
10663
10783
  # CloudFormation templates][8].
10664
10784
  #
@@ -11079,7 +11199,6 @@ module Aws::CloudFormation
11079
11199
  #
11080
11200
  # * If you don't specify either of these capabilities,
11081
11201
  # CloudFormation returns an `InsufficientCapabilities` error.
11082
- #
11083
11202
  # If your stack template contains these resources, we recommend that
11084
11203
  # you review all permissions associated with them and edit their
11085
11204
  # permissions if necessary.
@@ -11097,7 +11216,6 @@ module Aws::CloudFormation
11097
11216
  # * [AWS::IAM::User][6]
11098
11217
  #
11099
11218
  # * [AWS::IAM::UserToGroupAddition][7]
11100
- #
11101
11219
  # For more information, see [Acknowledging IAM resources in
11102
11220
  # CloudFormation templates][8].
11103
11221
  #
@@ -59,7 +59,7 @@ module Aws::CloudFormation
59
59
  autoload :StackResource, 'aws-sdk-cloudformation/stack_resource'
60
60
  autoload :StackResourceSummary, 'aws-sdk-cloudformation/stack_resource_summary'
61
61
 
62
- GEM_VERSION = '1.123.0'
62
+ GEM_VERSION = '1.124.0'
63
63
 
64
64
  end
65
65
 
data/sig/client.rbs CHANGED
@@ -929,6 +929,21 @@ module Aws
929
929
  ) -> _ListGeneratedTemplatesResponseSuccess
930
930
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListGeneratedTemplatesResponseSuccess
931
931
 
932
+ interface _ListHookResultsResponseSuccess
933
+ include ::Seahorse::Client::_ResponseSuccess[Types::ListHookResultsOutput]
934
+ def target_type: () -> ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
935
+ def target_id: () -> ::String
936
+ def hook_results: () -> ::Array[Types::HookResultSummary]
937
+ def next_token: () -> ::String
938
+ end
939
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudFormation/Client.html#list_hook_results-instance_method
940
+ def list_hook_results: (
941
+ target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL"),
942
+ target_id: ::String,
943
+ ?next_token: ::String
944
+ ) -> _ListHookResultsResponseSuccess
945
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListHookResultsResponseSuccess
946
+
932
947
  interface _ListImportsResponseSuccess
933
948
  include ::Seahorse::Client::_ResponseSuccess[Types::ListImportsOutput]
934
949
  def imports: () -> ::Array[::String]
data/sig/errors.rbs CHANGED
@@ -24,6 +24,8 @@ module Aws
24
24
  end
25
25
  class GeneratedTemplateNotFoundException < ::Aws::Errors::ServiceError
26
26
  end
27
+ class HookResultNotFoundException < ::Aws::Errors::ServiceError
28
+ end
27
29
  class InsufficientCapabilitiesException < ::Aws::Errors::ServiceError
28
30
  end
29
31
  class InvalidChangeSetStatusException < ::Aws::Errors::ServiceError
data/sig/types.rbs CHANGED
@@ -764,6 +764,20 @@ module Aws::CloudFormation
764
764
  SENSITIVE: []
765
765
  end
766
766
 
767
+ class HookResultNotFoundException < Aws::EmptyStructure
768
+ end
769
+
770
+ class HookResultSummary
771
+ attr_accessor invocation_point: ("PRE_PROVISION")
772
+ attr_accessor failure_mode: ("FAIL" | "WARN")
773
+ attr_accessor type_name: ::String
774
+ attr_accessor type_version_id: ::String
775
+ attr_accessor type_configuration_version_id: ::String
776
+ attr_accessor status: ("HOOK_IN_PROGRESS" | "HOOK_COMPLETE_SUCCEEDED" | "HOOK_COMPLETE_FAILED" | "HOOK_FAILED")
777
+ attr_accessor hook_status_reason: ::String
778
+ SENSITIVE: []
779
+ end
780
+
767
781
  class ImportStacksToStackSetInput
768
782
  attr_accessor stack_set_name: ::String
769
783
  attr_accessor stack_ids: ::Array[::String]
@@ -830,6 +844,21 @@ module Aws::CloudFormation
830
844
  SENSITIVE: []
831
845
  end
832
846
 
847
+ class ListHookResultsInput
848
+ attr_accessor target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
849
+ attr_accessor target_id: ::String
850
+ attr_accessor next_token: ::String
851
+ SENSITIVE: []
852
+ end
853
+
854
+ class ListHookResultsOutput
855
+ attr_accessor target_type: ("CHANGE_SET" | "STACK" | "RESOURCE" | "CLOUD_CONTROL")
856
+ attr_accessor target_id: ::String
857
+ attr_accessor hook_results: ::Array[Types::HookResultSummary]
858
+ attr_accessor next_token: ::String
859
+ SENSITIVE: []
860
+ end
861
+
833
862
  class ListImportsInput
834
863
  attr_accessor export_name: ::String
835
864
  attr_accessor next_token: ::String
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudformation
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.123.0
4
+ version: 1.124.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-11-06 00:00:00.000000000 Z
11
+ date: 2024-11-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core