aws-sdk-cloudformation 1.50.0 → 1.54.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.
@@ -50,14 +50,14 @@ module Aws::CloudFormation
50
50
  end
51
51
 
52
52
  # The name or unique identifier that corresponds to a physical instance
53
- # ID of a resource supported by AWS CloudFormation.
53
+ # ID of a resource supported by CloudFormation.
54
54
  # @return [String]
55
55
  def physical_resource_id
56
56
  data[:physical_resource_id]
57
57
  end
58
58
 
59
- # Type of resource. ((For more information, go to [ AWS Resource Types
60
- # Reference][1] in the AWS CloudFormation User Guide.)
59
+ # Type of resource. ((For more information, go to [Amazon Web Services
60
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
61
61
  #
62
62
  #
63
63
  #
@@ -92,8 +92,8 @@ module Aws::CloudFormation
92
92
  end
93
93
 
94
94
  # The content of the `Metadata` attribute declared for the resource. For
95
- # more information, see [Metadata Attribute][1] in the AWS
96
- # CloudFormation User Guide.
95
+ # more information, see [Metadata Attribute][1] in the CloudFormation
96
+ # User Guide.
97
97
  #
98
98
  #
99
99
  #
@@ -50,8 +50,8 @@ module Aws::CloudFormation
50
50
  data[:physical_resource_id]
51
51
  end
52
52
 
53
- # Type of resource. (For more information, go to [ AWS Resource Types
54
- # Reference][1] in the AWS CloudFormation User Guide.)
53
+ # Type of resource. (For more information, go to [Amazon Web Services
54
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
55
55
  #
56
56
  #
57
57
  #
@@ -11,17 +11,17 @@ module Aws::CloudFormation
11
11
  module Types
12
12
 
13
13
  # Structure that contains the results of the account gate function which
14
- # AWS CloudFormation invokes, if present, before proceeding with a stack
15
- # set operation in an account and Region.
16
- #
17
- # For each account and Region, AWS CloudFormation lets you specify a
18
- # Lamdba function that encapsulates any requirements that must be met
19
- # before CloudFormation can proceed with a stack set operation in that
20
- # account and Region. CloudFormation invokes the function each time a
21
- # stack set operation is requested for that account and Region; if the
22
- # function returns `FAILED`, CloudFormation cancels the operation in
23
- # that account and Region, and sets the stack set operation result
24
- # status for that account and Region to `FAILED`.
14
+ # CloudFormation invokes, if present, before proceeding with a stack set
15
+ # operation in an account and Region.
16
+ #
17
+ # For each account and Region, CloudFormation lets you specify a Lamdba
18
+ # function that encapsulates any requirements that must be met before
19
+ # CloudFormation can proceed with a stack set operation in that account
20
+ # and Region. CloudFormation invokes the function each time a stack set
21
+ # operation is requested for that account and Region; if the function
22
+ # returns `FAILED`, CloudFormation cancels the operation in that account
23
+ # and Region, and sets the stack set operation result status for that
24
+ # account and Region to `FAILED`.
25
25
  #
26
26
  # For more information, see [Configuring a target account gate][1].
27
27
  #
@@ -34,7 +34,7 @@ module Aws::CloudFormation
34
34
  #
35
35
  # * `SUCCEEDED`\: The account gate function has determined that the
36
36
  # account and Region passes any requirements for a stack set
37
- # operation to occur. AWS CloudFormation proceeds with the stack
37
+ # operation to occur. CloudFormation proceeds with the stack
38
38
  # operation in that account and Region.
39
39
  #
40
40
  # * `FAILED`\: The account gate function has determined that the
@@ -43,21 +43,21 @@ module Aws::CloudFormation
43
43
  # operation in that account and Region, and sets the stack set
44
44
  # operation result status for that account and Region to `FAILED`.
45
45
  #
46
- # * `SKIPPED`\: AWS CloudFormation has skipped calling the account
47
- # gate function for this account and Region, for one of the
48
- # following reasons:
46
+ # * `SKIPPED`\: CloudFormation has skipped calling the account gate
47
+ # function for this account and Region, for one of the following
48
+ # reasons:
49
49
  #
50
50
  # * An account gate function has not been specified for the account
51
- # and Region. AWS CloudFormation proceeds with the stack set
52
- # operation in this account and Region.
51
+ # and Region. CloudFormation proceeds with the stack set operation
52
+ # in this account and Region.
53
53
  #
54
54
  # * The `AWSCloudFormationStackSetExecutionRole` of the stack set
55
55
  # adminstration account lacks permissions to invoke the function.
56
- # AWS CloudFormation proceeds with the stack set operation in this
56
+ # CloudFormation proceeds with the stack set operation in this
57
57
  # account and Region.
58
58
  #
59
59
  # * Either no action is necessary, or no action is possible, on the
60
- # stack. AWS CloudFormation skips the stack set operation in this
60
+ # stack. CloudFormation skips the stack set operation in this
61
61
  # account and Region.
62
62
  # @return [String]
63
63
  #
@@ -86,8 +86,8 @@ module Aws::CloudFormation
86
86
  # * Number of stack outputs
87
87
  #
88
88
  # For more information about these account limits, and other
89
- # CloudFormation limits, see [AWS CloudFormation Limits][1] in the *AWS
90
- # CloudFormation User Guide*.
89
+ # CloudFormation limits, see [CloudFormation Limits][1] in the
90
+ # *CloudFormation User Guide*.
91
91
  #
92
92
  #
93
93
  #
@@ -113,6 +113,133 @@ module Aws::CloudFormation
113
113
  include Aws::Structure
114
114
  end
115
115
 
116
+ # @note When making an API call, you may pass ActivateTypeInput
117
+ # data as a hash:
118
+ #
119
+ # {
120
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
121
+ # public_type_arn: "ThirdPartyTypeArn",
122
+ # publisher_id: "PublisherId",
123
+ # type_name: "TypeName",
124
+ # type_name_alias: "TypeName",
125
+ # auto_update: false,
126
+ # logging_config: {
127
+ # log_role_arn: "RoleArn", # required
128
+ # log_group_name: "LogGroupName", # required
129
+ # },
130
+ # execution_role_arn: "RoleArn",
131
+ # version_bump: "MAJOR", # accepts MAJOR, MINOR
132
+ # major_version: 1,
133
+ # }
134
+ #
135
+ # @!attribute [rw] type
136
+ # The extension type.
137
+ #
138
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`,
139
+ # `Type`, and `PublisherId`.
140
+ # @return [String]
141
+ #
142
+ # @!attribute [rw] public_type_arn
143
+ # The Amazon Resource Number (ARN) of the public extension.
144
+ #
145
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`,
146
+ # `Type`, and `PublisherId`.
147
+ # @return [String]
148
+ #
149
+ # @!attribute [rw] publisher_id
150
+ # The ID of the extension publisher.
151
+ #
152
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`,
153
+ # `Type`, and `PublisherId`.
154
+ # @return [String]
155
+ #
156
+ # @!attribute [rw] type_name
157
+ # The name of the extension.
158
+ #
159
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`,
160
+ # `Type`, and `PublisherId`.
161
+ # @return [String]
162
+ #
163
+ # @!attribute [rw] type_name_alias
164
+ # An alias to assign to the public extension, in this account and
165
+ # region. If you specify an alias for the extension, CloudFormation
166
+ # treats the alias as the extension type name within this account and
167
+ # region. You must use the alias to refer to the extension in your
168
+ # templates, API calls, and CloudFormation console.
169
+ #
170
+ # An extension alias must be unique within a given account and region.
171
+ # You can activate the same public resource multiple times in the same
172
+ # account and region, using different type name aliases.
173
+ # @return [String]
174
+ #
175
+ # @!attribute [rw] auto_update
176
+ # Whether to automatically update the extension in this account and
177
+ # region when a new *minor* version is published by the extension
178
+ # publisher. Major versions released by the publisher must be manually
179
+ # updated.
180
+ #
181
+ # The default is `true`.
182
+ # @return [Boolean]
183
+ #
184
+ # @!attribute [rw] logging_config
185
+ # Contains logging configuration information for an extension.
186
+ # @return [Types::LoggingConfig]
187
+ #
188
+ # @!attribute [rw] execution_role_arn
189
+ # The name of the IAM execution role to use to activate the extension.
190
+ # @return [String]
191
+ #
192
+ # @!attribute [rw] version_bump
193
+ # Manually updates a previously-activated type to a new major or minor
194
+ # version, if available. You can also use this parameter to update the
195
+ # value of `AutoUpdate`.
196
+ #
197
+ # * `MAJOR`\: CloudFormation updates the extension to the newest major
198
+ # version, if one is available.
199
+ #
200
+ # * `MINOR`\: CloudFormation updates the extension to the newest minor
201
+ # version, if one is available.
202
+ # @return [String]
203
+ #
204
+ # @!attribute [rw] major_version
205
+ # The major version of this extension you want to activate, if
206
+ # multiple major versions are available. The default is the latest
207
+ # major version. CloudFormation uses the latest available *minor*
208
+ # version of the major version selected.
209
+ #
210
+ # You can specify `MajorVersion` or `VersionBump`, but not both.
211
+ # @return [Integer]
212
+ #
213
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ActivateTypeInput AWS API Documentation
214
+ #
215
+ class ActivateTypeInput < Struct.new(
216
+ :type,
217
+ :public_type_arn,
218
+ :publisher_id,
219
+ :type_name,
220
+ :type_name_alias,
221
+ :auto_update,
222
+ :logging_config,
223
+ :execution_role_arn,
224
+ :version_bump,
225
+ :major_version)
226
+ SENSITIVE = []
227
+ include Aws::Structure
228
+ end
229
+
230
+ # @!attribute [rw] arn
231
+ # The Amazon Resource Number (ARN) of the activated extension, in this
232
+ # account and region.
233
+ # @return [String]
234
+ #
235
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ActivateTypeOutput AWS API Documentation
236
+ #
237
+ class ActivateTypeOutput < Struct.new(
238
+ :arn)
239
+ SENSITIVE = []
240
+ include Aws::Structure
241
+ end
242
+
116
243
  # The resource with the name requested already exists.
117
244
  #
118
245
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/AlreadyExistsException AWS API Documentation
@@ -120,8 +247,8 @@ module Aws::CloudFormation
120
247
  class AlreadyExistsException < Aws::EmptyStructure; end
121
248
 
122
249
  # \[Service-managed permissions\] Describes whether StackSets
123
- # automatically deploys to AWS Organizations accounts that are added to
124
- # a target organization or organizational unit (OU).
250
+ # automatically deploys to Organizations accounts that are added to a
251
+ # target organization or organizational unit (OU).
125
252
  #
126
253
  # @note When making an API call, you may pass AutoDeployment
127
254
  # data as a hash:
@@ -133,7 +260,7 @@ module Aws::CloudFormation
133
260
  #
134
261
  # @!attribute [rw] enabled
135
262
  # If set to `true`, StackSets automatically deploys additional stack
136
- # instances to AWS Organizations accounts that are added to a target
263
+ # instances to Organizations accounts that are added to a target
137
264
  # organization or organizational unit (OU) in the specified Regions.
138
265
  # If an account is removed from a target organization or OU, StackSets
139
266
  # deletes stack instances from the account in the specified Regions.
@@ -154,6 +281,84 @@ module Aws::CloudFormation
154
281
  include Aws::Structure
155
282
  end
156
283
 
284
+ # Detailed information concerning an error generated during the setting
285
+ # of configuration data for a CloudFormation extension.
286
+ #
287
+ # @!attribute [rw] error_code
288
+ # The error code.
289
+ # @return [String]
290
+ #
291
+ # @!attribute [rw] error_message
292
+ # The error message.
293
+ # @return [String]
294
+ #
295
+ # @!attribute [rw] type_configuration_identifier
296
+ # Identifying information for the configuration of a CloudFormation
297
+ # extension.
298
+ # @return [Types::TypeConfigurationIdentifier]
299
+ #
300
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/BatchDescribeTypeConfigurationsError AWS API Documentation
301
+ #
302
+ class BatchDescribeTypeConfigurationsError < Struct.new(
303
+ :error_code,
304
+ :error_message,
305
+ :type_configuration_identifier)
306
+ SENSITIVE = []
307
+ include Aws::Structure
308
+ end
309
+
310
+ # @note When making an API call, you may pass BatchDescribeTypeConfigurationsInput
311
+ # data as a hash:
312
+ #
313
+ # {
314
+ # type_configuration_identifiers: [ # required
315
+ # {
316
+ # type_arn: "TypeArn",
317
+ # type_configuration_alias: "TypeConfigurationAlias",
318
+ # type_configuration_arn: "TypeConfigurationArn",
319
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
320
+ # type_name: "TypeName",
321
+ # },
322
+ # ],
323
+ # }
324
+ #
325
+ # @!attribute [rw] type_configuration_identifiers
326
+ # The list of identifiers for the desired extension configurations.
327
+ # @return [Array<Types::TypeConfigurationIdentifier>]
328
+ #
329
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/BatchDescribeTypeConfigurationsInput AWS API Documentation
330
+ #
331
+ class BatchDescribeTypeConfigurationsInput < Struct.new(
332
+ :type_configuration_identifiers)
333
+ SENSITIVE = []
334
+ include Aws::Structure
335
+ end
336
+
337
+ # @!attribute [rw] errors
338
+ # A list of information concerning any errors generated during the
339
+ # setting of the specified configurations.
340
+ # @return [Array<Types::BatchDescribeTypeConfigurationsError>]
341
+ #
342
+ # @!attribute [rw] unprocessed_type_configurations
343
+ # A list of any of the specified extension configurations that
344
+ # CloudFormation could not process for any reason.
345
+ # @return [Array<Types::TypeConfigurationIdentifier>]
346
+ #
347
+ # @!attribute [rw] type_configurations
348
+ # A list of any of the specified extension configurations from the
349
+ # CloudFormation registry.
350
+ # @return [Array<Types::TypeConfigurationDetails>]
351
+ #
352
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/BatchDescribeTypeConfigurationsOutput AWS API Documentation
353
+ #
354
+ class BatchDescribeTypeConfigurationsOutput < Struct.new(
355
+ :errors,
356
+ :unprocessed_type_configurations,
357
+ :type_configurations)
358
+ SENSITIVE = []
359
+ include Aws::Structure
360
+ end
361
+
157
362
  # An error occurred during a CloudFormation registry operation.
158
363
  #
159
364
  # @!attribute [rw] message
@@ -183,10 +388,10 @@ module Aws::CloudFormation
183
388
  #
184
389
  # @!attribute [rw] client_request_token
185
390
  # A unique identifier for this `CancelUpdateStack` request. Specify
186
- # this token if you plan to retry requests so that AWS CloudFormation
391
+ # this token if you plan to retry requests so that CloudFormation
187
392
  # knows that you're not attempting to cancel an update on a stack
188
393
  # with the same name. You might retry `CancelUpdateStack` requests to
189
- # ensure that AWS CloudFormation successfully received them.
394
+ # ensure that CloudFormation successfully received them.
190
395
  # @return [String]
191
396
  #
192
397
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CancelUpdateStackInput AWS API Documentation
@@ -198,17 +403,17 @@ module Aws::CloudFormation
198
403
  include Aws::Structure
199
404
  end
200
405
 
201
- # The `Change` structure describes the changes AWS CloudFormation will
406
+ # The `Change` structure describes the changes CloudFormation will
202
407
  # perform if you execute the change set.
203
408
  #
204
409
  # @!attribute [rw] type
205
- # The type of entity that AWS CloudFormation changes. Currently, the
206
- # only entity type is `Resource`.
410
+ # The type of entity that CloudFormation changes. Currently, the only
411
+ # entity type is `Resource`.
207
412
  # @return [String]
208
413
  #
209
414
  # @!attribute [rw] resource_change
210
415
  # A `ResourceChange` structure that describes the resource and action
211
- # that AWS CloudFormation will perform.
416
+ # that CloudFormation will perform.
212
417
  # @return [Types::ResourceChange]
213
418
  #
214
419
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Change AWS API Documentation
@@ -250,8 +455,8 @@ module Aws::CloudFormation
250
455
  # If the change set execution status is `AVAILABLE`, you can execute
251
456
  # the change set. If you can’t execute the change set, the status
252
457
  # indicates why. For example, a change set might be in an
253
- # `UNAVAILABLE` state because AWS CloudFormation is still creating it
254
- # or in an `OBSOLETE` state because the stack was already updated.
458
+ # `UNAVAILABLE` state because CloudFormation is still creating it or
459
+ # in an `OBSOLETE` state because the stack was already updated.
255
460
  # @return [String]
256
461
  #
257
462
  # @!attribute [rw] status
@@ -261,8 +466,8 @@ module Aws::CloudFormation
261
466
  #
262
467
  # @!attribute [rw] status_reason
263
468
  # A description of the change set's status. For example, if your
264
- # change set is in the `FAILED` state, AWS CloudFormation shows the
265
- # error message.
469
+ # change set is in the `FAILED` state, CloudFormation shows the error
470
+ # message.
266
471
  # @return [String]
267
472
  #
268
473
  # @!attribute [rw] creation_time
@@ -330,41 +535,40 @@ module Aws::CloudFormation
330
535
  # @return [String]
331
536
  #
332
537
  # @!attribute [rw] role_arn
333
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
334
- # Management (IAM) role that AWS CloudFormation assumes to roll back
335
- # the stack. AWS CloudFormation uses the role's credentials to make
336
- # calls on your behalf. AWS CloudFormation always uses this role for
337
- # all future operations on the stack. As long as users have permission
338
- # to operate on the stack, AWS CloudFormation uses this role even if
339
- # the users don't have permission to pass it. Ensure that the role
340
- # grants least privilege.
538
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
539
+ # (IAM) role that CloudFormation assumes to roll back the stack.
540
+ # CloudFormation uses the role's credentials to make calls on your
541
+ # behalf. CloudFormation always uses this role for all future
542
+ # operations on the stack. As long as users have permission to operate
543
+ # on the stack, CloudFormation uses this role even if the users don't
544
+ # have permission to pass it. Ensure that the role grants least
545
+ # privilege.
341
546
  #
342
- # If you don't specify a value, AWS CloudFormation uses the role that
343
- # was previously associated with the stack. If no role is available,
344
- # AWS CloudFormation uses a temporary session that is generated from
345
- # your user credentials.
547
+ # If you don't specify a value, CloudFormation uses the role that was
548
+ # previously associated with the stack. If no role is available,
549
+ # CloudFormation uses a temporary session that is generated from your
550
+ # user credentials.
346
551
  # @return [String]
347
552
  #
348
553
  # @!attribute [rw] resources_to_skip
349
- # A list of the logical IDs of the resources that AWS CloudFormation
350
- # skips during the continue update rollback operation. You can specify
351
- # only resources that are in the `UPDATE_FAILED` state because a
352
- # rollback failed. You can't specify resources that are in the
353
- # `UPDATE_FAILED` state for other reasons, for example, because an
354
- # update was cancelled. To check why a resource update failed, use the
554
+ # A list of the logical IDs of the resources that CloudFormation skips
555
+ # during the continue update rollback operation. You can specify only
556
+ # resources that are in the `UPDATE_FAILED` state because a rollback
557
+ # failed. You can't specify resources that are in the `UPDATE_FAILED`
558
+ # state for other reasons, for example, because an update was
559
+ # cancelled. To check why a resource update failed, use the
355
560
  # DescribeStackResources action, and view the resource status reason.
356
561
  #
357
- # Specify this property to skip rolling back resources that AWS
562
+ # Specify this property to skip rolling back resources that
358
563
  # CloudFormation can't successfully roll back. We recommend that you
359
- # [ troubleshoot][1] resources before skipping them. AWS
360
- # CloudFormation sets the status of the specified resources to
361
- # `UPDATE_COMPLETE` and continues to roll back the stack. After the
362
- # rollback is complete, the state of the skipped resources will be
363
- # inconsistent with the state of the resources in the stack template.
364
- # Before performing another stack update, you must update the stack or
365
- # resources to be consistent with each other. If you don't,
366
- # subsequent stack updates might fail, and the stack will become
367
- # unrecoverable.
564
+ # [ troubleshoot][1] resources before skipping them. CloudFormation
565
+ # sets the status of the specified resources to `UPDATE_COMPLETE` and
566
+ # continues to roll back the stack. After the rollback is complete,
567
+ # the state of the skipped resources will be inconsistent with the
568
+ # state of the resources in the stack template. Before performing
569
+ # another stack update, you must update the stack or resources to be
570
+ # consistent with each other. If you don't, subsequent stack updates
571
+ # might fail, and the stack will become unrecoverable.
368
572
  #
369
573
  # Specify the minimum number of resources required to successfully
370
574
  # roll back your stack. For example, a failed resource update might
@@ -393,10 +597,10 @@ module Aws::CloudFormation
393
597
  #
394
598
  # @!attribute [rw] client_request_token
395
599
  # A unique identifier for this `ContinueUpdateRollback` request.
396
- # Specify this token if you plan to retry requests so that AWS
397
- # CloudFormation knows that you're not attempting to continue the
600
+ # Specify this token if you plan to retry requests so that
601
+ # CloudFormationknows that you're not attempting to continue the
398
602
  # rollback to a stack with the same name. You might retry
399
- # `ContinueUpdateRollback` requests to ensure that AWS CloudFormation
603
+ # `ContinueUpdateRollback` requests to ensure that CloudFormation
400
604
  # successfully received them.
401
605
  # @return [String]
402
606
  #
@@ -472,14 +676,14 @@ module Aws::CloudFormation
472
676
  #
473
677
  # @!attribute [rw] stack_name
474
678
  # The name or the unique ID of the stack for which you are creating a
475
- # change set. AWS CloudFormation generates the change set by comparing
679
+ # change set. CloudFormation generates the change set by comparing
476
680
  # this stack's information with the information that you submit, such
477
681
  # as a modified template or different parameter input values.
478
682
  # @return [String]
479
683
  #
480
684
  # @!attribute [rw] template_body
481
685
  # A structure that contains the body of the revised template, with a
482
- # minimum length of 1 byte and a maximum length of 51,200 bytes. AWS
686
+ # minimum length of 1 byte and a maximum length of 51,200 bytes.
483
687
  # CloudFormation generates the change set by comparing this template
484
688
  # with the template of the stack that you specified.
485
689
  #
@@ -489,7 +693,7 @@ module Aws::CloudFormation
489
693
  # @!attribute [rw] template_url
490
694
  # The location of the file that contains the revised template. The URL
491
695
  # must point to a template (max size: 460,800 bytes) that is located
492
- # in an S3 bucket or a Systems Manager document. AWS CloudFormation
696
+ # in an S3 bucket or a Systems Manager document. CloudFormation
493
697
  # generates the change set by comparing this template with the stack
494
698
  # that you specified.
495
699
  #
@@ -508,15 +712,15 @@ module Aws::CloudFormation
508
712
  #
509
713
  # @!attribute [rw] capabilities
510
714
  # In some cases, you must explicitly acknowledge that your stack
511
- # template contains certain capabilities in order for AWS
512
- # CloudFormation to create the stack.
715
+ # template contains certain capabilities in order for CloudFormation
716
+ # to create the stack.
513
717
  #
514
718
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
515
719
  #
516
720
  # Some stack templates might include resources that can affect
517
- # permissions in your AWS account; for example, by creating new AWS
518
- # Identity and Access Management (IAM) users. For those stacks, you
519
- # must explicitly acknowledge this by specifying one of these
721
+ # permissions in your account; for example, by creating new Identity
722
+ # and Access Management (IAM) users. For those stacks, you must
723
+ # explicitly acknowledge this by specifying one of these
520
724
  # capabilities.
521
725
  #
522
726
  # The following IAM resources require you to specify either the
@@ -527,7 +731,7 @@ module Aws::CloudFormation
527
731
  # * If you have IAM resources with custom names, you *must* specify
528
732
  # `CAPABILITY_NAMED_IAM`.
529
733
  #
530
- # * If you don't specify either of these capabilities, AWS
734
+ # * If you don't specify either of these capabilities,
531
735
  # CloudFormation returns an `InsufficientCapabilities` error.
532
736
  #
533
737
  # If your stack template contains these resources, we recommend that
@@ -548,7 +752,7 @@ module Aws::CloudFormation
548
752
  #
549
753
  # * [ AWS::IAM::UserToGroupAddition][7]
550
754
  #
551
- # For more information, see [Acknowledging IAM Resources in AWS
755
+ # For more information, see [Acknowledging IAM Resources in
552
756
  # CloudFormation Templates][8].
553
757
  #
554
758
  # * `CAPABILITY_AUTO_EXPAND`
@@ -564,7 +768,7 @@ module Aws::CloudFormation
564
768
  # reviewing the resulting changes in a change set, you must
565
769
  # acknowledge this capability. This includes the [AWS::Include][9]
566
770
  # and [AWS::Serverless][10] transforms, which are macros hosted by
567
- # AWS CloudFormation.
771
+ # CloudFormation.
568
772
  #
569
773
  # <note markdown="1"> This capacity does not apply to creating change sets, and
570
774
  # specifying it when creating change sets has no effect.
@@ -576,8 +780,8 @@ module Aws::CloudFormation
576
780
  #
577
781
  # </note>
578
782
  #
579
- # For more information on macros, see [Using AWS CloudFormation
580
- # Macros to Perform Custom Processing on Templates][11].
783
+ # For more information on macros, see [Using CloudFormation Macros
784
+ # to Perform Custom Processing on Templates][11].
581
785
  #
582
786
  #
583
787
  #
@@ -600,12 +804,12 @@ module Aws::CloudFormation
600
804
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
601
805
  #
602
806
  # If the list of resource types doesn't include a resource type that
603
- # you're updating, the stack update fails. By default, AWS
604
- # CloudFormation grants permissions to all resource types. AWS
605
- # Identity and Access Management (IAM) uses this parameter for
606
- # condition keys in IAM policies for AWS CloudFormation. For more
607
- # information, see [Controlling Access with AWS Identity and Access
608
- # Management][1] in the AWS CloudFormation User Guide.
807
+ # you're updating, the stack update fails. By default, CloudFormation
808
+ # grants permissions to all resource types. Identity and Access
809
+ # Management (IAM) uses this parameter for condition keys in IAM
810
+ # policies for CloudFormation. For more information, see [Controlling
811
+ # Access with Identity and Access Management][1] in the CloudFormation
812
+ # User Guide.
609
813
  #
610
814
  #
611
815
  #
@@ -613,38 +817,37 @@ module Aws::CloudFormation
613
817
  # @return [Array<String>]
614
818
  #
615
819
  # @!attribute [rw] role_arn
616
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
617
- # Management (IAM) role that AWS CloudFormation assumes when executing
618
- # the change set. AWS CloudFormation uses the role's credentials to
619
- # make calls on your behalf. AWS CloudFormation uses this role for all
620
- # future operations on the stack. As long as users have permission to
621
- # operate on the stack, AWS CloudFormation uses this role even if the
622
- # users don't have permission to pass it. Ensure that the role grants
623
- # least privilege.
820
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
821
+ # (IAM) role that CloudFormation assumes when executing the change
822
+ # set. CloudFormation uses the role's credentials to make calls on
823
+ # your behalf. CloudFormation uses this role for all future operations
824
+ # on the stack. As long as users have permission to operate on the
825
+ # stack, CloudFormation uses this role even if the users don't have
826
+ # permission to pass it. Ensure that the role grants least privilege.
624
827
  #
625
- # If you don't specify a value, AWS CloudFormation uses the role that
626
- # was previously associated with the stack. If no role is available,
627
- # AWS CloudFormation uses a temporary session that is generated from
628
- # your user credentials.
828
+ # If you don't specify a value, CloudFormation uses the role that was
829
+ # previously associated with the stack. If no role is available,
830
+ # CloudFormation uses a temporary session that is generated from your
831
+ # user credentials.
629
832
  # @return [String]
630
833
  #
631
834
  # @!attribute [rw] rollback_configuration
632
- # The rollback triggers for AWS CloudFormation to monitor during stack
835
+ # The rollback triggers for CloudFormation to monitor during stack
633
836
  # creation and updating operations, and for the specified monitoring
634
837
  # period afterwards.
635
838
  # @return [Types::RollbackConfiguration]
636
839
  #
637
840
  # @!attribute [rw] notification_arns
638
841
  # The Amazon Resource Names (ARNs) of Amazon Simple Notification
639
- # Service (Amazon SNS) topics that AWS CloudFormation associates with
640
- # the stack. To remove all associated notification topics, specify an
842
+ # Service (Amazon SNS) topics that CloudFormation associates with the
843
+ # stack. To remove all associated notification topics, specify an
641
844
  # empty list.
