aws-sdk-cloudformation 1.52.0 → 1.56.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudformation/client.rb +1367 -494
- data/lib/aws-sdk-cloudformation/client_api.rb +332 -1
- data/lib/aws-sdk-cloudformation/errors.rb +22 -0
- data/lib/aws-sdk-cloudformation/event.rb +2 -2
- data/lib/aws-sdk-cloudformation/resource.rb +44 -44
- data/lib/aws-sdk-cloudformation/stack.rb +110 -105
- data/lib/aws-sdk-cloudformation/stack_resource.rb +5 -5
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +2 -2
- data/lib/aws-sdk-cloudformation/types.rb +2168 -768
- data/lib/aws-sdk-cloudformation.rb +2 -2
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b025ee4315fb41a60eceb4cd6578e2c677aba67b0b60b05c7922c40636805975
|
4
|
+
data.tar.gz: a353c99c194db166f2ae77b3caacd7e6d32b94eefe890cc024d9ed427ffa4f82
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: bcc52107f71d24280f51d322b401f9af27385c77941ea96de8a2c681bd19079b7005d9ef3a4cf6e02425611812388d8a86a4bf4109ccb63ed8ad431f252e5631
|
7
|
+
data.tar.gz: 6b2348e6ead24b7ffb7b0117184e4681df13b98b0ff4f55d75ea6d8adbd1206ca51a20c91ac35aca3912d5f2e41dae72737ef5c674b1596f7f1a724d7eaea8a5
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,26 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.56.0 (2021-08-30)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - AWS CloudFormation allows you to iteratively develop your applications when failures are encountered without rolling back successfully provisioned resources. By specifying stack failure options, you can troubleshoot resources in a CREATE_FAILED or UPDATE_FAILED status.
|
8
|
+
|
9
|
+
1.55.0 (2021-07-30)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
1.54.0 (2021-07-28)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - SDK update to support Importing existing Stacks to new/existing Self Managed StackSet - Stack Import feature.
|
18
|
+
|
19
|
+
1.53.0 (2021-06-21)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - CloudFormation registry service now supports 3rd party public type sharing
|
23
|
+
|
4
24
|
1.52.0 (2021-04-28)
|
5
25
|
------------------
|
6
26
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.56.0
|
@@ -327,6 +327,193 @@ module Aws::CloudFormation
|
|
327
327
|
|
328
328
|
# @!group API Operations
|
329
329
|
|
330
|
+
# Activates a public third-party extension, making it available for use
|
331
|
+
# in stack templates. For more information, see [Using public
|
332
|
+
# extensions][1] in the *CloudFormation User Guide*.
|
333
|
+
#
|
334
|
+
# Once you have activated a public third-party extension in your account
|
335
|
+
# and region, use
|
336
|
+
# [SetTypeConfiguration](AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html)
|
337
|
+
# to specify configuration properties for the extension. For more
|
338
|
+
# information, see [Configuring extensions at the account level][2] in
|
339
|
+
# the *CloudFormation User Guide*.
|
340
|
+
#
|
341
|
+
#
|
342
|
+
#
|
343
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html
|
344
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
|
345
|
+
#
|
346
|
+
# @option params [String] :type
|
347
|
+
# The extension type.
|
348
|
+
#
|
349
|
+
# Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
|
350
|
+
# and `PublisherId`.
|
351
|
+
#
|
352
|
+
# @option params [String] :public_type_arn
|
353
|
+
# The Amazon Resource Number (ARN) of the public extension.
|
354
|
+
#
|
355
|
+
# Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
|
356
|
+
# and `PublisherId`.
|
357
|
+
#
|
358
|
+
# @option params [String] :publisher_id
|
359
|
+
# The ID of the extension publisher.
|
360
|
+
#
|
361
|
+
# Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
|
362
|
+
# and `PublisherId`.
|
363
|
+
#
|
364
|
+
# @option params [String] :type_name
|
365
|
+
# The name of the extension.
|
366
|
+
#
|
367
|
+
# Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
|
368
|
+
# and `PublisherId`.
|
369
|
+
#
|
370
|
+
# @option params [String] :type_name_alias
|
371
|
+
# An alias to assign to the public extension, in this account and
|
372
|
+
# region. If you specify an alias for the extension, CloudFormation
|
373
|
+
# treats the alias as the extension type name within this account and
|
374
|
+
# region. You must use the alias to refer to the extension in your
|
375
|
+
# templates, API calls, and CloudFormation console.
|
376
|
+
#
|
377
|
+
# An extension alias must be unique within a given account and region.
|
378
|
+
# You can activate the same public resource multiple times in the same
|
379
|
+
# account and region, using different type name aliases.
|
380
|
+
#
|
381
|
+
# @option params [Boolean] :auto_update
|
382
|
+
# Whether to automatically update the extension in this account and
|
383
|
+
# region when a new *minor* version is published by the extension
|
384
|
+
# publisher. Major versions released by the publisher must be manually
|
385
|
+
# updated.
|
386
|
+
#
|
387
|
+
# The default is `true`.
|
388
|
+
#
|
389
|
+
# @option params [Types::LoggingConfig] :logging_config
|
390
|
+
# Contains logging configuration information for an extension.
|
391
|
+
#
|
392
|
+
# @option params [String] :execution_role_arn
|
393
|
+
# The name of the IAM execution role to use to activate the extension.
|
394
|
+
#
|
395
|
+
# @option params [String] :version_bump
|
396
|
+
# Manually updates a previously-activated type to a new major or minor
|
397
|
+
# version, if available. You can also use this parameter to update the
|
398
|
+
# value of `AutoUpdate`.
|
399
|
+
#
|
400
|
+
# * `MAJOR`\: CloudFormation updates the extension to the newest major
|
401
|
+
# version, if one is available.
|
402
|
+
#
|
403
|
+
# * `MINOR`\: CloudFormation updates the extension to the newest minor
|
404
|
+
# version, if one is available.
|
405
|
+
#
|
406
|
+
# @option params [Integer] :major_version
|
407
|
+
# The major version of this extension you want to activate, if multiple
|
408
|
+
# major versions are available. The default is the latest major version.
|
409
|
+
# CloudFormation uses the latest available *minor* version of the major
|
410
|
+
# version selected.
|
411
|
+
#
|
412
|
+
# You can specify `MajorVersion` or `VersionBump`, but not both.
|
413
|
+
#
|
414
|
+
# @return [Types::ActivateTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
415
|
+
#
|
416
|
+
# * {Types::ActivateTypeOutput#arn #arn} => String
|
417
|
+
#
|
418
|
+
# @example Request syntax with placeholder values
|
419
|
+
#
|
420
|
+
# resp = client.activate_type({
|
421
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
422
|
+
# public_type_arn: "ThirdPartyTypeArn",
|
423
|
+
# publisher_id: "PublisherId",
|
424
|
+
# type_name: "TypeName",
|
425
|
+
# type_name_alias: "TypeName",
|
426
|
+
# auto_update: false,
|
427
|
+
# logging_config: {
|
428
|
+
# log_role_arn: "RoleArn", # required
|
429
|
+
# log_group_name: "LogGroupName", # required
|
430
|
+
# },
|
431
|
+
# execution_role_arn: "RoleArn",
|
432
|
+
# version_bump: "MAJOR", # accepts MAJOR, MINOR
|
433
|
+
# major_version: 1,
|
434
|
+
# })
|
435
|
+
#
|
436
|
+
# @example Response structure
|
437
|
+
#
|
438
|
+
# resp.arn #=> String
|
439
|
+
#
|
440
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ActivateType AWS API Documentation
|
441
|
+
#
|
442
|
+
# @overload activate_type(params = {})
|
443
|
+
# @param [Hash] params ({})
|
444
|
+
def activate_type(params = {}, options = {})
|
445
|
+
req = build_request(:activate_type, params)
|
446
|
+
req.send_request(options)
|
447
|
+
end
|
448
|
+
|
449
|
+
# Returns configuration data for the specified CloudFormation
|
450
|
+
# extensions, from the CloudFormation registry for the account and
|
451
|
+
# region.
|
452
|
+
#
|
453
|
+
# For more information, see [Configuring extensions at the account
|
454
|
+
# level][1] in the *CloudFormation User Guide*.
|
455
|
+
#
|
456
|
+
#
|
457
|
+
#
|
458
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
|
459
|
+
#
|
460
|
+
# @option params [required, Array<Types::TypeConfigurationIdentifier>] :type_configuration_identifiers
|
461
|
+
# The list of identifiers for the desired extension configurations.
|
462
|
+
#
|
463
|
+
# @return [Types::BatchDescribeTypeConfigurationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
464
|
+
#
|
465
|
+
# * {Types::BatchDescribeTypeConfigurationsOutput#errors #errors} => Array<Types::BatchDescribeTypeConfigurationsError>
|
466
|
+
# * {Types::BatchDescribeTypeConfigurationsOutput#unprocessed_type_configurations #unprocessed_type_configurations} => Array<Types::TypeConfigurationIdentifier>
|
467
|
+
# * {Types::BatchDescribeTypeConfigurationsOutput#type_configurations #type_configurations} => Array<Types::TypeConfigurationDetails>
|
468
|
+
#
|
469
|
+
# @example Request syntax with placeholder values
|
470
|
+
#
|
471
|
+
# resp = client.batch_describe_type_configurations({
|
472
|
+
# type_configuration_identifiers: [ # required
|
473
|
+
# {
|
474
|
+
# type_arn: "TypeArn",
|
475
|
+
# type_configuration_alias: "TypeConfigurationAlias",
|
476
|
+
# type_configuration_arn: "TypeConfigurationArn",
|
477
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
478
|
+
# type_name: "TypeName",
|
479
|
+
# },
|
480
|
+
# ],
|
481
|
+
# })
|
482
|
+
#
|
483
|
+
# @example Response structure
|
484
|
+
#
|
485
|
+
# resp.errors #=> Array
|
486
|
+
# resp.errors[0].error_code #=> String
|
487
|
+
# resp.errors[0].error_message #=> String
|
488
|
+
# resp.errors[0].type_configuration_identifier.type_arn #=> String
|
489
|
+
# resp.errors[0].type_configuration_identifier.type_configuration_alias #=> String
|
490
|
+
# resp.errors[0].type_configuration_identifier.type_configuration_arn #=> String
|
491
|
+
# resp.errors[0].type_configuration_identifier.type #=> String, one of "RESOURCE", "MODULE"
|
492
|
+
# resp.errors[0].type_configuration_identifier.type_name #=> String
|
493
|
+
# resp.unprocessed_type_configurations #=> Array
|
494
|
+
# resp.unprocessed_type_configurations[0].type_arn #=> String
|
495
|
+
# resp.unprocessed_type_configurations[0].type_configuration_alias #=> String
|
496
|
+
# resp.unprocessed_type_configurations[0].type_configuration_arn #=> String
|
497
|
+
# resp.unprocessed_type_configurations[0].type #=> String, one of "RESOURCE", "MODULE"
|
498
|
+
# resp.unprocessed_type_configurations[0].type_name #=> String
|
499
|
+
# resp.type_configurations #=> Array
|
500
|
+
# resp.type_configurations[0].arn #=> String
|
501
|
+
# resp.type_configurations[0].alias #=> String
|
502
|
+
# resp.type_configurations[0].configuration #=> String
|
503
|
+
# resp.type_configurations[0].last_updated #=> Time
|
504
|
+
# resp.type_configurations[0].type_arn #=> String
|
505
|
+
# resp.type_configurations[0].type_name #=> String
|
506
|
+
# resp.type_configurations[0].is_default_configuration #=> Boolean
|
507
|
+
#
|
508
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/BatchDescribeTypeConfigurations AWS API Documentation
|
509
|
+
#
|
510
|
+
# @overload batch_describe_type_configurations(params = {})
|
511
|
+
# @param [Hash] params ({})
|
512
|
+
def batch_describe_type_configurations(params = {}, options = {})
|
513
|
+
req = build_request(:batch_describe_type_configurations, params)
|
514
|
+
req.send_request(options)
|
515
|
+
end
|
516
|
+
|
330
517
|
# Cancels an update on the specified stack. If the call completes
|
331
518
|
# successfully, the stack rolls back the update and reverts to the
|
332
519
|
# previous stack configuration.
|
@@ -340,10 +527,10 @@ module Aws::CloudFormation
|
|
340
527
|
#
|
341
528
|
# @option params [String] :client_request_token
|
342
529
|
# A unique identifier for this `CancelUpdateStack` request. Specify this
|
343
|
-
# token if you plan to retry requests so that
|
344
|
-
#
|
345
|
-
#
|
346
|
-
#
|
530
|
+
# token if you plan to retry requests so that CloudFormation knows that
|
531
|
+
# you're not attempting to cancel an update on a stack with the same
|
532
|
+
# name. You might retry `CancelUpdateStack` requests to ensure that
|
533
|
+
# CloudFormation successfully received them.
|
347
534
|
#
|
348
535
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
349
536
|
#
|
@@ -371,11 +558,11 @@ module Aws::CloudFormation
|
|
371
558
|
# `UPDATE_ROLLBACK_COMPLETE` state), and then try to update the stack
|
372
559
|
# again.
|
373
560
|
#
|
374
|
-
# A stack goes into the `UPDATE_ROLLBACK_FAILED` state when
|
561
|
+
# A stack goes into the `UPDATE_ROLLBACK_FAILED` state when
|
375
562
|
# CloudFormation cannot roll back all changes after a failed stack
|
376
563
|
# update. For example, you might have a stack that is rolling back to an
|
377
|
-
# old database instance that was deleted outside of
|
378
|
-
# Because
|
564
|
+
# old database instance that was deleted outside of CloudFormation.
|
565
|
+
# Because CloudFormation doesn't know the database was deleted, it
|
379
566
|
# assumes that the database instance still exists and attempts to roll
|
380
567
|
# back to it, causing the update rollback to fail.
|
381
568
|
#
|
@@ -395,33 +582,32 @@ module Aws::CloudFormation
|
|
395
582
|
# </note>
|
396
583
|
#
|
397
584
|
# @option params [String] :role_arn
|
398
|
-
# The Amazon Resource Name (ARN) of an
|
399
|
-
#
|
400
|
-
#
|
401
|
-
#
|
402
|
-
#
|
403
|
-
#
|
404
|
-
#
|
405
|
-
#
|
406
|
-
#
|
407
|
-
#
|
408
|
-
# was previously associated with the stack. If no role is available, AWS
|
585
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
586
|
+
# (IAM) role that CloudFormation assumes to roll back the stack.
|
587
|
+
# CloudFormation uses the role's credentials to make calls on your
|
588
|
+
# behalf. CloudFormation always uses this role for all future operations
|
589
|
+
# on the stack. As long as users have permission to operate on the
|
590
|
+
# stack, CloudFormation uses this role even if the users don't have
|
591
|
+
# permission to pass it. Ensure that the role grants least privilege.
|
592
|
+
#
|
593
|
+
# If you don't specify a value, CloudFormation uses the role that was
|
594
|
+
# previously associated with the stack. If no role is available,
|
409
595
|
# CloudFormation uses a temporary session that is generated from your
|
410
596
|
# user credentials.
|
411
597
|
#
|
412
598
|
# @option params [Array<String>] :resources_to_skip
|
413
|
-
# A list of the logical IDs of the resources that
|
414
|
-
#
|
415
|
-
#
|
416
|
-
#
|
417
|
-
#
|
418
|
-
#
|
419
|
-
#
|
420
|
-
#
|
421
|
-
# Specify this property to skip rolling back resources that
|
599
|
+
# A list of the logical IDs of the resources that CloudFormation skips
|
600
|
+
# during the continue update rollback operation. You can specify only
|
601
|
+
# resources that are in the `UPDATE_FAILED` state because a rollback
|
602
|
+
# failed. You can't specify resources that are in the `UPDATE_FAILED`
|
603
|
+
# state for other reasons, for example, because an update was cancelled.
|
604
|
+
# To check why a resource update failed, use the DescribeStackResources
|
605
|
+
# action, and view the resource status reason.
|
606
|
+
#
|
607
|
+
# Specify this property to skip rolling back resources that
|
422
608
|
# CloudFormation can't successfully roll back. We recommend that you [
|
423
|
-
# troubleshoot][1] resources before skipping them.
|
424
|
-
#
|
609
|
+
# troubleshoot][1] resources before skipping them. CloudFormation sets
|
610
|
+
# the status of the specified resources to `UPDATE_COMPLETE` and
|
425
611
|
# continues to roll back the stack. After the rollback is complete, the
|
426
612
|
# state of the skipped resources will be inconsistent with the state of
|
427
613
|
# the resources in the stack template. Before performing another stack
|
@@ -455,10 +641,10 @@ module Aws::CloudFormation
|
|
455
641
|
#
|
456
642
|
# @option params [String] :client_request_token
|
457
643
|
# A unique identifier for this `ContinueUpdateRollback` request. Specify
|
458
|
-
# this token if you plan to retry requests so that
|
459
|
-
#
|
460
|
-
#
|
461
|
-
#
|
644
|
+
# this token if you plan to retry requests so that CloudFormationknows
|
645
|
+
# that you're not attempting to continue the rollback to a stack with
|
646
|
+
# the same name. You might retry `ContinueUpdateRollback` requests to
|
647
|
+
# ensure that CloudFormation successfully received them.
|
462
648
|
#
|
463
649
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
464
650
|
#
|
@@ -484,25 +670,25 @@ module Aws::CloudFormation
|
|
484
670
|
# can review the changes before executing them. You can create a change
|
485
671
|
# set for a stack that doesn't exist or an existing stack. If you
|
486
672
|
# create a change set for a stack that doesn't exist, the change set
|
487
|
-
# shows all of the resources that
|
488
|
-
# create a change set for an existing stack,
|
489
|
-
#
|
673
|
+
# shows all of the resources that CloudFormation will create. If you
|
674
|
+
# create a change set for an existing stack, CloudFormation compares the
|
675
|
+
# stack's information with the information that you submit in the
|
490
676
|
# change set and lists the differences. Use change sets to understand
|
491
|
-
# which resources
|
492
|
-
#
|
493
|
-
#
|
677
|
+
# which resources CloudFormation will create or change, and how it will
|
678
|
+
# change resources in an existing stack, before you create or update a
|
679
|
+
# stack.
|
494
680
|
#
|
495
681
|
# To create a change set for a stack that doesn't exist, for the
|
496
682
|
# `ChangeSetType` parameter, specify `CREATE`. To create a change set
|
497
683
|
# for an existing stack, specify `UPDATE` for the `ChangeSetType`
|
498
684
|
# parameter. To create a change set for an import operation, specify
|
499
685
|
# `IMPORT` for the `ChangeSetType` parameter. After the
|
500
|
-
# `CreateChangeSet` call successfully completes,
|
501
|
-
#
|
502
|
-
#
|
686
|
+
# `CreateChangeSet` call successfully completes, CloudFormation starts
|
687
|
+
# creating the change set. To check the status of the change set or to
|
688
|
+
# review it, use the DescribeChangeSet action.
|
503
689
|
#
|
504
690
|
# When you are satisfied with the changes the change set will make,
|
505
|
-
# execute the change set by using the ExecuteChangeSet action.
|
691
|
+
# execute the change set by using the ExecuteChangeSet action.
|
506
692
|
# CloudFormation doesn't make changes until you execute the change set.
|
507
693
|
#
|
508
694
|
# To create a change set for the entire stack hierachy, set
|
@@ -510,13 +696,13 @@ module Aws::CloudFormation
|
|
510
696
|
#
|
511
697
|
# @option params [required, String] :stack_name
|
512
698
|
# The name or the unique ID of the stack for which you are creating a
|
513
|
-
# change set.
|
514
|
-
#
|
515
|
-
#
|
699
|
+
# change set. CloudFormation generates the change set by comparing this
|
700
|
+
# stack's information with the information that you submit, such as a
|
701
|
+
# modified template or different parameter input values.
|
516
702
|
#
|
517
703
|
# @option params [String] :template_body
|
518
704
|
# A structure that contains the body of the revised template, with a
|
519
|
-
# minimum length of 1 byte and a maximum length of 51,200 bytes.
|
705
|
+
# minimum length of 1 byte and a maximum length of 51,200 bytes.
|
520
706
|
# CloudFormation generates the change set by comparing this template
|
521
707
|
# with the template of the stack that you specified.
|
522
708
|
#
|
@@ -525,9 +711,9 @@ module Aws::CloudFormation
|
|
525
711
|
# @option params [String] :template_url
|
526
712
|
# The location of the file that contains the revised template. The URL
|
527
713
|
# must point to a template (max size: 460,800 bytes) that is located in
|
528
|
-
# an S3 bucket or a Systems Manager document.
|
529
|
-
#
|
530
|
-
#
|
714
|
+
# an S3 bucket or a Systems Manager document. CloudFormation generates
|
715
|
+
# the change set by comparing this template with the stack that you
|
716
|
+
# specified.
|
531
717
|
#
|
532
718
|
# Conditional: You must specify only `TemplateBody` or `TemplateURL`.
|
533
719
|
#
|
@@ -541,16 +727,16 @@ module Aws::CloudFormation
|
|
541
727
|
#
|
542
728
|
# @option params [Array<String>] :capabilities
|
543
729
|
# In some cases, you must explicitly acknowledge that your stack
|
544
|
-
# template contains certain capabilities in order for
|
545
|
-
#
|
730
|
+
# template contains certain capabilities in order for CloudFormation to
|
731
|
+
# create the stack.
|
546
732
|
#
|
547
733
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
548
734
|
#
|
549
735
|
# Some stack templates might include resources that can affect
|
550
|
-
# permissions in your
|
551
|
-
# Identity and Access Management (IAM) users. For those
|
552
|
-
# must explicitly acknowledge this by specifying one of
|
553
|
-
# capabilities.
|
736
|
+
# permissions in your Amazon Web Services account; for example, by
|
737
|
+
# creating new Identity and Access Management (IAM) users. For those
|
738
|
+
# stacks, you must explicitly acknowledge this by specifying one of
|
739
|
+
# these capabilities.
|
554
740
|
#
|
555
741
|
# The following IAM resources require you to specify either the
|
556
742
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -560,8 +746,8 @@ module Aws::CloudFormation
|
|
560
746
|
# * If you have IAM resources with custom names, you *must* specify
|
561
747
|
# `CAPABILITY_NAMED_IAM`.
|
562
748
|
#
|
563
|
-
# * If you don't specify either of these capabilities,
|
564
|
-
#
|
749
|
+
# * If you don't specify either of these capabilities, CloudFormation
|
750
|
+
# returns an `InsufficientCapabilities` error.
|
565
751
|
#
|
566
752
|
# If your stack template contains these resources, we recommend that
|
567
753
|
# you review all permissions associated with them and edit their
|
@@ -581,7 +767,7 @@ module Aws::CloudFormation
|
|
581
767
|
#
|
582
768
|
# * [ AWS::IAM::UserToGroupAddition][7]
|
583
769
|
#
|
584
|
-
# For more information, see [Acknowledging IAM Resources in
|
770
|
+
# For more information, see [Acknowledging IAM Resources in
|
585
771
|
# CloudFormation Templates][8].
|
586
772
|
#
|
587
773
|
# * `CAPABILITY_AUTO_EXPAND`
|
@@ -596,7 +782,7 @@ module Aws::CloudFormation
|
|
596
782
|
# create a stack directly from the processed template, without first
|
597
783
|
# reviewing the resulting changes in a change set, you must
|
598
784
|
# acknowledge this capability. This includes the [AWS::Include][9] and
|
599
|
-
# [AWS::Serverless][10] transforms, which are macros hosted by
|
785
|
+
# [AWS::Serverless][10] transforms, which are macros hosted by
|
600
786
|
# CloudFormation.
|
601
787
|
#
|
602
788
|
# <note markdown="1"> This capacity does not apply to creating change sets, and specifying
|
@@ -609,8 +795,8 @@ module Aws::CloudFormation
|
|
609
795
|
#
|
610
796
|
# </note>
|
611
797
|
#
|
612
|
-
# For more information on macros, see [Using
|
613
|
-
#
|
798
|
+
# For more information on macros, see [Using CloudFormation Macros to
|
799
|
+
# Perform Custom Processing on Templates][11].
|
614
800
|
#
|
615
801
|
#
|
616
802
|
#
|
@@ -632,44 +818,43 @@ module Aws::CloudFormation
|
|
632
818
|
# `AWS::EC2::*`, or `Custom::MyCustomInstance`.
|
633
819
|
#
|
634
820
|
# If the list of resource types doesn't include a resource type that
|
635
|
-
# you're updating, the stack update fails. By default,
|
636
|
-
#
|
637
|
-
#
|
638
|
-
#
|
639
|
-
#
|
640
|
-
#
|
821
|
+
# you're updating, the stack update fails. By default, CloudFormation
|
822
|
+
# grants permissions to all resource types. Identity and Access
|
823
|
+
# Management (IAM) uses this parameter for condition keys in IAM
|
824
|
+
# policies for CloudFormation. For more information, see [Controlling
|
825
|
+
# Access with Identity and Access Management][1] in the CloudFormation
|
826
|
+
# User Guide.
|
641
827
|
#
|
642
828
|
#
|
643
829
|
#
|
644
830
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
645
831
|
#
|
646
832
|
# @option params [String] :role_arn
|
647
|
-
# The Amazon Resource Name (ARN) of an
|
648
|
-
#
|
649
|
-
#
|
650
|
-
#
|
651
|
-
#
|
652
|
-
#
|
653
|
-
#
|
654
|
-
#
|
655
|
-
#
|
656
|
-
#
|
657
|
-
# was previously associated with the stack. If no role is available, AWS
|
833
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
834
|
+
# (IAM) role that CloudFormation assumes when executing the change set.
|
835
|
+
# CloudFormation uses the role's credentials to make calls on your
|
836
|
+
# behalf. CloudFormation uses this role for all future operations on the
|
837
|
+
# stack. As long as users have permission to operate on the stack,
|
838
|
+
# CloudFormation uses this role even if the users don't have permission
|
839
|
+
# to pass it. Ensure that the role grants least privilege.
|
840
|
+
#
|
841
|
+
# If you don't specify a value, CloudFormation uses the role that was
|
842
|
+
# previously associated with the stack. If no role is available,
|
658
843
|
# CloudFormation uses a temporary session that is generated from your
|
659
844
|
# user credentials.
|
660
845
|
#
|
661
846
|
# @option params [Types::RollbackConfiguration] :rollback_configuration
|
662
|
-
# The rollback triggers for
|
847
|
+
# The rollback triggers for CloudFormation to monitor during stack
|
663
848
|
# creation and updating operations, and for the specified monitoring
|
664
849
|
# period afterwards.
|
665
850
|
#
|
666
851
|
# @option params [Array<String>] :notification_arns
|
667
852
|
# The Amazon Resource Names (ARNs) of Amazon Simple Notification Service
|
668
|
-
# (Amazon SNS) topics that
|
669
|
-
#
|
853
|
+
# (Amazon SNS) topics that CloudFormation associates with the stack. To
|
854
|
+
# remove all associated notification topics, specify an empty list.
|
670
855
|
#
|
671
856
|
# @option params [Array<Types::Tag>] :tags
|
672
|
-
# Key-value pairs to associate with this stack.
|
857
|
+
# Key-value pairs to associate with this stack. CloudFormation also
|
673
858
|
# propagates these tags to resources in the stack. You can specify a
|
674
859
|
# maximum of 50 tags.
|
675
860
|
#
|
@@ -683,9 +868,9 @@ module Aws::CloudFormation
|
|
683
868
|
#
|
684
869
|
# @option params [String] :client_token
|
685
870
|
# A unique identifier for this `CreateChangeSet` request. Specify this
|
686
|
-
# token if you plan to retry requests so that
|
687
|
-
#
|
688
|
-
# name. You might retry `CreateChangeSet` requests to ensure that
|
871
|
+
# token if you plan to retry requests so that CloudFormation knows that
|
872
|
+
# you're not attempting to create another change set with the same
|
873
|
+
# name. You might retry `CreateChangeSet` requests to ensure that
|
689
874
|
# CloudFormation successfully received them.
|
690
875
|
#
|
691
876
|
# @option params [String] :description
|
@@ -697,12 +882,12 @@ module Aws::CloudFormation
|
|
697
882
|
# specify `UPDATE`. To create a change set for an import operation,
|
698
883
|
# specify `IMPORT`.
|
699
884
|
#
|
700
|
-
# If you create a change set for a new stack,
|
701
|
-
#
|
702
|
-
#
|
703
|
-
#
|
885
|
+
# If you create a change set for a new stack, CloudFormation creates a
|
886
|
+
# stack with a unique stack ID, but no template or resources. The stack
|
887
|
+
# will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you execute the
|
888
|
+
# change set.
|
704
889
|
#
|
705
|
-
# By default,
|
890
|
+
# By default, CloudFormation specifies `UPDATE`. You can't use the
|
706
891
|
# `UPDATE` type to create a change set for a new stack or the `CREATE`
|
707
892
|
# type to create a change set for an existing stack.
|
708
893
|
#
|
@@ -796,15 +981,15 @@ module Aws::CloudFormation
|
|
796
981
|
# the Region in which you are creating the stack.
|
797
982
|
#
|
798
983
|
# <note markdown="1"> A stack name can contain only alphanumeric characters (case sensitive)
|
799
|
-
# and hyphens. It must start with an
|
800
|
-
# longer than 128 characters.
|
984
|
+
# and hyphens. It must start with an alphabetical character and cannot
|
985
|
+
# be longer than 128 characters.
|
801
986
|
#
|
802
987
|
# </note>
|
803
988
|
#
|
804
989
|
# @option params [String] :template_body
|
805
990
|
# Structure containing the template body with a minimum length of 1 byte
|
806
991
|
# and a maximum length of 51,200 bytes. For more information, go to
|
807
|
-
# [Template Anatomy][1] in the
|
992
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.
|
808
993
|
#
|
809
994
|
# Conditional: You must specify either the `TemplateBody` or the
|
810
995
|
# `TemplateURL` parameter, but not both.
|
@@ -817,7 +1002,7 @@ module Aws::CloudFormation
|
|
817
1002
|
# Location of file containing the template body. The URL must point to a
|
818
1003
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
819
1004
|
# bucket or a Systems Manager document. For more information, go to the
|
820
|
-
# [Template Anatomy][1] in the
|
1005
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.
|
821
1006
|
#
|
822
1007
|
# Conditional: You must specify either the `TemplateBody` or the
|
823
1008
|
# `TemplateURL` parameter, but not both.
|
@@ -842,7 +1027,7 @@ module Aws::CloudFormation
|
|
842
1027
|
# Default: `false`
|
843
1028
|
#
|
844
1029
|
# @option params [Types::RollbackConfiguration] :rollback_configuration
|
845
|
-
# The rollback triggers for
|
1030
|
+
# The rollback triggers for CloudFormation to monitor during stack
|
846
1031
|
# creation and updating operations, and for the specified monitoring
|
847
1032
|
# period afterwards.
|
848
1033
|
#
|
@@ -858,16 +1043,16 @@ module Aws::CloudFormation
|
|
858
1043
|
#
|
859
1044
|
# @option params [Array<String>] :capabilities
|
860
1045
|
# In some cases, you must explicitly acknowledge that your stack
|
861
|
-
# template contains certain capabilities in order for
|
862
|
-
#
|
1046
|
+
# template contains certain capabilities in order for CloudFormation to
|
1047
|
+
# create the stack.
|
863
1048
|
#
|
864
1049
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
865
1050
|
#
|
866
1051
|
# Some stack templates might include resources that can affect
|
867
|
-
# permissions in your
|
868
|
-
# Identity and Access Management (IAM) users. For those
|
869
|
-
# must explicitly acknowledge this by specifying one of
|
870
|
-
# capabilities.
|
1052
|
+
# permissions in your Amazon Web Services account; for example, by
|
1053
|
+
# creating new Identity and Access Management (IAM) users. For those
|
1054
|
+
# stacks, you must explicitly acknowledge this by specifying one of
|
1055
|
+
# these capabilities.
|
871
1056
|
#
|
872
1057
|
# The following IAM resources require you to specify either the
|
873
1058
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -877,8 +1062,8 @@ module Aws::CloudFormation
|
|
877
1062
|
# * If you have IAM resources with custom names, you *must* specify
|
878
1063
|
# `CAPABILITY_NAMED_IAM`.
|
879
1064
|
#
|
880
|
-
# * If you don't specify either of these capabilities,
|
881
|
-
#
|
1065
|
+
# * If you don't specify either of these capabilities, CloudFormation
|
1066
|
+
# returns an `InsufficientCapabilities` error.
|
882
1067
|
#
|
883
1068
|
# If your stack template contains these resources, we recommend that
|
884
1069
|
# you review all permissions associated with them and edit their
|
@@ -898,7 +1083,7 @@ module Aws::CloudFormation
|
|
898
1083
|
#
|
899
1084
|
# * [ AWS::IAM::UserToGroupAddition][7]
|
900
1085
|
#
|
901
|
-
# For more information, see [Acknowledging IAM Resources in
|
1086
|
+
# For more information, see [Acknowledging IAM Resources in
|
902
1087
|
# CloudFormation Templates][8].
|
903
1088
|
#
|
904
1089
|
# * `CAPABILITY_AUTO_EXPAND`
|
@@ -913,7 +1098,7 @@ module Aws::CloudFormation
|
|
913
1098
|
# create a stack directly from the processed template, without first
|
914
1099
|
# reviewing the resulting changes in a change set, you must
|
915
1100
|
# acknowledge this capability. This includes the [AWS::Include][9] and
|
916
|
-
# [AWS::Serverless][10] transforms, which are macros hosted by
|
1101
|
+
# [AWS::Serverless][10] transforms, which are macros hosted by
|
917
1102
|
# CloudFormation.
|
918
1103
|
#
|
919
1104
|
# If you want to create a stack from a stack template that contains
|
@@ -925,11 +1110,11 @@ module Aws::CloudFormation
|
|
925
1110
|
#
|
926
1111
|
# Each macro relies on an underlying Lambda service function for
|
927
1112
|
# processing stack templates. Be aware that the Lambda function owner
|
928
|
-
# can update the function operation without
|
1113
|
+
# can update the function operation without CloudFormation being
|
929
1114
|
# notified.
|
930
1115
|
#
|
931
|
-
# For more information, see [Using
|
932
|
-
#
|
1116
|
+
# For more information, see [Using CloudFormation Macros to Perform
|
1117
|
+
# Custom Processing on Templates][11].
|
933
1118
|
#
|
934
1119
|
#
|
935
1120
|
#
|
@@ -949,35 +1134,35 @@ module Aws::CloudFormation
|
|
949
1134
|
# The template resource types that you have permissions to work with for
|
950
1135
|
# this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
|
951
1136
|
# or `Custom::MyCustomInstance`. Use the following syntax to describe
|
952
|
-
# template resource types: `AWS::*` (for all
|
953
|
-
#
|
954
|
-
#
|
955
|
-
#
|
956
|
-
#
|
1137
|
+
# template resource types: `AWS::*` (for all Amazon Web Services
|
1138
|
+
# resources), `Custom::*` (for all custom resources),
|
1139
|
+
# `Custom::logical_ID ` (for a specific custom resource),
|
1140
|
+
# `AWS::service_name::*` (for all resources of a particular Amazon Web
|
1141
|
+
# Services service), and `AWS::service_name::resource_logical_ID ` (for
|
1142
|
+
# a specific Amazon Web Services resource).
|
957
1143
|
#
|
958
1144
|
# If the list of resource types doesn't include a resource that you're
|
959
|
-
# creating, the stack creation fails. By default,
|
960
|
-
#
|
961
|
-
#
|
962
|
-
#
|
963
|
-
#
|
1145
|
+
# creating, the stack creation fails. By default, CloudFormation grants
|
1146
|
+
# permissions to all resource types. Identity and Access Management
|
1147
|
+
# (IAM) uses this parameter for CloudFormation-specific condition keys
|
1148
|
+
# in IAM policies. For more information, see [Controlling Access with
|
1149
|
+
# Identity and Access Management][1].
|
964
1150
|
#
|
965
1151
|
#
|
966
1152
|
#
|
967
1153
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
968
1154
|
#
|
969
1155
|
# @option params [String] :role_arn
|
970
|
-
# The Amazon Resource Name (ARN) of an
|
971
|
-
#
|
972
|
-
#
|
973
|
-
#
|
974
|
-
#
|
975
|
-
#
|
976
|
-
#
|
977
|
-
#
|
978
|
-
#
|
979
|
-
#
|
980
|
-
# was previously associated with the stack. If no role is available, AWS
|
1156
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
1157
|
+
# (IAM) role that CloudFormation assumes to create the stack.
|
1158
|
+
# CloudFormation uses the role's credentials to make calls on your
|
1159
|
+
# behalf. CloudFormation always uses this role for all future operations
|
1160
|
+
# on the stack. As long as users have permission to operate on the
|
1161
|
+
# stack, CloudFormation uses this role even if the users don't have
|
1162
|
+
# permission to pass it. Ensure that the role grants least privilege.
|
1163
|
+
#
|
1164
|
+
# If you don't specify a value, CloudFormation uses the role that was
|
1165
|
+
# previously associated with the stack. If no role is available,
|
981
1166
|
# CloudFormation uses a temporary session that is generated from your
|
982
1167
|
# user credentials.
|
983
1168
|
#
|
@@ -990,7 +1175,7 @@ module Aws::CloudFormation
|
|
990
1175
|
#
|
991
1176
|
# @option params [String] :stack_policy_body
|
992
1177
|
# Structure containing the stack policy body. For more information, go
|
993
|
-
# to [ Prevent Updates to Stack Resources][1] in the *
|
1178
|
+
# to [ Prevent Updates to Stack Resources][1] in the *CloudFormation
|
994
1179
|
# User Guide*. You can specify either the `StackPolicyBody` or the
|
995
1180
|
# `StackPolicyURL` parameter, but not both.
|
996
1181
|
#
|
@@ -1005,15 +1190,15 @@ module Aws::CloudFormation
|
|
1005
1190
|
# the `StackPolicyURL` parameter, but not both.
|
1006
1191
|
#
|
1007
1192
|
# @option params [Array<Types::Tag>] :tags
|
1008
|
-
# Key-value pairs to associate with this stack.
|
1193
|
+
# Key-value pairs to associate with this stack. CloudFormation also
|
1009
1194
|
# propagates these tags to the resources created in the stack. A maximum
|
1010
1195
|
# number of 50 tags can be specified.
|
1011
1196
|
#
|
1012
1197
|
# @option params [String] :client_request_token
|
1013
1198
|
# A unique identifier for this `CreateStack` request. Specify this token
|
1014
|
-
# if you plan to retry requests so that
|
1199
|
+
# if you plan to retry requests so that CloudFormation knows that
|
1015
1200
|
# you're not attempting to create a stack with the same name. You might
|
1016
|
-
# retry `CreateStack` requests to ensure that
|
1201
|
+
# retry `CreateStack` requests to ensure that CloudFormation
|
1017
1202
|
# successfully received them.
|
1018
1203
|
#
|
1019
1204
|
# All events triggered by a given stack operation are assigned the same
|
@@ -1035,7 +1220,7 @@ module Aws::CloudFormation
|
|
1035
1220
|
# user attempts to delete a stack with termination protection enabled,
|
1036
1221
|
# the operation fails and the stack remains unchanged. For more
|
1037
1222
|
# information, see [Protecting a Stack From Being Deleted][1] in the
|
1038
|
-
# *
|
1223
|
+
# *CloudFormation User Guide*. Termination protection is disabled on
|
1039
1224
|
# stacks by default.
|
1040
1225
|
#
|
1041
1226
|
# For [nested stacks][2], termination protection is set on the root
|
@@ -1116,21 +1301,21 @@ module Aws::CloudFormation
|
|
1116
1301
|
# instances from.
|
1117
1302
|
#
|
1118
1303
|
# @option params [Array<String>] :accounts
|
1119
|
-
# \[Self-managed permissions\] The names of one or more
|
1120
|
-
# that you want to create stack instances in the
|
1121
|
-
# for.
|
1304
|
+
# \[Self-managed permissions\] The names of one or more Amazon Web
|
1305
|
+
# Services accounts that you want to create stack instances in the
|
1306
|
+
# specified Region(s) for.
|
1122
1307
|
#
|
1123
1308
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1124
1309
|
#
|
1125
1310
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
1126
|
-
# \[Service-managed permissions\] The
|
1127
|
-
#
|
1311
|
+
# \[Service-managed permissions\] The Organizations accounts for which
|
1312
|
+
# to create stack instances in the specified Regions.
|
1128
1313
|
#
|
1129
1314
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1130
1315
|
#
|
1131
1316
|
# @option params [required, Array<String>] :regions
|
1132
1317
|
# The names of one or more Regions where you want to create stack
|
1133
|
-
# instances using the specified
|
1318
|
+
# instances using the specified Amazon Web Services accounts.
|
1134
1319
|
#
|
1135
1320
|
# @option params [Array<Types::Parameter>] :parameter_overrides
|
1136
1321
|
# A list of stack set parameters whose values you want to override in
|
@@ -1138,24 +1323,19 @@ module Aws::CloudFormation
|
|
1138
1323
|
#
|
1139
1324
|
# Any overridden parameter values will be applied to all stack instances
|
1140
1325
|
# in the specified accounts and Regions. When specifying parameters and
|
1141
|
-
# their values, be aware of how
|
1326
|
+
# their values, be aware of how CloudFormation sets parameter values
|
1142
1327
|
# during stack instance operations:
|
1143
1328
|
#
|
1144
1329
|
# * To override the current value for a parameter, include the parameter
|
1145
1330
|
# and specify its value.
|
1146
1331
|
#
|
1147
|
-
# * To leave
|
1148
|
-
#
|
1332
|
+
# * To leave an overridden parameter set to its present value, include
|
1333
|
+
# the parameter and specify `UsePreviousValue` as `true`. (You cannot
|
1334
|
+
# specify both a value and set `UsePreviousValue` to `true`.)
|
1149
1335
|
#
|
1150
|
-
#
|
1151
|
-
#
|
1152
|
-
#
|
1153
|
-
# (You cannot specify both a value and set `UsePreviousValue` to
|
1154
|
-
# `true`.)
|
1155
|
-
#
|
1156
|
-
# * To set all overridden parameter back to the values specified in the
|
1157
|
-
# stack set, specify a parameter list but do not include any
|
1158
|
-
# parameters.
|
1336
|
+
# * To set an overridden parameter back to the value specified in the
|
1337
|
+
# stack set, specify a parameter list but do not include the parameter
|
1338
|
+
# in the list.
|
1159
1339
|
#
|
1160
1340
|
# * To leave all parameters set to their present values, do not specify
|
1161
1341
|
# this property at all.
|
@@ -1172,17 +1352,16 @@ module Aws::CloudFormation
|
|
1172
1352
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
|
1173
1353
|
#
|
1174
1354
|
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
1175
|
-
# Preferences for how
|
1176
|
-
# operation.
|
1355
|
+
# Preferences for how CloudFormation performs this stack set operation.
|
1177
1356
|
#
|
1178
1357
|
# @option params [String] :operation_id
|
1179
1358
|
# The unique identifier for this stack set operation.
|
1180
1359
|
#
|
1181
1360
|
# The operation ID also functions as an idempotency token, to ensure
|
1182
|
-
# that
|
1183
|
-
#
|
1184
|
-
#
|
1185
|
-
#
|
1361
|
+
# that CloudFormation performs the stack set operation only once, even
|
1362
|
+
# if you retry the request multiple times. You might retry stack set
|
1363
|
+
# operation requests to ensure that CloudFormation successfully received
|
1364
|
+
# them.
|
1186
1365
|
#
|
1187
1366
|
# If you don't specify an operation ID, the SDK generates one
|
1188
1367
|
# automatically.
|
@@ -1206,9 +1385,10 @@ module Aws::CloudFormation
|
|
1206
1385
|
# * If you are signed in to a delegated administrator account, specify
|
1207
1386
|
# `DELEGATED_ADMIN`.
|
1208
1387
|
#
|
1209
|
-
# Your
|
1210
|
-
# the management account. For more information, see
|
1211
|
-
# delegated administrator][1] in the *
|
1388
|
+
# Your Amazon Web Services account must be registered as a delegated
|
1389
|
+
# administrator in the management account. For more information, see
|
1390
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
1391
|
+
# Guide*.
|
1212
1392
|
#
|
1213
1393
|
#
|
1214
1394
|
#
|
@@ -1281,7 +1461,7 @@ module Aws::CloudFormation
|
|
1281
1461
|
# @option params [String] :template_body
|
1282
1462
|
# The structure that contains the template body, with a minimum length
|
1283
1463
|
# of 1 byte and a maximum length of 51,200 bytes. For more information,
|
1284
|
-
# see [Template Anatomy][1] in the
|
1464
|
+
# see [Template Anatomy][1] in the CloudFormation User Guide.
|
1285
1465
|
#
|
1286
1466
|
# Conditional: You must specify either the TemplateBody or the
|
1287
1467
|
# TemplateURL parameter, but not both.
|
@@ -1294,7 +1474,7 @@ module Aws::CloudFormation
|
|
1294
1474
|
# The location of the file that contains the template body. The URL must
|
1295
1475
|
# point to a template (maximum size: 460,800 bytes) that's located in
|
1296
1476
|
# an Amazon S3 bucket or a Systems Manager document. For more
|
1297
|
-
# information, see [Template Anatomy][1] in the
|
1477
|
+
# information, see [Template Anatomy][1] in the CloudFormation User
|
1298
1478
|
# Guide.
|
1299
1479
|
#
|
1300
1480
|
# Conditional: You must specify either the TemplateBody or the
|
@@ -1304,21 +1484,25 @@ module Aws::CloudFormation
|
|
1304
1484
|
#
|
1305
1485
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
1306
1486
|
#
|
1487
|
+
# @option params [String] :stack_id
|
1488
|
+
# The stack ID you are importing into a new stack set. Specify the
|
1489
|
+
# Amazon Resource Number (ARN) of the stack.
|
1490
|
+
#
|
1307
1491
|
# @option params [Array<Types::Parameter>] :parameters
|
1308
1492
|
# The input parameters for the stack set template.
|
1309
1493
|
#
|
1310
1494
|
# @option params [Array<String>] :capabilities
|
1311
1495
|
# In some cases, you must explicitly acknowledge that your stack set
|
1312
|
-
# template contains certain capabilities in order for
|
1313
|
-
#
|
1496
|
+
# template contains certain capabilities in order for CloudFormation to
|
1497
|
+
# create the stack set and related stack instances.
|
1314
1498
|
#
|
1315
1499
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
1316
1500
|
#
|
1317
1501
|
# Some stack templates might include resources that can affect
|
1318
|
-
# permissions in your
|
1319
|
-
# Identity and Access Management (IAM) users. For those
|
1320
|
-
# you must explicitly acknowledge this by specifying one
|
1321
|
-
# capabilities.
|
1502
|
+
# permissions in your Amazon Web Services account; for example, by
|
1503
|
+
# creating new Identity and Access Management (IAM) users. For those
|
1504
|
+
# stack sets, you must explicitly acknowledge this by specifying one
|
1505
|
+
# of these capabilities.
|
1322
1506
|
#
|
1323
1507
|
# The following IAM resources require you to specify either the
|
1324
1508
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -1328,8 +1512,8 @@ module Aws::CloudFormation
|
|
1328
1512
|
# * If you have IAM resources with custom names, you *must* specify
|
1329
1513
|
# `CAPABILITY_NAMED_IAM`.
|
1330
1514
|
#
|
1331
|
-
# * If you don't specify either of these capabilities,
|
1332
|
-
#
|
1515
|
+
# * If you don't specify either of these capabilities, CloudFormation
|
1516
|
+
# returns an `InsufficientCapabilities` error.
|
1333
1517
|
#
|
1334
1518
|
# If your stack template contains these resources, we recommend that
|
1335
1519
|
# you review all permissions associated with them and edit their
|
@@ -1349,7 +1533,7 @@ module Aws::CloudFormation
|
|
1349
1533
|
#
|
1350
1534
|
# * [ AWS::IAM::UserToGroupAddition][7]
|
1351
1535
|
#
|
1352
|
-
# For more information, see [Acknowledging IAM Resources in
|
1536
|
+
# For more information, see [Acknowledging IAM Resources in
|
1353
1537
|
# CloudFormation Templates][8].
|
1354
1538
|
#
|
1355
1539
|
# * `CAPABILITY_AUTO_EXPAND`
|
@@ -1359,13 +1543,13 @@ module Aws::CloudFormation
|
|
1359
1543
|
# directly from the processed template, without first reviewing the
|
1360
1544
|
# resulting changes in a change set. To create the stack set directly,
|
1361
1545
|
# you must acknowledge this capability. For more information, see
|
1362
|
-
# [Using
|
1546
|
+
# [Using CloudFormation Macros to Perform Custom Processing on
|
1363
1547
|
# Templates][9].
|
1364
1548
|
#
|
1365
1549
|
# Stack sets with service-managed permissions do not currently support
|
1366
1550
|
# the use of macros in templates. (This includes the
|
1367
1551
|
# [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
|
1368
|
-
# macros hosted by
|
1552
|
+
# macros hosted by CloudFormation.) Even if you specify this
|
1369
1553
|
# capability for a stack set with service-managed permissions, if you
|
1370
1554
|
# reference a macro in your template the stack set operation will
|
1371
1555
|
# fail.
|
@@ -1386,11 +1570,11 @@ module Aws::CloudFormation
|
|
1386
1570
|
#
|
1387
1571
|
# @option params [Array<Types::Tag>] :tags
|
1388
1572
|
# The key-value pairs to associate with this stack set and the stacks
|
1389
|
-
# created from it.
|
1573
|
+
# created from it. CloudFormation also propagates these tags to
|
1390
1574
|
# supported resources that are created in the stacks. A maximum number
|
1391
1575
|
# of 50 tags can be specified.
|
1392
1576
|
#
|
1393
|
-
# If you specify tags as part of a `CreateStackSet` action,
|
1577
|
+
# If you specify tags as part of a `CreateStackSet` action,
|
1394
1578
|
# CloudFormation checks to see if you have the required IAM permission
|
1395
1579
|
# to tag resources. If you don't, the entire `CreateStackSet` action
|
1396
1580
|
# fails with an `access denied` error, and the stack set is not created.
|
@@ -1403,7 +1587,7 @@ module Aws::CloudFormation
|
|
1403
1587
|
# roles to control which users or groups can manage specific stack sets
|
1404
1588
|
# within the same administrator account. For more information, see
|
1405
1589
|
# [Prerequisites: Granting Permissions for Stack Set Operations][1] in
|
1406
|
-
# the *
|
1590
|
+
# the *CloudFormation User Guide*.
|
1407
1591
|
#
|
1408
1592
|
#
|
1409
1593
|
#
|
@@ -1411,7 +1595,7 @@ module Aws::CloudFormation
|
|
1411
1595
|
#
|
1412
1596
|
# @option params [String] :execution_role_name
|
1413
1597
|
# The name of the IAM execution role to use to create the stack set. If
|
1414
|
-
# you do not specify an execution role,
|
1598
|
+
# you do not specify an execution role, CloudFormation uses the
|
1415
1599
|
# `AWSCloudFormationStackSetExecutionRole` role for the stack set
|
1416
1600
|
# operation.
|
1417
1601
|
#
|
@@ -1428,7 +1612,7 @@ module Aws::CloudFormation
|
|
1428
1612
|
# information, see [Grant Self-Managed Stack Set Permissions][1].
|
1429
1613
|
#
|
1430
1614
|
# * With `service-managed` permissions, StackSets automatically creates
|
1431
|
-
# the IAM roles required to deploy to accounts managed by
|
1615
|
+
# the IAM roles required to deploy to accounts managed by
|
1432
1616
|
# Organizations. For more information, see [Grant Service-Managed
|
1433
1617
|
# Stack Set Permissions][2].
|
1434
1618
|
#
|
@@ -1438,7 +1622,7 @@ module Aws::CloudFormation
|
|
1438
1622
|
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
|
1439
1623
|
#
|
1440
1624
|
# @option params [Types::AutoDeployment] :auto_deployment
|
1441
|
-
# Describes whether StackSets automatically deploys to
|
1625
|
+
# Describes whether StackSets automatically deploys to Organizations
|
1442
1626
|
# accounts that are added to the target organization or organizational
|
1443
1627
|
# unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
|
1444
1628
|
#
|
@@ -1456,9 +1640,9 @@ module Aws::CloudFormation
|
|
1456
1640
|
# * To create a stack set with service-managed permissions while signed
|
1457
1641
|
# in to a delegated administrator account, specify `DELEGATED_ADMIN`.
|
1458
1642
|
#
|
1459
|
-
# Your
|
1460
|
-
# management account. For more information, see [Register
|
1461
|
-
# administrator][1] in the *
|
1643
|
+
# Your Amazon Web Services account must be registered as a delegated
|
1644
|
+
# admin in the management account. For more information, see [Register
|
1645
|
+
# a delegated administrator][1] in the *CloudFormation User Guide*.
|
1462
1646
|
#
|
1463
1647
|
# Stack sets with service-managed permissions are created in the
|
1464
1648
|
# management account, including stack sets that are created by delegated
|
@@ -1470,9 +1654,9 @@ module Aws::CloudFormation
|
|
1470
1654
|
#
|
1471
1655
|
# @option params [String] :client_request_token
|
1472
1656
|
# A unique identifier for this `CreateStackSet` request. Specify this
|
1473
|
-
# token if you plan to retry requests so that
|
1474
|
-
#
|
1475
|
-
#
|
1657
|
+
# token if you plan to retry requests so that CloudFormation knows that
|
1658
|
+
# you're not attempting to create another stack set with the same name.
|
1659
|
+
# You might retry `CreateStackSet` requests to ensure that
|
1476
1660
|
# CloudFormation successfully received them.
|
1477
1661
|
#
|
1478
1662
|
# If you don't specify an operation ID, the SDK generates one
|
@@ -1492,6 +1676,7 @@ module Aws::CloudFormation
|
|
1492
1676
|
# description: "Description",
|
1493
1677
|
# template_body: "TemplateBody",
|
1494
1678
|
# template_url: "TemplateURL",
|
1679
|
+
# stack_id: "StackId",
|
1495
1680
|
# parameters: [
|
1496
1681
|
# {
|
1497
1682
|
# parameter_key: "ParameterKey",
|
@@ -1531,10 +1716,56 @@ module Aws::CloudFormation
|
|
1531
1716
|
req.send_request(options)
|
1532
1717
|
end
|
1533
1718
|
|
1719
|
+
# Deactivates a public extension that was previously activated in this
|
1720
|
+
# account and region.
|
1721
|
+
#
|
1722
|
+
# Once deactivated, an extension cannot be used in any CloudFormation
|
1723
|
+
# operation. This includes stack update operations where the stack
|
1724
|
+
# template includes the extension, even if no updates are being made to
|
1725
|
+
# the extension. In addition, deactivated extensions are not
|
1726
|
+
# automatically updated if a new version of the extension is released.
|
1727
|
+
#
|
1728
|
+
# @option params [String] :type_name
|
1729
|
+
# The type name of the extension, in this account and region. If you
|
1730
|
+
# specified a type name alias when enabling the extension, use the type
|
1731
|
+
# name alias.
|
1732
|
+
#
|
1733
|
+
# Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
|
1734
|
+
#
|
1735
|
+
# @option params [String] :type
|
1736
|
+
# The extension type.
|
1737
|
+
#
|
1738
|
+
# Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
|
1739
|
+
#
|
1740
|
+
# @option params [String] :arn
|
1741
|
+
# The Amazon Resource Name (ARN) for the extension, in this account and
|
1742
|
+
# region.
|
1743
|
+
#
|
1744
|
+
# Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
|
1745
|
+
#
|
1746
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1747
|
+
#
|
1748
|
+
# @example Request syntax with placeholder values
|
1749
|
+
#
|
1750
|
+
# resp = client.deactivate_type({
|
1751
|
+
# type_name: "TypeName",
|
1752
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
1753
|
+
# arn: "PrivateTypeArn",
|
1754
|
+
# })
|
1755
|
+
#
|
1756
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeactivateType AWS API Documentation
|
1757
|
+
#
|
1758
|
+
# @overload deactivate_type(params = {})
|
1759
|
+
# @param [Hash] params ({})
|
1760
|
+
def deactivate_type(params = {}, options = {})
|
1761
|
+
req = build_request(:deactivate_type, params)
|
1762
|
+
req.send_request(options)
|
1763
|
+
end
|
1764
|
+
|
1534
1765
|
# Deletes the specified change set. Deleting change sets ensures that no
|
1535
1766
|
# one executes the wrong change set.
|
1536
1767
|
#
|
1537
|
-
# If the call successfully completes,
|
1768
|
+
# If the call successfully completes, CloudFormation successfully
|
1538
1769
|
# deleted the change set.
|
1539
1770
|
#
|
1540
1771
|
# If `IncludeNestedStacks` specifies `True` during the creation of the
|
@@ -1578,28 +1809,28 @@ module Aws::CloudFormation
|
|
1578
1809
|
# @option params [Array<String>] :retain_resources
|
1579
1810
|
# For stacks in the `DELETE_FAILED` state, a list of resource logical
|
1580
1811
|
# IDs that are associated with the resources you want to retain. During
|
1581
|
-
# deletion,
|
1812
|
+
# deletion, CloudFormation deletes the stack but does not delete the
|
1582
1813
|
# retained resources.
|
1583
1814
|
#
|
1584
1815
|
# Retaining resources is useful when you cannot delete a resource, such
|
1585
1816
|
# as a non-empty S3 bucket, but you want to delete the stack.
|
1586
1817
|
#
|
1587
1818
|
# @option params [String] :role_arn
|
1588
|
-
# The Amazon Resource Name (ARN) of an
|
1589
|
-
#
|
1590
|
-
#
|
1591
|
-
#
|
1819
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
1820
|
+
# (IAM) role that CloudFormation assumes to delete the stack.
|
1821
|
+
# CloudFormation uses the role's credentials to make calls on your
|
1822
|
+
# behalf.
|
1592
1823
|
#
|
1593
|
-
# If you don't specify a value,
|
1594
|
-
#
|
1824
|
+
# If you don't specify a value, CloudFormation uses the role that was
|
1825
|
+
# previously associated with the stack. If no role is available,
|
1595
1826
|
# CloudFormation uses a temporary session that is generated from your
|
1596
1827
|
# user credentials.
|
1597
1828
|
#
|
1598
1829
|
# @option params [String] :client_request_token
|
1599
1830
|
# A unique identifier for this `DeleteStack` request. Specify this token
|
1600
|
-
# if you plan to retry requests so that
|
1831
|
+
# if you plan to retry requests so that CloudFormation knows that
|
1601
1832
|
# you're not attempting to delete a stack with the same name. You might
|
1602
|
-
# retry `DeleteStack` requests to ensure that
|
1833
|
+
# retry `DeleteStack` requests to ensure that CloudFormation
|
1603
1834
|
# successfully received them.
|
1604
1835
|
#
|
1605
1836
|
# All events triggered by a given stack operation are assigned the same
|
@@ -1644,14 +1875,14 @@ module Aws::CloudFormation
|
|
1644
1875
|
# instances for.
|
1645
1876
|
#
|
1646
1877
|
# @option params [Array<String>] :accounts
|
1647
|
-
# \[Self-managed permissions\] The names of the
|
1648
|
-
# want to delete stack instances for.
|
1878
|
+
# \[Self-managed permissions\] The names of the Amazon Web Services
|
1879
|
+
# accounts that you want to delete stack instances for.
|
1649
1880
|
#
|
1650
1881
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1651
1882
|
#
|
1652
1883
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
1653
|
-
# \[Service-managed permissions\] The
|
1654
|
-
#
|
1884
|
+
# \[Service-managed permissions\] The Organizations accounts from which
|
1885
|
+
# to delete stack instances.
|
1655
1886
|
#
|
1656
1887
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1657
1888
|
#
|
@@ -1659,8 +1890,7 @@ module Aws::CloudFormation
|
|
1659
1890
|
# The Regions where you want to delete stack set instances.
|
1660
1891
|
#
|
1661
1892
|
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
1662
|
-
# Preferences for how
|
1663
|
-
# operation.
|
1893
|
+
# Preferences for how CloudFormation performs this stack set operation.
|
1664
1894
|
#
|
1665
1895
|
# @option params [required, Boolean] :retain_stacks
|
1666
1896
|
# Removes the stack instances from the specified stack set, but doesn't
|
@@ -1680,10 +1910,10 @@ module Aws::CloudFormation
|
|
1680
1910
|
# automatically.
|
1681
1911
|
#
|
1682
1912
|
# The operation ID also functions as an idempotency token, to ensure
|
1683
|
-
# that
|
1684
|
-
#
|
1685
|
-
# operation requests to ensure that
|
1686
|
-
#
|
1913
|
+
# that CloudFormation performs the stack set operation only once, even
|
1914
|
+
# if you retry the request multiple times. You can retry stack set
|
1915
|
+
# operation requests to ensure that CloudFormation successfully received
|
1916
|
+
# them.
|
1687
1917
|
#
|
1688
1918
|
# Repeating this stack set operation with a new operation ID retries all
|
1689
1919
|
# stack instances whose status is `OUTDATED`.
|
@@ -1704,9 +1934,10 @@ module Aws::CloudFormation
|
|
1704
1934
|
# * If you are signed in to a delegated administrator account, specify
|
1705
1935
|
# `DELEGATED_ADMIN`.
|
1706
1936
|
#
|
1707
|
-
# Your
|
1708
|
-
# the management account. For more information, see
|
1709
|
-
# delegated administrator][1] in the *
|
1937
|
+
# Your Amazon Web Services account must be registered as a delegated
|
1938
|
+
# administrator in the management account. For more information, see
|
1939
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
1940
|
+
# Guide*.
|
1710
1941
|
#
|
1711
1942
|
#
|
1712
1943
|
#
|
@@ -1774,9 +2005,10 @@ module Aws::CloudFormation
|
|
1774
2005
|
# * If you are signed in to a delegated administrator account, specify
|
1775
2006
|
# `DELEGATED_ADMIN`.
|
1776
2007
|
#
|
1777
|
-
# Your
|
1778
|
-
# the management account. For more information, see
|
1779
|
-
# delegated administrator][1] in the *
|
2008
|
+
# Your Amazon Web Services account must be registered as a delegated
|
2009
|
+
# administrator in the management account. For more information, see
|
2010
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
2011
|
+
# Guide*.
|
1780
2012
|
#
|
1781
2013
|
#
|
1782
2014
|
#
|
@@ -1863,10 +2095,10 @@ module Aws::CloudFormation
|
|
1863
2095
|
req.send_request(options)
|
1864
2096
|
end
|
1865
2097
|
|
1866
|
-
# Retrieves your account's
|
1867
|
-
#
|
1868
|
-
# information about account limits, see [
|
1869
|
-
#
|
2098
|
+
# Retrieves your account's CloudFormation limits, such as the maximum
|
2099
|
+
# number of stacks that you can create in your account. For more
|
2100
|
+
# information about account limits, see [CloudFormation Limits][1] in
|
2101
|
+
# the *CloudFormation User Guide*.
|
1870
2102
|
#
|
1871
2103
|
#
|
1872
2104
|
#
|
@@ -1905,9 +2137,9 @@ module Aws::CloudFormation
|
|
1905
2137
|
req.send_request(options)
|
1906
2138
|
end
|
1907
2139
|
|
1908
|
-
# Returns the inputs for the change set and a list of changes that
|
2140
|
+
# Returns the inputs for the change set and a list of changes that
|
1909
2141
|
# CloudFormation will make if you execute the change set. For more
|
1910
|
-
# information, see [Updating Stacks Using Change Sets][1] in the
|
2142
|
+
# information, see [Updating Stacks Using Change Sets][1] in the
|
1911
2143
|
# CloudFormation User Guide.
|
1912
2144
|
#
|
1913
2145
|
#
|
@@ -2021,6 +2253,60 @@ module Aws::CloudFormation
|
|
2021
2253
|
req.send_request(options)
|
2022
2254
|
end
|
2023
2255
|
|
2256
|
+
# Returns information about a CloudFormation extension publisher.
|
2257
|
+
#
|
2258
|
+
# If you do not supply a `PublisherId`, and you have registered as an
|
2259
|
+
# extension publisher, `DescribePublisher` returns information about
|
2260
|
+
# your own publisher account.
|
2261
|
+
#
|
2262
|
+
# For more information on registering as a publisher, see:
|
2263
|
+
#
|
2264
|
+
# * [RegisterPublisher][1]
|
2265
|
+
#
|
2266
|
+
# * [Publishing extensions to make them available for public use][2] in
|
2267
|
+
# the *CloudFormation CLI User Guide*
|
2268
|
+
#
|
2269
|
+
#
|
2270
|
+
#
|
2271
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
|
2272
|
+
# [2]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
|
2273
|
+
#
|
2274
|
+
# @option params [String] :publisher_id
|
2275
|
+
# The ID of the extension publisher.
|
2276
|
+
#
|
2277
|
+
# If you do not supply a `PublisherId`, and you have registered as an
|
2278
|
+
# extension publisher, `DescribePublisher` returns information about
|
2279
|
+
# your own publisher account.
|
2280
|
+
#
|
2281
|
+
# @return [Types::DescribePublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2282
|
+
#
|
2283
|
+
# * {Types::DescribePublisherOutput#publisher_id #publisher_id} => String
|
2284
|
+
# * {Types::DescribePublisherOutput#publisher_status #publisher_status} => String
|
2285
|
+
# * {Types::DescribePublisherOutput#identity_provider #identity_provider} => String
|
2286
|
+
# * {Types::DescribePublisherOutput#publisher_profile #publisher_profile} => String
|
2287
|
+
#
|
2288
|
+
# @example Request syntax with placeholder values
|
2289
|
+
#
|
2290
|
+
# resp = client.describe_publisher({
|
2291
|
+
# publisher_id: "PublisherId",
|
2292
|
+
# })
|
2293
|
+
#
|
2294
|
+
# @example Response structure
|
2295
|
+
#
|
2296
|
+
# resp.publisher_id #=> String
|
2297
|
+
# resp.publisher_status #=> String, one of "VERIFIED", "UNVERIFIED"
|
2298
|
+
# resp.identity_provider #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
|
2299
|
+
# resp.publisher_profile #=> String
|
2300
|
+
#
|
2301
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisher AWS API Documentation
|
2302
|
+
#
|
2303
|
+
# @overload describe_publisher(params = {})
|
2304
|
+
# @param [Hash] params ({})
|
2305
|
+
def describe_publisher(params = {}, options = {})
|
2306
|
+
req = build_request(:describe_publisher, params)
|
2307
|
+
req.send_request(options)
|
2308
|
+
end
|
2309
|
+
|
2024
2310
|
# Returns information about a stack drift detection operation. A stack
|
2025
2311
|
# drift detection operation detects whether a stack's actual
|
2026
2312
|
# configuration differs, or has *drifted*, from it's expected
|
@@ -2044,10 +2330,10 @@ module Aws::CloudFormation
|
|
2044
2330
|
# @option params [required, String] :stack_drift_detection_id
|
2045
2331
|
# The ID of the drift detection results of this operation.
|
2046
2332
|
#
|
2047
|
-
#
|
2048
|
-
#
|
2049
|
-
#
|
2050
|
-
#
|
2333
|
+
# CloudFormation generates new results, with a new drift detection ID,
|
2334
|
+
# each time this operation is run. However, the number of drift results
|
2335
|
+
# CloudFormation retains for any given stack, and for how long, may
|
2336
|
+
# vary.
|
2051
2337
|
#
|
2052
2338
|
# @return [Types::DescribeStackDriftDetectionStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2053
2339
|
#
|
@@ -2086,7 +2372,7 @@ module Aws::CloudFormation
|
|
2086
2372
|
|
2087
2373
|
# Returns all stack related events for a specified stack in reverse
|
2088
2374
|
# chronological order. For more information about a stack's event
|
2089
|
-
# history, go to [Stacks][1] in the
|
2375
|
+
# history, go to [Stacks][1] in the CloudFormation User Guide.
|
2090
2376
|
#
|
2091
2377
|
# <note markdown="1"> You can list events for stacks that have failed to create or have been
|
2092
2378
|
# deleted by specifying the unique stack identifier (stack ID).
|
@@ -2136,7 +2422,7 @@ module Aws::CloudFormation
|
|
2136
2422
|
# resp.stack_events[0].physical_resource_id #=> String
|
2137
2423
|
# resp.stack_events[0].resource_type #=> String
|
2138
2424
|
# resp.stack_events[0].timestamp #=> Time
|
2139
|
-
# resp.stack_events[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
2425
|
+
# resp.stack_events[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
|
2140
2426
|
# resp.stack_events[0].resource_status_reason #=> String
|
2141
2427
|
# resp.stack_events[0].resource_properties #=> String
|
2142
2428
|
# resp.stack_events[0].client_request_token #=> String
|
@@ -2152,7 +2438,7 @@ module Aws::CloudFormation
|
|
2152
2438
|
end
|
2153
2439
|
|
2154
2440
|
# Returns the stack instance that's associated with the specified stack
|
2155
|
-
# set,
|
2441
|
+
# set, Amazon Web Services account, and Region.
|
2156
2442
|
#
|
2157
2443
|
# For a list of stack instances that are associated with a specific
|
2158
2444
|
# stack set, use ListStackInstances.
|
@@ -2162,7 +2448,8 @@ module Aws::CloudFormation
|
|
2162
2448
|
# stack instance information for.
|
2163
2449
|
#
|
2164
2450
|
# @option params [required, String] :stack_instance_account
|
2165
|
-
# The ID of an
|
2451
|
+
# The ID of an Amazon Web Services account that's associated with this
|
2452
|
+
# stack instance.
|
2166
2453
|
#
|
2167
2454
|
# @option params [required, String] :stack_instance_region
|
2168
2455
|
# The name of a Region that's associated with this stack instance.
|
@@ -2180,9 +2467,10 @@ module Aws::CloudFormation
|
|
2180
2467
|
# * If you are signed in to a delegated administrator account, specify
|
2181
2468
|
# `DELEGATED_ADMIN`.
|
2182
2469
|
#
|
2183
|
-
# Your
|
2184
|
-
# the management account. For more information, see
|
2185
|
-
# delegated administrator][1] in the *
|
2470
|
+
# Your Amazon Web Services account must be registered as a delegated
|
2471
|
+
# administrator in the management account. For more information, see
|
2472
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
2473
|
+
# Guide*.
|
2186
2474
|
#
|
2187
2475
|
#
|
2188
2476
|
#
|
@@ -2269,7 +2557,7 @@ module Aws::CloudFormation
|
|
2269
2557
|
# resp.stack_resource_detail.physical_resource_id #=> String
|
2270
2558
|
# resp.stack_resource_detail.resource_type #=> String
|
2271
2559
|
# resp.stack_resource_detail.last_updated_timestamp #=> Time
|
2272
|
-
# resp.stack_resource_detail.resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
2560
|
+
# resp.stack_resource_detail.resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
|
2273
2561
|
# resp.stack_resource_detail.resource_status_reason #=> String
|
2274
2562
|
# resp.stack_resource_detail.description #=> String
|
2275
2563
|
# resp.stack_resource_detail.metadata #=> String
|
@@ -2289,7 +2577,7 @@ module Aws::CloudFormation
|
|
2289
2577
|
|
2290
2578
|
# Returns drift information for the resources that have been checked for
|
2291
2579
|
# drift in the specified stack. This includes actual and expected
|
2292
|
-
# configuration values for resources where
|
2580
|
+
# configuration values for resources where CloudFormation detects
|
2293
2581
|
# configuration drift.
|
2294
2582
|
#
|
2295
2583
|
# For a given stack, there will be one `StackResourceDrift` for each
|
@@ -2323,8 +2611,7 @@ module Aws::CloudFormation
|
|
2323
2611
|
# * `IN_SYNC`\: The resources's actual configuration matches its
|
2324
2612
|
# expected template configuration.
|
2325
2613
|
#
|
2326
|
-
# * `NOT_CHECKED`\:
|
2327
|
-
# value.
|
2614
|
+
# * `NOT_CHECKED`\: CloudFormation does not currently return this value.
|
2328
2615
|
#
|
2329
2616
|
# @option params [String] :next_token
|
2330
2617
|
# A string that identifies the next page of stack resource drift
|
@@ -2384,11 +2671,11 @@ module Aws::CloudFormation
|
|
2384
2671
|
req.send_request(options)
|
2385
2672
|
end
|
2386
2673
|
|
2387
|
-
# Returns
|
2388
|
-
# `StackName` is specified, all the associated
|
2389
|
-
# of the stack are returned. If
|
2390
|
-
#
|
2391
|
-
# returned.
|
2674
|
+
# Returns Amazon Web Services resource descriptions for running and
|
2675
|
+
# deleted stacks. If `StackName` is specified, all the associated
|
2676
|
+
# resources that are part of the stack are returned. If
|
2677
|
+
# `PhysicalResourceId` is specified, the associated resources of the
|
2678
|
+
# stack that the resource belongs to are returned.
|
2392
2679
|
#
|
2393
2680
|
# <note markdown="1"> Only the first 100 resources will be returned. If your stack has more
|
2394
2681
|
# resources than this, you should use `ListStackResources` instead.
|
@@ -2401,8 +2688,8 @@ module Aws::CloudFormation
|
|
2401
2688
|
# You must specify either `StackName` or `PhysicalResourceId`, but not
|
2402
2689
|
# both. In addition, you can specify `LogicalResourceId` to filter the
|
2403
2690
|
# returned result. For more information about resources, the
|
2404
|
-
# `LogicalResourceId` and `PhysicalResourceId`, go to the
|
2405
|
-
# CloudFormation User Guide][1].
|
2691
|
+
# `LogicalResourceId` and `PhysicalResourceId`, go to the
|
2692
|
+
# [CloudFormation User Guide][1].
|
2406
2693
|
#
|
2407
2694
|
# <note markdown="1"> A `ValidationError` is returned if you specify both `StackName` and
|
2408
2695
|
# `PhysicalResourceId` in the same request.
|
@@ -2434,7 +2721,7 @@ module Aws::CloudFormation
|
|
2434
2721
|
#
|
2435
2722
|
# @option params [String] :physical_resource_id
|
2436
2723
|
# The name or unique identifier that corresponds to a physical instance
|
2437
|
-
# ID of a resource supported by
|
2724
|
+
# ID of a resource supported by CloudFormation.
|
2438
2725
|
#
|
2439
2726
|
# For example, for an Amazon Elastic Compute Cloud (EC2) instance,
|
2440
2727
|
# `PhysicalResourceId` corresponds to the `InstanceId`. You can pass the
|
@@ -2467,7 +2754,7 @@ module Aws::CloudFormation
|
|
2467
2754
|
# resp.stack_resources[0].physical_resource_id #=> String
|
2468
2755
|
# resp.stack_resources[0].resource_type #=> String
|
2469
2756
|
# resp.stack_resources[0].timestamp #=> Time
|
2470
|
-
# resp.stack_resources[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
2757
|
+
# resp.stack_resources[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
|
2471
2758
|
# resp.stack_resources[0].resource_status_reason #=> String
|
2472
2759
|
# resp.stack_resources[0].description #=> String
|
2473
2760
|
# resp.stack_resources[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
@@ -2502,9 +2789,10 @@ module Aws::CloudFormation
|
|
2502
2789
|
# * If you are signed in to a delegated administrator account, specify
|
2503
2790
|
# `DELEGATED_ADMIN`.
|
2504
2791
|
#
|
2505
|
-
# Your
|
2506
|
-
# the management account. For more information, see
|
2507
|
-
# delegated administrator][1] in the *
|
2792
|
+
# Your Amazon Web Services account must be registered as a delegated
|
2793
|
+
# administrator in the management account. For more information, see
|
2794
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
2795
|
+
# Guide*.
|
2508
2796
|
#
|
2509
2797
|
#
|
2510
2798
|
#
|
@@ -2586,9 +2874,10 @@ module Aws::CloudFormation
|
|
2586
2874
|
# * If you are signed in to a delegated administrator account, specify
|
2587
2875
|
# `DELEGATED_ADMIN`.
|
2588
2876
|
#
|
2589
|
-
# Your
|
2590
|
-
# the management account. For more information, see
|
2591
|
-
# delegated administrator][1] in the *
|
2877
|
+
# Your Amazon Web Services account must be registered as a delegated
|
2878
|
+
# administrator in the management account. For more information, see
|
2879
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
2880
|
+
# Guide*.
|
2592
2881
|
#
|
2593
2882
|
#
|
2594
2883
|
#
|
@@ -2703,7 +2992,7 @@ module Aws::CloudFormation
|
|
2703
2992
|
# resp.stacks[0].rollback_configuration.rollback_triggers[0].arn #=> String
|
2704
2993
|
# resp.stacks[0].rollback_configuration.rollback_triggers[0].type #=> String
|
2705
2994
|
# resp.stacks[0].rollback_configuration.monitoring_time_in_minutes #=> Integer
|
2706
|
-
# resp.stacks[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
2995
|
+
# resp.stacks[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
2707
2996
|
# resp.stacks[0].stack_status_reason #=> String
|
2708
2997
|
# resp.stacks[0].disable_rollback #=> Boolean
|
2709
2998
|
# resp.stacks[0].notification_arns #=> Array
|
@@ -2777,6 +3066,14 @@ module Aws::CloudFormation
|
|
2777
3066
|
# that specific extension version. Otherwise, it returns information
|
2778
3067
|
# about the default extension version.
|
2779
3068
|
#
|
3069
|
+
# @option params [String] :publisher_id
|
3070
|
+
# The publisher ID of the extension publisher.
|
3071
|
+
#
|
3072
|
+
# Extensions provided by Amazon are not assigned a publisher ID.
|
3073
|
+
#
|
3074
|
+
# @option params [String] :public_version_number
|
3075
|
+
# The version number of a public third-party extension.
|
3076
|
+
#
|
2780
3077
|
# @return [Types::DescribeTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2781
3078
|
#
|
2782
3079
|
# * {Types::DescribeTypeOutput#arn #arn} => String
|
@@ -2784,17 +3081,28 @@ module Aws::CloudFormation
|
|
2784
3081
|
# * {Types::DescribeTypeOutput#type_name #type_name} => String
|
2785
3082
|
# * {Types::DescribeTypeOutput#default_version_id #default_version_id} => String
|
2786
3083
|
# * {Types::DescribeTypeOutput#is_default_version #is_default_version} => Boolean
|
3084
|
+
# * {Types::DescribeTypeOutput#type_tests_status #type_tests_status} => String
|
3085
|
+
# * {Types::DescribeTypeOutput#type_tests_status_description #type_tests_status_description} => String
|
2787
3086
|
# * {Types::DescribeTypeOutput#description #description} => String
|
2788
3087
|
# * {Types::DescribeTypeOutput#schema #schema} => String
|
2789
3088
|
# * {Types::DescribeTypeOutput#provisioning_type #provisioning_type} => String
|
2790
3089
|
# * {Types::DescribeTypeOutput#deprecated_status #deprecated_status} => String
|
2791
3090
|
# * {Types::DescribeTypeOutput#logging_config #logging_config} => Types::LoggingConfig
|
3091
|
+
# * {Types::DescribeTypeOutput#required_activated_types #required_activated_types} => Array<Types::RequiredActivatedType>
|
2792
3092
|
# * {Types::DescribeTypeOutput#execution_role_arn #execution_role_arn} => String
|
2793
3093
|
# * {Types::DescribeTypeOutput#visibility #visibility} => String
|
2794
3094
|
# * {Types::DescribeTypeOutput#source_url #source_url} => String
|
2795
3095
|
# * {Types::DescribeTypeOutput#documentation_url #documentation_url} => String
|
2796
3096
|
# * {Types::DescribeTypeOutput#last_updated #last_updated} => Time
|
2797
3097
|
# * {Types::DescribeTypeOutput#time_created #time_created} => Time
|
3098
|
+
# * {Types::DescribeTypeOutput#configuration_schema #configuration_schema} => String
|
3099
|
+
# * {Types::DescribeTypeOutput#publisher_id #publisher_id} => String
|
3100
|
+
# * {Types::DescribeTypeOutput#original_type_name #original_type_name} => String
|
3101
|
+
# * {Types::DescribeTypeOutput#original_type_arn #original_type_arn} => String
|
3102
|
+
# * {Types::DescribeTypeOutput#public_version_number #public_version_number} => String
|
3103
|
+
# * {Types::DescribeTypeOutput#latest_public_version #latest_public_version} => String
|
3104
|
+
# * {Types::DescribeTypeOutput#is_activated #is_activated} => Boolean
|
3105
|
+
# * {Types::DescribeTypeOutput#auto_update #auto_update} => Boolean
|
2798
3106
|
#
|
2799
3107
|
# @example Request syntax with placeholder values
|
2800
3108
|
#
|
@@ -2803,6 +3111,8 @@ module Aws::CloudFormation
|
|
2803
3111
|
# type_name: "TypeName",
|
2804
3112
|
# arn: "TypeArn",
|
2805
3113
|
# version_id: "TypeVersionId",
|
3114
|
+
# publisher_id: "PublisherId",
|
3115
|
+
# public_version_number: "PublicVersionNumber",
|
2806
3116
|
# })
|
2807
3117
|
#
|
2808
3118
|
# @example Response structure
|
@@ -2812,18 +3122,34 @@ module Aws::CloudFormation
|
|
2812
3122
|
# resp.type_name #=> String
|
2813
3123
|
# resp.default_version_id #=> String
|
2814
3124
|
# resp.is_default_version #=> Boolean
|
3125
|
+
# resp.type_tests_status #=> String, one of "PASSED", "FAILED", "IN_PROGRESS", "NOT_TESTED"
|
3126
|
+
# resp.type_tests_status_description #=> String
|
2815
3127
|
# resp.description #=> String
|
2816
3128
|
# resp.schema #=> String
|
2817
3129
|
# resp.provisioning_type #=> String, one of "NON_PROVISIONABLE", "IMMUTABLE", "FULLY_MUTABLE"
|
2818
3130
|
# resp.deprecated_status #=> String, one of "LIVE", "DEPRECATED"
|
2819
3131
|
# resp.logging_config.log_role_arn #=> String
|
2820
3132
|
# resp.logging_config.log_group_name #=> String
|
3133
|
+
# resp.required_activated_types #=> Array
|
3134
|
+
# resp.required_activated_types[0].type_name_alias #=> String
|
3135
|
+
# resp.required_activated_types[0].original_type_name #=> String
|
3136
|
+
# resp.required_activated_types[0].publisher_id #=> String
|
3137
|
+
# resp.required_activated_types[0].supported_major_versions #=> Array
|
3138
|
+
# resp.required_activated_types[0].supported_major_versions[0] #=> Integer
|
2821
3139
|
# resp.execution_role_arn #=> String
|
2822
3140
|
# resp.visibility #=> String, one of "PUBLIC", "PRIVATE"
|
2823
3141
|
# resp.source_url #=> String
|
2824
3142
|
# resp.documentation_url #=> String
|
2825
3143
|
# resp.last_updated #=> Time
|
2826
3144
|
# resp.time_created #=> Time
|
3145
|
+
# resp.configuration_schema #=> String
|
3146
|
+
# resp.publisher_id #=> String
|
3147
|
+
# resp.original_type_name #=> String
|
3148
|
+
# resp.original_type_arn #=> String
|
3149
|
+
# resp.public_version_number #=> String
|
3150
|
+
# resp.latest_public_version #=> String
|
3151
|
+
# resp.is_activated #=> Boolean
|
3152
|
+
# resp.auto_update #=> Boolean
|
2827
3153
|
#
|
2828
3154
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeType AWS API Documentation
|
2829
3155
|
#
|
@@ -2887,14 +3213,13 @@ module Aws::CloudFormation
|
|
2887
3213
|
# Detects whether a stack's actual configuration differs, or has
|
2888
3214
|
# *drifted*, from it's expected configuration, as defined in the stack
|
2889
3215
|
# template and any values specified as template parameters. For each
|
2890
|
-
# resource in the stack that supports drift detection,
|
2891
|
-
#
|
2892
|
-
#
|
2893
|
-
#
|
2894
|
-
#
|
2895
|
-
#
|
2896
|
-
#
|
2897
|
-
# Stacks and Resources][1].
|
3216
|
+
# resource in the stack that supports drift detection, CloudFormation
|
3217
|
+
# compares the actual configuration of the resource with its expected
|
3218
|
+
# template configuration. Only resource properties explicitly defined in
|
3219
|
+
# the stack template are checked for drift. A stack is considered to
|
3220
|
+
# have drifted if one or more of its resources differ from their
|
3221
|
+
# expected template configurations. For more information, see [Detecting
|
3222
|
+
# Unregulated Configuration Changes to Stacks and Resources][1].
|
2898
3223
|
#
|
2899
3224
|
# Use `DetectStackDrift` to detect drift on all supported resources for
|
2900
3225
|
# a given stack, or DetectStackResourceDrift to detect drift on
|
@@ -2910,8 +3235,8 @@ module Aws::CloudFormation
|
|
2910
3235
|
# completed, use DescribeStackResourceDrifts to return drift information
|
2911
3236
|
# about the stack and its resources.
|
2912
3237
|
#
|
2913
|
-
# When detecting drift on a stack,
|
2914
|
-
#
|
3238
|
+
# When detecting drift on a stack, CloudFormation does not detect drift
|
3239
|
+
# on any nested stacks belonging to that stack. Perform
|
2915
3240
|
# `DetectStackDrift` directly on the nested stack itself.
|
2916
3241
|
#
|
2917
3242
|
#
|
@@ -2953,7 +3278,7 @@ module Aws::CloudFormation
|
|
2953
3278
|
# differs, or has *drifted*, from it's expected configuration, as
|
2954
3279
|
# defined in the stack template and any values specified as template
|
2955
3280
|
# parameters. This information includes actual and expected property
|
2956
|
-
# values for resources in which
|
3281
|
+
# values for resources in which CloudFormation detects drift. Only
|
2957
3282
|
# resource properties explicitly defined in the stack template are
|
2958
3283
|
# checked for drift. For more information about stack and resource
|
2959
3284
|
# drift, see [Detecting Unregulated Configuration Changes to Stacks and
|
@@ -3067,8 +3392,8 @@ module Aws::CloudFormation
|
|
3067
3392
|
# operation.
|
3068
3393
|
#
|
3069
3394
|
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
3070
|
-
# The user-specified preferences for how
|
3071
|
-
#
|
3395
|
+
# The user-specified preferences for how CloudFormation performs a stack
|
3396
|
+
# set operation.
|
3072
3397
|
#
|
3073
3398
|
# For more information on maximum concurrent accounts and failure
|
3074
3399
|
# tolerance, see [Stack set operation options][1].
|
@@ -3096,9 +3421,10 @@ module Aws::CloudFormation
|
|
3096
3421
|
# * If you are signed in to a delegated administrator account, specify
|
3097
3422
|
# `DELEGATED_ADMIN`.
|
3098
3423
|
#
|
3099
|
-
# Your
|
3100
|
-
# the management account. For more information, see
|
3101
|
-
# delegated administrator][1] in the *
|
3424
|
+
# Your Amazon Web Services account must be registered as a delegated
|
3425
|
+
# administrator in the management account. For more information, see
|
3426
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
3427
|
+
# Guide*.
|
3102
3428
|
#
|
3103
3429
|
#
|
3104
3430
|
#
|
@@ -3138,13 +3464,13 @@ module Aws::CloudFormation
|
|
3138
3464
|
end
|
3139
3465
|
|
3140
3466
|
# Returns the estimated monthly cost of a template. The return value is
|
3141
|
-
# an
|
3142
|
-
# describes the resources required to run the template.
|
3467
|
+
# an Amazon Web Services Simple Monthly Calculator URL with a query
|
3468
|
+
# string that describes the resources required to run the template.
|
3143
3469
|
#
|
3144
3470
|
# @option params [String] :template_body
|
3145
3471
|
# Structure containing the template body with a minimum length of 1 byte
|
3146
3472
|
# and a maximum length of 51,200 bytes. (For more information, go to
|
3147
|
-
# [Template Anatomy][1] in the
|
3473
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.)
|
3148
3474
|
#
|
3149
3475
|
# Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
|
3150
3476
|
# are passed, only `TemplateBody` is used.
|
@@ -3156,7 +3482,7 @@ module Aws::CloudFormation
|
|
3156
3482
|
# @option params [String] :template_url
|
3157
3483
|
# Location of file containing the template body. The URL must point to a
|
3158
3484
|
# template that is located in an Amazon S3 bucket or a Systems Manager
|
3159
|
-
# document. For more information, go to [Template Anatomy][1] in the
|
3485
|
+
# document. For more information, go to [Template Anatomy][1] in the
|
3160
3486
|
# CloudFormation User Guide.
|
3161
3487
|
#
|
3162
3488
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
@@ -3203,14 +3529,14 @@ module Aws::CloudFormation
|
|
3203
3529
|
|
3204
3530
|
# Updates a stack using the input information that was provided when the
|
3205
3531
|
# specified change set was created. After the call successfully
|
3206
|
-
# completes,
|
3532
|
+
# completes, CloudFormation starts updating the stack. Use the
|
3207
3533
|
# DescribeStacks action to view the status of the update.
|
3208
3534
|
#
|
3209
|
-
# When you execute a change set,
|
3210
|
-
#
|
3211
|
-
#
|
3535
|
+
# When you execute a change set, CloudFormation deletes all other change
|
3536
|
+
# sets associated with the stack because they aren't valid for the
|
3537
|
+
# updated stack.
|
3212
3538
|
#
|
3213
|
-
# If a stack policy is associated with the stack,
|
3539
|
+
# If a stack policy is associated with the stack, CloudFormation
|
3214
3540
|
# enforces the policy during the update. You can't specify a temporary
|
3215
3541
|
# stack policy that overrides the current policy.
|
3216
3542
|
#
|
@@ -3227,10 +3553,16 @@ module Aws::CloudFormation
|
|
3227
3553
|
#
|
3228
3554
|
# @option params [String] :client_request_token
|
3229
3555
|
# A unique identifier for this `ExecuteChangeSet` request. Specify this
|
3230
|
-
# token if you plan to retry requests so that
|
3231
|
-
#
|
3232
|
-
#
|
3233
|
-
#
|
3556
|
+
# token if you plan to retry requests so that CloudFormation knows that
|
3557
|
+
# you're not attempting to execute a change set to update a stack with
|
3558
|
+
# the same name. You might retry `ExecuteChangeSet` requests to ensure
|
3559
|
+
# that CloudFormation successfully received them.
|
3560
|
+
#
|
3561
|
+
# @option params [Boolean] :disable_rollback
|
3562
|
+
# Preserves the state of previously provisioned resources when an
|
3563
|
+
# operation fails.
|
3564
|
+
#
|
3565
|
+
# Default: `True`
|
3234
3566
|
#
|
3235
3567
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3236
3568
|
#
|
@@ -3240,6 +3572,7 @@ module Aws::CloudFormation
|
|
3240
3572
|
# change_set_name: "ChangeSetNameOrId", # required
|
3241
3573
|
# stack_name: "StackNameOrId",
|
3242
3574
|
# client_request_token: "ClientRequestToken",
|
3575
|
+
# disable_rollback: false,
|
3243
3576
|
# })
|
3244
3577
|
#
|
3245
3578
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSet AWS API Documentation
|
@@ -3303,19 +3636,19 @@ module Aws::CloudFormation
|
|
3303
3636
|
# Default: There is no default value.
|
3304
3637
|
#
|
3305
3638
|
# @option params [String] :change_set_name
|
3306
|
-
# The name or Amazon Resource Name (ARN) of a change set for which
|
3639
|
+
# The name or Amazon Resource Name (ARN) of a change set for which
|
3307
3640
|
# CloudFormation returns the associated template. If you specify a name,
|
3308
3641
|
# you must also specify the `StackName`.
|
3309
3642
|
#
|
3310
3643
|
# @option params [String] :template_stage
|
3311
3644
|
# For templates that include transforms, the stage of the template that
|
3312
|
-
#
|
3313
|
-
#
|
3314
|
-
#
|
3645
|
+
# CloudFormation returns. To get the user-submitted template, specify
|
3646
|
+
# `Original`. To get the template after CloudFormation has processed all
|
3647
|
+
# transforms, specify `Processed`.
|
3315
3648
|
#
|
3316
3649
|
# If the template doesn't include transforms, `Original` and
|
3317
|
-
# `Processed` return the same template. By default,
|
3318
|
-
# specifies `
|
3650
|
+
# `Processed` return the same template. By default, CloudFormation
|
3651
|
+
# specifies `Processed`.
|
3319
3652
|
#
|
3320
3653
|
# @return [Types::GetTemplateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3321
3654
|
#
|
@@ -3361,8 +3694,7 @@ module Aws::CloudFormation
|
|
3361
3694
|
# @option params [String] :template_body
|
3362
3695
|
# Structure containing the template body with a minimum length of 1 byte
|
3363
3696
|
# and a maximum length of 51,200 bytes. For more information about
|
3364
|
-
# templates, see [Template Anatomy][1] in the
|
3365
|
-
# Guide.
|
3697
|
+
# templates, see [Template Anatomy][1] in the CloudFormation User Guide.
|
3366
3698
|
#
|
3367
3699
|
# Conditional: You must specify only one of the following parameters:
|
3368
3700
|
# `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
|
@@ -3375,8 +3707,7 @@ module Aws::CloudFormation
|
|
3375
3707
|
# Location of file containing the template body. The URL must point to a
|
3376
3708
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
3377
3709
|
# bucket or a Systems Manager document. For more information about
|
3378
|
-
# templates, see [Template Anatomy][1] in the
|
3379
|
-
# Guide.
|
3710
|
+
# templates, see [Template Anatomy][1] in the CloudFormation User Guide.
|
3380
3711
|
#
|
3381
3712
|
# Conditional: You must specify only one of the following parameters:
|
3382
3713
|
# `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
|
@@ -3414,9 +3745,10 @@ module Aws::CloudFormation
|
|
3414
3745
|
# * If you are signed in to a delegated administrator account, specify
|
3415
3746
|
# `DELEGATED_ADMIN`.
|
3416
3747
|
#
|
3417
|
-
# Your
|
3418
|
-
# the management account. For more information, see
|
3419
|
-
# delegated administrator][1] in the *
|
3748
|
+
# Your Amazon Web Services account must be registered as a delegated
|
3749
|
+
# administrator in the management account. For more information, see
|
3750
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
3751
|
+
# Guide*.
|
3420
3752
|
#
|
3421
3753
|
#
|
3422
3754
|
#
|
@@ -3480,8 +3812,86 @@ module Aws::CloudFormation
|
|
3480
3812
|
req.send_request(options)
|
3481
3813
|
end
|
3482
3814
|
|
3815
|
+
# Import existing stacks into a new stack sets. Use the stack import
|
3816
|
+
# operation to import up to 10 stacks into a new stack set in the same
|
3817
|
+
# account as the source stack or in a different administrator account
|
3818
|
+
# and Region, by specifying the stack ID of the stack you intend to
|
3819
|
+
# import.
|
3820
|
+
#
|
3821
|
+
# <note markdown="1"> `ImportStacksToStackSet` is only supported by self-managed
|
3822
|
+
# permissions.
|
3823
|
+
#
|
3824
|
+
# </note>
|
3825
|
+
#
|
3826
|
+
# @option params [required, String] :stack_set_name
|
3827
|
+
# The name of the stack set. The name must be unique in the Region where
|
3828
|
+
# you create your stack set.
|
3829
|
+
#
|
3830
|
+
# @option params [required, Array<String>] :stack_ids
|
3831
|
+
# The IDs of the stacks you are importing into a stack set. You import
|
3832
|
+
# up to 10 stacks per stack set at a time.
|
3833
|
+
#
|
3834
|
+
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
3835
|
+
# The user-specified preferences for how CloudFormation performs a stack
|
3836
|
+
# set operation.
|
3837
|
+
#
|
3838
|
+
# For more information on maximum concurrent accounts and failure
|
3839
|
+
# tolerance, see [Stack set operation options][1].
|
3840
|
+
#
|
3841
|
+
#
|
3842
|
+
#
|
3843
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
|
3844
|
+
#
|
3845
|
+
# @option params [String] :operation_id
|
3846
|
+
# A unique, user defined, identifier for the stack set operation.
|
3847
|
+
#
|
3848
|
+
# **A suitable default value is auto-generated.** You should normally
|
3849
|
+
# not need to pass this option.**
|
3850
|
+
#
|
3851
|
+
# @option params [String] :call_as
|
3852
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3853
|
+
# self-managed permissions.
|
3854
|
+
#
|
3855
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3856
|
+
#
|
3857
|
+
# * For service managed stack sets, specify `DELEGATED_ADMIN`.
|
3858
|
+
#
|
3859
|
+
# @return [Types::ImportStacksToStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3860
|
+
#
|
3861
|
+
# * {Types::ImportStacksToStackSetOutput#operation_id #operation_id} => String
|
3862
|
+
#
|
3863
|
+
# @example Request syntax with placeholder values
|
3864
|
+
#
|
3865
|
+
# resp = client.import_stacks_to_stack_set({
|
3866
|
+
# stack_set_name: "StackSetNameOrId", # required
|
3867
|
+
# stack_ids: ["StackId"], # required
|
3868
|
+
# operation_preferences: {
|
3869
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
3870
|
+
# region_order: ["Region"],
|
3871
|
+
# failure_tolerance_count: 1,
|
3872
|
+
# failure_tolerance_percentage: 1,
|
3873
|
+
# max_concurrent_count: 1,
|
3874
|
+
# max_concurrent_percentage: 1,
|
3875
|
+
# },
|
3876
|
+
# operation_id: "ClientRequestToken",
|
3877
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
3878
|
+
# })
|
3879
|
+
#
|
3880
|
+
# @example Response structure
|
3881
|
+
#
|
3882
|
+
# resp.operation_id #=> String
|
3883
|
+
#
|
3884
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSet AWS API Documentation
|
3885
|
+
#
|
3886
|
+
# @overload import_stacks_to_stack_set(params = {})
|
3887
|
+
# @param [Hash] params ({})
|
3888
|
+
def import_stacks_to_stack_set(params = {}, options = {})
|
3889
|
+
req = build_request(:import_stacks_to_stack_set, params)
|
3890
|
+
req.send_request(options)
|
3891
|
+
end
|
3892
|
+
|
3483
3893
|
# Returns the ID and status of each active change set for a stack. For
|
3484
|
-
# example,
|
3894
|
+
# example, CloudFormation lists change sets that are in the
|
3485
3895
|
# `CREATE_IN_PROGRESS` or `CREATE_PENDING` state.
|
3486
3896
|
#
|
3487
3897
|
# @option params [required, String] :stack_name
|
@@ -3537,7 +3947,7 @@ module Aws::CloudFormation
|
|
3537
3947
|
# values that you can import into other stacks. To import values, use
|
3538
3948
|
# the [ `Fn::ImportValue` ][1] function.
|
3539
3949
|
#
|
3540
|
-
# For more information, see [
|
3950
|
+
# For more information, see [ CloudFormation Export Stack Output
|
3541
3951
|
# Values][2].
|
3542
3952
|
#
|
3543
3953
|
#
|
@@ -3592,7 +4002,7 @@ module Aws::CloudFormation
|
|
3592
4002
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html
|
3593
4003
|
#
|
3594
4004
|
# @option params [required, String] :export_name
|
3595
|
-
# The name of the exported output value.
|
4005
|
+
# The name of the exported output value. CloudFormation returns the
|
3596
4006
|
# stack names that are importing this value.
|
3597
4007
|
#
|
3598
4008
|
# @option params [String] :next_token
|
@@ -3631,8 +4041,8 @@ module Aws::CloudFormation
|
|
3631
4041
|
|
3632
4042
|
# Returns summary information about stack instances that are associated
|
3633
4043
|
# with the specified stack set. You can filter for stack instances that
|
3634
|
-
# are associated with a specific
|
3635
|
-
# have a specific status.
|
4044
|
+
# are associated with a specific Amazon Web Services account name or
|
4045
|
+
# Region, or that have a specific status.
|
3636
4046
|
#
|
3637
4047
|
# @option params [required, String] :stack_set_name
|
3638
4048
|
# The name or unique ID of the stack set that you want to list stack
|
@@ -3656,7 +4066,8 @@ module Aws::CloudFormation
|
|
3656
4066
|
# The status that stack instances are filtered by.
|
3657
4067
|
#
|
3658
4068
|
# @option params [String] :stack_instance_account
|
3659
|
-
# The name of the
|
4069
|
+
# The name of the Amazon Web Services account that you want to list
|
4070
|
+
# stack instances for.
|
3660
4071
|
#
|
3661
4072
|
# @option params [String] :stack_instance_region
|
3662
4073
|
# The name of the Region where you want to list stack instances.
|
@@ -3674,9 +4085,10 @@ module Aws::CloudFormation
|
|
3674
4085
|
# * If you are signed in to a delegated administrator account, specify
|
3675
4086
|
# `DELEGATED_ADMIN`.
|
3676
4087
|
#
|
3677
|
-
# Your
|
3678
|
-
# the management account. For more information, see
|
3679
|
-
# delegated administrator][1] in the *
|
4088
|
+
# Your Amazon Web Services account must be registered as a delegated
|
4089
|
+
# administrator in the management account. For more information, see
|
4090
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
4091
|
+
# Guide*.
|
3680
4092
|
#
|
3681
4093
|
#
|
3682
4094
|
#
|
@@ -3771,7 +4183,7 @@ module Aws::CloudFormation
|
|
3771
4183
|
# resp.stack_resource_summaries[0].physical_resource_id #=> String
|
3772
4184
|
# resp.stack_resource_summaries[0].resource_type #=> String
|
3773
4185
|
# resp.stack_resource_summaries[0].last_updated_timestamp #=> Time
|
3774
|
-
# resp.stack_resource_summaries[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
4186
|
+
# resp.stack_resource_summaries[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
|
3775
4187
|
# resp.stack_resource_summaries[0].resource_status_reason #=> String
|
3776
4188
|
# resp.stack_resource_summaries[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
3777
4189
|
# resp.stack_resource_summaries[0].drift_information.last_check_timestamp #=> Time
|
@@ -3826,9 +4238,10 @@ module Aws::CloudFormation
|
|
3826
4238
|
# * If you are signed in to a delegated administrator account, specify
|
3827
4239
|
# `DELEGATED_ADMIN`.
|
3828
4240
|
#
|
3829
|
-
# Your
|
3830
|
-
# the management account. For more information, see
|
3831
|
-
# delegated administrator][1] in the *
|
4241
|
+
# Your Amazon Web Services account must be registered as a delegated
|
4242
|
+
# administrator in the management account. For more information, see
|
4243
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
4244
|
+
# Guide*.
|
3832
4245
|
#
|
3833
4246
|
#
|
3834
4247
|
#
|
@@ -3906,9 +4319,10 @@ module Aws::CloudFormation
|
|
3906
4319
|
# * If you are signed in to a delegated administrator account, specify
|
3907
4320
|
# `DELEGATED_ADMIN`.
|
3908
4321
|
#
|
3909
|
-
# Your
|
3910
|
-
# the management account. For more information, see
|
3911
|
-
# delegated administrator][1] in the *
|
4322
|
+
# Your Amazon Web Services account must be registered as a delegated
|
4323
|
+
# administrator in the management account. For more information, see
|
4324
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
4325
|
+
# Guide*.
|
3912
4326
|
#
|
3913
4327
|
#
|
3914
4328
|
#
|
@@ -3953,8 +4367,9 @@ module Aws::CloudFormation
|
|
3953
4367
|
# the user.
|
3954
4368
|
#
|
3955
4369
|
# * \[Self-managed permissions\] If you set the `CallAs` parameter to
|
3956
|
-
# `SELF` while signed in to your
|
3957
|
-
# all self-managed stack sets in your
|
4370
|
+
# `SELF` while signed in to your Amazon Web Services account,
|
4371
|
+
# `ListStackSets` returns all self-managed stack sets in your Amazon
|
4372
|
+
# Web Services account.
|
3958
4373
|
#
|
3959
4374
|
# * \[Service-managed permissions\] If you set the `CallAs` parameter to
|
3960
4375
|
# `SELF` while signed in to the organization's management account,
|
@@ -3996,9 +4411,10 @@ module Aws::CloudFormation
|
|
3996
4411
|
# * If you are signed in to a delegated administrator account, specify
|
3997
4412
|
# `DELEGATED_ADMIN`.
|
3998
4413
|
#
|
3999
|
-
# Your
|
4000
|
-
# the management account. For more information, see
|
4001
|
-
# delegated administrator][1] in the *
|
4414
|
+
# Your Amazon Web Services account must be registered as a delegated
|
4415
|
+
# administrator in the management account. For more information, see
|
4416
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
4417
|
+
# Guide*.
|
4002
4418
|
#
|
4003
4419
|
#
|
4004
4420
|
#
|
@@ -4071,7 +4487,7 @@ module Aws::CloudFormation
|
|
4071
4487
|
#
|
4072
4488
|
# resp = client.list_stacks({
|
4073
4489
|
# next_token: "NextToken",
|
4074
|
-
# stack_status_filter: ["CREATE_IN_PROGRESS"], # accepts CREATE_IN_PROGRESS, CREATE_FAILED, CREATE_COMPLETE, ROLLBACK_IN_PROGRESS, ROLLBACK_FAILED, ROLLBACK_COMPLETE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETE_COMPLETE, UPDATE_IN_PROGRESS, UPDATE_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_COMPLETE, UPDATE_ROLLBACK_IN_PROGRESS, UPDATE_ROLLBACK_FAILED, UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_ROLLBACK_COMPLETE, REVIEW_IN_PROGRESS, IMPORT_IN_PROGRESS, IMPORT_COMPLETE, IMPORT_ROLLBACK_IN_PROGRESS, IMPORT_ROLLBACK_FAILED, IMPORT_ROLLBACK_COMPLETE
|
4490
|
+
# stack_status_filter: ["CREATE_IN_PROGRESS"], # accepts CREATE_IN_PROGRESS, CREATE_FAILED, CREATE_COMPLETE, ROLLBACK_IN_PROGRESS, ROLLBACK_FAILED, ROLLBACK_COMPLETE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETE_COMPLETE, UPDATE_IN_PROGRESS, UPDATE_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_COMPLETE, UPDATE_FAILED, UPDATE_ROLLBACK_IN_PROGRESS, UPDATE_ROLLBACK_FAILED, UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_ROLLBACK_COMPLETE, REVIEW_IN_PROGRESS, IMPORT_IN_PROGRESS, IMPORT_COMPLETE, IMPORT_ROLLBACK_IN_PROGRESS, IMPORT_ROLLBACK_FAILED, IMPORT_ROLLBACK_COMPLETE
|
4075
4491
|
# })
|
4076
4492
|
#
|
4077
4493
|
# @example Response structure
|
@@ -4083,7 +4499,7 @@ module Aws::CloudFormation
|
|
4083
4499
|
# resp.stack_summaries[0].creation_time #=> Time
|
4084
4500
|
# resp.stack_summaries[0].last_updated_time #=> Time
|
4085
4501
|
# resp.stack_summaries[0].deletion_time #=> Time
|
4086
|
-
# resp.stack_summaries[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
4502
|
+
# resp.stack_summaries[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
|
4087
4503
|
# resp.stack_summaries[0].stack_status_reason #=> String
|
4088
4504
|
# resp.stack_summaries[0].parent_id #=> String
|
4089
4505
|
# resp.stack_summaries[0].root_id #=> String
|
@@ -4217,6 +4633,11 @@ module Aws::CloudFormation
|
|
4217
4633
|
#
|
4218
4634
|
# The default is `LIVE`.
|
4219
4635
|
#
|
4636
|
+
# @option params [String] :publisher_id
|
4637
|
+
# The publisher ID of the extension publisher.
|
4638
|
+
#
|
4639
|
+
# Extensions published by Amazon are not assigned a publisher ID.
|
4640
|
+
#
|
4220
4641
|
# @return [Types::ListTypeVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4221
4642
|
#
|
4222
4643
|
# * {Types::ListTypeVersionsOutput#type_version_summaries #type_version_summaries} => Array<Types::TypeVersionSummary>
|
@@ -4229,10 +4650,11 @@ module Aws::CloudFormation
|
|
4229
4650
|
# resp = client.list_type_versions({
|
4230
4651
|
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
4231
4652
|
# type_name: "TypeName",
|
4232
|
-
# arn: "
|
4653
|
+
# arn: "TypeArn",
|
4233
4654
|
# max_results: 1,
|
4234
4655
|
# next_token: "NextToken",
|
4235
4656
|
# deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
|
4657
|
+
# publisher_id: "PublisherId",
|
4236
4658
|
# })
|
4237
4659
|
#
|
4238
4660
|
# @example Response structure
|
@@ -4245,6 +4667,7 @@ module Aws::CloudFormation
|
|
4245
4667
|
# resp.type_version_summaries[0].arn #=> String
|
4246
4668
|
# resp.type_version_summaries[0].time_created #=> Time
|
4247
4669
|
# resp.type_version_summaries[0].description #=> String
|
4670
|
+
# resp.type_version_summaries[0].public_version_number #=> String
|
4248
4671
|
# resp.next_token #=> String
|
4249
4672
|
#
|
4250
4673
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeVersions AWS API Documentation
|
@@ -4260,36 +4683,45 @@ module Aws::CloudFormation
|
|
4260
4683
|
# with CloudFormation.
|
4261
4684
|
#
|
4262
4685
|
# @option params [String] :visibility
|
4263
|
-
# The scope at which the
|
4686
|
+
# The scope at which the extensions are visible and usable in
|
4264
4687
|
# CloudFormation operations.
|
4265
4688
|
#
|
4266
4689
|
# Valid values include:
|
4267
4690
|
#
|
4268
|
-
# * `PRIVATE`\:
|
4269
|
-
# account
|
4270
|
-
#
|
4691
|
+
# * `PRIVATE`\: Extensions that are visible and usable within this
|
4692
|
+
# account and region. This includes:
|
4693
|
+
#
|
4694
|
+
# * Private extensions you have registered in this account and region.
|
4271
4695
|
#
|
4272
|
-
#
|
4273
|
-
#
|
4696
|
+
# * Public extensions that you have activated in this account and
|
4697
|
+
# region.
|
4698
|
+
#
|
4699
|
+
# * `PUBLIC`\: Extensions that are publicly visible and available to be
|
4700
|
+
# activated within any Amazon account. This includes extensions from
|
4701
|
+
# Amazon, as well as third-party publishers.
|
4274
4702
|
#
|
4275
4703
|
# The default is `PRIVATE`.
|
4276
4704
|
#
|
4277
4705
|
# @option params [String] :provisioning_type
|
4278
|
-
#
|
4279
|
-
# the provisioning type during registration,
|
4280
|
-
# handlers in the schema handler package
|
4706
|
+
# For resource types, the provisioning behavior of the resource type.
|
4707
|
+
# CloudFormation determines the provisioning type during registration,
|
4708
|
+
# based on the types of handlers in the schema handler package
|
4709
|
+
# submitted.
|
4281
4710
|
#
|
4282
4711
|
# Valid values include:
|
4283
4712
|
#
|
4284
|
-
# * `FULLY_MUTABLE`\: The
|
4285
|
-
# process updates to the
|
4713
|
+
# * `FULLY_MUTABLE`\: The resource type includes an update handler to
|
4714
|
+
# process updates to the type during stack update operations.
|
4286
4715
|
#
|
4287
|
-
# * `IMMUTABLE`\: The
|
4288
|
-
# the
|
4716
|
+
# * `IMMUTABLE`\: The resource type does not include an update handler,
|
4717
|
+
# so the type cannot be updated and must instead be replaced during
|
4289
4718
|
# stack update operations.
|
4290
4719
|
#
|
4291
|
-
# * `NON_PROVISIONABLE`\: The
|
4292
|
-
# and delete handlers, and therefore cannot actually be
|
4720
|
+
# * `NON_PROVISIONABLE`\: The resource type does not include create,
|
4721
|
+
# read, and delete handlers, and therefore cannot actually be
|
4722
|
+
# provisioned.
|
4723
|
+
#
|
4724
|
+
# The default is `FULLY_MUTABLE`.
|
4293
4725
|
#
|
4294
4726
|
# @option params [String] :deprecated_status
|
4295
4727
|
# The deprecation status of the extension that you want to get summary
|
@@ -4306,6 +4738,12 @@ module Aws::CloudFormation
|
|
4306
4738
|
# @option params [String] :type
|
4307
4739
|
# The type of extension.
|
4308
4740
|
#
|
4741
|
+
# @option params [Types::TypeFilters] :filters
|
4742
|
+
# Filter criteria to use in determining which extensions to return.
|
4743
|
+
#
|
4744
|
+
# If you specify a filter, CloudFormation ignores any specified
|
4745
|
+
# `Visibility` value when returning the list of types.
|
4746
|
+
#
|
4309
4747
|
# @option params [Integer] :max_results
|
4310
4748
|
# The maximum number of results to be returned with a single call. If
|
4311
4749
|
# the number of available results exceeds this maximum, the response
|
@@ -4334,6 +4772,11 @@ module Aws::CloudFormation
|
|
4334
4772
|
# provisioning_type: "NON_PROVISIONABLE", # accepts NON_PROVISIONABLE, IMMUTABLE, FULLY_MUTABLE
|
4335
4773
|
# deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
|
4336
4774
|
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
4775
|
+
# filters: {
|
4776
|
+
# category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
|
4777
|
+
# publisher_id: "PublisherId",
|
4778
|
+
# type_name_prefix: "TypeNamePrefix",
|
4779
|
+
# },
|
4337
4780
|
# max_results: 1,
|
4338
4781
|
# next_token: "NextToken",
|
4339
4782
|
# })
|
@@ -4347,6 +4790,13 @@ module Aws::CloudFormation
|
|
4347
4790
|
# resp.type_summaries[0].type_arn #=> String
|
4348
4791
|
# resp.type_summaries[0].last_updated #=> Time
|
4349
4792
|
# resp.type_summaries[0].description #=> String
|
4793
|
+
# resp.type_summaries[0].publisher_id #=> String
|
4794
|
+
# resp.type_summaries[0].original_type_name #=> String
|
4795
|
+
# resp.type_summaries[0].public_version_number #=> String
|
4796
|
+
# resp.type_summaries[0].latest_public_version #=> String
|
4797
|
+
# resp.type_summaries[0].publisher_identity #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
|
4798
|
+
# resp.type_summaries[0].publisher_name #=> String
|
4799
|
+
# resp.type_summaries[0].is_activated #=> Boolean
|
4350
4800
|
# resp.next_token #=> String
|
4351
4801
|
#
|
4352
4802
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypes AWS API Documentation
|
@@ -4358,6 +4808,81 @@ module Aws::CloudFormation
|
|
4358
4808
|
req.send_request(options)
|
4359
4809
|
end
|
4360
4810
|
|
4811
|
+
# Publishes the specified extension to the CloudFormation registry as a
|
4812
|
+
# public extension in this region. Public extensions are available for
|
4813
|
+
# use by all CloudFormation users. For more information on publishing
|
4814
|
+
# extensions, see [Publishing extensions to make them available for
|
4815
|
+
# public use][1] in the *CloudFormation CLI User Guide*.
|
4816
|
+
#
|
4817
|
+
# To publish an extension, you must be registered as a publisher with
|
4818
|
+
# CloudFormation. For more information, see [RegisterPublisher][2].
|
4819
|
+
#
|
4820
|
+
#
|
4821
|
+
#
|
4822
|
+
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
|
4823
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
|
4824
|
+
#
|
4825
|
+
# @option params [String] :type
|
4826
|
+
# The type of the extension.
|
4827
|
+
#
|
4828
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
4829
|
+
#
|
4830
|
+
# @option params [String] :arn
|
4831
|
+
# The Amazon Resource Number (ARN) of the extension.
|
4832
|
+
#
|
4833
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
4834
|
+
#
|
4835
|
+
# @option params [String] :type_name
|
4836
|
+
# The name of the extension.
|
4837
|
+
#
|
4838
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
4839
|
+
#
|
4840
|
+
# @option params [String] :public_version_number
|
4841
|
+
# The version number to assign to this version of the extension.
|
4842
|
+
#
|
4843
|
+
# Use the following format, and adhere to semantic versioning when
|
4844
|
+
# assigning a version number to your extension:
|
4845
|
+
#
|
4846
|
+
# `MAJOR.MINOR.PATCH`
|
4847
|
+
#
|
4848
|
+
# For more information, see [Semantic Versioning 2.0.0][1].
|
4849
|
+
#
|
4850
|
+
# If you do not specify a version number, CloudFormation increments the
|
4851
|
+
# version number by one minor version release.
|
4852
|
+
#
|
4853
|
+
# The first time you publish a type, CloudFormation sets the version
|
4854
|
+
# number to `1.0.0`, regardless of the value you specify.
|
4855
|
+
#
|
4856
|
+
#
|
4857
|
+
#
|
4858
|
+
# [1]: https://semver.org/
|
4859
|
+
#
|
4860
|
+
# @return [Types::PublishTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4861
|
+
#
|
4862
|
+
# * {Types::PublishTypeOutput#public_type_arn #public_type_arn} => String
|
4863
|
+
#
|
4864
|
+
# @example Request syntax with placeholder values
|
4865
|
+
#
|
4866
|
+
# resp = client.publish_type({
|
4867
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
4868
|
+
# arn: "PrivateTypeArn",
|
4869
|
+
# type_name: "TypeName",
|
4870
|
+
# public_version_number: "PublicVersionNumber",
|
4871
|
+
# })
|
4872
|
+
#
|
4873
|
+
# @example Response structure
|
4874
|
+
#
|
4875
|
+
# resp.public_type_arn #=> String
|
4876
|
+
#
|
4877
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/PublishType AWS API Documentation
|
4878
|
+
#
|
4879
|
+
# @overload publish_type(params = {})
|
4880
|
+
# @param [Hash] params ({})
|
4881
|
+
def publish_type(params = {}, options = {})
|
4882
|
+
req = build_request(:publish_type, params)
|
4883
|
+
req.send_request(options)
|
4884
|
+
end
|
4885
|
+
|
4361
4886
|
# Reports progress of a resource handler to CloudFormation.
|
4362
4887
|
#
|
4363
4888
|
# Reserved for use by the [CloudFormation CLI][1]. Do not use this API
|
@@ -4425,7 +4950,7 @@ module Aws::CloudFormation
|
|
4425
4950
|
# operation_status: "PENDING", # required, accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
|
4426
4951
|
# current_operation_status: "PENDING", # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
|
4427
4952
|
# status_message: "StatusMessage",
|
4428
|
-
# error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure
|
4953
|
+
# error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure, InvalidTypeConfiguration
|
4429
4954
|
# resource_model: "ResourceModel",
|
4430
4955
|
# client_request_token: "ClientRequestToken",
|
4431
4956
|
# })
|
@@ -4439,9 +4964,72 @@ module Aws::CloudFormation
|
|
4439
4964
|
req.send_request(options)
|
4440
4965
|
end
|
4441
4966
|
|
4967
|
+
# Registers your account as a publisher of public extensions in the
|
4968
|
+
# CloudFormation registry. Public extensions are available for use by
|
4969
|
+
# all CloudFormation users. This publisher ID applies to your account in
|
4970
|
+
# all Amazon Web Services Regions.
|
4971
|
+
#
|
4972
|
+
# For information on requirements for registering as a public extension
|
4973
|
+
# publisher, see [Registering your account to publish CloudFormation
|
4974
|
+
# extensions][1] in the *CloudFormation CLI User Guide*.
|
4975
|
+
#
|
4976
|
+
#
|
4977
|
+
#
|
4978
|
+
#
|
4979
|
+
#
|
4980
|
+
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
|
4981
|
+
#
|
4982
|
+
# @option params [Boolean] :accept_terms_and_conditions
|
4983
|
+
# Whether you accept the [Terms and Conditions][1] for publishing
|
4984
|
+
# extensions in the CloudFormation registry. You must accept the terms
|
4985
|
+
# and conditions in order to register to publish public extensions to
|
4986
|
+
# the CloudFormation registry.
|
4987
|
+
#
|
4988
|
+
# The default is `false`.
|
4989
|
+
#
|
4990
|
+
#
|
4991
|
+
#
|
4992
|
+
# [1]: https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf
|
4993
|
+
#
|
4994
|
+
# @option params [String] :connection_arn
|
4995
|
+
# If you are using a Bitbucket or GitHub account for identity
|
4996
|
+
# verification, the Amazon Resource Name (ARN) for your connection to
|
4997
|
+
# that account.
|
4998
|
+
#
|
4999
|
+
# For more information, see [Registering your account to publish
|
5000
|
+
# CloudFormation extensions][1] in the *CloudFormation CLI User Guide*.
|
5001
|
+
#
|
5002
|
+
#
|
5003
|
+
#
|
5004
|
+
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
|
5005
|
+
#
|
5006
|
+
# @return [Types::RegisterPublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5007
|
+
#
|
5008
|
+
# * {Types::RegisterPublisherOutput#publisher_id #publisher_id} => String
|
5009
|
+
#
|
5010
|
+
# @example Request syntax with placeholder values
|
5011
|
+
#
|
5012
|
+
# resp = client.register_publisher({
|
5013
|
+
# accept_terms_and_conditions: false,
|
5014
|
+
# connection_arn: "ConnectionArn",
|
5015
|
+
# })
|
5016
|
+
#
|
5017
|
+
# @example Response structure
|
5018
|
+
#
|
5019
|
+
# resp.publisher_id #=> String
|
5020
|
+
#
|
5021
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterPublisher AWS API Documentation
|
5022
|
+
#
|
5023
|
+
# @overload register_publisher(params = {})
|
5024
|
+
# @param [Hash] params ({})
|
5025
|
+
def register_publisher(params = {}, options = {})
|
5026
|
+
req = build_request(:register_publisher, params)
|
5027
|
+
req.send_request(options)
|
5028
|
+
end
|
5029
|
+
|
4442
5030
|
# Registers an extension with the CloudFormation service. Registering an
|
4443
5031
|
# extension makes it available for use in CloudFormation templates in
|
4444
|
-
# your
|
5032
|
+
# your Amazon Web Services account, and includes:
|
4445
5033
|
#
|
4446
5034
|
# * Validating the extension schema
|
4447
5035
|
#
|
@@ -4463,9 +5051,17 @@ module Aws::CloudFormation
|
|
4463
5051
|
# you can use ` DescribeTypeRegistration ` to monitor the progress of
|
4464
5052
|
# the registration request.
|
4465
5053
|
#
|
5054
|
+
# Once you have registered a private extension in your account and
|
5055
|
+
# region, use
|
5056
|
+
# [SetTypeConfiguration](AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html)
|
5057
|
+
# to specify configuration properties for the extension. For more
|
5058
|
+
# information, see [Configuring extensions at the account level][2] in
|
5059
|
+
# the *CloudFormation User Guide*.
|
5060
|
+
#
|
4466
5061
|
#
|
4467
5062
|
#
|
4468
5063
|
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
|
5064
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
|
4469
5065
|
#
|
4470
5066
|
# @option params [String] :type
|
4471
5067
|
# The kind of extension.
|
@@ -4473,8 +5069,13 @@ module Aws::CloudFormation
|
|
4473
5069
|
# @option params [required, String] :type_name
|
4474
5070
|
# The name of the extension being registered.
|
4475
5071
|
#
|
4476
|
-
# We recommend that extension names adhere to the following
|
4477
|
-
#
|
5072
|
+
# We recommend that extension names adhere to the following patterns:
|
5073
|
+
#
|
5074
|
+
# * For resource types,
|
5075
|
+
# *company\_or\_organization*\::*service*\::*type*.
|
5076
|
+
#
|
5077
|
+
# * For modules,
|
5078
|
+
# *company\_or\_organization*\::*service*\::*type*\::MODULE.
|
4478
5079
|
#
|
4479
5080
|
# <note markdown="1"> The following organization namespaces are reserved and cannot be used
|
4480
5081
|
# in your extension names:
|
@@ -4504,8 +5105,8 @@ module Aws::CloudFormation
|
|
4504
5105
|
# <note markdown="1"> The user registering the extension must be able to access the package
|
4505
5106
|
# in the S3 bucket. That is, the user needs to have [GetObject][2]
|
4506
5107
|
# permissions for the schema handler package. For more information, see
|
4507
|
-
# [Actions, Resources, and Condition Keys for Amazon S3][3] in the
|
4508
|
-
# Identity and Access Management User Guide*.
|
5108
|
+
# [Actions, Resources, and Condition Keys for Amazon S3][3] in the
|
5109
|
+
# *Identity and Access Management User Guide*.
|
4509
5110
|
#
|
4510
5111
|
# </note>
|
4511
5112
|
#
|
@@ -4520,15 +5121,25 @@ module Aws::CloudFormation
|
|
4520
5121
|
#
|
4521
5122
|
# @option params [String] :execution_role_arn
|
4522
5123
|
# The Amazon Resource Name (ARN) of the IAM role for CloudFormation to
|
4523
|
-
# assume when invoking the extension.
|
4524
|
-
#
|
5124
|
+
# assume when invoking the extension.
|
5125
|
+
#
|
5126
|
+
# For CloudFormation to assume the specified execution role, the role
|
5127
|
+
# must contain a trust relationship with the CloudFormation service
|
5128
|
+
# principle (`resources.cloudformation.amazonaws.com`). For more
|
5129
|
+
# information on adding trust relationships, see [Modifying a role trust
|
5130
|
+
# policy](IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-managingrole_edit-trust-policy)
|
5131
|
+
# in the *Identity and Access Management User Guide*.
|
5132
|
+
#
|
5133
|
+
# If your extension calls Amazon Web Services APIs in any of its
|
5134
|
+
# handlers, you must create an <i> <a
|
4525
5135
|
# href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
|
4526
5136
|
# execution role</a> </i> that includes the necessary permissions to
|
4527
|
-
# call those
|
4528
|
-
# account. When CloudFormation needs to invoke the
|
4529
|
-
# CloudFormation assumes this execution role to create a
|
4530
|
-
# session token, which it then passes to the
|
4531
|
-
# supplying your
|
5137
|
+
# call those Amazon Web Services APIs, and provision that execution role
|
5138
|
+
# in your account. When CloudFormation needs to invoke the resource type
|
5139
|
+
# handler, CloudFormation assumes this execution role to create a
|
5140
|
+
# temporary session token, which it then passes to the resource type
|
5141
|
+
# handler, thereby supplying your resource type with the appropriate
|
5142
|
+
# credentials.
|
4532
5143
|
#
|
4533
5144
|
# @option params [String] :client_request_token
|
4534
5145
|
# A unique identifier that acts as an idempotency key for this
|
@@ -4568,6 +5179,62 @@ module Aws::CloudFormation
|
|
4568
5179
|
req.send_request(options)
|
4569
5180
|
end
|
4570
5181
|
|
5182
|
+
# When specifying `RollbackStack`, you preserve the state of previously
|
5183
|
+
# provisioned resources when an operation fails. You can check the
|
5184
|
+
# status of the stack through the DescribeStacks API.
|
5185
|
+
#
|
5186
|
+
# Rolls back the specified stack to the last known stable state from
|
5187
|
+
# `CREATE_FAILED` or `UPDATE_FAILED` stack statuses.
|
5188
|
+
#
|
5189
|
+
# This operation will delete a stack if it doesn't contain a last known
|
5190
|
+
# stable state. A last known stable state includes any status in a
|
5191
|
+
# `*_COMPLETE`. This includes the following stack statuses.
|
5192
|
+
#
|
5193
|
+
# * `CREATE_COMPLETE`
|
5194
|
+
#
|
5195
|
+
# * `UPDATE_COMPLETE`
|
5196
|
+
#
|
5197
|
+
# * `UPDATE_ROLLBACK_COMPLETE`
|
5198
|
+
#
|
5199
|
+
# * `IMPORT_COMPLETE`
|
5200
|
+
#
|
5201
|
+
# * `IMPORT_ROLLBACK_COMPLETE`
|
5202
|
+
#
|
5203
|
+
# @option params [required, String] :stack_name
|
5204
|
+
# The name that is associated with the stack.
|
5205
|
+
#
|
5206
|
+
# @option params [String] :role_arn
|
5207
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
5208
|
+
# role that CloudFormation assumes to rollback the stack.
|
5209
|
+
#
|
5210
|
+
# @option params [String] :client_request_token
|
5211
|
+
# A unique identifier for this `RollbackStack` request.
|
5212
|
+
#
|
5213
|
+
# @return [Types::RollbackStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5214
|
+
#
|
5215
|
+
# * {Types::RollbackStackOutput#stack_id #stack_id} => String
|
5216
|
+
#
|
5217
|
+
# @example Request syntax with placeholder values
|
5218
|
+
#
|
5219
|
+
# resp = client.rollback_stack({
|
5220
|
+
# stack_name: "StackNameOrId", # required
|
5221
|
+
# role_arn: "RoleARN",
|
5222
|
+
# client_request_token: "ClientRequestToken",
|
5223
|
+
# })
|
5224
|
+
#
|
5225
|
+
# @example Response structure
|
5226
|
+
#
|
5227
|
+
# resp.stack_id #=> String
|
5228
|
+
#
|
5229
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackStack AWS API Documentation
|
5230
|
+
#
|
5231
|
+
# @overload rollback_stack(params = {})
|
5232
|
+
# @param [Hash] params ({})
|
5233
|
+
def rollback_stack(params = {}, options = {})
|
5234
|
+
req = build_request(:rollback_stack, params)
|
5235
|
+
req.send_request(options)
|
5236
|
+
end
|
5237
|
+
|
4571
5238
|
# Sets a stack policy for a specified stack.
|
4572
5239
|
#
|
4573
5240
|
# @option params [required, String] :stack_name
|
@@ -4575,8 +5242,8 @@ module Aws::CloudFormation
|
|
4575
5242
|
#
|
4576
5243
|
# @option params [String] :stack_policy_body
|
4577
5244
|
# Structure containing the stack policy body. For more information, go
|
4578
|
-
# to [ Prevent Updates to Stack Resources][1] in the
|
4579
|
-
#
|
5245
|
+
# to [ Prevent Updates to Stack Resources][1] in the CloudFormation User
|
5246
|
+
# Guide. You can specify either the `StackPolicyBody` or the
|
4580
5247
|
# `StackPolicyURL` parameter, but not both.
|
4581
5248
|
#
|
4582
5249
|
#
|
@@ -4608,6 +5275,101 @@ module Aws::CloudFormation
|
|
4608
5275
|
req.send_request(options)
|
4609
5276
|
end
|
4610
5277
|
|
5278
|
+
# Specifies the configuration data for a registered CloudFormation
|
5279
|
+
# extension, in the given account and region.
|
5280
|
+
#
|
5281
|
+
# To view the current configuration data for an extension, refer to the
|
5282
|
+
# `ConfigurationSchema` element of
|
5283
|
+
# [DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
|
5284
|
+
# For more information, see [Configuring extensions at the account
|
5285
|
+
# level][1] in the *CloudFormation User Guide*.
|
5286
|
+
#
|
5287
|
+
# It is strongly recommended that you use dynamic references to restrict
|
5288
|
+
# sensitive configuration definitions, such as third-party credentials.
|
5289
|
+
# For more details on dynamic references, see [Using dynamic references
|
5290
|
+
# to specify template values][2] in the *CloudFormation User Guide*.
|
5291
|
+
#
|
5292
|
+
#
|
5293
|
+
#
|
5294
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
|
5295
|
+
# [2]: https://docs.aws.amazon.com/
|
5296
|
+
#
|
5297
|
+
# @option params [String] :type_arn
|
5298
|
+
# The Amazon Resource Name (ARN) for the extension, in this account and
|
5299
|
+
# region.
|
5300
|
+
#
|
5301
|
+
# For public extensions, this will be the ARN assigned when you
|
5302
|
+
# [activate the type][1] in this account and region. For private
|
5303
|
+
# extensions, this will be the ARN assigned when you [register the
|
5304
|
+
# type][2] in this account and region.
|
5305
|
+
#
|
5306
|
+
# Do not include the extension versions suffix at the end of the ARN.
|
5307
|
+
# You can set the configuration for an extension, but not for a specific
|
5308
|
+
# extension version.
|
5309
|
+
#
|
5310
|
+
#
|
5311
|
+
#
|
5312
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
|
5313
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
|
5314
|
+
#
|
5315
|
+
# @option params [required, String] :configuration
|
5316
|
+
# The configuration data for the extension, in this account and region.
|
5317
|
+
#
|
5318
|
+
# The configuration data must be formatted as JSON, and validate against
|
5319
|
+
# the schema returned in the `ConfigurationSchema` response element of
|
5320
|
+
# [API\_DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
|
5321
|
+
# For more information, see [Defining account-level configuration data
|
5322
|
+
# for an extension][1] in the *CloudFormation CLI User Guide*.
|
5323
|
+
#
|
5324
|
+
#
|
5325
|
+
#
|
5326
|
+
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration
|
5327
|
+
#
|
5328
|
+
# @option params [String] :configuration_alias
|
5329
|
+
# An alias by which to refer to this extension configuration data.
|
5330
|
+
#
|
5331
|
+
# Conditional: Specifying a configuration alias is required when setting
|
5332
|
+
# a configuration for a resource type extension.
|
5333
|
+
#
|
5334
|
+
# @option params [String] :type_name
|
5335
|
+
# The name of the extension.
|
5336
|
+
#
|
5337
|
+
# Conditional: You must specify `ConfigurationArn`, or `Type` and
|
5338
|
+
# `TypeName`.
|
5339
|
+
#
|
5340
|
+
# @option params [String] :type
|
5341
|
+
# The type of extension.
|
5342
|
+
#
|
5343
|
+
# Conditional: You must specify `ConfigurationArn`, or `Type` and
|
5344
|
+
# `TypeName`.
|
5345
|
+
#
|
5346
|
+
# @return [Types::SetTypeConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5347
|
+
#
|
5348
|
+
# * {Types::SetTypeConfigurationOutput#configuration_arn #configuration_arn} => String
|
5349
|
+
#
|
5350
|
+
# @example Request syntax with placeholder values
|
5351
|
+
#
|
5352
|
+
# resp = client.set_type_configuration({
|
5353
|
+
# type_arn: "TypeArn",
|
5354
|
+
# configuration: "TypeConfiguration", # required
|
5355
|
+
# configuration_alias: "TypeConfigurationAlias",
|
5356
|
+
# type_name: "TypeName",
|
5357
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
5358
|
+
# })
|
5359
|
+
#
|
5360
|
+
# @example Response structure
|
5361
|
+
#
|
5362
|
+
# resp.configuration_arn #=> String
|
5363
|
+
#
|
5364
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetTypeConfiguration AWS API Documentation
|
5365
|
+
#
|
5366
|
+
# @overload set_type_configuration(params = {})
|
5367
|
+
# @param [Hash] params ({})
|
5368
|
+
def set_type_configuration(params = {}, options = {})
|
5369
|
+
req = build_request(:set_type_configuration, params)
|
5370
|
+
req.send_request(options)
|
5371
|
+
end
|
5372
|
+
|
4611
5373
|
# Specify the default version of an extension. The default version of an
|
4612
5374
|
# extension will be used in CloudFormation operations.
|
4613
5375
|
#
|
@@ -4654,11 +5416,11 @@ module Aws::CloudFormation
|
|
4654
5416
|
|
4655
5417
|
# Sends a signal to the specified resource with a success or failure
|
4656
5418
|
# status. You can use the SignalResource API in conjunction with a
|
4657
|
-
# creation policy or update policy.
|
4658
|
-
#
|
4659
|
-
#
|
4660
|
-
#
|
4661
|
-
#
|
5419
|
+
# creation policy or update policy. CloudFormation doesn't proceed with
|
5420
|
+
# a stack creation or update until resources receive the required number
|
5421
|
+
# of signals or the timeout period is exceeded. The SignalResource API
|
5422
|
+
# is useful in cases where you want to send signals from anywhere other
|
5423
|
+
# than an Amazon EC2 instance.
|
4662
5424
|
#
|
4663
5425
|
# @option params [required, String] :stack_name
|
4664
5426
|
# The stack name or unique stack ID that includes the resource that you
|
@@ -4677,7 +5439,7 @@ module Aws::CloudFormation
|
|
4677
5439
|
#
|
4678
5440
|
# @option params [required, String] :status
|
4679
5441
|
# The status of the signal, which is either success or failure. A
|
4680
|
-
# failure signal causes
|
5442
|
+
# failure signal causes CloudFormation to immediately fail the stack
|
4681
5443
|
# creation or update.
|
4682
5444
|
#
|
4683
5445
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
@@ -4723,9 +5485,10 @@ module Aws::CloudFormation
|
|
4723
5485
|
# * If you are signed in to a delegated administrator account, specify
|
4724
5486
|
# `DELEGATED_ADMIN`.
|
4725
5487
|
#
|
4726
|
-
# Your
|
4727
|
-
# the management account. For more information, see
|
4728
|
-
# delegated administrator][1] in the *
|
5488
|
+
# Your Amazon Web Services account must be registered as a delegated
|
5489
|
+
# administrator in the management account. For more information, see
|
5490
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
5491
|
+
# Guide*.
|
4729
5492
|
#
|
4730
5493
|
#
|
4731
5494
|
#
|
@@ -4750,6 +5513,115 @@ module Aws::CloudFormation
|
|
4750
5513
|
req.send_request(options)
|
4751
5514
|
end
|
4752
5515
|
|
5516
|
+
# Tests a registered extension to make sure it meets all necessary
|
5517
|
+
# requirements for being published in the CloudFormation registry.
|
5518
|
+
#
|
5519
|
+
# * For resource types, this includes passing all contracts tests
|
5520
|
+
# defined for the type.
|
5521
|
+
#
|
5522
|
+
# * For modules, this includes determining if the module's model meets
|
5523
|
+
# all necessary requirements.
|
5524
|
+
#
|
5525
|
+
# For more information, see [Testing your public extension prior to
|
5526
|
+
# publishing][1] in the *CloudFormation CLI User Guide*.
|
5527
|
+
#
|
5528
|
+
# If you do not specify a version, CloudFormation uses the default
|
5529
|
+
# version of the extension in your account and region for testing.
|
5530
|
+
#
|
5531
|
+
# To perform testing, CloudFormation assumes the execution role
|
5532
|
+
# specified when the type was registered. For more information, see
|
5533
|
+
# [RegisterType](AWSCloudFormation/latest/APIReference/API_RegisterType.html).
|
5534
|
+
#
|
5535
|
+
# Once you've initiated testing on an extension using `TestType`, you
|
5536
|
+
# can use [DescribeType][2] to monitor the current test status and test
|
5537
|
+
# status description for the extension.
|
5538
|
+
#
|
5539
|
+
# An extension must have a test status of `PASSED` before it can be
|
5540
|
+
# published. For more information, see [Publishing extensions to make
|
5541
|
+
# them available for public use][3] in the *CloudFormation CLI User
|
5542
|
+
# Guide*.
|
5543
|
+
#
|
5544
|
+
#
|
5545
|
+
#
|
5546
|
+
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-testing
|
5547
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
|
5548
|
+
# [3]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-publish.html
|
5549
|
+
#
|
5550
|
+
# @option params [String] :arn
|
5551
|
+
# The Amazon Resource Number (ARN) of the extension.
|
5552
|
+
#
|
5553
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
5554
|
+
#
|
5555
|
+
# @option params [String] :type
|
5556
|
+
# The type of the extension to test.
|
5557
|
+
#
|
5558
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
5559
|
+
#
|
5560
|
+
# @option params [String] :type_name
|
5561
|
+
# The name of the extension to test.
|
5562
|
+
#
|
5563
|
+
# Conditional: You must specify `Arn`, or `TypeName` and `Type`.
|
5564
|
+
#
|
5565
|
+
# @option params [String] :version_id
|
5566
|
+
# The version of the extension to test.
|
5567
|
+
#
|
5568
|
+
# You can specify the version id with either `Arn`, or with `TypeName`
|
5569
|
+
# and `Type`.
|
5570
|
+
#
|
5571
|
+
# If you do not specify a version, CloudFormation uses the default
|
5572
|
+
# version of the extension in this account and region for testing.
|
5573
|
+
#
|
5574
|
+
# @option params [String] :log_delivery_bucket
|
5575
|
+
# The S3 bucket to which CloudFormation delivers the contract test
|
5576
|
+
# execution logs.
|
5577
|
+
#
|
5578
|
+
# CloudFormation delivers the logs by the time contract testing has
|
5579
|
+
# completed and the extension has been assigned a test type status of
|
5580
|
+
# `PASSED` or `FAILED`.
|
5581
|
+
#
|
5582
|
+
# The user calling `TestType` must be able to access items in the
|
5583
|
+
# specified S3 bucket. Specifically, the user needs the following
|
5584
|
+
# permissions:
|
5585
|
+
#
|
5586
|
+
# * GetObject
|
5587
|
+
#
|
5588
|
+
# * PutObject
|
5589
|
+
#
|
5590
|
+
# For more information, see [Actions, Resources, and Condition Keys for
|
5591
|
+
# Amazon S3][1] in the *Amazon Web Services Identity and Access
|
5592
|
+
# Management User Guide*.
|
5593
|
+
#
|
5594
|
+
#
|
5595
|
+
#
|
5596
|
+
# [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html
|
5597
|
+
#
|
5598
|
+
# @return [Types::TestTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5599
|
+
#
|
5600
|
+
# * {Types::TestTypeOutput#type_version_arn #type_version_arn} => String
|
5601
|
+
#
|
5602
|
+
# @example Request syntax with placeholder values
|
5603
|
+
#
|
5604
|
+
# resp = client.test_type({
|
5605
|
+
# arn: "TypeArn",
|
5606
|
+
# type: "RESOURCE", # accepts RESOURCE, MODULE
|
5607
|
+
# type_name: "TypeName",
|
5608
|
+
# version_id: "TypeVersionId",
|
5609
|
+
# log_delivery_bucket: "S3Bucket",
|
5610
|
+
# })
|
5611
|
+
#
|
5612
|
+
# @example Response structure
|
5613
|
+
#
|
5614
|
+
# resp.type_version_arn #=> String
|
5615
|
+
#
|
5616
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestType AWS API Documentation
|
5617
|
+
#
|
5618
|
+
# @overload test_type(params = {})
|
5619
|
+
# @param [Hash] params ({})
|
5620
|
+
def test_type(params = {}, options = {})
|
5621
|
+
req = build_request(:test_type, params)
|
5622
|
+
req.send_request(options)
|
5623
|
+
end
|
5624
|
+
|
4753
5625
|
# Updates a stack as specified in the template. After the call completes
|
4754
5626
|
# successfully, the stack update starts. You can check the status of the
|
4755
5627
|
# stack via the DescribeStacks action.
|
@@ -4771,7 +5643,7 @@ module Aws::CloudFormation
|
|
4771
5643
|
# @option params [String] :template_body
|
4772
5644
|
# Structure containing the template body with a minimum length of 1 byte
|
4773
5645
|
# and a maximum length of 51,200 bytes. (For more information, go to
|
4774
|
-
# [Template Anatomy][1] in the
|
5646
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.)
|
4775
5647
|
#
|
4776
5648
|
# Conditional: You must specify only one of the following parameters:
|
4777
5649
|
# `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
|
@@ -4784,7 +5656,7 @@ module Aws::CloudFormation
|
|
4784
5656
|
# @option params [String] :template_url
|
4785
5657
|
# Location of file containing the template body. The URL must point to a
|
4786
5658
|
# template that is located in an Amazon S3 bucket or a Systems Manager
|
4787
|
-
# document. For more information, go to [Template Anatomy][1] in the
|
5659
|
+
# document. For more information, go to [Template Anatomy][1] in the
|
4788
5660
|
# CloudFormation User Guide.
|
4789
5661
|
#
|
4790
5662
|
# Conditional: You must specify only one of the following parameters:
|
@@ -4835,16 +5707,16 @@ module Aws::CloudFormation
|
|
4835
5707
|
#
|
4836
5708
|
# @option params [Array<String>] :capabilities
|
4837
5709
|
# In some cases, you must explicitly acknowledge that your stack
|
4838
|
-
# template contains certain capabilities in order for
|
4839
|
-
#
|
5710
|
+
# template contains certain capabilities in order for CloudFormation to
|
5711
|
+
# update the stack.
|
4840
5712
|
#
|
4841
5713
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
4842
5714
|
#
|
4843
5715
|
# Some stack templates might include resources that can affect
|
4844
|
-
# permissions in your
|
4845
|
-
# Identity and Access Management (IAM) users. For those
|
4846
|
-
# must explicitly acknowledge this by specifying one of
|
4847
|
-
# capabilities.
|
5716
|
+
# permissions in your Amazon Web Services account; for example, by
|
5717
|
+
# creating new Identity and Access Management (IAM) users. For those
|
5718
|
+
# stacks, you must explicitly acknowledge this by specifying one of
|
5719
|
+
# these capabilities.
|
4848
5720
|
#
|
4849
5721
|
# The following IAM resources require you to specify either the
|
4850
5722
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -4854,8 +5726,8 @@ module Aws::CloudFormation
|
|
4854
5726
|
# * If you have IAM resources with custom names, you *must* specify
|
4855
5727
|
# `CAPABILITY_NAMED_IAM`.
|
4856
5728
|
#
|
4857
|
-
# * If you don't specify either of these capabilities,
|
4858
|
-
#
|
5729
|
+
# * If you don't specify either of these capabilities, CloudFormation
|
5730
|
+
# returns an `InsufficientCapabilities` error.
|
4859
5731
|
#
|
4860
5732
|
# If your stack template contains these resources, we recommend that
|
4861
5733
|
# you review all permissions associated with them and edit their
|
@@ -4875,7 +5747,7 @@ module Aws::CloudFormation
|
|
4875
5747
|
#
|
4876
5748
|
# * [ AWS::IAM::UserToGroupAddition][7]
|
4877
5749
|
#
|
4878
|
-
# For more information, see [Acknowledging IAM Resources in
|
5750
|
+
# For more information, see [Acknowledging IAM Resources in
|
4879
5751
|
# CloudFormation Templates][8].
|
4880
5752
|
#
|
4881
5753
|
# * `CAPABILITY_AUTO_EXPAND`
|
@@ -4890,7 +5762,7 @@ module Aws::CloudFormation
|
|
4890
5762
|
# update a stack directly from the processed template, without first
|
4891
5763
|
# reviewing the resulting changes in a change set, you must
|
4892
5764
|
# acknowledge this capability. This includes the [AWS::Include][9] and
|
4893
|
-
# [AWS::Serverless][10] transforms, which are macros hosted by
|
5765
|
+
# [AWS::Serverless][10] transforms, which are macros hosted by
|
4894
5766
|
# CloudFormation.
|
4895
5767
|
#
|
4896
5768
|
# If you want to update a stack from a stack template that contains
|
@@ -4902,11 +5774,11 @@ module Aws::CloudFormation
|
|
4902
5774
|
#
|
4903
5775
|
# Each macro relies on an underlying Lambda service function for
|
4904
5776
|
# processing stack templates. Be aware that the Lambda function owner
|
4905
|
-
# can update the function operation without
|
5777
|
+
# can update the function operation without CloudFormation being
|
4906
5778
|
# notified.
|
4907
5779
|
#
|
4908
|
-
# For more information, see [Using
|
4909
|
-
#
|
5780
|
+
# For more information, see [Using CloudFormation Macros to Perform
|
5781
|
+
# Custom Processing on Templates][11].
|
4910
5782
|
#
|
4911
5783
|
#
|
4912
5784
|
#
|
@@ -4928,33 +5800,32 @@ module Aws::CloudFormation
|
|
4928
5800
|
# or `Custom::MyCustomInstance`.
|
4929
5801
|
#
|
4930
5802
|
# If the list of resource types doesn't include a resource that you're
|
4931
|
-
# updating, the stack update fails. By default,
|
4932
|
-
#
|
4933
|
-
#
|
4934
|
-
#
|
4935
|
-
#
|
5803
|
+
# updating, the stack update fails. By default, CloudFormation grants
|
5804
|
+
# permissions to all resource types. Identity and Access Management
|
5805
|
+
# (IAM) uses this parameter for CloudFormation-specific condition keys
|
5806
|
+
# in IAM policies. For more information, see [Controlling Access with
|
5807
|
+
# Identity and Access Management][1].
|
4936
5808
|
#
|
4937
5809
|
#
|
4938
5810
|
#
|
4939
5811
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
4940
5812
|
#
|
4941
5813
|
# @option params [String] :role_arn
|
4942
|
-
# The Amazon Resource Name (ARN) of an
|
4943
|
-
#
|
4944
|
-
#
|
4945
|
-
#
|
4946
|
-
#
|
4947
|
-
#
|
4948
|
-
#
|
4949
|
-
#
|
4950
|
-
#
|
4951
|
-
#
|
4952
|
-
# was previously associated with the stack. If no role is available, AWS
|
5814
|
+
# The Amazon Resource Name (ARN) of an Identity and Access Management
|
5815
|
+
# (IAM) role that CloudFormation assumes to update the stack.
|
5816
|
+
# CloudFormation uses the role's credentials to make calls on your
|
5817
|
+
# behalf. CloudFormation always uses this role for all future operations
|
5818
|
+
# on the stack. As long as users have permission to operate on the
|
5819
|
+
# stack, CloudFormation uses this role even if the users don't have
|
5820
|
+
# permission to pass it. Ensure that the role grants least privilege.
|
5821
|
+
#
|
5822
|
+
# If you don't specify a value, CloudFormation uses the role that was
|
5823
|
+
# previously associated with the stack. If no role is available,
|
4953
5824
|
# CloudFormation uses a temporary session that is generated from your
|
4954
5825
|
# user credentials.
|
4955
5826
|
#
|
4956
5827
|
# @option params [Types::RollbackConfiguration] :rollback_configuration
|
4957
|
-
# The rollback triggers for
|
5828
|
+
# The rollback triggers for CloudFormation to monitor during stack
|
4958
5829
|
# creation and updating operations, and for the specified monitoring
|
4959
5830
|
# period afterwards.
|
4960
5831
|
#
|
@@ -4980,23 +5851,29 @@ module Aws::CloudFormation
|
|
4980
5851
|
#
|
4981
5852
|
# @option params [Array<String>] :notification_arns
|
4982
5853
|
# Amazon Simple Notification Service topic Amazon Resource Names (ARNs)
|
4983
|
-
# that
|
4984
|
-
#
|
5854
|
+
# that CloudFormation associates with the stack. Specify an empty list
|
5855
|
+
# to remove all notification topics.
|
4985
5856
|
#
|
4986
5857
|
# @option params [Array<Types::Tag>] :tags
|
4987
|
-
# Key-value pairs to associate with this stack.
|
5858
|
+
# Key-value pairs to associate with this stack. CloudFormation also
|
4988
5859
|
# propagates these tags to supported resources in the stack. You can
|
4989
5860
|
# specify a maximum number of 50 tags.
|
4990
5861
|
#
|
4991
|
-
# If you don't specify this parameter,
|
4992
|
-
#
|
4993
|
-
#
|
5862
|
+
# If you don't specify this parameter, CloudFormation doesn't modify
|
5863
|
+
# the stack's tags. If you specify an empty value, CloudFormation
|
5864
|
+
# removes all associated tags.
|
5865
|
+
#
|
5866
|
+
# @option params [Boolean] :disable_rollback
|
5867
|
+
# Preserve the state of previously provisioned resources when an
|
5868
|
+
# operation fails.
|
5869
|
+
#
|
5870
|
+
# Default: `False`
|
4994
5871
|
#
|
4995
5872
|
# @option params [String] :client_request_token
|
4996
5873
|
# A unique identifier for this `UpdateStack` request. Specify this token
|
4997
|
-
# if you plan to retry requests so that
|
5874
|
+
# if you plan to retry requests so that CloudFormation knows that
|
4998
5875
|
# you're not attempting to update a stack with the same name. You might
|
4999
|
-
# retry `UpdateStack` requests to ensure that
|
5876
|
+
# retry `UpdateStack` requests to ensure that CloudFormation
|
5000
5877
|
# successfully received them.
|
5001
5878
|
#
|
5002
5879
|
# All events triggered by a given stack operation are assigned the same
|
@@ -5055,6 +5932,7 @@ module Aws::CloudFormation
|
|
5055
5932
|
# value: "TagValue", # required
|
5056
5933
|
# },
|
5057
5934
|
# ],
|
5935
|
+
# disable_rollback: false,
|
5058
5936
|
# client_request_token: "ClientRequestToken",
|
5059
5937
|
# })
|
5060
5938
|
#
|
@@ -5102,16 +5980,16 @@ module Aws::CloudFormation
|
|
5102
5980
|
# instances.
|
5103
5981
|
#
|
5104
5982
|
# @option params [Array<String>] :accounts
|
5105
|
-
# \[Self-managed permissions\] The names of one or more
|
5106
|
-
# which you want to update parameter values for
|
5107
|
-
# overridden parameter values will be applied to
|
5108
|
-
# the specified accounts and Regions.
|
5983
|
+
# \[Self-managed permissions\] The names of one or more Amazon Web
|
5984
|
+
# Services accounts for which you want to update parameter values for
|
5985
|
+
# stack instances. The overridden parameter values will be applied to
|
5986
|
+
# all stack instances in the specified accounts and Regions.
|
5109
5987
|
#
|
5110
5988
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
5111
5989
|
#
|
5112
5990
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
5113
|
-
# \[Service-managed permissions\] The
|
5114
|
-
#
|
5991
|
+
# \[Service-managed permissions\] The Organizations accounts for which
|
5992
|
+
# you want to update parameter values for stack instances. If your
|
5115
5993
|
# update targets OUs, the overridden parameter values only apply to the
|
5116
5994
|
# accounts that are currently in the target OUs and their child OUs.
|
5117
5995
|
# Accounts added to the target OUs and their child OUs in the future
|
@@ -5130,24 +6008,19 @@ module Aws::CloudFormation
|
|
5130
6008
|
#
|
5131
6009
|
# Any overridden parameter values will be applied to all stack instances
|
5132
6010
|
# in the specified accounts and Regions. When specifying parameters and
|
5133
|
-
# their values, be aware of how
|
6011
|
+
# their values, be aware of how CloudFormation sets parameter values
|
5134
6012
|
# during stack instance update operations:
|
5135
6013
|
#
|
5136
6014
|
# * To override the current value for a parameter, include the parameter
|
5137
6015
|
# and specify its value.
|
5138
6016
|
#
|
5139
|
-
# * To leave
|
5140
|
-
#
|
5141
|
-
#
|
5142
|
-
# * Do not include the parameter in the list.
|
5143
|
-
#
|
5144
|
-
# * Include the parameter and specify `UsePreviousValue` as `true`.
|
5145
|
-
# (You cannot specify both a value and set `UsePreviousValue` to
|
5146
|
-
# `true`.)
|
6017
|
+
# * To leave an overridden parameter set to its present value, include
|
6018
|
+
# the parameter and specify `UsePreviousValue` as `true`. (You cannot
|
6019
|
+
# specify both a value and set `UsePreviousValue` to `true`.)
|
5147
6020
|
#
|
5148
|
-
# * To set
|
5149
|
-
# stack set, specify a parameter list but do not include
|
5150
|
-
#
|
6021
|
+
# * To set an overridden parameter back to the value specified in the
|
6022
|
+
# stack set, specify a parameter list but do not include the parameter
|
6023
|
+
# in the list.
|
5151
6024
|
#
|
5152
6025
|
# * To leave all parameters set to their present values, do not specify
|
5153
6026
|
# this property at all.
|
@@ -5170,17 +6043,16 @@ module Aws::CloudFormation
|
|
5170
6043
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
|
5171
6044
|
#
|
5172
6045
|
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
5173
|
-
# Preferences for how
|
5174
|
-
# operation.
|
6046
|
+
# Preferences for how CloudFormation performs this stack set operation.
|
5175
6047
|
#
|
5176
6048
|
# @option params [String] :operation_id
|
5177
6049
|
# The unique identifier for this stack set operation.
|
5178
6050
|
#
|
5179
6051
|
# The operation ID also functions as an idempotency token, to ensure
|
5180
|
-
# that
|
5181
|
-
#
|
5182
|
-
#
|
5183
|
-
#
|
6052
|
+
# that CloudFormation performs the stack set operation only once, even
|
6053
|
+
# if you retry the request multiple times. You might retry stack set
|
6054
|
+
# operation requests to ensure that CloudFormation successfully received
|
6055
|
+
# them.
|
5184
6056
|
#
|
5185
6057
|
# If you don't specify an operation ID, the SDK generates one
|
5186
6058
|
# automatically.
|
@@ -5201,9 +6073,10 @@ module Aws::CloudFormation
|
|
5201
6073
|
# * If you are signed in to a delegated administrator account, specify
|
5202
6074
|
# `DELEGATED_ADMIN`.
|
5203
6075
|
#
|
5204
|
-
# Your
|
5205
|
-
# the management account. For more information, see
|
5206
|
-
# delegated administrator][1] in the *
|
6076
|
+
# Your Amazon Web Services account must be registered as a delegated
|
6077
|
+
# administrator in the management account. For more information, see
|
6078
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
6079
|
+
# Guide*.
|
5207
6080
|
#
|
5208
6081
|
#
|
5209
6082
|
#
|
@@ -5275,7 +6148,7 @@ module Aws::CloudFormation
|
|
5275
6148
|
# @option params [String] :template_body
|
5276
6149
|
# The structure that contains the template body, with a minimum length
|
5277
6150
|
# of 1 byte and a maximum length of 51,200 bytes. For more information,
|
5278
|
-
# see [Template Anatomy][1] in the
|
6151
|
+
# see [Template Anatomy][1] in the CloudFormation User Guide.
|
5279
6152
|
#
|
5280
6153
|
# Conditional: You must specify only one of the following parameters:
|
5281
6154
|
# `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
|
@@ -5288,7 +6161,7 @@ module Aws::CloudFormation
|
|
5288
6161
|
# The location of the file that contains the template body. The URL must
|
5289
6162
|
# point to a template (maximum size: 460,800 bytes) that is located in
|
5290
6163
|
# an Amazon S3 bucket or a Systems Manager document. For more
|
5291
|
-
# information, see [Template Anatomy][1] in the
|
6164
|
+
# information, see [Template Anatomy][1] in the CloudFormation User
|
5292
6165
|
# Guide.
|
5293
6166
|
#
|
5294
6167
|
# Conditional: You must specify only one of the following parameters:
|
@@ -5310,16 +6183,16 @@ module Aws::CloudFormation
|
|
5310
6183
|
#
|
5311
6184
|
# @option params [Array<String>] :capabilities
|
5312
6185
|
# In some cases, you must explicitly acknowledge that your stack
|
5313
|
-
# template contains certain capabilities in order for
|
5314
|
-
#
|
6186
|
+
# template contains certain capabilities in order for CloudFormation to
|
6187
|
+
# update the stack set and its associated stack instances.
|
5315
6188
|
#
|
5316
6189
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
5317
6190
|
#
|
5318
6191
|
# Some stack templates might include resources that can affect
|
5319
|
-
# permissions in your
|
5320
|
-
# Identity and Access Management (IAM) users. For those
|
5321
|
-
# you must explicitly acknowledge this by specifying one
|
5322
|
-
# capabilities.
|
6192
|
+
# permissions in your Amazon Web Services account; for example, by
|
6193
|
+
# creating new Identity and Access Management (IAM) users. For those
|
6194
|
+
# stacks sets, you must explicitly acknowledge this by specifying one
|
6195
|
+
# of these capabilities.
|
5323
6196
|
#
|
5324
6197
|
# The following IAM resources require you to specify either the
|
5325
6198
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -5329,8 +6202,8 @@ module Aws::CloudFormation
|
|
5329
6202
|
# * If you have IAM resources with custom names, you *must* specify
|
5330
6203
|
# `CAPABILITY_NAMED_IAM`.
|
5331
6204
|
#
|
5332
|
-
# * If you don't specify either of these capabilities,
|
5333
|
-
#
|
6205
|
+
# * If you don't specify either of these capabilities, CloudFormation
|
6206
|
+
# returns an `InsufficientCapabilities` error.
|
5334
6207
|
#
|
5335
6208
|
# If your stack template contains these resources, we recommend that
|
5336
6209
|
# you review all permissions associated with them and edit their
|
@@ -5350,7 +6223,7 @@ module Aws::CloudFormation
|
|
5350
6223
|
#
|
5351
6224
|
# * [ AWS::IAM::UserToGroupAddition][7]
|
5352
6225
|
#
|
5353
|
-
# For more information, see [Acknowledging IAM Resources in
|
6226
|
+
# For more information, see [Acknowledging IAM Resources in
|
5354
6227
|
# CloudFormation Templates][8].
|
5355
6228
|
#
|
5356
6229
|
# * `CAPABILITY_AUTO_EXPAND`
|
@@ -5360,13 +6233,13 @@ module Aws::CloudFormation
|
|
5360
6233
|
# directly from the processed template, without first reviewing the
|
5361
6234
|
# resulting changes in a change set. To update the stack set directly,
|
5362
6235
|
# you must acknowledge this capability. For more information, see
|
5363
|
-
# [Using
|
6236
|
+
# [Using CloudFormation Macros to Perform Custom Processing on
|
5364
6237
|
# Templates][9].
|
5365
6238
|
#
|
5366
6239
|
# Stack sets with service-managed permissions do not currently support
|
5367
6240
|
# the use of macros in templates. (This includes the
|
5368
6241
|
# [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
|
5369
|
-
# macros hosted by
|
6242
|
+
# macros hosted by CloudFormation.) Even if you specify this
|
5370
6243
|
# capability for a stack set with service-managed permissions, if you
|
5371
6244
|
# reference a macro in your template the stack set operation will
|
5372
6245
|
# fail.
|
@@ -5387,15 +6260,15 @@ module Aws::CloudFormation
|
|
5387
6260
|
#
|
5388
6261
|
# @option params [Array<Types::Tag>] :tags
|
5389
6262
|
# The key-value pairs to associate with this stack set and the stacks
|
5390
|
-
# created from it.
|
6263
|
+
# created from it. CloudFormation also propagates these tags to
|
5391
6264
|
# supported resources that are created in the stacks. You can specify a
|
5392
6265
|
# maximum number of 50 tags.
|
5393
6266
|
#
|
5394
6267
|
# If you specify tags for this parameter, those tags replace any list of
|
5395
6268
|
# tags that are currently associated with this stack set. This means:
|
5396
6269
|
#
|
5397
|
-
# * If you don't specify this parameter,
|
5398
|
-
#
|
6270
|
+
# * If you don't specify this parameter, CloudFormation doesn't modify
|
6271
|
+
# the stack's tags.
|
5399
6272
|
#
|
5400
6273
|
# * If you specify *any* tags using this parameter, you must specify
|
5401
6274
|
# *all* the tags that you want associated with this stack set, even
|
@@ -5404,21 +6277,20 @@ module Aws::CloudFormation
|
|
5404
6277
|
# you don't include in the updated list of tags are removed from the
|
5405
6278
|
# stack set, and therefore from the stacks and resources as well.
|
5406
6279
|
#
|
5407
|
-
# * If you specify an empty value,
|
5408
|
-
#
|
6280
|
+
# * If you specify an empty value, CloudFormation removes all currently
|
6281
|
+
# associated tags.
|
5409
6282
|
#
|
5410
|
-
# If you specify new tags as part of an `UpdateStackSet` action,
|
6283
|
+
# If you specify new tags as part of an `UpdateStackSet` action,
|
5411
6284
|
# CloudFormation checks to see if you have the required IAM permission
|
5412
6285
|
# to tag resources. If you omit tags that are currently associated with
|
5413
|
-
# the stack set from the list of tags you specify,
|
6286
|
+
# the stack set from the list of tags you specify, CloudFormation
|
5414
6287
|
# assumes that you want to remove those tags from the stack set, and
|
5415
6288
|
# checks to see if you have permission to untag resources. If you don't
|
5416
6289
|
# have the necessary permission(s), the entire `UpdateStackSet` action
|
5417
6290
|
# fails with an `access denied` error, and the stack set is not updated.
|
5418
6291
|
#
|
5419
6292
|
# @option params [Types::StackSetOperationPreferences] :operation_preferences
|
5420
|
-
# Preferences for how
|
5421
|
-
# operation.
|
6293
|
+
# Preferences for how CloudFormation performs this stack set operation.
|
5422
6294
|
#
|
5423
6295
|
# @option params [String] :administration_role_arn
|
5424
6296
|
# The Amazon Resource Number (ARN) of the IAM role to use to update this
|
@@ -5427,8 +6299,8 @@ module Aws::CloudFormation
|
|
5427
6299
|
# Specify an IAM role only if you are using customized administrator
|
5428
6300
|
# roles to control which users or groups can manage specific stack sets
|
5429
6301
|
# within the same administrator account. For more information, see
|
5430
|
-
# [Granting Permissions for Stack Set Operations][1] in the
|
5431
|
-
# CloudFormation User Guide*.
|
6302
|
+
# [Granting Permissions for Stack Set Operations][1] in the
|
6303
|
+
# *CloudFormation User Guide*.
|
5432
6304
|
#
|
5433
6305
|
# If you specified a customized administrator role when you created the
|
5434
6306
|
# stack set, you must specify a customized administrator role, even if
|
@@ -5441,7 +6313,7 @@ module Aws::CloudFormation
|
|
5441
6313
|
#
|
5442
6314
|
# @option params [String] :execution_role_name
|
5443
6315
|
# The name of the IAM execution role to use to update the stack set. If
|
5444
|
-
# you do not specify an execution role,
|
6316
|
+
# you do not specify an execution role, CloudFormation uses the
|
5445
6317
|
# `AWSCloudFormationStackSetExecutionRole` role for the stack set
|
5446
6318
|
# operation.
|
5447
6319
|
#
|
@@ -5449,27 +6321,27 @@ module Aws::CloudFormation
|
|
5449
6321
|
# to control which stack resources users and groups can include in their
|
5450
6322
|
# stack sets.
|
5451
6323
|
#
|
5452
|
-
# If you specify a customized execution role,
|
5453
|
-
#
|
5454
|
-
#
|
5455
|
-
#
|
5456
|
-
#
|
6324
|
+
# If you specify a customized execution role, CloudFormation uses that
|
6325
|
+
# role to update the stack. If you do not specify a customized execution
|
6326
|
+
# role, CloudFormation performs the update using the role previously
|
6327
|
+
# associated with the stack set, so long as you have permissions to
|
6328
|
+
# perform operations on the stack set.
|
5457
6329
|
#
|
5458
6330
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
5459
|
-
# \[Service-managed permissions\] The
|
5460
|
-
#
|
6331
|
+
# \[Service-managed permissions\] The Organizations accounts in which to
|
6332
|
+
# update associated stack instances.
|
5461
6333
|
#
|
5462
6334
|
# To update all the stack instances associated with this stack set, do
|
5463
6335
|
# not specify `DeploymentTargets` or `Regions`.
|
5464
6336
|
#
|
5465
6337
|
# If the stack set update includes changes to the template (that is, if
|
5466
6338
|
# `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
|
5467
|
-
#
|
5468
|
-
#
|
5469
|
-
#
|
5470
|
-
#
|
5471
|
-
#
|
5472
|
-
#
|
6339
|
+
# CloudFormation marks all stack instances with a status of `OUTDATED`
|
6340
|
+
# prior to updating the stack instances in the specified accounts and
|
6341
|
+
# Regions. If the stack set update does not include changes to the
|
6342
|
+
# template or parameters, CloudFormation updates the stack instances in
|
6343
|
+
# the specified accounts and Regions, while leaving all other stack
|
6344
|
+
# instances with their existing stack instance status.
|
5473
6345
|
#
|
5474
6346
|
# @option params [String] :permission_model
|
5475
6347
|
# Describes how the IAM roles required for stack set operations are
|
@@ -5481,7 +6353,7 @@ module Aws::CloudFormation
|
|
5481
6353
|
# information, see [Grant Self-Managed Stack Set Permissions][1].
|
5482
6354
|
#
|
5483
6355
|
# * With `service-managed` permissions, StackSets automatically creates
|
5484
|
-
# the IAM roles required to deploy to accounts managed by
|
6356
|
+
# the IAM roles required to deploy to accounts managed by
|
5485
6357
|
# Organizations. For more information, see [Grant Service-Managed
|
5486
6358
|
# Stack Set Permissions][2].
|
5487
6359
|
#
|
@@ -5492,8 +6364,8 @@ module Aws::CloudFormation
|
|
5492
6364
|
#
|
5493
6365
|
# @option params [Types::AutoDeployment] :auto_deployment
|
5494
6366
|
# \[Service-managed permissions\] Describes whether StackSets
|
5495
|
-
# automatically deploys to
|
5496
|
-
#
|
6367
|
+
# automatically deploys to Organizations accounts that are added to a
|
6368
|
+
# target organization or organizational unit (OU).
|
5497
6369
|
#
|
5498
6370
|
# If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
|
5499
6371
|
# `Regions`.
|
@@ -5502,13 +6374,13 @@ module Aws::CloudFormation
|
|
5502
6374
|
# The unique ID for this stack set operation.
|
5503
6375
|
#
|
5504
6376
|
# The operation ID also functions as an idempotency token, to ensure
|
5505
|
-
# that
|
5506
|
-
#
|
5507
|
-
#
|
5508
|
-
#
|
6377
|
+
# that CloudFormation performs the stack set operation only once, even
|
6378
|
+
# if you retry the request multiple times. You might retry stack set
|
6379
|
+
# operation requests to ensure that CloudFormation successfully received
|
6380
|
+
# them.
|
5509
6381
|
#
|
5510
|
-
# If you don't specify an operation ID,
|
5511
|
-
#
|
6382
|
+
# If you don't specify an operation ID, CloudFormation generates one
|
6383
|
+
# automatically.
|
5512
6384
|
#
|
5513
6385
|
# Repeating this stack set operation with a new operation ID retries all
|
5514
6386
|
# stack instances whose status is `OUTDATED`.
|
@@ -5526,13 +6398,13 @@ module Aws::CloudFormation
|
|
5526
6398
|
#
|
5527
6399
|
# If the stack set update includes changes to the template (that is, if
|
5528
6400
|
# the `TemplateBody` or `TemplateURL` properties are specified), or the
|
5529
|
-
# `Parameters` property,
|
5530
|
-
#
|
5531
|
-
#
|
5532
|
-
# include changes to the template or parameters,
|
5533
|
-
#
|
5534
|
-
#
|
5535
|
-
#
|
6401
|
+
# `Parameters` property, CloudFormation marks all stack instances with a
|
6402
|
+
# status of `OUTDATED` prior to updating the stack instances in the
|
6403
|
+
# specified accounts and Regions. If the stack set update does not
|
6404
|
+
# include changes to the template or parameters, CloudFormation updates
|
6405
|
+
# the stack instances in the specified accounts and Regions, while
|
6406
|
+
# leaving all other stack instances with their existing stack instance
|
6407
|
+
# status.
|
5536
6408
|
#
|
5537
6409
|
# @option params [Array<String>] :regions
|
5538
6410
|
# The Regions in which to update associated stack instances. If you
|
@@ -5544,13 +6416,13 @@ module Aws::CloudFormation
|
|
5544
6416
|
#
|
5545
6417
|
# If the stack set update includes changes to the template (that is, if
|
5546
6418
|
# the `TemplateBody` or `TemplateURL` properties are specified), or the
|
5547
|
-
# `Parameters` property,
|
5548
|
-
#
|
5549
|
-
#
|
5550
|
-
# include changes to the template or parameters,
|
5551
|
-
#
|
5552
|
-
#
|
5553
|
-
#
|
6419
|
+
# `Parameters` property, CloudFormation marks all stack instances with a
|
6420
|
+
# status of `OUTDATED` prior to updating the stack instances in the
|
6421
|
+
# specified accounts and Regions. If the stack set update does not
|
6422
|
+
# include changes to the template or parameters, CloudFormation updates
|
6423
|
+
# the stack instances in the specified accounts and Regions, while
|
6424
|
+
# leaving all other stack instances with their existing stack instance
|
6425
|
+
# status.
|
5554
6426
|
#
|
5555
6427
|
# @option params [String] :call_as
|
5556
6428
|
# \[Service-managed permissions\] Specifies whether you are acting as an
|
@@ -5565,9 +6437,10 @@ module Aws::CloudFormation
|
|
5565
6437
|
# * If you are signed in to a delegated administrator account, specify
|
5566
6438
|
# `DELEGATED_ADMIN`.
|
5567
6439
|
#
|
5568
|
-
# Your
|
5569
|
-
# the management account. For more information, see
|
5570
|
-
# delegated administrator][1] in the *
|
6440
|
+
# Your Amazon Web Services account must be registered as a delegated
|
6441
|
+
# administrator in the management account. For more information, see
|
6442
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
6443
|
+
# Guide*.
|
5571
6444
|
#
|
5572
6445
|
#
|
5573
6446
|
#
|
@@ -5642,8 +6515,8 @@ module Aws::CloudFormation
|
|
5642
6515
|
# Updates termination protection for the specified stack. If a user
|
5643
6516
|
# attempts to delete a stack with termination protection enabled, the
|
5644
6517
|
# operation fails and the stack remains unchanged. For more information,
|
5645
|
-
# see [Protecting a Stack From Being Deleted][1] in the *
|
5646
|
-
#
|
6518
|
+
# see [Protecting a Stack From Being Deleted][1] in the *CloudFormation
|
6519
|
+
# User Guide*.
|
5647
6520
|
#
|
5648
6521
|
# For [nested stacks][2], termination protection is set on the root
|
5649
6522
|
# stack and cannot be changed directly on the nested stack.
|
@@ -5684,15 +6557,15 @@ module Aws::CloudFormation
|
|
5684
6557
|
req.send_request(options)
|
5685
6558
|
end
|
5686
6559
|
|
5687
|
-
# Validates a specified template.
|
5688
|
-
# template is valid JSON. If it isn't,
|
5689
|
-
# template is valid YAML. If both these checks fail,
|
6560
|
+
# Validates a specified template. CloudFormation first checks if the
|
6561
|
+
# template is valid JSON. If it isn't, CloudFormation checks if the
|
6562
|
+
# template is valid YAML. If both these checks fail, CloudFormation
|
5690
6563
|
# returns a template validation error.
|
5691
6564
|
#
|
5692
6565
|
# @option params [String] :template_body
|
5693
6566
|
# Structure containing the template body with a minimum length of 1 byte
|
5694
6567
|
# and a maximum length of 51,200 bytes. For more information, go to
|
5695
|
-
# [Template Anatomy][1] in the
|
6568
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.
|
5696
6569
|
#
|
5697
6570
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
5698
6571
|
# are passed, only `TemplateBody` is used.
|
@@ -5705,7 +6578,7 @@ module Aws::CloudFormation
|
|
5705
6578
|
# Location of file containing the template body. The URL must point to a
|
5706
6579
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
5707
6580
|
# bucket or a Systems Manager document. For more information, go to
|
5708
|
-
# [Template Anatomy][1] in the
|
6581
|
+
# [Template Anatomy][1] in the CloudFormation User Guide.
|
5709
6582
|
#
|
5710
6583
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
5711
6584
|
# are passed, only `TemplateBody` is used.
|
@@ -5765,7 +6638,7 @@ module Aws::CloudFormation
|
|
5765
6638
|
params: params,
|
5766
6639
|
config: config)
|
5767
6640
|
context[:gem_name] = 'aws-sdk-cloudformation'
|
5768
|
-
context[:gem_version] = '1.
|
6641
|
+
context[:gem_version] = '1.56.0'
|
5769
6642
|
Seahorse::Client::Request.new(handlers, context)
|
5770
6643
|
end
|
5771
6644
|
|