642
845
  # @return [Array<String>]
643
846
  #
644
847
  # @!attribute [rw] tags
645
- # Key-value pairs to associate with this stack. AWS CloudFormation
646
- # also propagates these tags to resources in the stack. You can
647
- # specify a maximum of 50 tags.
848
+ # Key-value pairs to associate with this stack. CloudFormation also
849
+ # propagates these tags to resources in the stack. You can specify a
850
+ # maximum of 50 tags.
648
851
  # @return [Array<Types::Tag>]
649
852
  #
650
853
  # @!attribute [rw] change_set_name
@@ -658,10 +861,10 @@ module Aws::CloudFormation
658
861
  #
659
862
  # @!attribute [rw] client_token
660
863
  # A unique identifier for this `CreateChangeSet` request. Specify this
661
- # token if you plan to retry requests so that AWS CloudFormation knows
864
+ # token if you plan to retry requests so that CloudFormation knows
662
865
  # that you're not attempting to create another change set with the
663
866
  # same name. You might retry `CreateChangeSet` requests to ensure that
664
- # AWS CloudFormation successfully received them.
867
+ # CloudFormation successfully received them.
665
868
  # @return [String]
666
869
  #
667
870
  # @!attribute [rw] description
@@ -674,14 +877,14 @@ module Aws::CloudFormation
674
877
  # stack, specify `UPDATE`. To create a change set for an import
675
878
  # operation, specify `IMPORT`.
676
879
  #
677
- # If you create a change set for a new stack, AWS Cloudformation
678
- # creates a stack with a unique stack ID, but no template or
679
- # resources. The stack will be in the [ `REVIEW_IN_PROGRESS` ][1]
680
- # state until you execute the change set.
880
+ # If you create a change set for a new stack, CloudFormation creates a
881
+ # stack with a unique stack ID, but no template or resources. The
882
+ # stack will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you
883
+ # execute the change set.
681
884
  #
682
- # By default, AWS CloudFormation specifies `UPDATE`. You can't use
683
- # the `UPDATE` type to create a change set for a new stack or the
684
- # `CREATE` type to create a change set for an existing stack.
885
+ # By default, CloudFormation specifies `UPDATE`. You can't use the
886
+ # `UPDATE` type to create a change set for a new stack or the `CREATE`
887
+ # type to create a change set for an existing stack.
685
888
  #
686
889
  #
687
890
  #
@@ -800,7 +1003,7 @@ module Aws::CloudFormation
800
1003
  # @!attribute [rw] template_body
801
1004
  # Structure containing the template body with a minimum length of 1
802
1005
  # byte and a maximum length of 51,200 bytes. For more information, go
803
- # to [Template Anatomy][1] in the AWS CloudFormation User Guide.
1006
+ # to [Template Anatomy][1] in the CloudFormation User Guide.
804
1007
  #
805
1008
  # Conditional: You must specify either the `TemplateBody` or the
806
1009
  # `TemplateURL` parameter, but not both.
@@ -814,7 +1017,7 @@ module Aws::CloudFormation
814
1017
  # Location of file containing the template body. The URL must point to
815
1018
  # a template (max size: 460,800 bytes) that is located in an Amazon S3
816
1019
  # bucket or a Systems Manager document. For more information, go to
817
- # the [Template Anatomy][1] in the AWS CloudFormation User Guide.
1020
+ # the [Template Anatomy][1] in the CloudFormation User Guide.
818
1021
  #
819
1022
  # Conditional: You must specify either the `TemplateBody` or the
820
1023
  # `TemplateURL` parameter, but not both.
@@ -842,7 +1045,7 @@ module Aws::CloudFormation
842
1045
  # @return [Boolean]
843
1046
  #
844
1047
  # @!attribute [rw] rollback_configuration
845
- # The rollback triggers for AWS CloudFormation to monitor during stack
1048
+ # The rollback triggers for CloudFormation to monitor during stack
846
1049
  # creation and updating operations, and for the specified monitoring
847
1050
  # period afterwards.
848
1051
  # @return [Types::RollbackConfiguration]
@@ -861,15 +1064,15 @@ module Aws::CloudFormation
861
1064
  #
862
1065
  # @!attribute [rw] capabilities
863
1066
  # In some cases, you must explicitly acknowledge that your stack
864
- # template contains certain capabilities in order for AWS
865
- # CloudFormation to create the stack.
1067
+ # template contains certain capabilities in order for CloudFormation
1068
+ # to create the stack.
866
1069
  #
867
1070
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
868
1071
  #
869
1072
  # Some stack templates might include resources that can affect
870
- # permissions in your AWS account; for example, by creating new AWS
871
- # Identity and Access Management (IAM) users. For those stacks, you
872
- # must explicitly acknowledge this by specifying one of these
1073
+ # permissions in your account; for example, by creating new Identity
1074
+ # and Access Management (IAM) users. For those stacks, you must
1075
+ # explicitly acknowledge this by specifying one of these
873
1076
  # capabilities.
874
1077
  #
875
1078
  # The following IAM resources require you to specify either the
@@ -880,7 +1083,7 @@ module Aws::CloudFormation
880
1083
  # * If you have IAM resources with custom names, you *must* specify
881
1084
  # `CAPABILITY_NAMED_IAM`.
882
1085
  #
883
- # * If you don't specify either of these capabilities, AWS
1086
+ # * If you don't specify either of these capabilities,
884
1087
  # CloudFormation returns an `InsufficientCapabilities` error.
885
1088
  #
886
1089
  # If your stack template contains these resources, we recommend that
@@ -901,7 +1104,7 @@ module Aws::CloudFormation
901
1104
  #
902
1105
  # * [ AWS::IAM::UserToGroupAddition][7]
903
1106
  #
904
- # For more information, see [Acknowledging IAM Resources in AWS
1107
+ # For more information, see [Acknowledging IAM Resources in
905
1108
  # CloudFormation Templates][8].
906
1109
  #
907
1110
  # * `CAPABILITY_AUTO_EXPAND`
@@ -917,7 +1120,7 @@ module Aws::CloudFormation
917
1120
  # reviewing the resulting changes in a change set, you must
918
1121
  # acknowledge this capability. This includes the [AWS::Include][9]
919
1122
  # and [AWS::Serverless][10] transforms, which are macros hosted by
920
- # AWS CloudFormation.
1123
+ # CloudFormation.
921
1124
  #
922
1125
  # If you want to create a stack from a stack template that contains
923
1126
  # macros *and* nested stacks, you must create the stack directly
@@ -928,11 +1131,11 @@ module Aws::CloudFormation
928
1131
  #
929
1132
  # Each macro relies on an underlying Lambda service function for
930
1133
  # processing stack templates. Be aware that the Lambda function
931
- # owner can update the function operation without AWS CloudFormation
1134
+ # owner can update the function operation without CloudFormation
932
1135
  # being notified.
933
1136
  #
934
- # For more information, see [Using AWS CloudFormation Macros to
935
- # Perform Custom Processing on Templates][11].
1137
+ # For more information, see [Using CloudFormation Macros to Perform
1138
+ # Custom Processing on Templates][11].
936
1139
  #
937
1140
  #
938
1141
  #
@@ -953,19 +1156,19 @@ module Aws::CloudFormation
953
1156
  # The template resource types that you have permissions to work with
954
1157
  # for this create stack action, such as `AWS::EC2::Instance`,
955
1158
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`. Use the following
956
- # syntax to describe template resource types: `AWS::*` (for all AWS
957
- # resource), `Custom::*` (for all custom resources),
1159
+ # syntax to describe template resource types: `AWS::*` (for all Amazon
1160
+ # Web Services resources), `Custom::*` (for all custom resources),
958
1161
  # `Custom::logical_ID ` (for a specific custom resource),
959
- # `AWS::service_name::*` (for all resources of a particular AWS
960
- # service), and `AWS::service_name::resource_logical_ID ` (for a
961
- # specific AWS resource).
1162
+ # `AWS::service_name::*` (for all resources of a particular Amazon Web
1163
+ # Services service), and `AWS::service_name::resource_logical_ID `
1164
+ # (for a specific Amazon Web Services resource).
962
1165
  #
963
1166
  # If the list of resource types doesn't include a resource that
964
- # you're creating, the stack creation fails. By default, AWS
965
- # CloudFormation grants permissions to all resource types. AWS
966
- # Identity and Access Management (IAM) uses this parameter for AWS
1167
+ # you're creating, the stack creation fails. By default,
1168
+ # CloudFormation grants permissions to all resource types. Identity
1169
+ # and Access Management (IAM) uses this parameter for
967
1170
  # CloudFormation-specific condition keys in IAM policies. For more
968
- # information, see [Controlling Access with AWS Identity and Access
1171
+ # information, see [Controlling Access with Identity and Access
969
1172
  # Management][1].
970
1173
  #
971
1174
  #
@@ -974,19 +1177,19 @@ module Aws::CloudFormation
974
1177
  # @return [Array<String>]
975
1178
  #
976
1179
  # @!attribute [rw] role_arn
977
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
978
- # Management (IAM) role that AWS CloudFormation assumes to create the
979
- # stack. AWS CloudFormation uses the role's credentials to make calls
980
- # on your behalf. AWS CloudFormation always uses this role for all
981
- # future operations on the stack. As long as users have permission to
982
- # operate on the stack, AWS CloudFormation uses this role even if the
983
- # users don't have permission to pass it. Ensure that the role grants
984
- # least privilege.
1180
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1181
+ # (IAM) role that CloudFormation assumes to create the stack.
1182
+ # CloudFormation uses the role's credentials to make calls on your
1183
+ # behalf. CloudFormation always uses this role for all future
1184
+ # operations on the stack. As long as users have permission to operate
1185
+ # on the stack, CloudFormation uses this role even if the users don't
1186
+ # have permission to pass it. Ensure that the role grants least
1187
+ # privilege.
985
1188
  #
986
- # If you don't specify a value, AWS CloudFormation uses the role that
987
- # was previously associated with the stack. If no role is available,
988
- # AWS CloudFormation uses a temporary session that is generated from
989
- # your user credentials.
1189
+ # If you don't specify a value, CloudFormation uses the role that was
1190
+ # previously associated with the stack. If no role is available,
1191
+ # CloudFormation uses a temporary session that is generated from your
1192
+ # user credentials.
990
1193
  # @return [String]
991
1194
  #
992
1195
  # @!attribute [rw] on_failure
@@ -999,9 +1202,9 @@ module Aws::CloudFormation
999
1202
  #
1000
1203
  # @!attribute [rw] stack_policy_body
1001
1204
  # Structure containing the stack policy body. For more information, go
1002
- # to [ Prevent Updates to Stack Resources][1] in the *AWS
1003
- # CloudFormation User Guide*. You can specify either the
1004
- # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
1205
+ # to [ Prevent Updates to Stack Resources][1] in the *CloudFormation
1206
+ # User Guide*. You can specify either the `StackPolicyBody` or the
1207
+ # `StackPolicyURL` parameter, but not both.
1005
1208
  #
1006
1209
  #
1007
1210
  #
@@ -1016,17 +1219,17 @@ module Aws::CloudFormation
1016
1219
  # @return [String]
1017
1220
  #
1018
1221
  # @!attribute [rw] tags
1019
- # Key-value pairs to associate with this stack. AWS CloudFormation
1020
- # also propagates these tags to the resources created in the stack. A
1222
+ # Key-value pairs to associate with this stack. CloudFormation also
1223
+ # propagates these tags to the resources created in the stack. A
1021
1224
  # maximum number of 50 tags can be specified.
1022
1225
  # @return [Array<Types::Tag>]
1023
1226
  #
1024
1227
  # @!attribute [rw] client_request_token
1025
1228
  # A unique identifier for this `CreateStack` request. Specify this
1026
- # token if you plan to retry requests so that AWS CloudFormation knows
1229
+ # token if you plan to retry requests so that CloudFormation knows
1027
1230
  # that you're not attempting to create a stack with the same name.
1028
- # You might retry `CreateStack` requests to ensure that AWS
1029
- # CloudFormation successfully received them.
1231
+ # You might retry `CreateStack` requests to ensure that CloudFormation
1232
+ # successfully received them.
1030
1233
  #
1031
1234
  # All events triggered by a given stack operation are assigned the
1032
1235
  # same client request token, which you can use to track operations.
@@ -1048,8 +1251,8 @@ module Aws::CloudFormation
1048
1251
  # a user attempts to delete a stack with termination protection
1049
1252
  # enabled, the operation fails and the stack remains unchanged. For
1050
1253
  # more information, see [Protecting a Stack From Being Deleted][1] in
1051
- # the *AWS CloudFormation User Guide*. Termination protection is
1052
- # disabled on stacks by default.
1254
+ # the *CloudFormation User Guide*. Termination protection is disabled
1255
+ # on stacks by default.
1053
1256
  #
1054
1257
  # For [nested stacks][2], termination protection is set on the root
1055
1258
  # stack and cannot be changed directly on the nested stack.
@@ -1122,23 +1325,22 @@ module Aws::CloudFormation
1122
1325
  # @return [String]
1123
1326
  #
1124
1327
  # @!attribute [rw] accounts
1125
- # \[Self-managed permissions\] The names of one or more AWS accounts
1126
- # that you want to create stack instances in the specified Region(s)
1127
- # for.
1328
+ # \[Self-managed permissions\] The names of one or more accounts that
1329
+ # you want to create stack instances in the specified Region(s) for.
1128
1330
  #
1129
1331
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1130
1332
  # @return [Array<String>]
1131
1333
  #
1132
1334
  # @!attribute [rw] deployment_targets
1133
- # \[Service-managed permissions\] The AWS Organizations accounts for
1134
- # which to create stack instances in the specified Regions.
1335
+ # \[Service-managed permissions\] The Organizations accounts for which
1336
+ # to create stack instances in the specified Regions.
1135
1337
  #
1136
1338
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1137
1339
  # @return [Types::DeploymentTargets]
1138
1340
  #
1139
1341
  # @!attribute [rw] regions
1140
1342
  # The names of one or more Regions where you want to create stack
1141
- # instances using the specified AWS account(s).
1343
+ # instances using the specified accounts.
1142
1344
  # @return [Array<String>]
1143
1345
  #
1144
1346
  # @!attribute [rw] parameter_overrides
@@ -1147,24 +1349,19 @@ module Aws::CloudFormation
1147
1349
  #
1148
1350
  # Any overridden parameter values will be applied to all stack
1149
1351
  # instances in the specified accounts and Regions. When specifying
1150
- # parameters and their values, be aware of how AWS CloudFormation sets
1352
+ # parameters and their values, be aware of how CloudFormation sets
1151
1353
  # parameter values during stack instance operations:
1152
1354
  #
1153
1355
  # * To override the current value for a parameter, include the
1154
1356
  # parameter and specify its value.
1155
1357
  #
1156
- # * To leave a parameter set to its present value, you can do one of
1157
- # the following:
1158
- #
1159
- # * Do not include the parameter in the list.
1160
- #
1161
- # * Include the parameter and specify `UsePreviousValue` as `true`.
1162
- # (You cannot specify both a value and set `UsePreviousValue` to
1163
- # `true`.)
1358
+ # * To leave an overridden parameter set to its present value, include
1359
+ # the parameter and specify `UsePreviousValue` as `true`. (You
1360
+ # cannot specify both a value and set `UsePreviousValue` to `true`.)
1164
1361
  #
1165
- # * To set all overridden parameter back to the values specified in
1166
- # the stack set, specify a parameter list but do not include any
1167
- # parameters.
1362
+ # * To set an overridden parameter back to the value specified in the
1363
+ # stack set, specify a parameter list but do not include the
1364
+ # parameter in the list.
1168
1365
  #
1169
1366
  # * To leave all parameters set to their present values, do not
1170
1367
  # specify this property at all.
@@ -1182,7 +1379,7 @@ module Aws::CloudFormation
1182
1379
  # @return [Array<Types::Parameter>]
1183
1380
  #
1184
1381
  # @!attribute [rw] operation_preferences
1185
- # Preferences for how AWS CloudFormation performs this stack set
1382
+ # Preferences for how CloudFormation performs this stack set
1186
1383
  # operation.
1187
1384
  # @return [Types::StackSetOperationPreferences]
1188
1385
  #
@@ -1190,10 +1387,10 @@ module Aws::CloudFormation
1190
1387
  # The unique identifier for this stack set operation.
1191
1388
  #
1192
1389
  # The operation ID also functions as an idempotency token, to ensure
1193
- # that AWS CloudFormation performs the stack set operation only once,
1194
- # even if you retry the request multiple times. You might retry stack
1195
- # set operation requests to ensure that AWS CloudFormation
1196
- # successfully received them.
1390
+ # that CloudFormation performs the stack set operation only once, even
1391
+ # if you retry the request multiple times. You might retry stack set
1392
+ # operation requests to ensure that CloudFormation successfully
1393
+ # received them.
1197
1394
  #
1198
1395
  # If you don't specify an operation ID, the SDK generates one
1199
1396
  # automatically.
@@ -1218,10 +1415,9 @@ module Aws::CloudFormation
1218
1415
  # * If you are signed in to a delegated administrator account, specify
1219
1416
  # `DELEGATED_ADMIN`.
1220
1417
  #
1221
- # Your AWS account must be registered as a delegated administrator
1222
- # in the management account. For more information, see [Register a
1223
- # delegated administrator][1] in the *AWS CloudFormation User
1224
- # Guide*.
1418
+ # Your account must be registered as a delegated administrator in
1419
+ # the management account. For more information, see [Register a
1420
+ # delegated administrator][1] in the *CloudFormation User Guide*.
1225
1421
  #
1226
1422
  #
1227
1423
  #
@@ -1277,6 +1473,7 @@ module Aws::CloudFormation
1277
1473
  # description: "Description",
1278
1474
  # template_body: "TemplateBody",
1279
1475
  # template_url: "TemplateURL",
1476
+ # stack_id: "StackId",
1280
1477
  # parameters: [
1281
1478
  # {
1282
1479
  # parameter_key: "ParameterKey",
@@ -1322,8 +1519,8 @@ module Aws::CloudFormation
1322
1519
  # @!attribute [rw] template_body
1323
1520
  # The structure that contains the template body, with a minimum length
1324
1521
  # of 1 byte and a maximum length of 51,200 bytes. For more
1325
- # information, see [Template Anatomy][1] in the AWS CloudFormation
1326
- # User Guide.
1522
+ # information, see [Template Anatomy][1] in the CloudFormation User
1523
+ # Guide.
1327
1524
  #
1328
1525
  # Conditional: You must specify either the TemplateBody or the
1329
1526
  # TemplateURL parameter, but not both.
@@ -1337,8 +1534,8 @@ module Aws::CloudFormation
1337
1534
  # The location of the file that contains the template body. The URL
1338
1535
  # must point to a template (maximum size: 460,800 bytes) that's
1339
1536
  # located in an Amazon S3 bucket or a Systems Manager document. For
1340
- # more information, see [Template Anatomy][1] in the AWS
1341
- # CloudFormation User Guide.
1537
+ # more information, see [Template Anatomy][1] in the CloudFormation
1538
+ # User Guide.
1342
1539
  #
1343
1540
  # Conditional: You must specify either the TemplateBody or the
1344
1541
  # TemplateURL parameter, but not both.
@@ -1348,21 +1545,26 @@ module Aws::CloudFormation
1348
1545
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
1349
1546
  # @return [String]
1350
1547
  #
1548
+ # @!attribute [rw] stack_id
1549
+ # The stack ID you are importing into a new stack set. Specify the
1550
+ # Amazon Resource Number (ARN) of the stack.
1551
+ # @return [String]
1552
+ #
1351
1553
  # @!attribute [rw] parameters
1352
1554
  # The input parameters for the stack set template.
1353
1555
  # @return [Array<Types::Parameter>]
1354
1556
  #
1355
1557
  # @!attribute [rw] capabilities
1356
1558
  # In some cases, you must explicitly acknowledge that your stack set
1357
- # template contains certain capabilities in order for AWS
1358
- # CloudFormation to create the stack set and related stack instances.
1559
+ # template contains certain capabilities in order for CloudFormation
1560
+ # to create the stack set and related stack instances.
1359
1561
  #
1360
1562
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1361
1563
  #
1362
1564
  # Some stack templates might include resources that can affect
1363
- # permissions in your AWS account; for example, by creating new AWS
1364
- # Identity and Access Management (IAM) users. For those stack sets,
1365
- # you must explicitly acknowledge this by specifying one of these
1565
+ # permissions in your account; for example, by creating new Identity
1566
+ # and Access Management (IAM) users. For those stack sets, you must
1567
+ # explicitly acknowledge this by specifying one of these
1366
1568
  # capabilities.
1367
1569
  #
1368
1570
  # The following IAM resources require you to specify either the
@@ -1373,7 +1575,7 @@ module Aws::CloudFormation
1373
1575
  # * If you have IAM resources with custom names, you *must* specify
1374
1576
  # `CAPABILITY_NAMED_IAM`.
1375
1577
  #
1376
- # * If you don't specify either of these capabilities, AWS
1578
+ # * If you don't specify either of these capabilities,
1377
1579
  # CloudFormation returns an `InsufficientCapabilities` error.
1378
1580
  #
1379
1581
  # If your stack template contains these resources, we recommend that
@@ -1394,25 +1596,26 @@ module Aws::CloudFormation
1394
1596
  #
1395
1597
  # * [ AWS::IAM::UserToGroupAddition][7]
1396
1598
  #
1397
- # For more information, see [Acknowledging IAM Resources in AWS
1599
+ # For more information, see [Acknowledging IAM Resources in
1398
1600
  # CloudFormation Templates][8].
1399
1601
  #
1400
1602
  # * `CAPABILITY_AUTO_EXPAND`
1401
1603
  #
1402
- # Some templates contain macros. If your stack template contains one
1403
- # or more macros, and you choose to create a stack directly from the
1404
- # processed template, without first reviewing the resulting changes
1405
- # in a change set, you must acknowledge this capability. For more
1406
- # information, see [Using AWS CloudFormation Macros to Perform
1407
- # Custom Processing on Templates][9].
1604
+ # Some templates reference macros. If your stack set template
1605
+ # references one or more macros, you must create the stack set
1606
+ # directly from the processed template, without first reviewing the
1607
+ # resulting changes in a change set. To create the stack set
1608
+ # directly, you must acknowledge this capability. For more
1609
+ # information, see [Using CloudFormation Macros to Perform Custom
1610
+ # Processing on Templates][9].
1408
1611
  #
1409
- # <note markdown="1"> Stack sets do not currently support macros in stack templates.
1410
- # (This includes the [AWS::Include][10] and [AWS::Serverless][11]
1411
- # transforms, which are macros hosted by AWS CloudFormation.) Even
1412
- # if you specify this capability, if you include a macro in your
1413
- # template the stack set operation will fail.
1414
- #
1415
- # </note>
1612
+ # Stack sets with service-managed permissions do not currently
1613
+ # support the use of macros in templates. (This includes the
1614
+ # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1615
+ # macros hosted by CloudFormation.) Even if you specify this
1616
+ # capability for a stack set with service-managed permissions, if
1617
+ # you reference a macro in your template the stack set operation
1618
+ # will fail.
1416
1619
  #
1417
1620
  #
1418
1621
  #
@@ -1431,11 +1634,11 @@ module Aws::CloudFormation
1431
1634
  #
1432
1635
  # @!attribute [rw] tags
1433
1636
  # The key-value pairs to associate with this stack set and the stacks
1434
- # created from it. AWS CloudFormation also propagates these tags to
1637
+ # created from it. CloudFormation also propagates these tags to
1435
1638
  # supported resources that are created in the stacks. A maximum number
1436
1639
  # of 50 tags can be specified.
1437
1640
  #
1438
- # If you specify tags as part of a `CreateStackSet` action, AWS
1641
+ # If you specify tags as part of a `CreateStackSet` action,
1439
1642
  # CloudFormation checks to see if you have the required IAM permission
1440
1643
  # to tag resources. If you don't, the entire `CreateStackSet` action
1441
1644
  # fails with an `access denied` error, and the stack set is not
@@ -1450,7 +1653,7 @@ module Aws::CloudFormation
1450
1653
  # roles to control which users or groups can manage specific stack
1451
1654
  # sets within the same administrator account. For more information,
1452
1655
  # see [Prerequisites: Granting Permissions for Stack Set
1453
- # Operations][1] in the *AWS CloudFormation User Guide*.
1656
+ # Operations][1] in the *CloudFormation User Guide*.
1454
1657
  #
1455
1658
  #
1456
1659
  #
@@ -1459,7 +1662,7 @@ module Aws::CloudFormation
1459
1662
  #
1460
1663
  # @!attribute [rw] execution_role_name
1461
1664
  # The name of the IAM execution role to use to create the stack set.
1462
- # If you do not specify an execution role, AWS CloudFormation uses the
1665
+ # If you do not specify an execution role, CloudFormation uses the
1463
1666
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
1464
1667
  # operation.
1465
1668
  #
@@ -1479,8 +1682,8 @@ module Aws::CloudFormation
1479
1682
  #
1480
1683
  # * With `service-managed` permissions, StackSets automatically
1481
1684
  # creates the IAM roles required to deploy to accounts managed by
1482
- # AWS Organizations. For more information, see [Grant
1483
- # Service-Managed Stack Set Permissions][2].
1685
+ # Organizations. For more information, see [Grant Service-Managed
1686
+ # Stack Set Permissions][2].
1484
1687
  #
1485
1688
  #
1486
1689
  #
@@ -1489,10 +1692,9 @@ module Aws::CloudFormation
1489
1692
  # @return [String]
1490
1693
  #
1491
1694
  # @!attribute [rw] auto_deployment
1492
- # Describes whether StackSets automatically deploys to AWS
1493
- # Organizations accounts that are added to the target organization or
1494
- # organizational unit (OU). Specify only if `PermissionModel` is
1495
- # `SERVICE_MANAGED`.
1695
+ # Describes whether StackSets automatically deploys to Organizations
1696
+ # accounts that are added to the target organization or organizational
1697
+ # unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
1496
1698
  # @return [Types::AutoDeployment]
1497
1699
  #
1498
1700
  # @!attribute [rw] call_as
@@ -1510,10 +1712,9 @@ module Aws::CloudFormation
1510
1712
  # signed in to a delegated administrator account, specify
1511
1713
  # `DELEGATED_ADMIN`.
1512
1714
  #
1513
- # Your AWS account must be registered as a delegated admin in the
1715
+ # Your account must be registered as a delegated admin in the
1514
1716
  # management account. For more information, see [Register a
1515
- # delegated administrator][1] in the *AWS CloudFormation User
1516
- # Guide*.
1717
+ # delegated administrator][1] in the *CloudFormation User Guide*.
1517
1718
  #
1518
1719
  # Stack sets with service-managed permissions are created in the
1519
1720
  # management account, including stack sets that are created by
@@ -1526,10 +1727,10 @@ module Aws::CloudFormation
1526
1727
  #
1527
1728
  # @!attribute [rw] client_request_token
1528
1729
  # A unique identifier for this `CreateStackSet` request. Specify this
1529
- # token if you plan to retry requests so that AWS CloudFormation knows
1730
+ # token if you plan to retry requests so that CloudFormation knows
1530
1731
  # that you're not attempting to create another stack set with the
1531
1732
  # same name. You might retry `CreateStackSet` requests to ensure that
1532
- # AWS CloudFormation successfully received them.
1733
+ # CloudFormation successfully received them.
1533
1734
  #
1534
1735
  # If you don't specify an operation ID, the SDK generates one
1535
1736
  # automatically.
@@ -1545,6 +1746,7 @@ module Aws::CloudFormation
1545
1746
  :description,
1546
1747
  :template_body,
1547
1748
  :template_url,
1749
+ :stack_id,
1548
1750
  :parameters,
1549
1751
  :capabilities,
1550
1752
  :tags,
@@ -1576,6 +1778,53 @@ module Aws::CloudFormation
1576
1778
  #
1577
1779
  class CreatedButModifiedException < Aws::EmptyStructure; end
1578
1780
 
1781
+ # @note When making an API call, you may pass DeactivateTypeInput
1782
+ # data as a hash:
1783
+ #
1784
+ # {
1785
+ # type_name: "TypeName",
1786
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
1787
+ # arn: "PrivateTypeArn",
1788
+ # }
1789
+ #
1790
+ # @!attribute [rw] type_name
1791
+ # The type name of the extension, in this account and region. If you
1792
+ # specified a type name alias when enabling the extension, use the
1793
+ # type name alias.
1794
+ #
1795
+ # Conditional: You must specify either `Arn`, or `TypeName` and
1796
+ # `Type`.
1797
+ # @return [String]
1798
+ #
1799
+ # @!attribute [rw] type
1800
+ # The extension type.
1801
+ #
1802
+ # Conditional: You must specify either `Arn`, or `TypeName` and
1803
+ # `Type`.
1804
+ # @return [String]
1805
+ #
1806
+ # @!attribute [rw] arn
1807
+ # The Amazon Resource Name (ARN) for the extension, in this account
1808
+ # and region.
1809
+ #
1810
+ # Conditional: You must specify either `Arn`, or `TypeName` and
1811
+ # `Type`.
1812
+ # @return [String]
1813
+ #
1814
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeactivateTypeInput AWS API Documentation
1815
+ #
1816
+ class DeactivateTypeInput < Struct.new(
1817
+ :type_name,
1818
+ :type,
1819
+ :arn)
1820
+ SENSITIVE = []
1821
+ include Aws::Structure
1822
+ end
1823
+
1824
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeactivateTypeOutput AWS API Documentation
1825
+ #
1826
+ class DeactivateTypeOutput < Aws::EmptyStructure; end
1827
+
1579
1828
  # The input for the DeleteChangeSet action.
1580
1829
  #
1581
1830
  # @note When making an API call, you may pass DeleteChangeSetInput
@@ -1630,7 +1879,7 @@ module Aws::CloudFormation
1630
1879
  # @!attribute [rw] retain_resources
1631
1880
  # For stacks in the `DELETE_FAILED` state, a list of resource logical
1632
1881
  # IDs that are associated with the resources you want to retain.
1633
- # During deletion, AWS CloudFormation deletes the stack but does not
1882
+ # During deletion, CloudFormation deletes the stack but does not
1634
1883
  # delete the retained resources.
1635
1884
  #
1636
1885
  # Retaining resources is useful when you cannot delete a resource,
@@ -1638,23 +1887,23 @@ module Aws::CloudFormation
1638
1887
  # @return [Array<String>]
1639
1888
  #
1640
1889
  # @!attribute [rw] role_arn
1641
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
1642
- # Management (IAM) role that AWS CloudFormation assumes to delete the
1643
- # stack. AWS CloudFormation uses the role's credentials to make calls
1644
- # on your behalf.
1890
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1891
+ # (IAM) role that CloudFormation assumes to delete the stack.
1892
+ # CloudFormation uses the role's credentials to make calls on your
1893
+ # behalf.
1645
1894
  #
1646
- # If you don't specify a value, AWS CloudFormation uses the role that
1647
- # was previously associated with the stack. If no role is available,
1648
- # AWS CloudFormation uses a temporary session that is generated from
1649
- # your user credentials.
1895
+ # If you don't specify a value, CloudFormation uses the role that was
1896
+ # previously associated with the stack. If no role is available,
1897
+ # CloudFormation uses a temporary session that is generated from your
1898
+ # user credentials.
1650
1899
  # @return [String]
1651
1900
  #
1652
1901
  # @!attribute [rw] client_request_token
1653
1902
  # A unique identifier for this `DeleteStack` request. Specify this
1654
- # token if you plan to retry requests so that AWS CloudFormation knows
1903
+ # token if you plan to retry requests so that CloudFormation knows
1655
1904
  # that you're not attempting to delete a stack with the same name.
1656
- # You might retry `DeleteStack` requests to ensure that AWS
1657
- # CloudFormation successfully received them.
1905
+ # You might retry `DeleteStack` requests to ensure that CloudFormation
1906
+ # successfully received them.
1658
1907
  #
1659
1908
  # All events triggered by a given stack operation are assigned the
1660
1909
  # same client request token, which you can use to track operations.
@@ -1713,14 +1962,14 @@ module Aws::CloudFormation
1713
1962
  # @return [String]
1714
1963
  #
1715
1964
  # @!attribute [rw] accounts
1716
- # \[Self-managed permissions\] The names of the AWS accounts that you
1717
- # want to delete stack instances for.
1965
+ # \[Self-managed permissions\] The names of the accounts that you want
1966
+ # to delete stack instances for.
1718
1967
  #
1719
1968
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1720
1969
  # @return [Array<String>]
1721
1970
  #
1722
1971
  # @!attribute [rw] deployment_targets
1723
- # \[Service-managed permissions\] The AWS Organizations accounts from
1972
+ # \[Service-managed permissions\] The Organizations accounts from
1724
1973
  # which to delete stack instances.
1725
1974
  #
1726
1975
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
@@ -1731,7 +1980,7 @@ module Aws::CloudFormation
1731
1980
  # @return [Array<String>]
1732
1981
  #
1733
1982
  # @!attribute [rw] operation_preferences
1734
- # Preferences for how AWS CloudFormation performs this stack set
1983
+ # Preferences for how CloudFormation performs this stack set
1735
1984
  # operation.
1736
1985
  # @return [Types::StackSetOperationPreferences]
1737
1986
  #
@@ -1754,10 +2003,10 @@ module Aws::CloudFormation
1754
2003
  # automatically.
1755
2004
  #
1756
2005
  # The operation ID also functions as an idempotency token, to ensure
1757
- # that AWS CloudFormation performs the stack set operation only once,
1758
- # even if you retry the request multiple times. You can retry stack
1759
- # set operation requests to ensure that AWS CloudFormation
1760
- # successfully received them.
2006
+ # that CloudFormation performs the stack set operation only once, even
2007
+ # if you retry the request multiple times. You can retry stack set
2008
+ # operation requests to ensure that CloudFormation successfully
2009
+ # received them.
1761
2010
  #
1762
2011
  # Repeating this stack set operation with a new operation ID retries
1763
2012
  # all stack instances whose status is `OUTDATED`.
@@ -1779,10 +2028,9 @@ module Aws::CloudFormation
1779
2028
  # * If you are signed in to a delegated administrator account, specify
1780
2029
  # `DELEGATED_ADMIN`.
1781
2030
  #
1782
- # Your AWS account must be registered as a delegated administrator
1783
- # in the management account. For more information, see [Register a
1784
- # delegated administrator][1] in the *AWS CloudFormation User
1785
- # Guide*.
2031
+ # Your account must be registered as a delegated administrator in
2032
+ # the management account. For more information, see [Register a
2033
+ # delegated administrator][1] in the *CloudFormation User Guide*.
1786
2034
  #
1787
2035
  #
1788
2036
  #
@@ -1842,10 +2090,9 @@ module Aws::CloudFormation
1842
2090
  # * If you are signed in to a delegated administrator account, specify
1843
2091
  # `DELEGATED_ADMIN`.
1844
2092
  #
1845
- # Your AWS account must be registered as a delegated administrator
1846
- # in the management account. For more information, see [Register a
1847
- # delegated administrator][1] in the *AWS CloudFormation User
1848
- # Guide*.
2093
+ # Your account must be registered as a delegated administrator in
2094
+ # the management account. For more information, see [Register a
2095
+ # delegated administrator][1] in the *CloudFormation User Guide*.
1849
2096
  #
1850
2097
  #
1851
2098
  #
@@ -1865,11 +2112,10 @@ module Aws::CloudFormation
1865
2112
  #
1866
2113
  class DeleteStackSetOutput < Aws::EmptyStructure; end
1867
2114
 
1868
- # \[Service-managed permissions\] The AWS Organizations accounts to
1869
- # which StackSets deploys. StackSets does not deploy stack instances to
1870
- # the organization management account, even if the organization
1871
- # management account is in your organization or in an OU in your
1872
- # organization.
2115
+ # \[Service-managed permissions\] The Organizations accounts to which
2116
+ # StackSets deploys. StackSets does not deploy stack instances to the
2117
+ # organization management account, even if the organization management
2118
+ # account is in your organization or in an OU in your organization.
1873
2119
  #
1874
2120
  # For update operations, you can specify either `Accounts` or
1875
2121
  # `OrganizationalUnitIds`. For create and delete operations, specify
@@ -1885,11 +2131,12 @@ module Aws::CloudFormation
1885
2131
  # }
1886
2132
  #
1887
2133
  # @!attribute [rw] accounts
1888
- # The names of one or more AWS accounts for which you want to deploy
1889
- # stack set updates.
2134
+ # The names of one or more accounts for which you want to deploy stack
2135
+ # set updates.
1890
2136
  # @return [Array<String>]
1891
2137
  #
1892
2138
  # @!attribute [rw] accounts_url
2139
+ # Returns the value of the `AccountsUrl` property.
1893
2140
  # @return [String]
1894
2141
  #
1895
2142
  # @!attribute [rw] organizational_unit_ids
@@ -1984,7 +2231,7 @@ module Aws::CloudFormation
1984
2231
  # The output for the DescribeAccountLimits action.
1985
2232
  #
1986
2233
  # @!attribute [rw] account_limits
1987
- # An account limit structure that contain a list of AWS CloudFormation
2234
+ # An account limit structure that contain a list of CloudFormation
1988
2235
  # account limits and their values.
1989
2236
  # @return [Array<Types::AccountLimit>]
1990
2237
  #
@@ -2079,8 +2326,8 @@ module Aws::CloudFormation
2079
2326
  # If the change set execution status is `AVAILABLE`, you can execute
2080
2327
  # the change set. If you can’t execute the change set, the status
2081
2328
  # indicates why. For example, a change set might be in an
2082
- # `UNAVAILABLE` state because AWS CloudFormation is still creating it
2083
- # or in an `OBSOLETE` state because the stack was already updated.
2329
+ # `UNAVAILABLE` state because CloudFormation is still creating it or
2330
+ # in an `OBSOLETE` state because the stack was already updated.
2084
2331
  # @return [String]
2085
2332
  #
2086
2333
  # @!attribute [rw] status
@@ -2090,7 +2337,7 @@ module Aws::CloudFormation
2090
2337
  #
2091
2338
  # @!attribute [rw] status_reason
2092
2339
  # A description of the change set's status. For example, if your
2093
- # attempt to create a change set failed, AWS CloudFormation shows the
2340
+ # attempt to create a change set failed, CloudFormation shows the
2094
2341
  # error message.
2095
2342
  # @return [String]
2096
2343
  #
@@ -2101,7 +2348,7 @@ module Aws::CloudFormation
2101
2348
  # @return [Array<String>]
2102
2349
  #
2103
2350
  # @!attribute [rw] rollback_configuration
2104
- # The rollback triggers for AWS CloudFormation to monitor during stack
2351
+ # The rollback triggers for CloudFormation to monitor during stack
2105
2352
  # creation and updating operations, and for the specified monitoring
2106
2353
  # period afterwards.
2107
2354
  # @return [Types::RollbackConfiguration]
@@ -2117,7 +2364,7 @@ module Aws::CloudFormation
2117
2364
  # @return [Array<Types::Tag>]
2118
2365
  #
2119
2366
  # @!attribute [rw] changes
2120
- # A list of `Change` structures that describes the resources AWS
2367
+ # A list of `Change` structures that describes the resources
2121
2368
  # CloudFormation changes if you execute the change set.
2122
2369
  # @return [Array<Types::Change>]
2123
2370
  #
@@ -2166,6 +2413,58 @@ module Aws::CloudFormation
2166
2413
  include Aws::Structure
2167
2414
  end
2168
2415
 
2416
+ # @note When making an API call, you may pass DescribePublisherInput
2417
+ # data as a hash:
2418
+ #
2419
+ # {
2420
+ # publisher_id: "PublisherId",
2421
+ # }
2422
+ #
2423
+ # @!attribute [rw] publisher_id
2424
+ # The ID of the extension publisher.
2425
+ #
2426
+ # If you do not supply a `PublisherId`, and you have registered as an
2427
+ # extension publisher, `DescribePublisher` returns information about
2428
+ # your own publisher account.
2429
+ # @return [String]
2430
+ #
2431
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisherInput AWS API Documentation
2432
+ #
2433
+ class DescribePublisherInput < Struct.new(
2434
+ :publisher_id)
2435
+ SENSITIVE = []
2436
+ include Aws::Structure
2437
+ end
2438
+
2439
+ # @!attribute [rw] publisher_id
2440
+ # The ID of the extension publisher.
2441
+ # @return [String]
2442
+ #
2443
+ # @!attribute [rw] publisher_status
2444
+ # Whether the publisher is verified. Currently, all registered
2445
+ # publishers are verified.
2446
+ # @return [String]
2447
+ #
2448
+ # @!attribute [rw] identity_provider
2449
+ # The type of account used as the identity provider when registering
2450
+ # this publisher with CloudFormation.
2451
+ # @return [String]
2452
+ #
2453
+ # @!attribute [rw] publisher_profile
2454
+ # The URL to the publisher's profile with the identity provider.
2455
+ # @return [String]
2456
+ #
2457
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisherOutput AWS API Documentation
2458
+ #
2459
+ class DescribePublisherOutput < Struct.new(
2460
+ :publisher_id,
2461
+ :publisher_status,
2462
+ :identity_provider,
2463
+ :publisher_profile)
2464
+ SENSITIVE = []
2465
+ include Aws::Structure
2466
+ end
2467
+
2169
2468
  # @note When making an API call, you may pass DescribeStackDriftDetectionStatusInput
2170
2469
  # data as a hash:
2171
2470
  #
@@ -2176,9 +2475,9 @@ module Aws::CloudFormation
2176
2475
  # @!attribute [rw] stack_drift_detection_id
2177
2476
  # The ID of the drift detection results of this operation.
2178
2477
  #
2179
- # AWS CloudFormation generates new results, with a new drift detection
2180
- # ID, each time this operation is run. However, the number of drift
2181
- # results AWS CloudFormation retains for any given stack, and for how
2478
+ # CloudFormation generates new results, with a new drift detection ID,
2479
+ # each time this operation is run. However, the number of drift
2480
+ # results CloudFormation retains for any given stack, and for how
2182
2481
  # long, may vary.
2183
2482
  # @return [String]
2184
2483
  #
@@ -2197,10 +2496,10 @@ module Aws::CloudFormation
2197
2496
  # @!attribute [rw] stack_drift_detection_id
2198
2497
  # The ID of the drift detection results of this operation.
2199
2498
  #
2200
- # AWS CloudFormation generates new results, with a new drift detection
2201
- # ID, each time this operation is run. However, the number of reports
2202
- # AWS CloudFormation retains for any given stack, and for how long,
2203
- # may vary.
2499
+ # CloudFormation generates new results, with a new drift detection ID,
2500
+ # each time this operation is run. However, the number of reports
2501
+ # CloudFormation retains for any given stack, and for how long, may
2502
+ # vary.
2204
2503
  # @return [String]
2205
2504
  #
2206
2505
  # @!attribute [rw] stack_drift_status
@@ -2211,7 +2510,7 @@ module Aws::CloudFormation
2211
2510
  # configuration. A stack is considered to have drifted if one or
2212
2511
  # more of its resources have drifted.
2213
2512
  #
2214
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the stack
2513
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
2215
2514
  # differs from its expected template configuration.
2216
2515
  #
2217
2516
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -2228,13 +2527,13 @@ module Aws::CloudFormation
2228
2527
  # drift detection. (Resources that do not currently support stack
2229
2528
  # detection remain unchecked.)
2230
2529
  #
2231
- # If you specified logical resource IDs for AWS CloudFormation to
2232
- # use as a filter for the stack drift detection operation, only the
2530
+ # If you specified logical resource IDs for CloudFormation to use as
2531
+ # a filter for the stack drift detection operation, only the
2233
2532
  # resources with those logical IDs are checked for drift.
2234
2533
  #
2235
2534
  # * `DETECTION_FAILED`\: The stack drift detection operation has
2236
2535
  # failed for at least one resource in the stack. Results will be
2237
- # available for resources on which AWS CloudFormation successfully
2536
+ # available for resources on which CloudFormation successfully
2238
2537
  # completed drift detection.
2239
2538
  #
2240
2539
  # * `DETECTION_IN_PROGRESS`\: The stack drift detection operation is
@@ -2344,8 +2643,7 @@ module Aws::CloudFormation
2344
2643
  # @return [String]
2345
2644
  #
2346
2645
  # @!attribute [rw] stack_instance_account
2347
- # The ID of an AWS account that's associated with this stack
2348
- # instance.
2646
+ # The ID of an account that's associated with this stack instance.
2349
2647
  # @return [String]
2350
2648
  #
2351
2649
  # @!attribute [rw] stack_instance_region
@@ -2365,10 +2663,9 @@ module Aws::CloudFormation
2365
2663
  # * If you are signed in to a delegated administrator account, specify
2366
2664
  # `DELEGATED_ADMIN`.
2367
2665
  #
2368
- # Your AWS account must be registered as a delegated administrator
2369
- # in the management account. For more information, see [Register a
2370
- # delegated administrator][1] in the *AWS CloudFormation User
2371
- # Guide*.
2666
+ # Your account must be registered as a delegated administrator in
2667
+ # the management account. For more information, see [Register a
2668
+ # delegated administrator][1] in the *CloudFormation User Guide*.
2372
2669
  #
2373
2670
  #
2374
2671
  #
@@ -2425,7 +2722,7 @@ module Aws::CloudFormation
2425
2722
  # * `IN_SYNC`\: The resources's actual configuration matches its
2426
2723
  # expected template configuration.
2427
2724
  #
2428
- # * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
2725
+ # * `NOT_CHECKED`\: CloudFormation does not currently return this
2429
2726
  # value.
2430
2727
  # @return [Array<String>]
2431
2728
  #
@@ -2455,7 +2752,7 @@ module Aws::CloudFormation
2455
2752
  # @!attribute [rw] stack_resource_drifts
2456
2753
  # Drift information for the resources that have been checked for drift
2457
2754
  # in the specified stack. This includes actual and expected
2458
- # configuration values for resources where AWS CloudFormation detects
2755
+ # configuration values for resources where CloudFormation detects
2459
2756
  # drift.
2460
2757
  #
2461
2758
  # For a given stack, there will be one `StackResourceDrift` for each
@@ -2573,7 +2870,7 @@ module Aws::CloudFormation
2573
2870
  #
2574
2871
  # @!attribute [rw] physical_resource_id
2575
2872
  # The name or unique identifier that corresponds to a physical
2576
- # instance ID of a resource supported by AWS CloudFormation.
2873
+ # instance ID of a resource supported by CloudFormation.
2577
2874
  #
2578
2875
  # For example, for an Amazon Elastic Compute Cloud (EC2) instance,
2579
2876
  # `PhysicalResourceId` corresponds to the `InstanceId`. You can pass
@@ -2636,10 +2933,9 @@ module Aws::CloudFormation
2636
2933
  # * If you are signed in to a delegated administrator account, specify
2637
2934
  # `DELEGATED_ADMIN`.
2638
2935
  #
2639
- # Your AWS account must be registered as a delegated administrator
2640
- # in the management account. For more information, see [Register a
2641
- # delegated administrator][1] in the *AWS CloudFormation User
2642
- # Guide*.
2936
+ # Your account must be registered as a delegated administrator in
2937
+ # the management account. For more information, see [Register a
2938
+ # delegated administrator][1] in the *CloudFormation User Guide*.
2643
2939
  #
2644
2940
  #
2645
2941
  #
@@ -2686,10 +2982,9 @@ module Aws::CloudFormation
2686
2982
  # * If you are signed in to a delegated administrator account, specify
2687
2983
  # `DELEGATED_ADMIN`.
2688
2984
  #
2689
- # Your AWS account must be registered as a delegated administrator
2690
- # in the management account. For more information, see [Register a
2691
- # delegated administrator][1] in the *AWS CloudFormation User
2692
- # Guide*.
2985
+ # Your account must be registered as a delegated administrator in
2986
+ # the management account. For more information, see [Register a
2987
+ # delegated administrator][1] in the *CloudFormation User Guide*.
2693
2988
  #
2694
2989
  #
2695
2990
  #
@@ -2795,6 +3090,8 @@ module Aws::CloudFormation
2795
3090
  # type_name: "TypeName",
2796
3091
  # arn: "TypeArn",
2797
3092
  # version_id: "TypeVersionId",
3093
+ # publisher_id: "PublisherId",
3094
+ # public_version_number: "PublicVersionNumber",
2798
3095
  # }
2799
3096
  #
2800
3097
  # @!attribute [rw] type
@@ -2828,13 +3125,25 @@ module Aws::CloudFormation
2828
3125
  # information about the default extension version.
2829
3126
  # @return [String]
2830
3127
  #
3128
+ # @!attribute [rw] publisher_id
3129
+ # The publisher ID of the extension publisher.
3130
+ #
3131
+ # Extensions provided by Amazon are not assigned a publisher ID.
3132
+ # @return [String]
3133
+ #
3134
+ # @!attribute [rw] public_version_number
3135
+ # The version number of a public third-party extension.
3136
+ # @return [String]
3137
+ #
2831
3138
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeTypeInput AWS API Documentation
2832
3139
  #
2833
3140
  class DescribeTypeInput < Struct.new(
2834
3141
  :type,
2835
3142
  :type_name,
2836
3143
  :arn,
2837
- :version_id)
3144
+ :version_id,
3145
+ :publisher_id,
3146
+ :public_version_number)
2838
3147
  SENSITIVE = []
2839
3148
  include Aws::Structure
2840
3149
  end
@@ -2848,24 +3157,84 @@ module Aws::CloudFormation
2848
3157
  # @return [String]
2849
3158
  #
2850
3159
  # @!attribute [rw] type_name
2851
- # The name of the registered extension.
3160
+ # The name of the extension.
3161
+ #
3162
+ # If the extension is a public third-party type you have activated
3163
+ # with a type name alias, CloudFormation returns the type name alias.
3164
+ # For more information, see [ActivateType][1].
3165
+ #
3166
+ #
3167
+ #
3168
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
2852
3169
  # @return [String]
2853
3170
  #
2854
3171
  # @!attribute [rw] default_version_id
2855
3172
  # The ID of the default version of the extension. The default version
2856
3173
  # is used when the extension version is not specified.
2857
3174
  #
3175
+ # This applies only to private extensions you have registered in your
3176
+ # account. For public extensions, both those provided by Amazon and
3177
+ # published by third parties, CloudFormation returns `null`. For more
3178
+ # information, see [RegisterType][1].
3179
+ #
2858
3180
  # To set the default version of an extension, use `
2859
3181
  # SetTypeDefaultVersion `.
3182
+ #
3183
+ #
3184
+ #
3185
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
2860
3186
  # @return [String]
2861
3187
  #
2862
3188
  # @!attribute [rw] is_default_version
2863
3189
  # Whether the specified extension version is set as the default
2864
3190
  # version.
3191
+ #
3192
+ # This applies only to private extensions you have registered in your
3193
+ # account, and extensions published by Amazon. For public third-party
3194
+ # extensions, whether or not they are activated in your account,
3195
+ # CloudFormation returns `null`.
2865
3196
  # @return [Boolean]
2866
3197
  #
3198
+ # @!attribute [rw] type_tests_status
3199
+ # The contract test status of the registered extension version. To
3200
+ # return the extension test status of a specifc extension version, you
3201
+ # must specify `VersionId`.
3202
+ #
3203
+ # This applies only to registered private extension versions.
3204
+ # CloudFormation does not return this information for public
3205
+ # extensions, whether or not they are activated in your account.
3206
+ #
3207
+ # * `PASSED`\: The extension has passed all its contract tests.
3208
+ #
3209
+ # An extension must have a test status of `PASSED` before it can be
3210
+ # published. For more information, see [Publishing extensions to
3211
+ # make them available for public use][1] in the *CloudFormation
3212
+ # Command Line Interface User Guide*.
3213
+ #
3214
+ # * `FAILED`\: The extension has failed one or more contract tests.
3215
+ #
3216
+ # * `IN_PROGRESS`\: Contract tests are currently being performed on
3217
+ # the extension.
3218
+ #
3219
+ # * `NOT_TESTED`\: Contract tests have not been performed on the
3220
+ # extension.
3221
+ #
3222
+ #
3223
+ #
3224
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-publish.html
3225
+ # @return [String]
3226
+ #
3227
+ # @!attribute [rw] type_tests_status_description
3228
+ # The description of the test status. To return the extension test
3229
+ # status of a specifc extension version, you must specify `VersionId`.
3230
+ #
3231
+ # This applies only to registered private extension versions.
3232
+ # CloudFormation does not return this information for public
3233
+ # extensions, whether or not they are activated in your account.
3234
+ # @return [String]
3235
+ #
2867
3236
  # @!attribute [rw] description
2868
- # The description of the registered extension.
3237
+ # The description of the extension.
2869
3238
  # @return [String]
2870
3239
  #
2871
3240
  # @!attribute [rw] schema
@@ -2880,21 +3249,23 @@ module Aws::CloudFormation
2880
3249
  # @return [String]
2881
3250
  #
2882
3251
  # @!attribute [rw] provisioning_type
2883
- # The provisioning behavior of the extension. AWS CloudFormation
2884
- # determines the provisioning type during registration, based on the
2885
- # types of handlers in the schema handler package submitted.
3252
+ # For resource type extensions, the provisioning behavior of the
3253
+ # resource type. CloudFormation determines the provisioning type
3254
+ # during registration, based on the types of handlers in the schema
3255
+ # handler package submitted.
2886
3256
  #
2887
3257
  # Valid values include:
2888
3258
  #
2889
- # * `FULLY_MUTABLE`\: The extension includes an update handler to
2890
- # process updates to the extension during stack update operations.
3259
+ # * `FULLY_MUTABLE`\: The resource type includes an update handler to
3260
+ # process updates to the type during stack update operations.
2891
3261
  #
2892
- # * `IMMUTABLE`\: The extension does not include an update handler, so
2893
- # the extension cannot be updated and must instead be replaced
2894
- # during stack update operations.
3262
+ # * `IMMUTABLE`\: The resource type does not include an update
3263
+ # handler, so the type cannot be updated and must instead be
3264
+ # replaced during stack update operations.
2895
3265
  #
2896
- # * `NON_PROVISIONABLE`\: The extension does not include all of the
2897
- # following handlers, and therefore cannot actually be provisioned.
3266
+ # * `NON_PROVISIONABLE`\: The resource type does not include all of
3267
+ # the following handlers, and therefore cannot actually be
3268
+ # provisioned.
2898
3269
  #
2899
3270
  # * create
2900
3271
  #
@@ -2908,27 +3279,53 @@ module Aws::CloudFormation
2908
3279
  #
2909
3280
  # Valid values include:
2910
3281
  #
2911
- # * `LIVE`\: The extension is registered and can be used in
2912
- # CloudFormation operations, dependent on its provisioning behavior
2913
- # and visibility scope.
3282
+ # * `LIVE`\: The extension is activated or registered and can be used
3283
+ # in CloudFormation operations, dependent on its provisioning
3284
+ # behavior and visibility scope.
2914
3285
  #
2915
- # * `DEPRECATED`\: The extension has been deregistered and can no
2916
- # longer be used in CloudFormation operations.
3286
+ # * `DEPRECATED`\: The extension has been deactivated or deregistered
3287
+ # and can no longer be used in CloudFormation operations.
3288
+ #
3289
+ # For public third-party extensions, CloudFormation returns `null`.
2917
3290
  # @return [String]
2918
3291
  #
2919
3292
  # @!attribute [rw] logging_config
2920
- # Contains logging configuration information for an extension.
3293
+ # Contains logging configuration information for private extensions.
3294
+ # This applies only to private extensions you have registered in your
3295
+ # account. For public extensions, both those provided by Amazon and
3296
+ # published by third parties, CloudFormation returns `null`. For more
3297
+ # information, see [RegisterType][1].
3298
+ #
3299
+ #
3300
+ #
3301
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
2921
3302
  # @return [Types::LoggingConfig]
2922
3303
  #
3304
+ # @!attribute [rw] required_activated_types
3305
+ # For extensions that are modules, the public third-party extensions
3306
+ # that must be activated in your account in order for the module
3307
+ # itself to be activated.
3308
+ # @return [Array<Types::RequiredActivatedType>]
3309
+ #
2923
3310
  # @!attribute [rw] execution_role_arn
2924
3311
  # The Amazon Resource Name (ARN) of the IAM execution role used to
2925
- # register the extension. If your resource type calls AWS APIs in any
2926
- # of its handlers, you must create an <i> <a
3312
+ # register the extension. This applies only to private extensions you
3313
+ # have registered in your account. For more information, see
3314
+ # [RegisterType][1].
3315
+ #
3316
+ #
3317
+ #
3318
+ # If the registered extension calls any Amazon Web Services APIs, you
3319
+ # must create an <i> <a
2927
3320
  # href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
2928
3321
  # execution role</a> </i> that includes the necessary permissions to
2929
- # call those AWS APIs, and provision that execution role in your
2930
- # account. CloudFormation then assumes that execution role to provide
2931
- # your extension with the appropriate credentials.
3322
+ # call those Amazon Web Services APIs, and provision that execution
3323
+ # role in your account. CloudFormation then assumes that execution
3324
+ # role to provide your extension with the appropriate credentials.
3325
+ #
3326
+ #
3327
+ #
3328
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
2932
3329
  # @return [String]
2933
3330
  #
2934
3331
  # @!attribute [rw] visibility
@@ -2938,8 +3335,8 @@ module Aws::CloudFormation
2938
3335
  # Valid values include:
2939
3336
  #
2940
3337
  # * `PRIVATE`\: The extension is only visible and usable within the
2941
- # account in which it is registered. Currently, AWS CloudFormation
2942
- # marks any types you register as `PRIVATE`.
3338
+ # account in which it is registered. CloudFormation marks any
3339
+ # extensions you register as `PRIVATE`.
2943
3340
  #
2944
3341
  # * `PUBLIC`\: The extension is publically visible and usable within
2945
3342
  # any Amazon account.
@@ -2955,41 +3352,145 @@ module Aws::CloudFormation
2955
3352
  # @return [String]
2956
3353
  #
2957
3354
  # @!attribute [rw] last_updated
2958
- # When the specified extension version was registered.
3355
+ # When the specified extension version was registered. This applies
3356
+ # only to:
3357
+ #
3358
+ # * Private extensions you have registered in your account. For more
3359
+ # information, see [RegisterType][1].
3360
+ #
3361
+ # * Public extensions you have activated in your account with
3362
+ # auto-update specified. For more information, see
3363
+ # [ActivateType][2].
3364
+ #
3365
+ #
3366
+ #
3367
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
3368
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
2959
3369
  # @return [Time]
2960
3370
  #
2961
3371
  # @!attribute [rw] time_created
2962
- # When the specified extension version was registered.
3372
+ # When the specified private extension version was registered or
3373
+ # activated in your account.
2963
3374
  # @return [Time]
2964
3375
  #
2965
- # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeTypeOutput AWS API Documentation
3376
+ # @!attribute [rw] configuration_schema
3377
+ # A JSON string that represent the current configuration data for the
3378
+ # extension in this account and region.
2966
3379
  #
2967
- class DescribeTypeOutput < Struct.new(
2968
- :arn,
2969
- :type,
2970
- :type_name,
2971
- :default_version_id,
2972
- :is_default_version,
2973
- :description,
2974
- :schema,
2975
- :provisioning_type,
2976
- :deprecated_status,
2977
- :logging_config,
2978
- :execution_role_arn,
2979
- :visibility,
2980
- :source_url,
2981
- :documentation_url,
2982
- :last_updated,
2983
- :time_created)
2984
- SENSITIVE = []
2985
- include Aws::Structure
2986
- end
2987
-
2988
- # @note When making an API call, you may pass DescribeTypeRegistrationInput
2989
- # data as a hash:
3380
+ # To set the configuration data for an extension, use
3381
+ # [SetTypeConfiguration][1]. For more information, see [Configuring
3382
+ # extensions at the account level][2] in the *CloudFormation User
3383
+ # Guide*.
2990
3384
  #
2991
- # {
2992
- # registration_token: "RegistrationToken", # required
3385
+ #
3386
+ #
3387
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html
3388
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
3389
+ # @return [String]
3390
+ #
3391
+ # @!attribute [rw] publisher_id
3392
+ # The publisher ID of the extension publisher.
3393
+ #
3394
+ # This applies only to public third-party extensions. For private
3395
+ # registered extensions, and extensions provided by Amazon,
3396
+ # CloudFormation returns `null`.
3397
+ # @return [String]
3398
+ #
3399
+ # @!attribute [rw] original_type_name
3400
+ # For public extensions that have been activated for this account and
3401
+ # region, the type name of the public extension.
3402
+ #
3403
+ # If you specified a `TypeNameAlias` when enabling the extension in
3404
+ # this account and region, CloudFormation treats that alias as the
3405
+ # extension's type name within the account and region, not the type
3406
+ # name of the public extension. For more information, see [Specifying
3407
+ # aliases to refer to extensions][1] in the *CloudFormation User
3408
+ # Guide*.
3409
+ #
3410
+ #
3411
+ #
3412
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-alias
3413
+ # @return [String]
3414
+ #
3415
+ # @!attribute [rw] original_type_arn
3416
+ # For public extensions that have been activated for this account and
3417
+ # region, the Amazon Resource Name (ARN) of the public extension.
3418
+ # @return [String]
3419
+ #
3420
+ # @!attribute [rw] public_version_number
3421
+ # The version number of a public third-party extension.
3422
+ #
3423
+ # This applies only if you specify a public extension you have
3424
+ # activated in your account, or specify a public extension without
3425
+ # specifying a version. For all other extensions, CloudFormation
3426
+ # returns `null`.
3427
+ # @return [String]
3428
+ #
3429
+ # @!attribute [rw] latest_public_version
3430
+ # The latest version of a public extension *that is available* for
3431
+ # use.
3432
+ #
3433
+ # This only applies if you specify a public extension, and you do not
3434
+ # specify a version. For all other requests, CloudFormation returns
3435
+ # `null`.
3436
+ # @return [String]
3437
+ #
3438
+ # @!attribute [rw] is_activated
3439
+ # Whether or not the extension is activated in the account and region.
3440
+ #
3441
+ # This only applies to public third-party extensions. For all other
3442
+ # extensions, CloudFormation returns `null`.
3443
+ # @return [Boolean]
3444
+ #
3445
+ # @!attribute [rw] auto_update
3446
+ # Whether CloudFormation automatically updates the extension in this
3447
+ # account and region when a new *minor* version is published by the
3448
+ # extension publisher. Major versions released by the publisher must
3449
+ # be manually updated. For more information, see [Activating public
3450
+ # extensions for use in your
3451
+ # account](AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable)
3452
+ # in the *CloudFormation User Guide*.
3453
+ # @return [Boolean]
3454
+ #
3455
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeTypeOutput AWS API Documentation
3456
+ #
3457
+ class DescribeTypeOutput < Struct.new(
3458
+ :arn,
3459
+ :type,
3460
+ :type_name,
3461
+ :default_version_id,
3462
+ :is_default_version,
3463
+ :type_tests_status,
3464
+ :type_tests_status_description,
3465
+ :description,
3466
+ :schema,
3467
+ :provisioning_type,
3468
+ :deprecated_status,
3469
+ :logging_config,
3470
+ :required_activated_types,
3471
+ :execution_role_arn,
3472
+ :visibility,
3473
+ :source_url,
3474
+ :documentation_url,
3475
+ :last_updated,
3476
+ :time_created,
3477
+ :configuration_schema,
3478
+ :publisher_id,
3479
+ :original_type_name,
3480
+ :original_type_arn,
3481
+ :public_version_number,
3482
+ :latest_public_version,
3483
+ :is_activated,
3484
+ :auto_update)
3485
+ SENSITIVE = []
3486
+ include Aws::Structure
3487
+ end
3488
+
3489
+ # @note When making an API call, you may pass DescribeTypeRegistrationInput
3490
+ # data as a hash:
3491
+ #
3492
+ # {
3493
+ # registration_token: "RegistrationToken", # required
2993
3494
  # }
2994
3495
  #
2995
3496
  # @!attribute [rw] registration_token
@@ -3069,9 +3570,9 @@ module Aws::CloudFormation
3069
3570
  # @!attribute [rw] stack_drift_detection_id
3070
3571
  # The ID of the drift detection results of this operation.
3071
3572
  #
3072
- # AWS CloudFormation generates new results, with a new drift detection
3073
- # ID, each time this operation is run. However, the number of drift
3074
- # results AWS CloudFormation retains for any given stack, and for how
3573
+ # CloudFormation generates new results, with a new drift detection ID,
3574
+ # each time this operation is run. However, the number of drift
3575
+ # results CloudFormation retains for any given stack, and for how
3075
3576
  # long, may vary.
3076
3577
  # @return [String]
3077
3578
  #
@@ -3146,7 +3647,7 @@ module Aws::CloudFormation
3146
3647
  # @return [String]
3147
3648
  #
3148
3649
  # @!attribute [rw] operation_preferences
3149
- # The user-specified preferences for how AWS CloudFormation performs a
3650
+ # The user-specified preferences for how CloudFormation performs a
3150
3651
  # stack set operation.
3151
3652
  #
3152
3653
  # For more information on maximum concurrent accounts and failure
@@ -3177,10 +3678,9 @@ module Aws::CloudFormation
3177
3678
  # * If you are signed in to a delegated administrator account, specify
3178
3679
  # `DELEGATED_ADMIN`.
3179
3680
  #
3180
- # Your AWS account must be registered as a delegated administrator
3181
- # in the management account. For more information, see [Register a
3182
- # delegated administrator][1] in the *AWS CloudFormation User
3183
- # Guide*.
3681
+ # Your account must be registered as a delegated administrator in
3682
+ # the management account. For more information, see [Register a
3683
+ # delegated administrator][1] in the *CloudFormation User Guide*.
3184
3684
  #
3185
3685
  #
3186
3686
  #
@@ -3234,7 +3734,7 @@ module Aws::CloudFormation
3234
3734
  # @!attribute [rw] template_body
3235
3735
  # Structure containing the template body with a minimum length of 1
3236
3736
  # byte and a maximum length of 51,200 bytes. (For more information, go
3237
- # to [Template Anatomy][1] in the AWS CloudFormation User Guide.)
3737
+ # to [Template Anatomy][1] in the CloudFormation User Guide.)
3238
3738
  #
3239
3739
  # Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
3240
3740
  # are passed, only `TemplateBody` is used.
@@ -3248,7 +3748,7 @@ module Aws::CloudFormation
3248
3748
  # Location of file containing the template body. The URL must point to
3249
3749
  # a template that is located in an Amazon S3 bucket or a Systems
3250
3750
  # Manager document. For more information, go to [Template Anatomy][1]
3251
- # in the AWS CloudFormation User Guide.
3751
+ # in the CloudFormation User Guide.
3252
3752
  #
3253
3753
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
3254
3754
  # are passed, only `TemplateBody` is used.
@@ -3275,8 +3775,8 @@ module Aws::CloudFormation
3275
3775
  # The output for a EstimateTemplateCost action.
3276
3776
  #
3277
3777
  # @!attribute [rw] url
3278
- # An AWS Simple Monthly Calculator URL with a query string that
3279
- # describes the resources required to run the template.
3778
+ # An Amazon Web Services Simple Monthly Calculator URL with a query
3779
+ # string that describes the resources required to run the template.
3280
3780
  # @return [String]
3281
3781
  #
3282
3782
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/EstimateTemplateCostOutput AWS API Documentation
@@ -3310,11 +3810,10 @@ module Aws::CloudFormation
3310
3810
  #
3311
3811
  # @!attribute [rw] client_request_token
3312
3812
  # A unique identifier for this `ExecuteChangeSet` request. Specify
3313
- # this token if you plan to retry requests so that AWS CloudFormation
3813
+ # this token if you plan to retry requests so that CloudFormation
3314
3814
  # knows that you're not attempting to execute a change set to update
3315
3815
  # a stack with the same name. You might retry `ExecuteChangeSet`
3316
- # requests to ensure that AWS CloudFormation successfully received
3317
- # them.
3816
+ # requests to ensure that CloudFormation successfully received them.
3318
3817
  # @return [String]
3319
3818
  #
3320
3819
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSetInput AWS API Documentation
@@ -3389,8 +3888,8 @@ module Aws::CloudFormation
3389
3888
  #
3390
3889
  # @!attribute [rw] stack_policy_body
3391
3890
  # Structure containing the stack policy body. (For more information,
3392
- # go to [ Prevent Updates to Stack Resources][1] in the AWS
3393
- # CloudFormation User Guide.)
3891
+ # go to [ Prevent Updates to Stack Resources][1] in the CloudFormation
3892
+ # User Guide.)
3394
3893
  #
3395
3894
  #
3396
3895
  #
@@ -3429,20 +3928,20 @@ module Aws::CloudFormation
3429
3928
  # @return [String]
3430
3929
  #
3431
3930
  # @!attribute [rw] change_set_name
3432
- # The name or Amazon Resource Name (ARN) of a change set for which AWS
3931
+ # The name or Amazon Resource Name (ARN) of a change set for which
3433
3932
  # CloudFormation returns the associated template. If you specify a
3434
3933
  # name, you must also specify the `StackName`.
3435
3934
  # @return [String]
3436
3935
  #
3437
3936
  # @!attribute [rw] template_stage
3438
3937
  # For templates that include transforms, the stage of the template
3439
- # that AWS CloudFormation returns. To get the user-submitted template,
3440
- # specify `Original`. To get the template after AWS CloudFormation has
3938
+ # that CloudFormation returns. To get the user-submitted template,
3939
+ # specify `Original`. To get the template after CloudFormation has
3441
3940
  # processed all transforms, specify `Processed`.
3442
3941
  #
3443
3942
  # If the template doesn't include transforms, `Original` and
3444
- # `Processed` return the same template. By default, AWS CloudFormation
3445
- # specifies `Original`.
3943
+ # `Processed` return the same template. By default, CloudFormation
3944
+ # specifies `Processed`.
3446
3945
  # @return [String]
3447
3946
  #
3448
3947
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetTemplateInput AWS API Documentation
@@ -3459,9 +3958,9 @@ module Aws::CloudFormation
3459
3958
  #
3460
3959
  # @!attribute [rw] template_body
3461
3960
  # Structure containing the template body. (For more information, go to
3462
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
3961
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
3463
3962
  #
3464
- # AWS CloudFormation returns the same template that was used when the
3963
+ # CloudFormation returns the same template that was used when the
3465
3964
  # stack was created.
3466
3965
  #
3467
3966
  #
@@ -3472,7 +3971,7 @@ module Aws::CloudFormation
3472
3971
  # @!attribute [rw] stages_available
3473
3972
  # The stage of the template that you can retrieve. For stacks, the
3474
3973
  # `Original` and `Processed` templates are always available. For
3475
- # change sets, the `Original` template is always available. After AWS
3974
+ # change sets, the `Original` template is always available. After
3476
3975
  # CloudFormation finishes creating the change set, the `Processed`
3477
3976
  # template becomes available.
3478
3977
  # @return [Array<String>]
@@ -3496,12 +3995,13 @@ module Aws::CloudFormation
3496
3995
  # template_url: "TemplateURL",
3497
3996
  # stack_name: "StackNameOrId",
3498
3997
  # stack_set_name: "StackSetNameOrId",
3998
+ # call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
3499
3999
  # }
3500
4000
  #
3501
4001
  # @!attribute [rw] template_body
3502
4002
  # Structure containing the template body with a minimum length of 1
3503
4003
  # byte and a maximum length of 51,200 bytes. For more information
3504
- # about templates, see [Template Anatomy][1] in the AWS CloudFormation
4004
+ # about templates, see [Template Anatomy][1] in the CloudFormation
3505
4005
  # User Guide.
3506
4006
  #
3507
4007
  # Conditional: You must specify only one of the following parameters:
@@ -3516,7 +4016,7 @@ module Aws::CloudFormation
3516
4016
  # Location of file containing the template body. The URL must point to
3517
4017
  # a template (max size: 460,800 bytes) that is located in an Amazon S3
3518
4018
  # bucket or a Systems Manager document. For more information about
3519
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
4019
+ # templates, see [Template Anatomy][1] in the CloudFormation User
3520
4020
  # Guide.
3521
4021
  #
3522
4022
  # Conditional: You must specify only one of the following parameters:
@@ -3545,13 +4045,36 @@ module Aws::CloudFormation
3545
4045
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
3546
4046
  # @return [String]
3547
4047
  #
4048
+ # @!attribute [rw] call_as
4049
+ # \[Service-managed permissions\] Specifies whether you are acting as
4050
+ # an account administrator in the organization's management account
4051
+ # or as a delegated administrator in a member account.
4052
+ #
4053
+ # By default, `SELF` is specified. Use `SELF` for stack sets with
4054
+ # self-managed permissions.
4055
+ #
4056
+ # * If you are signed in to the management account, specify `SELF`.
4057
+ #
4058
+ # * If you are signed in to a delegated administrator account, specify
4059
+ # `DELEGATED_ADMIN`.
4060
+ #
4061
+ # Your account must be registered as a delegated administrator in
4062
+ # the management account. For more information, see [Register a
4063
+ # delegated administrator][1] in the *CloudFormation User Guide*.
4064
+ #
4065
+ #
4066
+ #
4067
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
4068
+ # @return [String]
4069
+ #
3548
4070
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetTemplateSummaryInput AWS API Documentation
3549
4071
  #
3550
4072
  class GetTemplateSummaryInput < Struct.new(
3551
4073
  :template_body,
3552
4074
  :template_url,
3553
4075
  :stack_name,
3554
- :stack_set_name)
4076
+ :stack_set_name,
4077
+ :call_as)
3555
4078
  SENSITIVE = []
3556
4079
  include Aws::Structure
3557
4080
  end
@@ -3575,7 +4098,7 @@ module Aws::CloudFormation
3575
4098
  # CreateStack or UpdateStack actions with your template; otherwise,
3576
4099
  # those actions return an InsufficientCapabilities error.
3577
4100
  #
3578
- # For more information, see [Acknowledging IAM Resources in AWS
4101
+ # For more information, see [Acknowledging IAM Resources in
3579
4102
  # CloudFormation Templates][1].
3580
4103
  #
3581
4104
  #
@@ -3595,8 +4118,8 @@ module Aws::CloudFormation
3595
4118
  # @return [Array<String>]
3596
4119
  #
3597
4120
  # @!attribute [rw] version
3598
- # The AWS template format version, which identifies the capabilities
3599
- # of the template.
4121
+ # The Amazon Web Services template format version, which identifies
4122
+ # the capabilities of the template.
3600
4123
  # @return [String]
3601
4124
  #
3602
4125
  # @!attribute [rw] metadata
@@ -3632,6 +4155,86 @@ module Aws::CloudFormation
3632
4155
  include Aws::Structure
3633
4156
  end
3634
4157
 
4158
+ # @note When making an API call, you may pass ImportStacksToStackSetInput
4159
+ # data as a hash:
4160
+ #
4161
+ # {
4162
+ # stack_set_name: "StackSetNameOrId", # required
4163
+ # stack_ids: ["StackId"], # required
4164
+ # operation_preferences: {
4165
+ # region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
4166
+ # region_order: ["Region"],
4167
+ # failure_tolerance_count: 1,
4168
+ # failure_tolerance_percentage: 1,
4169
+ # max_concurrent_count: 1,
4170
+ # max_concurrent_percentage: 1,
4171
+ # },
4172
+ # operation_id: "ClientRequestToken",
4173
+ # call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
4174
+ # }
4175
+ #
4176
+ # @!attribute [rw] stack_set_name
4177
+ # The name of the stack set. The name must be unique in the Region
4178
+ # where you create your stack set.
4179
+ # @return [String]
4180
+ #
4181
+ # @!attribute [rw] stack_ids
4182
+ # The IDs of the stacks you are importing into a stack set. You import
4183
+ # up to 10 stacks per stack set at a time.
4184
+ # @return [Array<String>]
4185
+ #
4186
+ # @!attribute [rw] operation_preferences
4187
+ # The user-specified preferences for how CloudFormation performs a
4188
+ # stack set operation.
4189
+ #
4190
+ # For more information on maximum concurrent accounts and failure
4191
+ # tolerance, see [Stack set operation options][1].
4192
+ #
4193
+ #
4194
+ #
4195
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
4196
+ # @return [Types::StackSetOperationPreferences]
4197
+ #
4198
+ # @!attribute [rw] operation_id
4199
+ # A unique, user defined, identifier for the stack set operation.
4200
+ #
4201
+ # **A suitable default value is auto-generated.** You should normally
4202
+ # not need to pass this option.
4203
+ # @return [String]
4204
+ #
4205
+ # @!attribute [rw] call_as
4206
+ # By default, `SELF` is specified. Use `SELF` for stack sets with
4207
+ # self-managed permissions.
4208
+ #
4209
+ # * If you are signed in to the management account, specify `SELF`.
4210
+ #
4211
+ # * For service managed stack sets, specify `DELEGATED_ADMIN`.
4212
+ # @return [String]
4213
+ #
4214
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSetInput AWS API Documentation
4215
+ #
4216
+ class ImportStacksToStackSetInput < Struct.new(
4217
+ :stack_set_name,
4218
+ :stack_ids,
4219
+ :operation_preferences,
4220
+ :operation_id,
4221
+ :call_as)
4222
+ SENSITIVE = []
4223
+ include Aws::Structure
4224
+ end
4225
+
4226
+ # @!attribute [rw] operation_id
4227
+ # The unique identifier for the stack set operation.
4228
+ # @return [String]
4229
+ #
4230
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSetOutput AWS API Documentation
4231
+ #
4232
+ class ImportStacksToStackSetOutput < Struct.new(
4233
+ :operation_id)
4234
+ SENSITIVE = []
4235
+ include Aws::Structure
4236
+ end
4237
+
3635
4238
  # The template contains resources with capabilities that weren't
3636
4239
  # specified in the Capabilities parameter.
3637
4240
  #
@@ -3667,7 +4270,7 @@ module Aws::CloudFormation
3667
4270
  # The quota for the resource has already been reached.
3668
4271
  #
3669
4272
  # For information on resource and stack limitations, see [Limits][1] in
3670
- # the *AWS CloudFormation User Guide*.
4273
+ # the *CloudFormation User Guide*.
3671
4274
  #
3672
4275
  #
3673
4276
  #
@@ -3776,8 +4379,8 @@ module Aws::CloudFormation
3776
4379
  # }
3777
4380
  #
3778
4381
  # @!attribute [rw] export_name
3779
- # The name of the exported output value. AWS CloudFormation returns
3780
- # the stack names that are importing this value.
4382
+ # The name of the exported output value. CloudFormation returns the
4383
+ # stack names that are importing this value.
3781
4384
  # @return [String]
3782
4385
  #
3783
4386
  # @!attribute [rw] next_token
@@ -3858,8 +4461,7 @@ module Aws::CloudFormation
3858
4461
  # @return [Array<Types::StackInstanceFilter>]
3859
4462
  #
3860
4463
  # @!attribute [rw] stack_instance_account
3861
- # The name of the AWS account that you want to list stack instances
3862
- # for.
4464
+ # The name of the account that you want to list stack instances for.
3863
4465
  # @return [String]
3864
4466
  #
3865
4467
  # @!attribute [rw] stack_instance_region
@@ -3879,10 +4481,9 @@ module Aws::CloudFormation
3879
4481
  # * If you are signed in to a delegated administrator account, specify
3880
4482
  # `DELEGATED_ADMIN`.
3881
4483
  #
3882
- # Your AWS account must be registered as a delegated administrator
3883
- # in the management account. For more information, see [Register a
3884
- # delegated administrator][1] in the *AWS CloudFormation User
3885
- # Guide*.
4484
+ # Your account must be registered as a delegated administrator in
4485
+ # the management account. For more information, see [Register a
4486
+ # delegated administrator][1] in the *CloudFormation User Guide*.
3886
4487
  #
3887
4488
  #
3888
4489
  #
@@ -4032,10 +4633,9 @@ module Aws::CloudFormation
4032
4633
  # * If you are signed in to a delegated administrator account, specify
4033
4634
  # `DELEGATED_ADMIN`.
4034
4635
  #
4035
- # Your AWS account must be registered as a delegated administrator
4036
- # in the management account. For more information, see [Register a
4037
- # delegated administrator][1] in the *AWS CloudFormation User
4038
- # Guide*.
4636
+ # Your account must be registered as a delegated administrator in
4637
+ # the management account. For more information, see [Register a
4638
+ # delegated administrator][1] in the *CloudFormation User Guide*.
4039
4639
  #
4040
4640
  #
4041
4641
  #
@@ -4122,10 +4722,9 @@ module Aws::CloudFormation
4122
4722
  # * If you are signed in to a delegated administrator account, specify
4123
4723
  # `DELEGATED_ADMIN`.
4124
4724
  #
4125
- # Your AWS account must be registered as a delegated administrator
4126
- # in the management account. For more information, see [Register a
4127
- # delegated administrator][1] in the *AWS CloudFormation User
4128
- # Guide*.
4725
+ # Your account must be registered as a delegated administrator in
4726
+ # the management account. For more information, see [Register a
4727
+ # delegated administrator][1] in the *CloudFormation User Guide*.
4129
4728
  #
4130
4729
  #
4131
4730
  #
@@ -4209,10 +4808,9 @@ module Aws::CloudFormation
4209
4808
  # * If you are signed in to a delegated administrator account, specify
4210
4809
  # `DELEGATED_ADMIN`.
4211
4810
  #
4212
- # Your AWS account must be registered as a delegated administrator
4213
- # in the management account. For more information, see [Register a
4214
- # delegated administrator][1] in the *AWS CloudFormation User
4215
- # Guide*.
4811
+ # Your account must be registered as a delegated administrator in
4812
+ # the management account. For more information, see [Register a
4813
+ # delegated administrator][1] in the *CloudFormation User Guide*.
4216
4814
  #
4217
4815
  #
4218
4816
  #
@@ -4403,10 +5001,11 @@ module Aws::CloudFormation
4403
5001
  # {
4404
5002
  # type: "RESOURCE", # accepts RESOURCE, MODULE
4405
5003
  # type_name: "TypeName",
4406
- # arn: "PrivateTypeArn",
5004
+ # arn: "TypeArn",
4407
5005
  # max_results: 1,
4408
5006
  # next_token: "NextToken",
4409
5007
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
5008
+ # publisher_id: "PublisherId",
4410
5009
  # }
4411
5010
  #
4412
5011
  # @!attribute [rw] type
@@ -4464,6 +5063,12 @@ module Aws::CloudFormation
4464
5063
  # The default is `LIVE`.
4465
5064
  # @return [String]
4466
5065
  #
5066
+ # @!attribute [rw] publisher_id
5067
+ # The publisher ID of the extension publisher.
5068
+ #
5069
+ # Extensions published by Amazon are not assigned a publisher ID.
5070
+ # @return [String]
5071
+ #
4467
5072
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeVersionsInput AWS API Documentation
4468
5073
  #
4469
5074
  class ListTypeVersionsInput < Struct.new(
@@ -4472,7 +5077,8 @@ module Aws::CloudFormation
4472
5077
  :arn,
4473
5078
  :max_results,
4474
5079
  :next_token,
4475
- :deprecated_status)
5080
+ :deprecated_status,
5081
+ :publisher_id)
4476
5082
  SENSITIVE = []
4477
5083
  include Aws::Structure
4478
5084
  end
@@ -4507,42 +5113,57 @@ module Aws::CloudFormation
4507
5113
  # provisioning_type: "NON_PROVISIONABLE", # accepts NON_PROVISIONABLE, IMMUTABLE, FULLY_MUTABLE
4508
5114
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
4509
5115
  # type: "RESOURCE", # accepts RESOURCE, MODULE
5116
+ # filters: {
5117
+ # category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
5118
+ # publisher_id: "PublisherId",
5119
+ # type_name_prefix: "TypeNamePrefix",
5120
+ # },
4510
5121
  # max_results: 1,
4511
5122
  # next_token: "NextToken",
4512
5123
  # }
4513
5124
  #
4514
5125
  # @!attribute [rw] visibility
4515
- # The scope at which the extension is visible and usable in
5126
+ # The scope at which the extensions are visible and usable in
4516
5127
  # CloudFormation operations.
4517
5128
  #
4518
5129
  # Valid values include:
4519
5130
  #
4520
- # * `PRIVATE`\: The extension is only visible and usable within the
4521
- # account in which it is registered. Currently, AWS CloudFormation
4522
- # marks any extension you create as `PRIVATE`.
5131
+ # * `PRIVATE`\: Extensions that are visible and usable within this
5132
+ # account and region. This includes:
4523
5133
  #
4524
- # * `PUBLIC`\: The extension is publically visible and usable within
4525
- # any Amazon account.
5134
+ # * Private extensions you have registered in this account and
5135
+ # region.
5136
+ #
5137
+ # * Public extensions that you have activated in this account and
5138
+ # region.
5139
+ #
5140
+ # * `PUBLIC`\: Extensions that are publicly visible and available to
5141
+ # be activated within any Amazon account. This includes extensions
5142
+ # from Amazon, as well as third-party publishers.
4526
5143
  #
4527
5144
  # The default is `PRIVATE`.
4528
5145
  # @return [String]
4529
5146
  #
4530
5147
  # @!attribute [rw] provisioning_type
4531
- # The provisioning behavior of the type. AWS CloudFormation determines
4532
- # the provisioning type during registration, based on the types of
4533
- # handlers in the schema handler package submitted.
5148
+ # For resource types, the provisioning behavior of the resource type.
5149
+ # CloudFormation determines the provisioning type during registration,
5150
+ # based on the types of handlers in the schema handler package
5151
+ # submitted.
4534
5152
  #
4535
5153
  # Valid values include:
4536
5154
  #
4537
- # * `FULLY_MUTABLE`\: The extension includes an update handler to
4538
- # process updates to the extension during stack update operations.
5155
+ # * `FULLY_MUTABLE`\: The resource type includes an update handler to
5156
+ # process updates to the type during stack update operations.
5157
+ #
5158
+ # * `IMMUTABLE`\: The resource type does not include an update
5159
+ # handler, so the type cannot be updated and must instead be
5160
+ # replaced during stack update operations.
4539
5161
  #
4540
- # * `IMMUTABLE`\: The extension does not include an update handler, so
4541
- # the extension cannot be updated and must instead be replaced
4542
- # during stack update operations.
5162
+ # * `NON_PROVISIONABLE`\: The resource type does not include create,
5163
+ # read, and delete handlers, and therefore cannot actually be
5164
+ # provisioned.
4543
5165
  #
4544
- # * `NON_PROVISIONABLE`\: The extension does not include create, read,
4545
- # and delete handlers, and therefore cannot actually be provisioned.
5166
+ # The default is `FULLY_MUTABLE`.
4546
5167
  # @return [String]
4547
5168
  #
4548
5169
  # @!attribute [rw] deprecated_status
@@ -4562,6 +5183,13 @@ module Aws::CloudFormation
4562
5183
  # The type of extension.
4563
5184
  # @return [String]
4564
5185
  #
5186
+ # @!attribute [rw] filters
5187
+ # Filter criteria to use in determining which extensions to return.
5188
+ #
5189
+ # If you specify a filter, CloudFormation ignores any specified
5190
+ # `Visibility` value when returning the list of types.
5191
+ # @return [Types::TypeFilters]
5192
+ #
4565
5193
  # @!attribute [rw] max_results
4566
5194
  # The maximum number of results to be returned with a single call. If
4567
5195
  # the number of available results exceeds this maximum, the response
@@ -4585,6 +5213,7 @@ module Aws::CloudFormation
4585
5213
  :provisioning_type,
4586
5214
  :deprecated_status,
4587
5215
  :type,
5216
+ :filters,
4588
5217
  :max_results,
4589
5218
  :next_token)
4590
5219
  SENSITIVE = []
@@ -4613,7 +5242,7 @@ module Aws::CloudFormation
4613
5242
  include Aws::Structure
4614
5243
  end
4615
5244
 
4616
- # Contains logging configuration information for a type.
5245
+ # Contains logging configuration information for an extension.
4617
5246
  #
4618
5247
  # @note When making an API call, you may pass LoggingConfig
4619
5248
  # data as a hash:
@@ -4630,7 +5259,7 @@ module Aws::CloudFormation
4630
5259
  #
4631
5260
  # @!attribute [rw] log_group_name
4632
5261
  # The Amazon CloudWatch log group to which CloudFormation sends error
4633
- # logging information when invoking the type's handlers.
5262
+ # logging information when invoking the extension's handlers.
4634
5263
  # @return [String]
4635
5264
  #
4636
5265
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/LoggingConfig AWS API Documentation
@@ -4766,7 +5395,7 @@ module Aws::CloudFormation
4766
5395
  #
4767
5396
  # @!attribute [rw] parameter_key
4768
5397
  # The key associated with the parameter. If you don't specify a key
4769
- # and value for a particular parameter, AWS CloudFormation uses the
5398
+ # and value for a particular parameter, CloudFormation uses the
4770
5399
  # default value that is specified in your template.
4771
5400
  # @return [String]
4772
5401
  #
@@ -4801,10 +5430,9 @@ module Aws::CloudFormation
4801
5430
  include Aws::Structure
4802
5431
  end
4803
5432
 
4804
- # A set of criteria that AWS CloudFormation uses to validate parameter
5433
+ # A set of criteria that CloudFormation uses to validate parameter
4805
5434
  # values. Although other constraints might be defined in the stack
4806
- # template, AWS CloudFormation returns only the `AllowedValues`
4807
- # property.
5435
+ # template, CloudFormation returns only the `AllowedValues` property.
4808
5436
  #
4809
5437
  # @!attribute [rw] allowed_values
4810
5438
  # A list of values that are permitted for a parameter.
@@ -4834,7 +5462,7 @@ module Aws::CloudFormation
4834
5462
  #
4835
5463
  # @!attribute [rw] no_echo
4836
5464
  # Flag that indicates whether the parameter value is shown as plain
4837
- # text in logs and in the AWS Management Console.
5465
+ # text in logs and in the Management Console.
4838
5466
  # @return [Boolean]
4839
5467
  #
4840
5468
  # @!attribute [rw] description
@@ -4842,8 +5470,7 @@ module Aws::CloudFormation
4842
5470
  # @return [String]
4843
5471
  #
4844
5472
  # @!attribute [rw] parameter_constraints
4845
- # The criteria that AWS CloudFormation uses to validate parameter
4846
- # values.
5473
+ # The criteria that CloudFormation uses to validate parameter values.
4847
5474
  # @return [Types::ParameterConstraints]
4848
5475
  #
4849
5476
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ParameterDeclaration AWS API Documentation
@@ -4859,11 +5486,11 @@ module Aws::CloudFormation
4859
5486
  include Aws::Structure
4860
5487
  end
4861
5488
 
4862
- # Context information that enables AWS CloudFormation to uniquely
4863
- # identify a resource. AWS CloudFormation uses context key-value pairs
4864
- # in cases where a resource's logical and physical IDs are not enough
4865
- # to uniquely identify that resource. Each context key-value pair
4866
- # specifies a resource that contains the targeted resource.
5489
+ # Context information that enables CloudFormation to uniquely identify a
5490
+ # resource. CloudFormation uses context key-value pairs in cases where a
5491
+ # resource's logical and physical IDs are not enough to uniquely
5492
+ # identify that resource. Each context key-value pair specifies a
5493
+ # resource that contains the targeted resource.
4867
5494
  #
4868
5495
  # @!attribute [rw] key
4869
5496
  # The resource context key.
@@ -4931,6 +5558,79 @@ module Aws::CloudFormation
4931
5558
  include Aws::Structure
4932
5559
  end
4933
5560
 
5561
+ # @note When making an API call, you may pass PublishTypeInput
5562
+ # data as a hash:
5563
+ #
5564
+ # {
5565
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
5566
+ # arn: "PrivateTypeArn",
5567
+ # type_name: "TypeName",
5568
+ # public_version_number: "PublicVersionNumber",
5569
+ # }
5570
+ #
5571
+ # @!attribute [rw] type
5572
+ # The type of the extension.
5573
+ #
5574
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5575
+ # @return [String]
5576
+ #
5577
+ # @!attribute [rw] arn
5578
+ # The Amazon Resource Number (ARN) of the extension.
5579
+ #
5580
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5581
+ # @return [String]
5582
+ #
5583
+ # @!attribute [rw] type_name
5584
+ # The name of the extension.
5585
+ #
5586
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5587
+ # @return [String]
5588
+ #
5589
+ # @!attribute [rw] public_version_number
5590
+ # The version number to assign to this version of the extension.
5591
+ #
5592
+ # Use the following format, and adhere to semantic versioning when
5593
+ # assigning a version number to your extension:
5594
+ #
5595
+ # `MAJOR.MINOR.PATCH`
5596
+ #
5597
+ # For more information, see [Semantic Versioning 2.0.0][1].
5598
+ #
5599
+ # If you do not specify a version number, CloudFormation increments
5600
+ # the version number by one minor version release.
5601
+ #
5602
+ # The first time you publish a type, CloudFormation sets the version
5603
+ # number to `1.0.0`, regardless of the value you specify.
5604
+ #
5605
+ #
5606
+ #
5607
+ # [1]: https://semver.org/
5608
+ # @return [String]
5609
+ #
5610
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/PublishTypeInput AWS API Documentation
5611
+ #
5612
+ class PublishTypeInput < Struct.new(
5613
+ :type,
5614
+ :arn,
5615
+ :type_name,
5616
+ :public_version_number)
5617
+ SENSITIVE = []
5618
+ include Aws::Structure
5619
+ end
5620
+
5621
+ # @!attribute [rw] public_type_arn
5622
+ # The Amazon Resource Number (ARN) assigned to the public extension
5623
+ # upon publication.
5624
+ # @return [String]
5625
+ #
5626
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/PublishTypeOutput AWS API Documentation
5627
+ #
5628
+ class PublishTypeOutput < Struct.new(
5629
+ :public_type_arn)
5630
+ SENSITIVE = []
5631
+ include Aws::Structure
5632
+ end
5633
+
4934
5634
  # @note When making an API call, you may pass RecordHandlerProgressInput
4935
5635
  # data as a hash:
4936
5636
  #
@@ -4939,7 +5639,7 @@ module Aws::CloudFormation
4939
5639
  # operation_status: "PENDING", # required, accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4940
5640
  # current_operation_status: "PENDING", # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4941
5641
  # status_message: "StatusMessage",
4942
- # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure
5642
+ # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure, InvalidTypeConfiguration
4943
5643
  # resource_model: "ResourceModel",
4944
5644
  # client_request_token: "ClientRequestToken",
4945
5645
  # }
@@ -5018,6 +5718,63 @@ module Aws::CloudFormation
5018
5718
  #
5019
5719
  class RecordHandlerProgressOutput < Aws::EmptyStructure; end
5020
5720
 
5721
+ # @note When making an API call, you may pass RegisterPublisherInput
5722
+ # data as a hash:
5723
+ #
5724
+ # {
5725
+ # accept_terms_and_conditions: false,
5726
+ # connection_arn: "ConnectionArn",
5727
+ # }
5728
+ #
5729
+ # @!attribute [rw] accept_terms_and_conditions
5730
+ # Whether you accept the [Terms and Conditions][1] for publishing
5731
+ # extensions in the CloudFormation registry. You must accept the terms
5732
+ # and conditions in order to register to publish public extensions to
5733
+ # the CloudFormation registry.
5734
+ #
5735
+ # The default is `false`.
5736
+ #
5737
+ #
5738
+ #
5739
+ # [1]: https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf
5740
+ # @return [Boolean]
5741
+ #
5742
+ # @!attribute [rw] connection_arn
5743
+ # If you are using a Bitbucket or GitHub account for identity
5744
+ # verification, the Amazon Resource Name (ARN) for your connection to
5745
+ # that account.
5746
+ #
5747
+ # For more information, see [Registering your account to publish
5748
+ # CloudFormation extensions][1] in the *CloudFormation CLI User
5749
+ # Guide*.
5750
+ #
5751
+ #
5752
+ #
5753
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
5754
+ # @return [String]
5755
+ #
5756
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterPublisherInput AWS API Documentation
5757
+ #
5758
+ class RegisterPublisherInput < Struct.new(
5759
+ :accept_terms_and_conditions,
5760
+ :connection_arn)
5761
+ SENSITIVE = []
5762
+ include Aws::Structure
5763
+ end
5764
+
5765
+ # @!attribute [rw] publisher_id
5766
+ # The ID assigned this account by CloudFormation for publishing
5767
+ # extensions.
5768
+ # @return [String]
5769
+ #
5770
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterPublisherOutput AWS API Documentation
5771
+ #
5772
+ class RegisterPublisherOutput < Struct.new(
5773
+ :publisher_id)
5774
+ SENSITIVE = []
5775
+ include Aws::Structure
5776
+ end
5777
+
5021
5778
  # @note When making an API call, you may pass RegisterTypeInput
5022
5779
  # data as a hash:
5023
5780
  #
@@ -5040,8 +5797,13 @@ module Aws::CloudFormation
5040
5797
  # @!attribute [rw] type_name
5041
5798
  # The name of the extension being registered.
5042
5799
  #
5043
- # We recommend that extension names adhere to the following pattern:
5044
- # *company\_or\_organization*\::*service*\::*type*.
5800
+ # We recommend that extension names adhere to the following patterns:
5801
+ #
5802
+ # * For resource types,
5803
+ # *company\_or\_organization*\::*service*\::*type*.
5804
+ #
5805
+ # * For modules,
5806
+ # *company\_or\_organization*\::*service*\::*type*\::MODULE.
5045
5807
  #
5046
5808
  # <note markdown="1"> The following organization namespaces are reserved and cannot be
5047
5809
  # used in your extension names:
@@ -5074,7 +5836,7 @@ module Aws::CloudFormation
5074
5836
  # package in the S3 bucket. That is, the user needs to have
5075
5837
  # [GetObject][2] permissions for the schema handler package. For more
5076
5838
  # information, see [Actions, Resources, and Condition Keys for Amazon
5077
- # S3][3] in the *AWS Identity and Access Management User Guide*.
5839
+ # S3][3] in the *Identity and Access Management User Guide*.
5078
5840
  #
5079
5841
  # </note>
5080
5842
  #
@@ -5091,15 +5853,26 @@ module Aws::CloudFormation
5091
5853
  #
5092
5854
  # @!attribute [rw] execution_role_arn
5093
5855
  # The Amazon Resource Name (ARN) of the IAM role for CloudFormation to
5094
- # assume when invoking the extension. If your extension calls AWS APIs
5095
- # in any of its handlers, you must create an <i> <a
5856
+ # assume when invoking the extension.
5857
+ #
5858
+ # For CloudFormation to assume the specified execution role, the role
5859
+ # must contain a trust relationship with the CloudFormation service
5860
+ # principle (`resources.cloudformation.amazonaws.com`). For more
5861
+ # information on adding trust relationships, see [Modifying a role
5862
+ # trust
5863
+ # policy](IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-managingrole_edit-trust-policy)
5864
+ # in the *Identity and Access Management User Guide*.
5865
+ #
5866
+ # If your extension calls Amazon Web Services APIs in any of its
5867
+ # handlers, you must create an <i> <a
5096
5868
  # href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
5097
5869
  # execution role</a> </i> that includes the necessary permissions to
5098
- # call those AWS APIs, and provision that execution role in your
5099
- # account. When CloudFormation needs to invoke the extension handler,
5100
- # CloudFormation assumes this execution role to create a temporary
5101
- # session token, which it then passes to the extension handler,
5102
- # thereby supplying your extension with the appropriate credentials.
5870
+ # call those Amazon Web Services APIs, and provision that execution
5871
+ # role in your account. When CloudFormation needs to invoke the
5872
+ # resource type handler, CloudFormation assumes this execution role to
5873
+ # create a temporary session token, which it then passes to the
5874
+ # resource type handler, thereby supplying your resource type with the
5875
+ # appropriate credentials.
5103
5876
  # @return [String]
5104
5877
  #
5105
5878
  # @!attribute [rw] client_request_token
@@ -5139,13 +5912,66 @@ module Aws::CloudFormation
5139
5912
  include Aws::Structure
5140
5913
  end
5141
5914
 
5915
+ # For extensions that are modules, a public third-party extension that
5916
+ # must be activated in your account in order for the module itself to be
5917
+ # activated.
5918
+ #
5919
+ # For more information, see [Activating public modules for use in your
5920
+ # account][1] in the *CloudFormation User Guide*.
5921
+ #
5922
+ #
5923
+ #
5924
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/modules.html#module-enabling
5925
+ #
5926
+ # @!attribute [rw] type_name_alias
5927
+ # An alias assigned to the public extension, in this account and
5928
+ # region. If you specify an alias for the extension, CloudFormation
5929
+ # treats the alias as the extension type name within this account and
5930
+ # region. You must use the alias to refer to the extension in your
5931
+ # templates, API calls, and CloudFormation console.
5932
+ # @return [String]
5933
+ #
5934
+ # @!attribute [rw] original_type_name
5935
+ # The type name of the public extension.
5936
+ #
5937
+ # If you specified a `TypeNameAlias` when enabling the extension in
5938
+ # this account and region, CloudFormation treats that alias as the
5939
+ # extension's type name within the account and region, not the type
5940
+ # name of the public extension. For more information, see [Specifying
5941
+ # aliases to refer to extensions][1] in the *CloudFormation User
5942
+ # Guide*.
5943
+ #
5944
+ #
5945
+ #
5946
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-alias
5947
+ # @return [String]
5948
+ #
5949
+ # @!attribute [rw] publisher_id
5950
+ # The publisher ID of the extension publisher.
5951
+ # @return [String]
5952
+ #
5953
+ # @!attribute [rw] supported_major_versions
5954
+ # A list of the major versions of the extension type that the macro
5955
+ # supports.
5956
+ # @return [Array<Integer>]
5957
+ #
5958
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RequiredActivatedType AWS API Documentation
5959
+ #
5960
+ class RequiredActivatedType < Struct.new(
5961
+ :type_name_alias,
5962
+ :original_type_name,
5963
+ :publisher_id,
5964
+ :supported_major_versions)
5965
+ SENSITIVE = []
5966
+ include Aws::Structure
5967
+ end
5968
+
5142
5969
  # The `ResourceChange` structure describes the resource and the action
5143
- # that AWS CloudFormation will perform on it if you execute this change
5144
- # set.
5970
+ # that CloudFormation will perform on it if you execute this change set.
5145
5971
  #
5146
5972
  # @!attribute [rw] action
5147
- # The action that AWS CloudFormation takes on the resource, such as
5148
- # `Add` (adds a new resource), `Modify` (changes a resource), `Remove`
5973
+ # The action that CloudFormation takes on the resource, such as `Add`
5974
+ # (adds a new resource), `Modify` (changes a resource), `Remove`
5149
5975
  # (deletes a resource), `Import` (imports a resource), or `Dynamic`
5150
5976
  # (exact action for the resource cannot be determined).
5151
5977
  # @return [String]
@@ -5161,11 +5987,11 @@ module Aws::CloudFormation
5161
5987
  # @return [String]
5162
5988
  #
5163
5989
  # @!attribute [rw] resource_type
5164
- # The type of AWS CloudFormation resource, such as `AWS::S3::Bucket`.
5990
+ # The type of CloudFormation resource, such as `AWS::S3::Bucket`.
5165
5991
  # @return [String]
5166
5992
  #
5167
5993
  # @!attribute [rw] replacement
5168
- # For the `Modify` action, indicates whether AWS CloudFormation will
5994
+ # For the `Modify` action, indicates whether CloudFormation will
5169
5995
  # replace the resource by creating a new one and deleting the old one.
5170
5996
  # This value depends on the value of the `RequiresRecreation` property
5171
5997
  # in the `ResourceTargetDefinition` structure. For example, if the
@@ -5188,7 +6014,7 @@ module Aws::CloudFormation
5188
6014
  #
5189
6015
  # @!attribute [rw] details
5190
6016
  # For the `Modify` action, a list of `ResourceChangeDetail` structures
5191
- # that describes the changes that AWS CloudFormation will make to the
6017
+ # that describes the changes that CloudFormation will make to the
5192
6018
  # resource.
5193
6019
  # @return [Array<Types::ResourceChangeDetail>]
5194
6020
  #
@@ -5219,23 +6045,23 @@ module Aws::CloudFormation
5219
6045
  end
5220
6046
 
5221
6047
  # For a resource with `Modify` as the action, the `ResourceChange`
5222
- # structure describes the changes AWS CloudFormation will make to that
6048
+ # structure describes the changes CloudFormation will make to that
5223
6049
  # resource.
5224
6050
  #
5225
6051
  # @!attribute [rw] target
5226
6052
  # A `ResourceTargetDefinition` structure that describes the field that
5227
- # AWS CloudFormation will change and whether the resource will be
6053
+ # CloudFormation will change and whether the resource will be
5228
6054
  # recreated.
5229
6055
  # @return [Types::ResourceTargetDefinition]
5230
6056
  #
5231
6057
  # @!attribute [rw] evaluation
5232
- # Indicates whether AWS CloudFormation can determine the target value,
5233
- # and whether the target value will change before you execute a change
6058
+ # Indicates whether CloudFormation can determine the target value, and
6059
+ # whether the target value will change before you execute a change
5234
6060
  # set.
5235
6061
  #
5236
- # For `Static` evaluations, AWS CloudFormation can determine that the
6062
+ # For `Static` evaluations, CloudFormation can determine that the
5237
6063
  # target value will change, and its value. For example, if you
5238
- # directly modify the `InstanceType` property of an EC2 instance, AWS
6064
+ # directly modify the `InstanceType` property of an EC2 instance,
5239
6065
  # CloudFormation knows that this property value will change, and its
5240
6066
  # value, so this is a `Static` evaluation.
5241
6067
  #
@@ -5270,11 +6096,11 @@ module Aws::CloudFormation
5270
6096
  #
5271
6097
  # * `Automatic` entities are `AWS::CloudFormation::Stack` resource
5272
6098
  # types, which are also known as nested stacks. If you made no
5273
- # changes to the `AWS::CloudFormation::Stack` resource, AWS
6099
+ # changes to the `AWS::CloudFormation::Stack` resource,
5274
6100
  # CloudFormation sets the `ChangeSource` to `Automatic` because the
5275
6101
  # nested stack's template might have changed. Changes to a nested
5276
- # stack's template aren't visible to AWS CloudFormation until you
5277
- # run an update on the parent stack.
6102
+ # stack's template aren't visible to CloudFormation until you run
6103
+ # an update on the parent stack.
5278
6104
  # @return [String]
5279
6105
  #
5280
6106
  # @!attribute [rw] causing_entity
@@ -5330,7 +6156,7 @@ module Aws::CloudFormation
5330
6156
  include Aws::Structure
5331
6157
  end
5332
6158
 
5333
- # The field that AWS CloudFormation will change, such as the name of a
6159
+ # The field that CloudFormation will change, such as the name of a
5334
6160
  # resource's property, and whether the resource will be recreated.
5335
6161
  #
5336
6162
  # @!attribute [rw] attribute
@@ -5349,7 +6175,7 @@ module Aws::CloudFormation
5349
6175
  # to this property causes the resource to be recreated. The value can
5350
6176
  # be `Never`, `Always`, or `Conditionally`. To determine the
5351
6177
  # conditions for a `Conditionally` recreation, see the update behavior
5352
- # for that [property][1] in the AWS CloudFormation User Guide.
6178
+ # for that [property][1] in the CloudFormation User Guide.
5353
6179
  #
5354
6180
  #
5355
6181
  #
@@ -5382,8 +6208,8 @@ module Aws::CloudFormation
5382
6208
  # @!attribute [rw] resource_type
5383
6209
  # The type of resource to import into your stack, such as
5384
6210
  # `AWS::S3::Bucket`. For a list of supported resource types, see
5385
- # [Resources that support import operations][1] in the AWS
5386
- # CloudFormation User Guide.
6211
+ # [Resources that support import operations][1] in the CloudFormation
6212
+ # User Guide.
5387
6213
  #
5388
6214
  #
5389
6215
  #
@@ -5411,15 +6237,15 @@ module Aws::CloudFormation
5411
6237
  include Aws::Structure
5412
6238
  end
5413
6239
 
5414
- # Structure containing the rollback triggers for AWS CloudFormation to
6240
+ # Structure containing the rollback triggers for CloudFormation to
5415
6241
  # monitor during stack creation and updating operations, and for the
5416
6242
  # specified monitoring period afterwards.
5417
6243
  #
5418
- # Rollback triggers enable you to have AWS CloudFormation monitor the
5419
- # state of your application during stack creation and updating, and to
5420
- # roll back that operation if the application breaches the threshold of
5421
- # any of the alarms you've specified. For more information, see
5422
- # [Monitor and Roll Back Stack Operations][1].
6244
+ # Rollback triggers enable you to have CloudFormation monitor the state
6245
+ # of your application during stack creation and updating, and to roll
6246
+ # back that operation if the application breaches the threshold of any
6247
+ # of the alarms you've specified. For more information, see [Monitor
6248
+ # and Roll Back Stack Operations][1].
5423
6249
  #
5424
6250
  #
5425
6251
  #
@@ -5441,9 +6267,9 @@ module Aws::CloudFormation
5441
6267
  # @!attribute [rw] rollback_triggers
5442
6268
  # The triggers to monitor during stack creation or update actions.
5443
6269
  #
5444
- # By default, AWS CloudFormation saves the rollback triggers specified
5445
- # for a stack and applies them to any subsequent update operations for
5446
- # the stack, unless you specify otherwise. If you do specify rollback
6270
+ # By default, CloudFormation saves the rollback triggers specified for
6271
+ # a stack and applies them to any subsequent update operations for the
6272
+ # stack, unless you specify otherwise. If you do specify rollback
5447
6273
  # triggers for this parameter, those triggers replace any list of
5448
6274
  # triggers previously specified for the stack. This means:
5449
6275
  #
@@ -5497,7 +6323,7 @@ module Aws::CloudFormation
5497
6323
  include Aws::Structure
5498
6324
  end
5499
6325
 
5500
- # A rollback trigger AWS CloudFormation monitors during creation and
6326
+ # A rollback trigger CloudFormation monitors during creation and
5501
6327
  # updating of stacks. If any of the alarms you specify goes to ALARM
5502
6328
  # state during the stack operation or within the specified monitoring
5503
6329
  # period afterwards, CloudFormation rolls back the entire stack
@@ -5554,9 +6380,9 @@ module Aws::CloudFormation
5554
6380
  #
5555
6381
  # @!attribute [rw] stack_policy_body
5556
6382
  # Structure containing the stack policy body. For more information, go
5557
- # to [ Prevent Updates to Stack Resources][1] in the AWS
5558
- # CloudFormation User Guide. You can specify either the
5559
- # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
6383
+ # to [ Prevent Updates to Stack Resources][1] in the CloudFormation
6384
+ # User Guide. You can specify either the `StackPolicyBody` or the
6385
+ # `StackPolicyURL` parameter, but not both.
5560
6386
  #
5561
6387
  #
5562
6388
  #
@@ -5580,6 +6406,101 @@ module Aws::CloudFormation
5580
6406
  include Aws::Structure
5581
6407
  end
5582
6408
 
6409
+ # @note When making an API call, you may pass SetTypeConfigurationInput
6410
+ # data as a hash:
6411
+ #
6412
+ # {
6413
+ # type_arn: "TypeArn",
6414
+ # configuration: "TypeConfiguration", # required
6415
+ # configuration_alias: "TypeConfigurationAlias",
6416
+ # type_name: "TypeName",
6417
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
6418
+ # }
6419
+ #
6420
+ # @!attribute [rw] type_arn
6421
+ # The Amazon Resource Name (ARN) for the extension, in this account
6422
+ # and region.
6423
+ #
6424
+ # For public extensions, this will be the ARN assigned when you
6425
+ # [activate the type][1] in this account and region. For private
6426
+ # extensions, this will be the ARN assigned when you [register the
6427
+ # type][2] in this account and region.
6428
+ #
6429
+ # Do not include the extension versions suffix at the end of the ARN.
6430
+ # You can set the configuration for an extension, but not for a
6431
+ # specific extension version.
6432
+ #
6433
+ #
6434
+ #
6435
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
6436
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
6437
+ # @return [String]
6438
+ #
6439
+ # @!attribute [rw] configuration
6440
+ # The configuration data for the extension, in this account and
6441
+ # region.
6442
+ #
6443
+ # The configuration data must be formatted as JSON, and validate
6444
+ # against the schema returned in the `ConfigurationSchema` response
6445
+ # element of
6446
+ # [API\_DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
6447
+ # For more information, see [Defining account-level configuration data
6448
+ # for an extension][1] in the *CloudFormation CLI User Guide*.
6449
+ #
6450
+ #
6451
+ #
6452
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration
6453
+ # @return [String]
6454
+ #
6455
+ # @!attribute [rw] configuration_alias
6456
+ # An alias by which to refer to this extension configuration data.
6457
+ #
6458
+ # Conditional: Specifying a configuration alias is required when
6459
+ # setting a configuration for a resource type extension.
6460
+ # @return [String]
6461
+ #
6462
+ # @!attribute [rw] type_name
6463
+ # The name of the extension.
6464
+ #
6465
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
6466
+ # `TypeName`.
6467
+ # @return [String]
6468
+ #
6469
+ # @!attribute [rw] type
6470
+ # The type of extension.
6471
+ #
6472
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
6473
+ # `TypeName`.
6474
+ # @return [String]
6475
+ #
6476
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetTypeConfigurationInput AWS API Documentation
6477
+ #
6478
+ class SetTypeConfigurationInput < Struct.new(
6479
+ :type_arn,
6480
+ :configuration,
6481
+ :configuration_alias,
6482
+ :type_name,
6483
+ :type)
6484
+ SENSITIVE = []
6485
+ include Aws::Structure
6486
+ end
6487
+
6488
+ # @!attribute [rw] configuration_arn
6489
+ # The Amazon Resource Name (ARN) for the configuration data, in this
6490
+ # account and region.
6491
+ #
6492
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
6493
+ # `TypeName`.
6494
+ # @return [String]
6495
+ #
6496
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetTypeConfigurationOutput AWS API Documentation
6497
+ #
6498
+ class SetTypeConfigurationOutput < Struct.new(
6499
+ :configuration_arn)
6500
+ SENSITIVE = []
6501
+ include Aws::Structure
6502
+ end
6503
+
5583
6504
  # @note When making an API call, you may pass SetTypeDefaultVersionInput
5584
6505
  # data as a hash:
5585
6506
  #
@@ -5665,8 +6586,8 @@ module Aws::CloudFormation
5665
6586
  #
5666
6587
  # @!attribute [rw] status
5667
6588
  # The status of the signal, which is either success or failure. A
5668
- # failure signal causes AWS CloudFormation to immediately fail the
5669
- # stack creation or update.
6589
+ # failure signal causes CloudFormation to immediately fail the stack
6590
+ # creation or update.
5670
6591
  # @return [String]
5671
6592
  #
5672
6593
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SignalResourceInput AWS API Documentation
@@ -5716,7 +6637,7 @@ module Aws::CloudFormation
5716
6637
  # @return [Time]
5717
6638
  #
5718
6639
  # @!attribute [rw] rollback_configuration
5719
- # The rollback triggers for AWS CloudFormation to monitor during stack
6640
+ # The rollback triggers for CloudFormation to monitor during stack
5720
6641
  # creation and updating operations, and for the specified monitoring
5721
6642
  # period afterwards.
5722
6643
  # @return [Types::RollbackConfiguration]
@@ -5754,10 +6675,10 @@ module Aws::CloudFormation
5754
6675
  # @return [Array<Types::Output>]
5755
6676
  #
5756
6677
  # @!attribute [rw] role_arn
5757
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
5758
- # Management (IAM) role that is associated with the stack. During a
5759
- # stack operation, AWS CloudFormation uses this role's credentials to
5760
- # make calls on your behalf.
6678
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
6679
+ # (IAM) role that is associated with the stack. During a stack
6680
+ # operation, CloudFormation uses this role's credentials to make
6681
+ # calls on your behalf.
5761
6682
  # @return [String]
5762
6683
  #
5763
6684
  # @!attribute [rw] tags
@@ -5770,7 +6691,7 @@ module Aws::CloudFormation
5770
6691
  # For [nested stacks][1], termination protection is set on the root
5771
6692
  # stack and cannot be changed directly on the nested stack. For more
5772
6693
  # information, see [Protecting a Stack From Being Deleted][2] in the
5773
- # *AWS CloudFormation User Guide*.
6694
+ # *CloudFormation User Guide*.
5774
6695
  #
5775
6696
  #
5776
6697
  #
@@ -5785,7 +6706,7 @@ module Aws::CloudFormation
5785
6706
  # stack.
5786
6707
  #
5787
6708
  # For more information, see [Working with Nested Stacks][1] in the
5788
- # *AWS CloudFormation User Guide*.
6709
+ # *CloudFormation User Guide*.
5789
6710
  #
5790
6711
  #
5791
6712
  #
@@ -5798,7 +6719,7 @@ module Aws::CloudFormation
5798
6719
  # ultimately belongs.
5799
6720
  #
5800
6721
  # For more information, see [Working with Nested Stacks][1] in the
5801
- # *AWS CloudFormation User Guide*.
6722
+ # *CloudFormation User Guide*.
5802
6723
  #
5803
6724
  #
5804
6725
  #
@@ -5860,7 +6781,7 @@ module Aws::CloudFormation
5860
6781
  # configuration. A stack is considered to have drifted if one or
5861
6782
  # more of its resources have drifted.
5862
6783
  #
5863
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the stack
6784
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
5864
6785
  # differs from its expected template configuration.
5865
6786
  #
5866
6787
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -5898,7 +6819,7 @@ module Aws::CloudFormation
5898
6819
  # configuration. A stack is considered to have drifted if one or
5899
6820
  # more of its resources have drifted.
5900
6821
  #
5901
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the stack
6822
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
5902
6823
  # differs from its expected template configuration.
5903
6824
  #
5904
6825
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -5946,8 +6867,8 @@ module Aws::CloudFormation
5946
6867
  # @return [String]
5947
6868
  #
5948
6869
  # @!attribute [rw] resource_type
5949
- # Type of resource. (For more information, go to [ AWS Resource Types
5950
- # Reference][1] in the AWS CloudFormation User Guide.)
6870
+ # Type of resource. (For more information, go to [Amazon Web Services
6871
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
5951
6872
  #
5952
6873
  #
5953
6874
  #
@@ -6006,7 +6927,7 @@ module Aws::CloudFormation
6006
6927
  include Aws::Structure
6007
6928
  end
6008
6929
 
6009
- # An AWS CloudFormation stack, in a specific account and Region, that's
6930
+ # An CloudFormation stack, in a specific account and Region, that's
6010
6931
  # part of a stack set operation. A stack instance is a reference to an
6011
6932
  # attempted or actual stack in a given account within a given Region. A
6012
6933
  # stack instance can exist without a stack—for example, if the stack
@@ -6021,13 +6942,12 @@ module Aws::CloudFormation
6021
6942
  # @return [String]
6022
6943
  #
6023
6944
  # @!attribute [rw] region
6024
- # The name of the AWS Region that the stack instance is associated
6025
- # with.
6945
+ # The name of the Region that the stack instance is associated with.
6026
6946
  # @return [String]
6027
6947
  #
6028
6948
  # @!attribute [rw] account
6029
- # \[Self-managed permissions\] The name of the AWS account that the
6030
- # stack instance is associated with.
6949
+ # \[Self-managed permissions\] The name of the account that the stack
6950
+ # instance is associated with.
6031
6951
  # @return [String]
6032
6952
  #
6033
6953
  # @!attribute [rw] stack_id
@@ -6092,7 +7012,7 @@ module Aws::CloudFormation
6092
7012
  # stack instance is considered to have drifted if one or more of the
6093
7013
  # resources in the associated stack have drifted.
6094
7014
  #
6095
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the stack
7015
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
6096
7016
  # instance differs from its expected stack set configuration.
6097
7017
  #
6098
7018
  # * `IN_SYNC`\: The stack instance's actual configuration matches its
@@ -6205,13 +7125,12 @@ module Aws::CloudFormation
6205
7125
  # @return [String]
6206
7126
  #
6207
7127
  # @!attribute [rw] region
6208
- # The name of the AWS Region that the stack instance is associated
6209
- # with.
7128
+ # The name of the Region that the stack instance is associated with.
6210
7129
  # @return [String]
6211
7130
  #
6212
7131
  # @!attribute [rw] account
6213
- # \[Self-managed permissions\] The name of the AWS account that the
6214
- # stack instance is associated with.
7132
+ # \[Self-managed permissions\] The name of the account that the stack
7133
+ # instance is associated with.
6215
7134
  # @return [String]
6216
7135
  #
6217
7136
  # @!attribute [rw] stack_id
@@ -6271,7 +7190,7 @@ module Aws::CloudFormation
6271
7190
  # stack instance is considered to have drifted if one or more of the
6272
7191
  # resources in the associated stack have drifted.
6273
7192
  #
6274
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the stack
7193
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
6275
7194
  # instance differs from its expected stack set configuration.
6276
7195
  #
6277
7196
  # * `IN_SYNC`\: The stack instance's actual configuration matches its
@@ -6303,6 +7222,13 @@ module Aws::CloudFormation
6303
7222
  include Aws::Structure
6304
7223
  end
6305
7224
 
7225
+ # The specified stack ARN doesn’t exist or stack doesn’t exist
7226
+ # corresponding to the ARN in input.
7227
+ #
7228
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackNotFoundException AWS API Documentation
7229
+ #
7230
+ class StackNotFoundException < Aws::EmptyStructure; end
7231
+
6306
7232
  # The StackResource data type.
6307
7233
  #
6308
7234
  # @!attribute [rw] stack_name
@@ -6319,12 +7245,12 @@ module Aws::CloudFormation
6319
7245
  #
6320
7246
  # @!attribute [rw] physical_resource_id
6321
7247
  # The name or unique identifier that corresponds to a physical
6322
- # instance ID of a resource supported by AWS CloudFormation.
7248
+ # instance ID of a resource supported by CloudFormation.
6323
7249
  # @return [String]
6324
7250
  #
6325
7251
  # @!attribute [rw] resource_type
6326
- # Type of resource. (For more information, go to [ AWS Resource Types
6327
- # Reference][1] in the AWS CloudFormation User Guide.)
7252
+ # Type of resource. (For more information, go to [Amazon Web Services
7253
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
6328
7254
  #
6329
7255
  #
6330
7256
  #
@@ -6399,12 +7325,12 @@ module Aws::CloudFormation
6399
7325
  #
6400
7326
  # @!attribute [rw] physical_resource_id
6401
7327
  # The name or unique identifier that corresponds to a physical
6402
- # instance ID of a resource supported by AWS CloudFormation.
7328
+ # instance ID of a resource supported by CloudFormation.
6403
7329
  # @return [String]
6404
7330
  #
6405
7331
  # @!attribute [rw] resource_type
6406
- # Type of resource. ((For more information, go to [ AWS Resource Types
6407
- # Reference][1] in the AWS CloudFormation User Guide.)
7332
+ # Type of resource. ((For more information, go to [Amazon Web Services
7333
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
6408
7334
  #
6409
7335
  #
6410
7336
  #
@@ -6429,7 +7355,7 @@ module Aws::CloudFormation
6429
7355
  #
6430
7356
  # @!attribute [rw] metadata
6431
7357
  # The content of the `Metadata` attribute declared for the resource.
6432
- # For more information, see [Metadata Attribute][1] in the AWS
7358
+ # For more information, see [Metadata Attribute][1] in the
6433
7359
  # CloudFormation User Guide.
6434
7360
  #
6435
7361
  #
@@ -6476,10 +7402,10 @@ module Aws::CloudFormation
6476
7402
 
6477
7403
  # Contains the drift information for a resource that has been checked
6478
7404
  # for drift. This includes actual and expected property values for
6479
- # resources in which AWS CloudFormation has detected drift. Only
6480
- # resource properties explicitly defined in the stack template are
6481
- # checked for drift. For more information, see [Detecting Unregulated
6482
- # Configuration Changes to Stacks and Resources][1].
7405
+ # resources in which CloudFormation has detected drift. Only resource
7406
+ # properties explicitly defined in the stack template are checked for
7407
+ # drift. For more information, see [Detecting Unregulated Configuration
7408
+ # Changes to Stacks and Resources][1].
6483
7409
  #
6484
7410
  # Resources that do not currently support drift detection cannot be
6485
7411
  # checked. For a list of resources that support drift detection, see
@@ -6504,14 +7430,14 @@ module Aws::CloudFormation
6504
7430
  #
6505
7431
  # @!attribute [rw] physical_resource_id
6506
7432
  # The name or unique identifier that corresponds to a physical
6507
- # instance ID of a resource supported by AWS CloudFormation.
7433
+ # instance ID of a resource supported by CloudFormation.
6508
7434
  # @return [String]
6509
7435
  #
6510
7436
  # @!attribute [rw] physical_resource_id_context
6511
- # Context information that enables AWS CloudFormation to uniquely
6512
- # identify a resource. AWS CloudFormation uses context key-value pairs
6513
- # in cases where a resource's logical and physical IDs are not enough
6514
- # to uniquely identify that resource. Each context key-value pair
7437
+ # Context information that enables CloudFormation to uniquely identify
7438
+ # a resource. CloudFormation uses context key-value pairs in cases
7439
+ # where a resource's logical and physical IDs are not enough to
7440
+ # uniquely identify that resource. Each context key-value pair
6515
7441
  # specifies a unique resource that contains the targeted resource.
6516
7442
  # @return [Array<Types::PhysicalResourceIdContextKeyValuePair>]
6517
7443
  #
@@ -6556,13 +7482,13 @@ module Aws::CloudFormation
6556
7482
  # * `IN_SYNC`\: The resources's actual configuration matches its
6557
7483
  # expected template configuration.
6558
7484
  #
6559
- # * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
7485
+ # * `NOT_CHECKED`\: CloudFormation does not currently return this
6560
7486
  # value.
6561
7487
  # @return [String]
6562
7488
  #
6563
7489
  # @!attribute [rw] timestamp
6564
- # Time at which AWS CloudFormation performed drift detection on the
6565
- # stack resource.
7490
+ # Time at which CloudFormation performed drift detection on the stack
7491
+ # resource.
6566
7492
  # @return [Time]
6567
7493
  #
6568
7494
  # @!attribute [rw] module_info
@@ -6602,7 +7528,7 @@ module Aws::CloudFormation
6602
7528
  #
6603
7529
  # * `MODIFIED`\: The resource differs from its expected configuration.
6604
7530
  #
6605
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the resource
7531
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the resource
6606
7532
  # differs from its expected configuration.
6607
7533
  #
6608
7534
  # Any resources that do not currently support drift detection have a
@@ -6618,8 +7544,8 @@ module Aws::CloudFormation
6618
7544
  # @return [String]
6619
7545
  #
6620
7546
  # @!attribute [rw] last_check_timestamp
6621
- # When AWS CloudFormation last checked if the resource had drifted
6622
- # from its expected configuration.
7547
+ # When CloudFormation last checked if the resource had drifted from
7548
+ # its expected configuration.
6623
7549
  # @return [Time]
6624
7550
  #
6625
7551
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackResourceDriftInformation AWS API Documentation
@@ -6644,7 +7570,7 @@ module Aws::CloudFormation
6644
7570
  #
6645
7571
  # * `MODIFIED`\: The resource differs from its expected configuration.
6646
7572
  #
6647
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked if the resource
7573
+ # * `NOT_CHECKED`\: CloudFormation has not checked if the resource
6648
7574
  # differs from its expected configuration.
6649
7575
  #
6650
7576
  # Any resources that do not currently support drift detection have a
@@ -6654,7 +7580,7 @@ module Aws::CloudFormation
6654
7580
  # included in `ResourcesToSkip` will also have a status of
6655
7581
  # `NOT_CHECKED`. For more information on skipping resources during
6656
7582
  # rollback operations, see [Continue Rolling Back an Update][2] in
6657
- # the AWS CloudFormation User Guide.
7583
+ # the CloudFormation User Guide.
6658
7584
  #
6659
7585
  # * `IN_SYNC`\: The resources's actual configuration matches its
6660
7586
  # expected configuration.
@@ -6666,8 +7592,8 @@ module Aws::CloudFormation
6666
7592
  # @return [String]
6667
7593
  #
6668
7594
  # @!attribute [rw] last_check_timestamp
6669
- # When AWS CloudFormation last checked if the resource had drifted
6670
- # from its expected configuration.
7595
+ # When CloudFormation last checked if the resource had drifted from
7596
+ # its expected configuration.
6671
7597
  # @return [Time]
6672
7598
  #
6673
7599
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackResourceDriftInformationSummary AWS API Documentation
@@ -6691,8 +7617,8 @@ module Aws::CloudFormation
6691
7617
  # @return [String]
6692
7618
  #
6693
7619
  # @!attribute [rw] resource_type
6694
- # Type of resource. (For more information, go to [ AWS Resource Types
6695
- # Reference][1] in the AWS CloudFormation User Guide.)
7620
+ # Type of resource. (For more information, go to [Amazon Web Services
7621
+ # Resource Types Reference][1] in the CloudFormation User Guide.)
6696
7622
  #
6697
7623
  #
6698
7624
  #
@@ -6745,10 +7671,10 @@ module Aws::CloudFormation
6745
7671
  end
6746
7672
 
6747
7673
  # A structure that contains information about a stack set. A stack set
6748
- # enables you to provision stacks into AWS accounts and across Regions
6749
- # by using a single CloudFormation template. In the stack set, you
6750
- # specify the template to use, as well as any parameters and
6751
- # capabilities that the template requires.
7674
+ # enables you to provision stacks into accounts and across Regions by
7675
+ # using a single CloudFormation template. In the stack set, you specify
7676
+ # the template to use, as well as any parameters and capabilities that
7677
+ # the template requires.
6752
7678
  #
6753
7679
  # @!attribute [rw] stack_set_name
6754
7680
  # The name that's associated with the stack set.
@@ -6779,9 +7705,9 @@ module Aws::CloudFormation
6779
7705
  # @!attribute [rw] capabilities
6780
7706
  # The capabilities that are allowed in the stack set. Some stack set
6781
7707
  # templates might include resources that can affect permissions in
6782
- # your AWS account—for example, by creating new AWS Identity and
6783
- # Access Management (IAM) users. For more information, see
6784
- # [Acknowledging IAM Resources in AWS CloudFormation Templates.][1]
7708
+ # your account—for example, by creating new Identity and Access
7709
+ # Management (IAM) users. For more information, see [Acknowledging IAM
7710
+ # Resources in CloudFormation Templates.][1]
6785
7711
  #
6786
7712
  #
6787
7713
  #
@@ -6804,8 +7730,8 @@ module Aws::CloudFormation
6804
7730
  # Use customized administrator roles to control which users or groups
6805
7731
  # can manage specific stack sets within the same administrator
6806
7732
  # account. For more information, see [Prerequisites: Granting
6807
- # Permissions for Stack Set Operations][1] in the *AWS CloudFormation
6808
- # User Guide*.
7733
+ # Permissions for Stack Set Operations][1] in the *CloudFormation User
7734
+ # Guide*.
6809
7735
  #
6810
7736
  #
6811
7737
  #
@@ -6830,8 +7756,8 @@ module Aws::CloudFormation
6830
7756
  #
6831
7757
  # @!attribute [rw] auto_deployment
6832
7758
  # \[Service-managed permissions\] Describes whether StackSets
6833
- # automatically deploys to AWS Organizations accounts that are added
6834
- # to a target organization or organizational unit (OU).
7759
+ # automatically deploys to Organizations accounts that are added to a
7760
+ # target organization or organizational unit (OU).
6835
7761
  # @return [Types::AutoDeployment]
6836
7762
  #
6837
7763
  # @!attribute [rw] permission_model
@@ -6845,8 +7771,8 @@ module Aws::CloudFormation
6845
7771
  #
6846
7772
  # * With `service-managed` permissions, StackSets automatically
6847
7773
  # creates the IAM roles required to deploy to accounts managed by
6848
- # AWS Organizations. For more information, see [Grant
6849
- # Service-Managed Stack Set Permissions][2].
7774
+ # Organizations. For more information, see [Grant Service-Managed
7775
+ # Stack Set Permissions][2].
6850
7776
  #
6851
7777
  #
6852
7778
  #
@@ -6896,7 +7822,7 @@ module Aws::CloudFormation
6896
7822
  # currently being performed on the stack set.
6897
7823
  #
6898
7824
  # For more information, see [Detecting Unmanaged Changes in Stack
6899
- # Sets][1] in the *AWS CloudFormation User Guide*.
7825
+ # Sets][1] in the *CloudFormation User Guide*.
6900
7826
  #
6901
7827
  #
6902
7828
  #
@@ -6914,8 +7840,8 @@ module Aws::CloudFormation
6914
7840
  # configuration. A stack instance is considered to have drifted if
6915
7841
  # one or more of the resources in the associated stack have drifted.
6916
7842
  #
6917
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked the stack set
6918
- # for drift.
7843
+ # * `NOT_CHECKED`\: CloudFormation has not checked the stack set for
7844
+ # drift.
6919
7845
  #
6920
7846
  # * `IN_SYNC`\: All of the stack instances belonging to the stack set
6921
7847
  # stack match from the expected template and parameter
@@ -7040,14 +7966,13 @@ module Aws::CloudFormation
7040
7966
  # If the number of failed stacks within a Region exceeds the failure
7041
7967
  # tolerance, the status of the operation in the Region is set to
7042
7968
  # `FAILED`. This in turn sets the status of the operation as a whole
7043
- # to `FAILED`, and AWS CloudFormation cancels the operation in any
7969
+ # to `FAILED`, and CloudFormation cancels the operation in any
7044
7970
  # remaining Regions.
7045
7971
  #
7046
7972
  # * `QUEUED`\: \[Service-managed permissions\] For automatic
7047
7973
  # deployments that require a sequence of operations, the operation
7048
7974
  # is queued to be performed. For more information, see the [stack
7049
- # set operation status codes][1] in the AWS CloudFormation User
7050
- # Guide.
7975
+ # set operation status codes][1] in the CloudFormation User Guide.
7051
7976
  #
7052
7977
  # * `RUNNING`\: The operation is currently being performed.
7053
7978
  #
@@ -7066,7 +7991,7 @@ module Aws::CloudFormation
7066
7991
  # @return [String]
7067
7992
  #
7068
7993
  # @!attribute [rw] operation_preferences
7069
- # The preferences for how AWS CloudFormation performs this stack set
7994
+ # The preferences for how CloudFormation performs this stack set
7070
7995
  # operation.
7071
7996
  # @return [Types::StackSetOperationPreferences]
7072
7997
  #
@@ -7084,7 +8009,7 @@ module Aws::CloudFormation
7084
8009
  # Use customized administrator roles to control which users or groups
7085
8010
  # can manage specific stack sets within the same administrator
7086
8011
  # account. For more information, see [Define Permissions for Multiple
7087
- # Administrators][1] in the *AWS CloudFormation User Guide*.
8012
+ # Administrators][1] in the *CloudFormation User Guide*.
7088
8013
  #
7089
8014
  #
7090
8015
  #
@@ -7103,9 +8028,9 @@ module Aws::CloudFormation
7103
8028
  # The time at which the operation was initiated. Note that the
7104
8029
  # creation times for the stack set operation might differ from the
7105
8030
  # creation time of the individual stacks themselves. This is because
7106
- # AWS CloudFormation needs to perform preparatory work for the
7107
- # operation, such as dispatching the work to the requested Regions,
7108
- # before actually creating the first stacks.
8031
+ # CloudFormation needs to perform preparatory work for the operation,
8032
+ # such as dispatching the work to the requested Regions, before
8033
+ # actually creating the first stacks.
7109
8034
  # @return [Time]
7110
8035
  #
7111
8036
  # @!attribute [rw] end_timestamp
@@ -7116,8 +8041,8 @@ module Aws::CloudFormation
7116
8041
  # @return [Time]
7117
8042
  #
7118
8043
  # @!attribute [rw] deployment_targets
7119
- # \[Service-managed permissions\] The AWS Organizations accounts
7120
- # affected by the stack operation.
8044
+ # \[Service-managed permissions\] The Organizations accounts affected
8045
+ # by the stack operation.
7121
8046
  # @return [Types::DeploymentTargets]
7122
8047
  #
7123
8048
  # @!attribute [rw] stack_set_drift_detection_details
@@ -7129,7 +8054,7 @@ module Aws::CloudFormation
7129
8054
  # `Action` type is `DETECT_DRIFT`.
7130
8055
  #
7131
8056
  # For more information, see [Detecting Unmanaged Changes in Stack
7132
- # Sets][1] in the AWS CloudFormation User Guide.
8057
+ # Sets][1] in the CloudFormation User Guide.
7133
8058
  #
7134
8059
  #
7135
8060
  #
@@ -7155,8 +8080,8 @@ module Aws::CloudFormation
7155
8080
  include Aws::Structure
7156
8081
  end
7157
8082
 
7158
- # The user-specified preferences for how AWS CloudFormation performs a
7159
- # stack set operation.
8083
+ # The user-specified preferences for how CloudFormation performs a stack
8084
+ # set operation.
7160
8085
  #
7161
8086
  # For more information on maximum concurrent accounts and failure
7162
8087
  # tolerance, see [Stack set operation options][1].
@@ -7178,6 +8103,8 @@ module Aws::CloudFormation
7178
8103
  # }
7179
8104
  #
7180
8105
  # @!attribute [rw] region_concurrency_type
8106
+ # The concurrency type of deploying StackSets operations in Regions,
8107
+ # could be in parallel or one Region at a time.
7181
8108
  # @return [String]
7182
8109
  #
7183
8110
  # @!attribute [rw] region_order
@@ -7187,27 +8114,29 @@ module Aws::CloudFormation
7187
8114
  #
7188
8115
  # @!attribute [rw] failure_tolerance_count
7189
8116
  # The number of accounts, per Region, for which this operation can
7190
- # fail before AWS CloudFormation stops the operation in that Region.
7191
- # If the operation is stopped in a Region, AWS CloudFormation doesn't
8117
+ # fail before CloudFormation stops the operation in that Region. If
8118
+ # the operation is stopped in a Region, CloudFormation doesn't
7192
8119
  # attempt the operation in any subsequent Regions.
7193
8120
  #
7194
8121
  # Conditional: You must specify either `FailureToleranceCount` or
7195
8122
  # `FailureTolerancePercentage` (but not both).
8123
+ #
8124
+ # By default, `0` is specified.
7196
8125
  # @return [Integer]
7197
8126
  #
7198
8127
  # @!attribute [rw] failure_tolerance_percentage
7199
8128
  # The percentage of accounts, per Region, for which this stack
7200
- # operation can fail before AWS CloudFormation stops the operation in
7201
- # that Region. If the operation is stopped in a Region, AWS
7202
- # CloudFormation doesn't attempt the operation in any subsequent
7203
- # Regions.
8129
+ # operation can fail before CloudFormation stops the operation in that
8130
+ # Region. If the operation is stopped in a Region, CloudFormation
8131
+ # doesn't attempt the operation in any subsequent Regions.
7204
8132
  #
7205
8133
  # When calculating the number of accounts based on the specified
7206
- # percentage, AWS CloudFormation rounds *down* to the next whole
7207
- # number.
8134
+ # percentage, CloudFormation rounds *down* to the next whole number.
7208
8135
  #
7209
8136
  # Conditional: You must specify either `FailureToleranceCount` or
7210
8137
  # `FailureTolerancePercentage`, but not both.
8138
+ #
8139
+ # By default, `0` is specified.
7211
8140
  # @return [Integer]
7212
8141
  #
7213
8142
  # @!attribute [rw] max_concurrent_count
@@ -7223,6 +8152,8 @@ module Aws::CloudFormation
7223
8152
  #
7224
8153
  # Conditional: You must specify either `MaxConcurrentCount` or
7225
8154
  # `MaxConcurrentPercentage`, but not both.
8155
+ #
8156
+ # By default, `1` is specified.
7226
8157
  # @return [Integer]
7227
8158
  #
7228
8159
  # @!attribute [rw] max_concurrent_percentage
@@ -7230,7 +8161,7 @@ module Aws::CloudFormation
7230
8161
  # operation at one time.
7231
8162
  #
7232
8163
  # When calculating the number of accounts based on the specified
7233
- # percentage, AWS CloudFormation rounds down to the next whole number.
8164
+ # percentage, CloudFormation rounds down to the next whole number.
7234
8165
  # This is true except in cases where rounding down would result is
7235
8166
  # zero. In this case, CloudFormation sets the number as one instead.
7236
8167
  #
@@ -7241,6 +8172,8 @@ module Aws::CloudFormation
7241
8172
  #
7242
8173
  # Conditional: You must specify either `MaxConcurrentCount` or
7243
8174
  # `MaxConcurrentPercentage`, but not both.
8175
+ #
8176
+ # By default, `1` is specified.
7244
8177
  # @return [Integer]
7245
8178
  #
7246
8179
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetOperationPreferences AWS API Documentation
@@ -7260,12 +8193,12 @@ module Aws::CloudFormation
7260
8193
  # results for a given account in a given Region.
7261
8194
  #
7262
8195
  # @!attribute [rw] account
7263
- # \[Self-managed permissions\] The name of the AWS account for this
8196
+ # \[Self-managed permissions\] The name of the account for this
7264
8197
  # operation result.
7265
8198
  # @return [String]
7266
8199
  #
7267
8200
  # @!attribute [rw] region
7268
- # The name of the AWS Region for this operation result.
8201
+ # The name of the Region for this operation result.
7269
8202
  # @return [String]
7270
8203
  #
7271
8204
  # @!attribute [rw] status
@@ -7299,9 +8232,8 @@ module Aws::CloudFormation
7299
8232
  # @return [String]
7300
8233
  #
7301
8234
  # @!attribute [rw] account_gate_result
7302
- # The results of the account gate function AWS CloudFormation invokes,
7303
- # if present, before proceeding with stack set operations in an
7304
- # account
8235
+ # The results of the account gate function CloudFormation invokes, if
8236
+ # present, before proceeding with stack set operations in an account
7305
8237
  # @return [Types::AccountGateResult]
7306
8238
  #
7307
8239
  # @!attribute [rw] organizational_unit_id
@@ -7351,14 +8283,13 @@ module Aws::CloudFormation
7351
8283
  # If the number of failed stacks within a Region exceeds the failure
7352
8284
  # tolerance, the status of the operation in the Region is set to
7353
8285
  # `FAILED`. This in turn sets the status of the operation as a whole
7354
- # to `FAILED`, and AWS CloudFormation cancels the operation in any
8286
+ # to `FAILED`, and CloudFormation cancels the operation in any
7355
8287
  # remaining Regions.
7356
8288
  #
7357
8289
  # * `QUEUED`\: \[Service-managed permissions\] For automatic
7358
8290
  # deployments that require a sequence of operations, the operation
7359
8291
  # is queued to be performed. For more information, see the [stack
7360
- # set operation status codes][1] in the AWS CloudFormation User
7361
- # Guide.
8292
+ # set operation status codes][1] in the CloudFormation User Guide.
7362
8293
  #
7363
8294
  # * `RUNNING`\: The operation is currently being performed.
7364
8295
  #
@@ -7380,9 +8311,9 @@ module Aws::CloudFormation
7380
8311
  # The time at which the operation was initiated. Note that the
7381
8312
  # creation times for the stack set operation might differ from the
7382
8313
  # creation time of the individual stacks themselves. This is because
7383
- # AWS CloudFormation needs to perform preparatory work for the
7384
- # operation, such as dispatching the work to the requested Regions,
7385
- # before actually creating the first stacks.
8314
+ # CloudFormation needs to perform preparatory work for the operation,
8315
+ # such as dispatching the work to the requested Regions, before
8316
+ # actually creating the first stacks.
7386
8317
  # @return [Time]
7387
8318
  #
7388
8319
  # @!attribute [rw] end_timestamp
@@ -7426,8 +8357,8 @@ module Aws::CloudFormation
7426
8357
  #
7427
8358
  # @!attribute [rw] auto_deployment
7428
8359
  # \[Service-managed permissions\] Describes whether StackSets
7429
- # automatically deploys to AWS Organizations accounts that are added
7430
- # to a target organizational unit (OU).
8360
+ # automatically deploys to Organizations accounts that are added to a
8361
+ # target organizational unit (OU).
7431
8362
  # @return [Types::AutoDeployment]
7432
8363
  #
7433
8364
  # @!attribute [rw] permission_model
@@ -7441,8 +8372,8 @@ module Aws::CloudFormation
7441
8372
  #
7442
8373
  # * With `service-managed` permissions, StackSets automatically
7443
8374
  # creates the IAM roles required to deploy to accounts managed by
7444
- # AWS Organizations. For more information, see [Grant
7445
- # Service-Managed Stack Set Permissions][2].
8375
+ # Organizations. For more information, see [Grant Service-Managed
8376
+ # Stack Set Permissions][2].
7446
8377
  #
7447
8378
  #
7448
8379
  #
@@ -7462,8 +8393,8 @@ module Aws::CloudFormation
7462
8393
  # configuration. A stack instance is considered to have drifted if
7463
8394
  # one or more of the resources in the associated stack have drifted.
7464
8395
  #
7465
- # * `NOT_CHECKED`\: AWS CloudFormation has not checked the stack set
7466
- # for drift.
8396
+ # * `NOT_CHECKED`\: CloudFormation has not checked the stack set for
8397
+ # drift.
7467
8398
  #
7468
8399
  # * `IN_SYNC`\: All of the stack instances belonging to the stack set
7469
8400
  # stack match from the expected template and parameter
@@ -7535,7 +8466,7 @@ module Aws::CloudFormation
7535
8466
  # stack.
7536
8467
  #
7537
8468
  # For more information, see [Working with Nested Stacks][1] in the
7538
- # *AWS CloudFormation User Guide*.
8469
+ # *CloudFormation User Guide*.
7539
8470
  #
7540
8471
  #
7541
8472
  #
@@ -7548,7 +8479,7 @@ module Aws::CloudFormation
7548
8479
  # ultimately belongs.
7549
8480
  #
7550
8481
  # For more information, see [Working with Nested Stacks][1] in the
7551
- # *AWS CloudFormation User Guide*.
8482
+ # *CloudFormation User Guide*.
7552
8483
  #
7553
8484
  #
7554
8485
  #
@@ -7623,10 +8554,9 @@ module Aws::CloudFormation
7623
8554
  # * If you are signed in to a delegated administrator account, specify
7624
8555
  # `DELEGATED_ADMIN`.
7625
8556
  #
7626
- # Your AWS account must be registered as a delegated administrator
7627
- # in the management account. For more information, see [Register a
7628
- # delegated administrator][1] in the *AWS CloudFormation User
7629
- # Guide*.
8557
+ # Your account must be registered as a delegated administrator in
8558
+ # the management account. For more information, see [Register a
8559
+ # delegated administrator][1] in the *CloudFormation User Guide*.
7630
8560
  #
7631
8561
  #
7632
8562
  #
@@ -7648,7 +8578,7 @@ module Aws::CloudFormation
7648
8578
  class StopStackSetOperationOutput < Aws::EmptyStructure; end
7649
8579
 
7650
8580
  # The Tag type enables you to specify a key-value pair that can be used
7651
- # to store information about an AWS CloudFormation stack.
8581
+ # to store information about an CloudFormation stack.
7652
8582
  #
7653
8583
  # @note When making an API call, you may pass Tag
7654
8584
  # data as a hash:
@@ -7661,7 +8591,7 @@ module Aws::CloudFormation
7661
8591
  # @!attribute [rw] key
7662
8592
  # *Required*. A string used to identify this tag. You can specify a
7663
8593
  # maximum of 128 characters for a tag key. Tags owned by Amazon Web
7664
- # Services (AWS) have the reserved prefix: `aws:`.
8594
+ # Services (Amazon Web Services) have the reserved prefix: `aws:`.
7665
8595
  # @return [String]
7666
8596
  #
7667
8597
  # @!attribute [rw] value
@@ -7708,47 +8638,440 @@ module Aws::CloudFormation
7708
8638
  include Aws::Structure
7709
8639
  end
7710
8640
 
8641
+ # @note When making an API call, you may pass TestTypeInput
8642
+ # data as a hash:
8643
+ #
8644
+ # {
8645
+ # arn: "TypeArn",
8646
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
8647
+ # type_name: "TypeName",
8648
+ # version_id: "TypeVersionId",
8649
+ # log_delivery_bucket: "S3Bucket",
8650
+ # }
8651
+ #
8652
+ # @!attribute [rw] arn
8653
+ # The Amazon Resource Number (ARN) of the extension.
8654
+ #
8655
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
8656
+ # @return [String]
8657
+ #
8658
+ # @!attribute [rw] type
8659
+ # The type of the extension to test.
8660
+ #
8661
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
8662
+ # @return [String]
8663
+ #
8664
+ # @!attribute [rw] type_name
8665
+ # The name of the extension to test.
8666
+ #
8667
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
8668
+ # @return [String]
8669
+ #
8670
+ # @!attribute [rw] version_id
8671
+ # The version of the extension to test.
8672
+ #
8673
+ # You can specify the version id with either `Arn`, or with `TypeName`
8674
+ # and `Type`.
8675
+ #
8676
+ # If you do not specify a version, CloudFormation uses the default
8677
+ # version of the extension in this account and region for testing.
8678
+ # @return [String]
8679
+ #
8680
+ # @!attribute [rw] log_delivery_bucket
8681
+ # The S3 bucket to which CloudFormation delivers the contract test
8682
+ # execution logs.
8683
+ #
8684
+ # CloudFormation delivers the logs by the time contract testing has
8685
+ # completed and the extension has been assigned a test type status of
8686
+ # `PASSED` or `FAILED`.
8687
+ #
8688
+ # The user calling `TestType` must be able to access items in the
8689
+ # specified S3 bucket. Specifically, the user needs the following
8690
+ # permissions:
8691
+ #
8692
+ # * GetObject
8693
+ #
8694
+ # * PutObject
8695
+ #
8696
+ # For more information, see [Actions, Resources, and Condition Keys
8697
+ # for Amazon S3][1] in the *Amazon Web Services Identity and Access
8698
+ # Management User Guide*.
8699
+ #
8700
+ #
8701
+ #
8702
+ # [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html
8703
+ # @return [String]
8704
+ #
8705
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestTypeInput AWS API Documentation
8706
+ #
8707
+ class TestTypeInput < Struct.new(
8708
+ :arn,
8709
+ :type,
8710
+ :type_name,
8711
+ :version_id,
8712
+ :log_delivery_bucket)
8713
+ SENSITIVE = []
8714
+ include Aws::Structure
8715
+ end
8716
+
8717
+ # @!attribute [rw] type_version_arn
8718
+ # The Amazon Resource Number (ARN) of the extension.
8719
+ # @return [String]
8720
+ #
8721
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestTypeOutput AWS API Documentation
8722
+ #
8723
+ class TestTypeOutput < Struct.new(
8724
+ :type_version_arn)
8725
+ SENSITIVE = []
8726
+ include Aws::Structure
8727
+ end
8728
+
7711
8729
  # A client request token already exists.
7712
8730
  #
7713
8731
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TokenAlreadyExistsException AWS API Documentation
7714
8732
  #
7715
8733
  class TokenAlreadyExistsException < Aws::EmptyStructure; end
7716
8734
 
7717
- # The specified type does not exist in the CloudFormation registry.
8735
+ # Detailed information concerning the specification of a CloudFormation
8736
+ # extension in a given account and region.
8737
+ #
8738
+ # For more information, see [Configuring extensions at the account
8739
+ # level][1] in the *CloudFormation User Guide*.
8740
+ #
8741
+ #
8742
+ #
8743
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
8744
+ #
8745
+ # @!attribute [rw] arn
8746
+ # The Amazon Resource Name (ARN) for the configuration data, in this
8747
+ # account and region.
8748
+ # @return [String]
8749
+ #
8750
+ # @!attribute [rw] alias
8751
+ # The alias specified for this configuration, if one was specified
8752
+ # when the configuration was set.
8753
+ # @return [String]
8754
+ #
8755
+ # @!attribute [rw] configuration
8756
+ # A JSON string specifying the configuration data for the extension,
8757
+ # in this account and region.
8758
+ #
8759
+ # If a configuration has not been set for a specified extension,
8760
+ # CloudFormation returns `\{\}`.
8761
+ # @return [String]
8762
+ #
8763
+ # @!attribute [rw] last_updated
8764
+ # When the configuration data was last updated for this extension.
8765
+ #
8766
+ # If a configuration has not been set for a specified extension,
8767
+ # CloudFormation returns `null`.
8768
+ # @return [Time]
8769
+ #
8770
+ # @!attribute [rw] type_arn
8771
+ # The Amazon Resource Name (ARN) for the extension, in this account
8772
+ # and region.
8773
+ #
8774
+ # For public extensions, this will be the ARN assigned when you
8775
+ # [activate the type][1] in this account and region. For private
8776
+ # extensions, this will be the ARN assigned when you [register the
8777
+ # type][2] in this account and region.
8778
+ #
8779
+ #
8780
+ #
8781
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
8782
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
8783
+ # @return [String]
8784
+ #
8785
+ # @!attribute [rw] type_name
8786
+ # The name of the extension.
8787
+ # @return [String]
8788
+ #
8789
+ # @!attribute [rw] is_default_configuration
8790
+ # Whether or not this configuration data is the default configuration
8791
+ # for the extension.
8792
+ # @return [Boolean]
8793
+ #
8794
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeConfigurationDetails AWS API Documentation
8795
+ #
8796
+ class TypeConfigurationDetails < Struct.new(
8797
+ :arn,
8798
+ :alias,
8799
+ :configuration,
8800
+ :last_updated,
8801
+ :type_arn,
8802
+ :type_name,
8803
+ :is_default_configuration)
8804
+ SENSITIVE = []
8805
+ include Aws::Structure
8806
+ end
8807
+
8808
+ # Identifying information for the configuration of a CloudFormation
8809
+ # extension.
8810
+ #
8811
+ # @note When making an API call, you may pass TypeConfigurationIdentifier
8812
+ # data as a hash:
8813
+ #
8814
+ # {
8815
+ # type_arn: "TypeArn",
8816
+ # type_configuration_alias: "TypeConfigurationAlias",
8817
+ # type_configuration_arn: "TypeConfigurationArn",
8818
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
8819
+ # type_name: "TypeName",
8820
+ # }
8821
+ #
8822
+ # @!attribute [rw] type_arn
8823
+ # The Amazon Resource Name (ARN) for the extension, in this account
8824
+ # and region.
8825
+ #
8826
+ # For public extensions, this will be the ARN assigned when you
8827
+ # [activate the type][1] in this account and region. For private
8828
+ # extensions, this will be the ARN assigned when you [register the
8829
+ # type][2] in this account and region.
8830
+ #
8831
+ #
8832
+ #
8833
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
8834
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
8835
+ # @return [String]
8836
+ #
8837
+ # @!attribute [rw] type_configuration_alias
8838
+ # The alias specified for this configuration, if one was specified
8839
+ # when the configuration was set.
8840
+ # @return [String]
8841
+ #
8842
+ # @!attribute [rw] type_configuration_arn
8843
+ # The Amazon Resource Name (ARN) for the configuration, in this
8844
+ # account and region.
8845
+ # @return [String]
8846
+ #
8847
+ # @!attribute [rw] type
8848
+ # The type of extension.
8849
+ # @return [String]
8850
+ #
8851
+ # @!attribute [rw] type_name
8852
+ # The name of the extension type to which this configuration applies.
8853
+ # @return [String]
8854
+ #
8855
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeConfigurationIdentifier AWS API Documentation
8856
+ #
8857
+ class TypeConfigurationIdentifier < Struct.new(
8858
+ :type_arn,
8859
+ :type_configuration_alias,
8860
+ :type_configuration_arn,
8861
+ :type,
8862
+ :type_name)
8863
+ SENSITIVE = []
8864
+ include Aws::Structure
8865
+ end
8866
+
8867
+ # The specified extension configuration cannot be found.
8868
+ #
8869
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeConfigurationNotFoundException AWS API Documentation
8870
+ #
8871
+ class TypeConfigurationNotFoundException < Aws::EmptyStructure; end
8872
+
8873
+ # Filter criteria to use in determining which extensions to return.
8874
+ #
8875
+ # @note When making an API call, you may pass TypeFilters
8876
+ # data as a hash:
8877
+ #
8878
+ # {
8879
+ # category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
8880
+ # publisher_id: "PublisherId",
8881
+ # type_name_prefix: "TypeNamePrefix",
8882
+ # }
8883
+ #
8884
+ # @!attribute [rw] category
8885
+ # The category of extensions to return.
8886
+ #
8887
+ # * `REGISTERED`\: Private extensions that have been registered for
8888
+ # this account and region.
8889
+ #
8890
+ # * `ACTIVATED`\: Public extensions that have been activated for this
8891
+ # account and region.
8892
+ #
8893
+ # * `THIRD-PARTY`\: Extensions available for use from publishers other
8894
+ # than Amazon. This includes:
8895
+ #
8896
+ # * Private extensions registered in the account.
8897
+ #
8898
+ # * Public extensions from publishers other than Amazon, whether
8899
+ # activated or not.
8900
+ #
8901
+ # * `AWS-TYPES`\: Extensions available for use from Amazon.
8902
+ # @return [String]
8903
+ #
8904
+ # @!attribute [rw] publisher_id
8905
+ # The id of the publisher of the extension.
8906
+ #
8907
+ # Extensions published by Amazon are not assigned a publisher ID. Use
8908
+ # the `AWS-TYPES` category to specify a list of types published by
8909
+ # Amazon.
8910
+ # @return [String]
8911
+ #
8912
+ # @!attribute [rw] type_name_prefix
8913
+ # A prefix to use as a filter for results.
8914
+ # @return [String]
8915
+ #
8916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeFilters AWS API Documentation
8917
+ #
8918
+ class TypeFilters < Struct.new(
8919
+ :category,
8920
+ :publisher_id,
8921
+ :type_name_prefix)
8922
+ SENSITIVE = []
8923
+ include Aws::Structure
8924
+ end
8925
+
8926
+ # The specified extension does not exist in the CloudFormation registry.
7718
8927
  #
7719
8928
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeNotFoundException AWS API Documentation
7720
8929
  #
7721
8930
  class TypeNotFoundException < Aws::EmptyStructure; end
7722
8931
 
7723
- # Contains summary information about the specified CloudFormation type.
8932
+ # Contains summary information about the specified CloudFormation
8933
+ # extension.
7724
8934
  #
7725
8935
  # @!attribute [rw] type
7726
- # The kind of type.
8936
+ # The kind of extension.
7727
8937
  # @return [String]
7728
8938
  #
7729
8939
  # @!attribute [rw] type_name
7730
- # The name of the type.
8940
+ # The name of the extension.
8941
+ #
8942
+ # If you specified a `TypeNameAlias` when you [activate this
8943
+ # extension][1] in your account and region, CloudFormation considers
8944
+ # that alias as the type name.
8945
+ #
8946
+ #
8947
+ #
8948
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
7731
8949
  # @return [String]
7732
8950
  #
7733
8951
  # @!attribute [rw] default_version_id
7734
- # The ID of the default version of the type. The default version is
7735
- # used when the type version is not specified.
8952
+ # The ID of the default version of the extension. The default version
8953
+ # is used when the extension version is not specified.
8954
+ #
8955
+ # This applies only to private extensions you have registered in your
8956
+ # account. For public extensions, both those provided by Amazon and
8957
+ # published by third parties, CloudFormation returns `null`. For more
8958
+ # information, see [RegisterType][1].
8959
+ #
8960
+ # To set the default version of an extension, use `
8961
+ # SetTypeDefaultVersion `.
7736
8962
  #
7737
- # To set the default version of a type, use ` SetTypeDefaultVersion `.
8963
+ #
8964
+ #
8965
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
7738
8966
  # @return [String]
7739
8967
  #
7740
8968
  # @!attribute [rw] type_arn
7741
- # The Amazon Resource Name (ARN) of the type.
8969
+ # The Amazon Resource Name (ARN) of the extension.
7742
8970
  # @return [String]
7743
8971
  #
7744
8972
  # @!attribute [rw] last_updated
7745
- # When the current default version of the type was registered.
8973
+ # When the specified extension version was registered. This applies
8974
+ # only to:
8975
+ #
8976
+ # * Private extensions you have registered in your account. For more
8977
+ # information, see [RegisterType][1].
8978
+ #
8979
+ # * Public extensions you have activated in your account with
8980
+ # auto-update specified. For more information, see
8981
+ # [ActivateType][2].
8982
+ #
8983
+ # For all other extension types, CloudFormation returns `null`.
8984
+ #
8985
+ #
8986
+ #
8987
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
8988
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
7746
8989
  # @return [Time]
7747
8990
  #
7748
8991
  # @!attribute [rw] description
7749
- # The description of the type.
8992
+ # The description of the extension.
8993
+ # @return [String]
8994
+ #
8995
+ # @!attribute [rw] publisher_id
8996
+ # The ID of the extension publisher, if the extension is published by
8997
+ # a third party. Extensions published by Amazon do not return a
8998
+ # publisher ID.
8999
+ # @return [String]
9000
+ #
9001
+ # @!attribute [rw] original_type_name
9002
+ # For public extensions that have been activated for this account and
9003
+ # region, the type name of the public extension.
9004
+ #
9005
+ # If you specified a `TypeNameAlias` when enabling the extension in
9006
+ # this account and region, CloudFormation treats that alias as the
9007
+ # extension's type name within the account and region, not the type
9008
+ # name of the public extension. For more information, see [Specifying
9009
+ # aliases to refer to extensions][1] in the *CloudFormation User
9010
+ # Guide*.
9011
+ #
9012
+ #
9013
+ #
9014
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-alias
9015
+ # @return [String]
9016
+ #
9017
+ # @!attribute [rw] public_version_number
9018
+ # For public extensions that have been activated for this account and
9019
+ # region, the version of the public extension to be used for
9020
+ # CloudFormation operations in this account and region.
9021
+ #
9022
+ # How you specified `AutoUpdate` when enabling the extension affects
9023
+ # whether CloudFormation automatically updates the extention in this
9024
+ # account and region when a new version is released. For more
9025
+ # information, see [Setting CloudFormation to automatically use new
9026
+ # versions of extensions][1] in the *CloudFormation User Guide*.
9027
+ #
9028
+ #
9029
+ #
9030
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto
9031
+ # @return [String]
9032
+ #
9033
+ # @!attribute [rw] latest_public_version
9034
+ # For public extensions that have been activated for this account and
9035
+ # region, the latest version of the public extension *that is
9036
+ # available*. For any extensions other than activated third-arty
9037
+ # extensions, CloudFormation returns `null`.
9038
+ #
9039
+ # How you specified `AutoUpdate` when enabling the extension affects
9040
+ # whether CloudFormation automatically updates the extention in this
9041
+ # account and region when a new version is released. For more
9042
+ # information, see [Setting CloudFormation to automatically use new
9043
+ # versions of extensions][1] in the *CloudFormation User Guide*.
9044
+ #
9045
+ #
9046
+ #
9047
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto
9048
+ # @return [String]
9049
+ #
9050
+ # @!attribute [rw] publisher_identity
9051
+ # The service used to verify the publisher identity.
9052
+ #
9053
+ # For more information, see [Registering your account to publish
9054
+ # CloudFormation extensions][1] in the <i> CFN-CLI User Guide for
9055
+ # Extension Development</i>.
9056
+ #
9057
+ #
9058
+ #
9059
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
9060
+ # @return [String]
9061
+ #
9062
+ # @!attribute [rw] publisher_name
9063
+ # The publisher name, as defined in the public profile for that
9064
+ # publisher in the service used to verify the publisher identity.
7750
9065
  # @return [String]
7751
9066
  #
9067
+ # @!attribute [rw] is_activated
9068
+ # Whether or not the extension is activated for this account and
9069
+ # region.
9070
+ #
9071
+ # This applies only to third-party public extensions. Extensions
9072
+ # published by Amazon are activated by default.
9073
+ # @return [Boolean]
9074
+ #
7752
9075
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeSummary AWS API Documentation
7753
9076
  #
7754
9077
  class TypeSummary < Struct.new(
@@ -7757,34 +9080,47 @@ module Aws::CloudFormation
7757
9080
  :default_version_id,
7758
9081
  :type_arn,
7759
9082
  :last_updated,
7760
- :description)
9083
+ :description,
9084
+ :publisher_id,
9085
+ :original_type_name,
9086
+ :public_version_number,
9087
+ :latest_public_version,
9088
+ :publisher_identity,
9089
+ :publisher_name,
9090
+ :is_activated)
7761
9091
  SENSITIVE = []
7762
9092
  include Aws::Structure
7763
9093
  end
7764
9094
 
7765
9095
  # Contains summary information about a specific version of a
7766
- # CloudFormation type.
9096
+ # CloudFormation extension.
7767
9097
  #
7768
9098
  # @!attribute [rw] type
7769
- # The kind of type.
9099
+ # The kind of extension.
7770
9100
  # @return [String]
7771
9101
  #
7772
9102
  # @!attribute [rw] type_name
7773
- # The name of the type.
9103
+ # The name of the extension.
7774
9104
  # @return [String]
7775
9105
  #
7776
9106
  # @!attribute [rw] version_id
7777
- # The ID of a specific version of the type. The version ID is the
9107
+ # The ID of a specific version of the extension. The version ID is the
7778
9108
  # value at the end of the Amazon Resource Name (ARN) assigned to the
7779
- # type version when it is registered.
9109
+ # extension version when it is registered.
7780
9110
  # @return [String]
7781
9111
  #
7782
9112
  # @!attribute [rw] is_default_version
7783
- # Whether the specified type version is set as the default version.
9113
+ # Whether the specified extension version is set as the default
9114
+ # version.
9115
+ #
9116
+ # This applies only to private extensions you have registered in your
9117
+ # account, and extensions published by Amazon. For public third-party
9118
+ # extensions, whether or not they are activated in your account,
9119
+ # CloudFormation returns `null`.
7784
9120
  # @return [Boolean]
7785
9121
  #
7786
9122
  # @!attribute [rw] arn
7787
- # The Amazon Resource Name (ARN) of the type version.
9123
+ # The Amazon Resource Name (ARN) of the extension version.
7788
9124
  # @return [String]
7789
9125
  #
7790
9126
  # @!attribute [rw] time_created
@@ -7792,7 +9128,25 @@ module Aws::CloudFormation
7792
9128
  # @return [Time]
7793
9129
  #
7794
9130
  # @!attribute [rw] description
7795
- # The description of the type version.
9131
+ # The description of the extension version.
9132
+ # @return [String]
9133
+ #
9134
+ # @!attribute [rw] public_version_number
9135
+ # For public extensions that have been activated for this account and
9136
+ # region, the version of the public extension to be used for
9137
+ # CloudFormation operations in this account and region. For any
9138
+ # extensions other than activated third-arty extensions,
9139
+ # CloudFormation returns `null`.
9140
+ #
9141
+ # How you specified `AutoUpdate` when enabling the extension affects
9142
+ # whether CloudFormation automatically updates the extention in this
9143
+ # account and region when a new version is released. For more
9144
+ # information, see [Setting CloudFormation to automatically use new
9145
+ # versions of extensions][1] in the *CloudFormation User Guide*.
9146
+ #
9147
+ #
9148
+ #
9149
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto
7796
9150
  # @return [String]
7797
9151
  #
7798
9152
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeVersionSummary AWS API Documentation
@@ -7804,7 +9158,8 @@ module Aws::CloudFormation
7804
9158
  :is_default_version,
7805
9159
  :arn,
7806
9160
  :time_created,
7807
- :description)
9161
+ :description,
9162
+ :public_version_number)
7808
9163
  SENSITIVE = []
7809
9164
  include Aws::Structure
7810
9165
  end
@@ -7860,7 +9215,7 @@ module Aws::CloudFormation
7860
9215
  # @!attribute [rw] template_body
7861
9216
  # Structure containing the template body with a minimum length of 1
7862
9217
  # byte and a maximum length of 51,200 bytes. (For more information, go
7863
- # to [Template Anatomy][1] in the AWS CloudFormation User Guide.)
9218
+ # to [Template Anatomy][1] in the CloudFormation User Guide.)
7864
9219
  #
7865
9220
  # Conditional: You must specify only one of the following parameters:
7866
9221
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -7875,7 +9230,7 @@ module Aws::CloudFormation
7875
9230
  # Location of file containing the template body. The URL must point to
7876
9231
  # a template that is located in an Amazon S3 bucket or a Systems
7877
9232
  # Manager document. For more information, go to [Template Anatomy][1]
7878
- # in the AWS CloudFormation User Guide.
9233
+ # in the CloudFormation User Guide.
7879
9234
  #
7880
9235
  # Conditional: You must specify only one of the following parameters:
7881
9236
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -7930,15 +9285,15 @@ module Aws::CloudFormation
7930
9285
  #
7931
9286
  # @!attribute [rw] capabilities
7932
9287
  # In some cases, you must explicitly acknowledge that your stack
7933
- # template contains certain capabilities in order for AWS
7934
- # CloudFormation to update the stack.
9288
+ # template contains certain capabilities in order for CloudFormation
9289
+ # to update the stack.
7935
9290
  #
7936
9291
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
7937
9292
  #
7938
9293
  # Some stack templates might include resources that can affect
7939
- # permissions in your AWS account; for example, by creating new AWS
7940
- # Identity and Access Management (IAM) users. For those stacks, you
7941
- # must explicitly acknowledge this by specifying one of these
9294
+ # permissions in your account; for example, by creating new Identity
9295
+ # and Access Management (IAM) users. For those stacks, you must
9296
+ # explicitly acknowledge this by specifying one of these
7942
9297
  # capabilities.
7943
9298
  #
7944
9299
  # The following IAM resources require you to specify either the
@@ -7949,7 +9304,7 @@ module Aws::CloudFormation
7949
9304
  # * If you have IAM resources with custom names, you *must* specify
7950
9305
  # `CAPABILITY_NAMED_IAM`.
7951
9306
  #
7952
- # * If you don't specify either of these capabilities, AWS
9307
+ # * If you don't specify either of these capabilities,
7953
9308
  # CloudFormation returns an `InsufficientCapabilities` error.
7954
9309
  #
7955
9310
  # If your stack template contains these resources, we recommend that
@@ -7970,7 +9325,7 @@ module Aws::CloudFormation
7970
9325
  #
7971
9326
  # * [ AWS::IAM::UserToGroupAddition][7]
7972
9327
  #
7973
- # For more information, see [Acknowledging IAM Resources in AWS
9328
+ # For more information, see [Acknowledging IAM Resources in
7974
9329
  # CloudFormation Templates][8].
7975
9330
  #
7976
9331
  # * `CAPABILITY_AUTO_EXPAND`
@@ -7986,7 +9341,7 @@ module Aws::CloudFormation
7986
9341
  # reviewing the resulting changes in a change set, you must
7987
9342
  # acknowledge this capability. This includes the [AWS::Include][9]
7988
9343
  # and [AWS::Serverless][10] transforms, which are macros hosted by
7989
- # AWS CloudFormation.
9344
+ # CloudFormation.
7990
9345
  #
7991
9346
  # If you want to update a stack from a stack template that contains
7992
9347
  # macros *and* nested stacks, you must update the stack directly
@@ -7997,11 +9352,11 @@ module Aws::CloudFormation
7997
9352
  #
7998
9353
  # Each macro relies on an underlying Lambda service function for
7999
9354
  # processing stack templates. Be aware that the Lambda function
8000
- # owner can update the function operation without AWS CloudFormation
9355
+ # owner can update the function operation without CloudFormation
8001
9356
  # being notified.
8002
9357
  #
8003
- # For more information, see [Using AWS CloudFormation Macros to
8004
- # Perform Custom Processing on Templates][11].
9358
+ # For more information, see [Using CloudFormation Macros to Perform
9359
+ # Custom Processing on Templates][11].
8005
9360
  #
8006
9361
  #
8007
9362
  #
@@ -8024,12 +9379,11 @@ module Aws::CloudFormation
8024
9379
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
8025
9380
  #
8026
9381
  # If the list of resource types doesn't include a resource that
8027
- # you're updating, the stack update fails. By default, AWS
8028
- # CloudFormation grants permissions to all resource types. AWS
8029
- # Identity and Access Management (IAM) uses this parameter for AWS
8030
- # CloudFormation-specific condition keys in IAM policies. For more
8031
- # information, see [Controlling Access with AWS Identity and Access
8032
- # Management][1].
9382
+ # you're updating, the stack update fails. By default, CloudFormation
9383
+ # grants permissions to all resource types. Identity and Access
9384
+ # Management (IAM) uses this parameter for CloudFormation-specific
9385
+ # condition keys in IAM policies. For more information, see
9386
+ # [Controlling Access with Identity and Access Management][1].
8033
9387
  #
8034
9388
  #
8035
9389
  #
@@ -8037,23 +9391,23 @@ module Aws::CloudFormation
8037
9391
  # @return [Array<String>]
8038
9392
  #
8039
9393
  # @!attribute [rw] role_arn
8040
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
8041
- # Management (IAM) role that AWS CloudFormation assumes to update the
8042
- # stack. AWS CloudFormation uses the role's credentials to make calls
8043
- # on your behalf. AWS CloudFormation always uses this role for all
8044
- # future operations on the stack. As long as users have permission to
8045
- # operate on the stack, AWS CloudFormation uses this role even if the
8046
- # users don't have permission to pass it. Ensure that the role grants
8047
- # least privilege.
9394
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
9395
+ # (IAM) role that CloudFormation assumes to update the stack.
9396
+ # CloudFormation uses the role's credentials to make calls on your
9397
+ # behalf. CloudFormation always uses this role for all future
9398
+ # operations on the stack. As long as users have permission to operate
9399
+ # on the stack, CloudFormation uses this role even if the users don't
9400
+ # have permission to pass it. Ensure that the role grants least
9401
+ # privilege.
8048
9402
  #
8049
- # If you don't specify a value, AWS CloudFormation uses the role that
8050
- # was previously associated with the stack. If no role is available,
8051
- # AWS CloudFormation uses a temporary session that is generated from
8052
- # your user credentials.
9403
+ # If you don't specify a value, CloudFormation uses the role that was
9404
+ # previously associated with the stack. If no role is available,
9405
+ # CloudFormation uses a temporary session that is generated from your
9406
+ # user credentials.
8053
9407
  # @return [String]
8054
9408
  #
8055
9409
  # @!attribute [rw] rollback_configuration
8056
- # The rollback triggers for AWS CloudFormation to monitor during stack
9410
+ # The rollback triggers for CloudFormation to monitor during stack
8057
9411
  # creation and updating operations, and for the specified monitoring
8058
9412
  # period afterwards.
8059
9413
  # @return [Types::RollbackConfiguration]
@@ -8083,26 +9437,26 @@ module Aws::CloudFormation
8083
9437
  #
8084
9438
  # @!attribute [rw] notification_arns
8085
9439
  # Amazon Simple Notification Service topic Amazon Resource Names
8086
- # (ARNs) that AWS CloudFormation associates with the stack. Specify an
9440
+ # (ARNs) that CloudFormation associates with the stack. Specify an
8087
9441
  # empty list to remove all notification topics.
8088
9442
  # @return [Array<String>]
8089
9443
  #
8090
9444
  # @!attribute [rw] tags
8091
- # Key-value pairs to associate with this stack. AWS CloudFormation
8092
- # also propagates these tags to supported resources in the stack. You
8093
- # can specify a maximum number of 50 tags.
9445
+ # Key-value pairs to associate with this stack. CloudFormation also
9446
+ # propagates these tags to supported resources in the stack. You can
9447
+ # specify a maximum number of 50 tags.
8094
9448
  #
8095
- # If you don't specify this parameter, AWS CloudFormation doesn't
8096
- # modify the stack's tags. If you specify an empty value, AWS
8097
- # CloudFormation removes all associated tags.
9449
+ # If you don't specify this parameter, CloudFormation doesn't modify
9450
+ # the stack's tags. If you specify an empty value, CloudFormation
9451
+ # removes all associated tags.
8098
9452
  # @return [Array<Types::Tag>]
8099
9453
  #
8100
9454
  # @!attribute [rw] client_request_token
8101
9455
  # A unique identifier for this `UpdateStack` request. Specify this
8102
- # token if you plan to retry requests so that AWS CloudFormation knows
9456
+ # token if you plan to retry requests so that CloudFormation knows
8103
9457
  # that you're not attempting to update a stack with the same name.
8104
- # You might retry `UpdateStack` requests to ensure that AWS
8105
- # CloudFormation successfully received them.
9458
+ # You might retry `UpdateStack` requests to ensure that CloudFormation
9459
+ # successfully received them.
8106
9460
  #
8107
9461
  # All events triggered by a given stack operation are assigned the
8108
9462
  # same client request token, which you can use to track operations.
@@ -8180,19 +9534,19 @@ module Aws::CloudFormation
8180
9534
  # @return [String]
8181
9535
  #
8182
9536
  # @!attribute [rw] accounts
8183
- # \[Self-managed permissions\] The names of one or more AWS accounts
8184
- # for which you want to update parameter values for stack instances.
8185
- # The overridden parameter values will be applied to all stack
8186
- # instances in the specified accounts and Regions.
9537
+ # \[Self-managed permissions\] The names of one or more accounts for
9538
+ # which you want to update parameter values for stack instances. The
9539
+ # overridden parameter values will be applied to all stack instances
9540
+ # in the specified accounts and Regions.
8187
9541
  #
8188
9542
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
8189
9543
  # @return [Array<String>]
8190
9544
  #
8191
9545
  # @!attribute [rw] deployment_targets
8192
- # \[Service-managed permissions\] The AWS Organizations accounts for
8193
- # which you want to update parameter values for stack instances. If
8194
- # your update targets OUs, the overridden parameter values only apply
8195
- # to the accounts that are currently in the target OUs and their child
9546
+ # \[Service-managed permissions\] The Organizations accounts for which
9547
+ # you want to update parameter values for stack instances. If your
9548
+ # update targets OUs, the overridden parameter values only apply to
9549
+ # the accounts that are currently in the target OUs and their child
8196
9550
  # OUs. Accounts added to the target OUs and their child OUs in the
8197
9551
  # future won't use the overridden values.
8198
9552
  #
@@ -8212,24 +9566,19 @@ module Aws::CloudFormation
8212
9566
  #
8213
9567
  # Any overridden parameter values will be applied to all stack
8214
9568
  # instances in the specified accounts and Regions. When specifying
8215
- # parameters and their values, be aware of how AWS CloudFormation sets
9569
+ # parameters and their values, be aware of how CloudFormation sets
8216
9570
  # parameter values during stack instance update operations:
8217
9571
  #
8218
9572
  # * To override the current value for a parameter, include the
8219
9573
  # parameter and specify its value.
8220
9574
  #
8221
- # * To leave a parameter set to its present value, you can do one of
8222
- # the following:
8223
- #
8224
- # * Do not include the parameter in the list.
9575
+ # * To leave an overridden parameter set to its present value, include
9576
+ # the parameter and specify `UsePreviousValue` as `true`. (You
9577
+ # cannot specify both a value and set `UsePreviousValue` to `true`.)
8225
9578
  #
8226
- # * Include the parameter and specify `UsePreviousValue` as `true`.
8227
- # (You cannot specify both a value and set `UsePreviousValue` to
8228
- # `true`.)
8229
- #
8230
- # * To set all overridden parameter back to the values specified in
8231
- # the stack set, specify a parameter list but do not include any
8232
- # parameters.
9579
+ # * To set an overridden parameter back to the value specified in the
9580
+ # stack set, specify a parameter list but do not include the
9581
+ # parameter in the list.
8233
9582
  #
8234
9583
  # * To leave all parameters set to their present values, do not
8235
9584
  # specify this property at all.
@@ -8253,7 +9602,7 @@ module Aws::CloudFormation
8253
9602
  # @return [Array<Types::Parameter>]
8254
9603
  #
8255
9604
  # @!attribute [rw] operation_preferences
8256
- # Preferences for how AWS CloudFormation performs this stack set
9605
+ # Preferences for how CloudFormation performs this stack set
8257
9606
  # operation.
8258
9607
  # @return [Types::StackSetOperationPreferences]
8259
9608
  #
@@ -8261,10 +9610,10 @@ module Aws::CloudFormation
8261
9610
  # The unique identifier for this stack set operation.
8262
9611
  #
8263
9612
  # The operation ID also functions as an idempotency token, to ensure
8264
- # that AWS CloudFormation performs the stack set operation only once,
8265
- # even if you retry the request multiple times. You might retry stack
8266
- # set operation requests to ensure that AWS CloudFormation
8267
- # successfully received them.
9613
+ # that CloudFormation performs the stack set operation only once, even
9614
+ # if you retry the request multiple times. You might retry stack set
9615
+ # operation requests to ensure that CloudFormation successfully
9616
+ # received them.
8268
9617
  #
8269
9618
  # If you don't specify an operation ID, the SDK generates one
8270
9619
  # automatically.
@@ -8286,10 +9635,9 @@ module Aws::CloudFormation
8286
9635
  # * If you are signed in to a delegated administrator account, specify
8287
9636
  # `DELEGATED_ADMIN`.
8288
9637
  #
8289
- # Your AWS account must be registered as a delegated administrator
8290
- # in the management account. For more information, see [Register a
8291
- # delegated administrator][1] in the *AWS CloudFormation User
8292
- # Guide*.
9638
+ # Your account must be registered as a delegated administrator in
9639
+ # the management account. For more information, see [Register a
9640
+ # delegated administrator][1] in the *CloudFormation User Guide*.
8293
9641
  #
8294
9642
  #
8295
9643
  #
@@ -8398,8 +9746,8 @@ module Aws::CloudFormation
8398
9746
  # @!attribute [rw] template_body
8399
9747
  # The structure that contains the template body, with a minimum length
8400
9748
  # of 1 byte and a maximum length of 51,200 bytes. For more
8401
- # information, see [Template Anatomy][1] in the AWS CloudFormation
8402
- # User Guide.
9749
+ # information, see [Template Anatomy][1] in the CloudFormation User
9750
+ # Guide.
8403
9751
  #
8404
9752
  # Conditional: You must specify only one of the following parameters:
8405
9753
  # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to
@@ -8414,8 +9762,8 @@ module Aws::CloudFormation
8414
9762
  # The location of the file that contains the template body. The URL
8415
9763
  # must point to a template (maximum size: 460,800 bytes) that is
8416
9764
  # located in an Amazon S3 bucket or a Systems Manager document. For
8417
- # more information, see [Template Anatomy][1] in the AWS
8418
- # CloudFormation User Guide.
9765
+ # more information, see [Template Anatomy][1] in the CloudFormation
9766
+ # User Guide.
8419
9767
  #
8420
9768
  # Conditional: You must specify only one of the following parameters:
8421
9769
  # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to
@@ -8441,16 +9789,15 @@ module Aws::CloudFormation
8441
9789
  #
8442
9790
  # @!attribute [rw] capabilities
8443
9791
  # In some cases, you must explicitly acknowledge that your stack
8444
- # template contains certain capabilities in order for AWS
8445
- # CloudFormation to update the stack set and its associated stack
8446
- # instances.
9792
+ # template contains certain capabilities in order for CloudFormation
9793
+ # to update the stack set and its associated stack instances.
8447
9794
  #
8448
9795
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
8449
9796
  #
8450
9797
  # Some stack templates might include resources that can affect
8451
- # permissions in your AWS account; for example, by creating new AWS
8452
- # Identity and Access Management (IAM) users. For those stacks sets,
8453
- # you must explicitly acknowledge this by specifying one of these
9798
+ # permissions in your account; for example, by creating new Identity
9799
+ # and Access Management (IAM) users. For those stacks sets, you must
9800
+ # explicitly acknowledge this by specifying one of these
8454
9801
  # capabilities.
8455
9802
  #
8456
9803
  # The following IAM resources require you to specify either the
@@ -8461,7 +9808,7 @@ module Aws::CloudFormation
8461
9808
  # * If you have IAM resources with custom names, you *must* specify
8462
9809
  # `CAPABILITY_NAMED_IAM`.
8463
9810
  #
8464
- # * If you don't specify either of these capabilities, AWS
9811
+ # * If you don't specify either of these capabilities,
8465
9812
  # CloudFormation returns an `InsufficientCapabilities` error.
8466
9813
  #
8467
9814
  # If your stack template contains these resources, we recommend that
@@ -8482,23 +9829,26 @@ module Aws::CloudFormation
8482
9829
  #
8483
9830
  # * [ AWS::IAM::UserToGroupAddition][7]
8484
9831
  #
8485
- # For more information, see [Acknowledging IAM Resources in AWS
9832
+ # For more information, see [Acknowledging IAM Resources in
8486
9833
  # CloudFormation Templates][8].
8487
9834
  #
8488
9835
  # * `CAPABILITY_AUTO_EXPAND`
8489
9836
  #
8490
- # Some templates contain macros. If your stack template contains one
8491
- # or more macros, and you choose to update a stack directly from the
8492
- # processed template, without first reviewing the resulting changes
8493
- # in a change set, you must acknowledge this capability. For more
8494
- # information, see [Using AWS CloudFormation Macros to Perform
8495
- # Custom Processing on Templates][9].
9837
+ # Some templates reference macros. If your stack set template
9838
+ # references one or more macros, you must update the stack set
9839
+ # directly from the processed template, without first reviewing the
9840
+ # resulting changes in a change set. To update the stack set
9841
+ # directly, you must acknowledge this capability. For more
9842
+ # information, see [Using CloudFormation Macros to Perform Custom
9843
+ # Processing on Templates][9].
8496
9844
  #
8497
- # Stack sets do not currently support macros in stack templates.
8498
- # (This includes the [AWS::Include][10] and [AWS::Serverless][11]
8499
- # transforms, which are macros hosted by AWS CloudFormation.) Even
8500
- # if you specify this capability, if you include a macro in your
8501
- # template the stack set operation will fail.
9845
+ # Stack sets with service-managed permissions do not currently
9846
+ # support the use of macros in templates. (This includes the
9847
+ # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
9848
+ # macros hosted by CloudFormation.) Even if you specify this
9849
+ # capability for a stack set with service-managed permissions, if
9850
+ # you reference a macro in your template the stack set operation
9851
+ # will fail.
8502
9852
  #
8503
9853
  #
8504
9854
  #
@@ -8517,7 +9867,7 @@ module Aws::CloudFormation
8517
9867
  #
8518
9868
  # @!attribute [rw] tags
8519
9869
  # The key-value pairs to associate with this stack set and the stacks
8520
- # created from it. AWS CloudFormation also propagates these tags to
9870
+ # created from it. CloudFormation also propagates these tags to
8521
9871
  # supported resources that are created in the stacks. You can specify
8522
9872
  # a maximum number of 50 tags.
8523
9873
  #
@@ -8525,7 +9875,7 @@ module Aws::CloudFormation
8525
9875
  # of tags that are currently associated with this stack set. This
8526
9876
  # means:
8527
9877
  #
8528
- # * If you don't specify this parameter, AWS CloudFormation doesn't
9878
+ # * If you don't specify this parameter, CloudFormation doesn't
8529
9879
  # modify the stack's tags.
8530
9880
  #
8531
9881
  # * If you specify *any* tags using this parameter, you must specify
@@ -8536,22 +9886,22 @@ module Aws::CloudFormation
8536
9886
  # the stack set, and therefore from the stacks and resources as
8537
9887
  # well.
8538
9888
  #
8539
- # * If you specify an empty value, AWS CloudFormation removes all
9889
+ # * If you specify an empty value, CloudFormation removes all
8540
9890
  # currently associated tags.
8541
9891
  #
8542
- # If you specify new tags as part of an `UpdateStackSet` action, AWS
9892
+ # If you specify new tags as part of an `UpdateStackSet` action,
8543
9893
  # CloudFormation checks to see if you have the required IAM permission
8544
9894
  # to tag resources. If you omit tags that are currently associated
8545
- # with the stack set from the list of tags you specify, AWS
8546
- # CloudFormation assumes that you want to remove those tags from the
8547
- # stack set, and checks to see if you have permission to untag
8548
- # resources. If you don't have the necessary permission(s), the
8549
- # entire `UpdateStackSet` action fails with an `access denied` error,
8550
- # and the stack set is not updated.
9895
+ # with the stack set from the list of tags you specify, CloudFormation
9896
+ # assumes that you want to remove those tags from the stack set, and
9897
+ # checks to see if you have permission to untag resources. If you
9898
+ # don't have the necessary permission(s), the entire `UpdateStackSet`
9899
+ # action fails with an `access denied` error, and the stack set is not
9900
+ # updated.
8551
9901
  # @return [Array<Types::Tag>]
8552
9902
  #
8553
9903
  # @!attribute [rw] operation_preferences
8554
- # Preferences for how AWS CloudFormation performs this stack set
9904
+ # Preferences for how CloudFormation performs this stack set
8555
9905
  # operation.
8556
9906
  # @return [Types::StackSetOperationPreferences]
8557
9907
  #
@@ -8562,8 +9912,8 @@ module Aws::CloudFormation
8562
9912
  # Specify an IAM role only if you are using customized administrator
8563
9913
  # roles to control which users or groups can manage specific stack
8564
9914
  # sets within the same administrator account. For more information,
8565
- # see [Granting Permissions for Stack Set Operations][1] in the *AWS
8566
- # CloudFormation User Guide*.
9915
+ # see [Granting Permissions for Stack Set Operations][1] in the
9916
+ # *CloudFormation User Guide*.
8567
9917
  #
8568
9918
  # If you specified a customized administrator role when you created
8569
9919
  # the stack set, you must specify a customized administrator role,
@@ -8577,7 +9927,7 @@ module Aws::CloudFormation
8577
9927
  #
8578
9928
  # @!attribute [rw] execution_role_name
8579
9929
  # The name of the IAM execution role to use to update the stack set.
8580
- # If you do not specify an execution role, AWS CloudFormation uses the
9930
+ # If you do not specify an execution role, CloudFormation uses the
8581
9931
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
8582
9932
  # operation.
8583
9933
  #
@@ -8585,29 +9935,28 @@ module Aws::CloudFormation
8585
9935
  # to control which stack resources users and groups can include in
8586
9936
  # their stack sets.
8587
9937
  #
8588
- # If you specify a customized execution role, AWS CloudFormation uses
8589
- # that role to update the stack. If you do not specify a customized
8590
- # execution role, AWS CloudFormation performs the update using the
8591
- # role previously associated with the stack set, so long as you have
9938
+ # If you specify a customized execution role, CloudFormation uses that
9939
+ # role to update the stack. If you do not specify a customized
9940
+ # execution role, CloudFormation performs the update using the role
9941
+ # previously associated with the stack set, so long as you have
8592
9942
  # permissions to perform operations on the stack set.
8593
9943
  # @return [String]
8594
9944
  #
8595
9945
  # @!attribute [rw] deployment_targets
8596
- # \[Service-managed permissions\] The AWS Organizations accounts in
8597
- # which to update associated stack instances.
9946
+ # \[Service-managed permissions\] The Organizations accounts in which
9947
+ # to update associated stack instances.
8598
9948
  #
8599
9949
  # To update all the stack instances associated with this stack set, do
8600
9950
  # not specify `DeploymentTargets` or `Regions`.
8601
9951
  #
8602
9952
  # If the stack set update includes changes to the template (that is,
8603
9953
  # if `TemplateBody` or `TemplateURL` is specified), or the
8604
- # `Parameters`, AWS CloudFormation marks all stack instances with a
8605
- # status of `OUTDATED` prior to updating the stack instances in the
8606
- # specified accounts and Regions. If the stack set update does not
8607
- # include changes to the template or parameters, AWS CloudFormation
8608
- # updates the stack instances in the specified accounts and Regions,
8609
- # while leaving all other stack instances with their existing stack
8610
- # instance status.
9954
+ # `Parameters`, CloudFormation marks all stack instances with a status
9955
+ # of `OUTDATED` prior to updating the stack instances in the specified
9956
+ # accounts and Regions. If the stack set update does not include
9957
+ # changes to the template or parameters, CloudFormation updates the
9958
+ # stack instances in the specified accounts and Regions, while leaving
9959
+ # all other stack instances with their existing stack instance status.
8611
9960
  # @return [Types::DeploymentTargets]
8612
9961
  #
8613
9962
  # @!attribute [rw] permission_model
@@ -8622,8 +9971,8 @@ module Aws::CloudFormation
8622
9971
  #
8623
9972
  # * With `service-managed` permissions, StackSets automatically
8624
9973
  # creates the IAM roles required to deploy to accounts managed by
8625
- # AWS Organizations. For more information, see [Grant
8626
- # Service-Managed Stack Set Permissions][2].
9974
+ # Organizations. For more information, see [Grant Service-Managed
9975
+ # Stack Set Permissions][2].
8627
9976
  #
8628
9977
  #
8629
9978
  #
@@ -8633,8 +9982,8 @@ module Aws::CloudFormation
8633
9982
  #
8634
9983
  # @!attribute [rw] auto_deployment
8635
9984
  # \[Service-managed permissions\] Describes whether StackSets
8636
- # automatically deploys to AWS Organizations accounts that are added
8637
- # to a target organization or organizational unit (OU).
9985
+ # automatically deploys to Organizations accounts that are added to a
9986
+ # target organization or organizational unit (OU).
8638
9987
  #
8639
9988
  # If you specify `AutoDeployment`, do not specify `DeploymentTargets`
8640
9989
  # or `Regions`.
@@ -8644,13 +9993,13 @@ module Aws::CloudFormation
8644
9993
  # The unique ID for this stack set operation.
8645
9994
  #
8646
9995
  # The operation ID also functions as an idempotency token, to ensure
8647
- # that AWS CloudFormation performs the stack set operation only once,
8648
- # even if you retry the request multiple times. You might retry stack
8649
- # set operation requests to ensure that AWS CloudFormation
8650
- # successfully received them.
9996
+ # that CloudFormation performs the stack set operation only once, even
9997
+ # if you retry the request multiple times. You might retry stack set
9998
+ # operation requests to ensure that CloudFormation successfully
9999
+ # received them.
8651
10000
  #
8652
- # If you don't specify an operation ID, AWS CloudFormation generates
8653
- # one automatically.
10001
+ # If you don't specify an operation ID, CloudFormation generates one
10002
+ # automatically.
8654
10003
  #
8655
10004
  # Repeating this stack set operation with a new operation ID retries
8656
10005
  # all stack instances whose status is `OUTDATED`.
@@ -8669,13 +10018,13 @@ module Aws::CloudFormation
8669
10018
  #
8670
10019
  # If the stack set update includes changes to the template (that is,
8671
10020
  # if the `TemplateBody` or `TemplateURL` properties are specified), or
8672
- # the `Parameters` property, AWS CloudFormation marks all stack
8673
- # instances with a status of `OUTDATED` prior to updating the stack
8674
- # instances in the specified accounts and Regions. If the stack set
8675
- # update does not include changes to the template or parameters, AWS
8676
- # CloudFormation updates the stack instances in the specified accounts
8677
- # and Regions, while leaving all other stack instances with their
8678
- # existing stack instance status.
10021
+ # the `Parameters` property, CloudFormation marks all stack instances
10022
+ # with a status of `OUTDATED` prior to updating the stack instances in
10023
+ # the specified accounts and Regions. If the stack set update does not
10024
+ # include changes to the template or parameters, CloudFormation
10025
+ # updates the stack instances in the specified accounts and Regions,
10026
+ # while leaving all other stack instances with their existing stack
10027
+ # instance status.
8679
10028
  # @return [Array<String>]
8680
10029
  #
8681
10030
  # @!attribute [rw] regions
@@ -8688,13 +10037,13 @@ module Aws::CloudFormation
8688
10037
  #
8689
10038
  # If the stack set update includes changes to the template (that is,
8690
10039
  # if the `TemplateBody` or `TemplateURL` properties are specified), or
8691
- # the `Parameters` property, AWS CloudFormation marks all stack
8692
- # instances with a status of `OUTDATED` prior to updating the stack
8693
- # instances in the specified accounts and Regions. If the stack set
8694
- # update does not include changes to the template or parameters, AWS
8695
- # CloudFormation updates the stack instances in the specified accounts
8696
- # and Regions, while leaving all other stack instances with their
8697
- # existing stack instance status.
10040
+ # the `Parameters` property, CloudFormation marks all stack instances
10041
+ # with a status of `OUTDATED` prior to updating the stack instances in
10042
+ # the specified accounts and Regions. If the stack set update does not
10043
+ # include changes to the template or parameters, CloudFormation
10044
+ # updates the stack instances in the specified accounts and Regions,
10045
+ # while leaving all other stack instances with their existing stack
10046
+ # instance status.
8698
10047
  # @return [Array<String>]
8699
10048
  #
8700
10049
  # @!attribute [rw] call_as
@@ -8710,10 +10059,9 @@ module Aws::CloudFormation
8710
10059
  # * If you are signed in to a delegated administrator account, specify
8711
10060
  # `DELEGATED_ADMIN`.
8712
10061
  #
8713
- # Your AWS account must be registered as a delegated administrator
8714
- # in the management account. For more information, see [Register a
8715
- # delegated administrator][1] in the *AWS CloudFormation User
8716
- # Guide*.
10062
+ # Your account must be registered as a delegated administrator in
10063
+ # the management account. For more information, see [Register a
10064
+ # delegated administrator][1] in the *CloudFormation User Guide*.
8717
10065
  #
8718
10066
  #
8719
10067
  #
@@ -8808,7 +10156,7 @@ module Aws::CloudFormation
8808
10156
  # @!attribute [rw] template_body
8809
10157
  # Structure containing the template body with a minimum length of 1
8810
10158
  # byte and a maximum length of 51,200 bytes. For more information, go
8811
- # to [Template Anatomy][1] in the AWS CloudFormation User Guide.
10159
+ # to [Template Anatomy][1] in the CloudFormation User Guide.
8812
10160
  #
8813
10161
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
8814
10162
  # are passed, only `TemplateBody` is used.
@@ -8822,7 +10170,7 @@ module Aws::CloudFormation
8822
10170
  # Location of file containing the template body. The URL must point to
8823
10171
  # a template (max size: 460,800 bytes) that is located in an Amazon S3
8824
10172
  # bucket or a Systems Manager document. For more information, go to
8825
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
10173
+ # [Template Anatomy][1] in the CloudFormation User Guide.
8826
10174
  #
8827
10175
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
8828
10176
  # are passed, only `TemplateBody` is used.
@@ -8858,7 +10206,7 @@ module Aws::CloudFormation
8858
10206
  # CreateStack or UpdateStack actions with your template; otherwise,
8859
10207
  # those actions return an InsufficientCapabilities error.
8860
10208
  #
8861
- # For more information, see [Acknowledging IAM Resources in AWS
10209
+ # For more information, see [Acknowledging IAM Resources in
8862
10210
  # CloudFormation Templates][1].
8863
10211
  #
8864
10212
  #