aws-sdk-cloudformation 1.91.0 → 1.93.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f8b161e3dd557a5114c04f06db7ef86925ffda94f704c1a46ebb01112d5d5f2
-  data.tar.gz: 8ed88c506558e5b3761484e2d68faddb336037ec733cbba4ce978e724511847a
+  metadata.gz: 28ea979399cbdd5109c4e88615a7e7c91496b252c73735f35a5c0b227b1d166d
+  data.tar.gz: 7830fbe9cc988ca01fd353ed8da8948a49f2b7e095e7a3bac9e46a1c706df61c
 SHA512:
-  metadata.gz: e7073114b255177c38d156ec4ed4a31d088d3c1abe375c8a30fff0370c0fa05bd88ab9c6998eaf7d3082f05d8ce69ad6a3165139298e69c7d4a812a61906e2b1
-  data.tar.gz: 4ffe6de5c2082fe5b883b563a02cbd3f403e1e4bbbd545ced895ec527d8c75e96937a35373e79e74a70eadb5395ecb07a362e20f65abec057575371ec804f4de
+  metadata.gz: 3ed73a5389e4f8243319669a916ea35a817a357d5d50a50511df80f27db5d1766ab4d622899bd32be83a751c4203ce311f181fe589e854b00569a1a0923b43bc
+  data.tar.gz: fe40a7d404494aca6866e53c9ab6dfab777adfc21db4950d0d834b941b148b94cdb216c3766d9658c578000a96db943b7c76747a66031bfd52ddfa605f737111

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.93.0 (2023-11-17)
+------------------
+
+* Feature - This release adds a new flag ImportExistingResources to CreateChangeSet. Specify this parameter on a CREATE- or UPDATE-type change set to import existing resources with custom names instead of recreating them.
+
+1.92.0 (2023-11-09)
+------------------
+
+* Feature - Added new ConcurrencyMode feature for AWS CloudFormation StackSets for faster deployments to target accounts.
+
 1.91.0 (2023-10-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.91.0
+1.93.0

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

@@ -887,6 +887,11 @@ module Aws::CloudFormation
     #     For more information about macros, see [Using CloudFormation macros
     #     to perform custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -911,8 +916,13 @@ module Aws::CloudFormation
     #   grants permissions to all resource types. Identity and Access
     #   Management (IAM) uses this parameter for condition keys in IAM
     #   policies for CloudFormation. For more information, see [Controlling
-    #   access with Identity and Access Management][1] in the CloudFormation
-    #   User Guide.
+    #   access with Identity and Access Management][1] in the *CloudFormation
+    #   User Guide*.
+    #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
     #
     #
     #
@@ -1020,6 +1030,23 @@ module Aws::CloudFormation
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html
     #
+    # @option params [Boolean] :import_existing_resources
+    #   Indicates if the stack set imports resources that already exist.
+    #
+    #   <note markdown="1"> This parameter can only import resources that have custom names in
+    #   templates. For more information, see [name type][1] in the
+    #   *CloudFormation User Guide*. To import resources that do not accept
+    #   custom names, such as EC2 instances, use the resource import feature
+    #   instead. For more information, see [Bringing existing resources into
+    #   CloudFormation management][2] in the *CloudFormation User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html
+    #
     # @return [Types::CreateChangeSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateChangeSetOutput#id #id} => String
@@ -1074,6 +1101,7 @@ module Aws::CloudFormation
     #     ],
     #     include_nested_stacks: false,
     #     on_stack_failure: "DO_NOTHING", # accepts DO_NOTHING, ROLLBACK, DELETE
+    #     import_existing_resources: false,
     #   })
     #
     # @example Response structure
@@ -1107,7 +1135,7 @@ module Aws::CloudFormation
     # @option params [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. For more information, go to
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -1120,7 +1148,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to the
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -1234,6 +1262,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation macros to perform
     #     custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -1266,6 +1299,11 @@ module Aws::CloudFormation
     #   in IAM policies. For more information, see [Controlling Access with
     #   Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
@@ -1553,6 +1591,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     operation_id: "ClientRequestToken",
     #     call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
@@ -2118,6 +2157,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     retain_stacks: false, # required
     #     operation_id: "ClientRequestToken",
@@ -2293,7 +2333,7 @@ module Aws::CloudFormation
     # Returns the inputs for the change set and a list of changes that
     # CloudFormation will make if you execute the change set. For more
     # information, see [Updating Stacks Using Change Sets][1] in the
-    # CloudFormation User Guide.
+    # *CloudFormation User Guide*.
     #
     #
     #
@@ -2333,6 +2373,7 @@ module Aws::CloudFormation
     #   * {Types::DescribeChangeSetOutput#parent_change_set_id #parent_change_set_id} => String
     #   * {Types::DescribeChangeSetOutput#root_change_set_id #root_change_set_id} => String
     #   * {Types::DescribeChangeSetOutput#on_stack_failure #on_stack_failure} => String
+    #   * {Types::DescribeChangeSetOutput#import_existing_resources #import_existing_resources} => Boolean
     #
     # @example Request syntax with placeholder values
     #
@@ -2394,6 +2435,7 @@ module Aws::CloudFormation
     #   resp.parent_change_set_id #=> String
     #   resp.root_change_set_id #=> String
     #   resp.on_stack_failure #=> String, one of "DO_NOTHING", "ROLLBACK", "DELETE"
+    #   resp.import_existing_resources #=> Boolean
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -2645,7 +2687,7 @@ module Aws::CloudFormation
 
     # Returns all stack related events for a specified stack in reverse
     # chronological order. For more information about a stack's event
-    # history, go to [Stacks][1] in the CloudFormation User Guide.
+    # history, go to [Stacks][1] in the *CloudFormation User Guide*.
     #
     # <note markdown="1"> You can list events for stacks that have failed to create or have been
     # deleted by specifying the unique stack identifier (stack ID).
@@ -3190,6 +3232,7 @@ module Aws::CloudFormation
     #   resp.stack_set_operation.operation_preferences.failure_tolerance_percentage #=> Integer
     #   resp.stack_set_operation.operation_preferences.max_concurrent_count #=> Integer
     #   resp.stack_set_operation.operation_preferences.max_concurrent_percentage #=> Integer
+    #   resp.stack_set_operation.operation_preferences.concurrency_mode #=> String, one of "STRICT_FAILURE_TOLERANCE", "SOFT_FAILURE_TOLERANCE"
     #   resp.stack_set_operation.retain_stacks #=> Boolean
     #   resp.stack_set_operation.administration_role_arn #=> String
     #   resp.stack_set_operation.execution_role_name #=> String
@@ -3224,7 +3267,7 @@ module Aws::CloudFormation
     # Returns the description for the specified stack; if no stack name was
     # specified, then it returns the description for all the stacks created.
     #
-    # <note markdown="1"> If the stack doesn't exist, an `ValidationError` is returned.
+    # <note markdown="1"> If the stack doesn't exist, a `ValidationError` is returned.
     #
     #  </note>
     #
@@ -3750,6 +3793,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     operation_id: "ClientRequestToken",
     #     call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
@@ -3775,7 +3819,7 @@ module Aws::CloudFormation
     # @option params [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. (For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
     #   are passed, only `TemplateBody` is used.
@@ -3788,7 +3832,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template that's located in an Amazon S3 bucket or a Systems Manager
     #   document. For more information, go to [Template Anatomy][1] in the
-    #   CloudFormation User Guide.
+    #   *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.
@@ -4022,7 +4066,8 @@ module Aws::CloudFormation
     # @option params [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. For more information about
-    #   templates, see [Template anatomy][1] in the CloudFormation User Guide.
+    #   templates, see [Template anatomy][1] in the *CloudFormation User
+    #   Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -4035,7 +4080,8 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information about
-    #   templates, see [Template anatomy][1] in the CloudFormation User Guide.
+    #   templates, see [Template anatomy][1] in the *CloudFormation User
+    #   Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -4217,6 +4263,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     operation_id: "ClientRequestToken",
     #     call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
@@ -4276,6 +4323,7 @@ module Aws::CloudFormation
     #   resp.summaries[0].include_nested_stacks #=> Boolean
     #   resp.summaries[0].parent_change_set_id #=> String
     #   resp.summaries[0].root_change_set_id #=> String
+    #   resp.summaries[0].import_existing_resources #=> Boolean
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListChangeSets AWS API Documentation
@@ -4833,6 +4881,7 @@ module Aws::CloudFormation
     #   resp.summaries[0].operation_preferences.failure_tolerance_percentage #=> Integer
     #   resp.summaries[0].operation_preferences.max_concurrent_count #=> Integer
     #   resp.summaries[0].operation_preferences.max_concurrent_percentage #=> Integer
+    #   resp.summaries[0].operation_preferences.concurrency_mode #=> String, one of "STRICT_FAILURE_TOLERANCE", "SOFT_FAILURE_TOLERANCE"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetOperations AWS API Documentation
@@ -5612,7 +5661,7 @@ module Aws::CloudFormation
     #
     #   For CloudFormation to assume the specified execution role, the role
     #   must contain a trust relationship with the CloudFormation service
-    #   principle (`resources.cloudformation.amazonaws.com`). For more
+    #   principal (`resources.cloudformation.amazonaws.com`). For more
     #   information about adding trust relationships, see [Modifying a role
     #   trust policy][1] in the *Identity and Access Management User Guide*.
     #
@@ -5740,8 +5789,8 @@ module Aws::CloudFormation
     #
     # @option params [String] :stack_policy_body
     #   Structure containing the stack policy body. For more information, go
-    #   to [ Prevent updates to stack resources][1] in the CloudFormation User
-    #   Guide. You can specify either the `StackPolicyBody` or the
+    #   to [ Prevent updates to stack resources][1] in the *CloudFormation
+    #   User Guide*. You can specify either the `StackPolicyBody` or the
     #   `StackPolicyURL` parameter, but not both.
     #
     #
@@ -6145,7 +6194,7 @@ module Aws::CloudFormation
     # @option params [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. (For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -6159,7 +6208,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template that's located in an Amazon S3 bucket or a Systems Manager
     #   document. For more information, go to [Template Anatomy][1] in the
-    #   CloudFormation User Guide.
+    #   *CloudFormation User Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -6282,6 +6331,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation Macros to Perform
     #     Custom Processing on Templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -6308,6 +6362,11 @@ module Aws::CloudFormation
     #   in IAM policies. For more information, see [Controlling Access with
     #   Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
@@ -6625,6 +6684,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     operation_id: "ClientRequestToken",
     #     call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
@@ -6998,6 +7058,7 @@ module Aws::CloudFormation
     #       failure_tolerance_percentage: 1,
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
+    #       concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
     #     },
     #     administration_role_arn: "RoleARN",
     #     execution_role_name: "ExecutionRoleName",
@@ -7087,7 +7148,7 @@ module Aws::CloudFormation
     # @option params [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.
@@ -7100,7 +7161,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template (max size: 460,800 bytes) that is located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.
@@ -7160,7 +7221,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.91.0'
+      context[:gem_version] = '1.93.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -69,6 +69,7 @@ module Aws::CloudFormation
     Changes = Shapes::ListShape.new(name: 'Changes')
     ClientRequestToken = Shapes::StringShape.new(name: 'ClientRequestToken')
     ClientToken = Shapes::StringShape.new(name: 'ClientToken')
+    ConcurrencyMode = Shapes::StringShape.new(name: 'ConcurrencyMode')
     ConfigurationSchema = Shapes::StringShape.new(name: 'ConfigurationSchema')
     ConnectionArn = Shapes::StringShape.new(name: 'ConnectionArn')
     ContinueUpdateRollbackInput = Shapes::StructureShape.new(name: 'ContinueUpdateRollbackInput')
@@ -178,6 +179,7 @@ module Aws::CloudFormation
     HookTypeName = Shapes::StringShape.new(name: 'HookTypeName')
     HookTypeVersionId = Shapes::StringShape.new(name: 'HookTypeVersionId')
     IdentityProvider = Shapes::StringShape.new(name: 'IdentityProvider')
+    ImportExistingResources = Shapes::BooleanShape.new(name: 'ImportExistingResources')
     ImportStacksToStackSetInput = Shapes::StructureShape.new(name: 'ImportStacksToStackSetInput')
     ImportStacksToStackSetOutput = Shapes::StructureShape.new(name: 'ImportStacksToStackSetOutput')
     Imports = Shapes::ListShape.new(name: 'Imports')
@@ -598,6 +600,7 @@ module Aws::CloudFormation
     ChangeSetSummary.add_member(:include_nested_stacks, Shapes::ShapeRef.new(shape: IncludeNestedStacks, location_name: "IncludeNestedStacks"))
     ChangeSetSummary.add_member(:parent_change_set_id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "ParentChangeSetId"))
     ChangeSetSummary.add_member(:root_change_set_id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "RootChangeSetId"))
+    ChangeSetSummary.add_member(:import_existing_resources, Shapes::ShapeRef.new(shape: ImportExistingResources, location_name: "ImportExistingResources"))
     ChangeSetSummary.struct_class = Types::ChangeSetSummary
 
     Changes.member = Shapes::ShapeRef.new(shape: Change)
@@ -628,6 +631,7 @@ module Aws::CloudFormation
     CreateChangeSetInput.add_member(:resources_to_import, Shapes::ShapeRef.new(shape: ResourcesToImport, location_name: "ResourcesToImport"))
     CreateChangeSetInput.add_member(:include_nested_stacks, Shapes::ShapeRef.new(shape: IncludeNestedStacks, location_name: "IncludeNestedStacks"))
     CreateChangeSetInput.add_member(:on_stack_failure, Shapes::ShapeRef.new(shape: OnStackFailure, location_name: "OnStackFailure"))
+    CreateChangeSetInput.add_member(:import_existing_resources, Shapes::ShapeRef.new(shape: ImportExistingResources, location_name: "ImportExistingResources"))
     CreateChangeSetInput.struct_class = Types::CreateChangeSetInput
 
     CreateChangeSetOutput.add_member(:id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "Id"))
@@ -795,6 +799,7 @@ module Aws::CloudFormation
     DescribeChangeSetOutput.add_member(:parent_change_set_id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "ParentChangeSetId"))
     DescribeChangeSetOutput.add_member(:root_change_set_id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "RootChangeSetId"))
     DescribeChangeSetOutput.add_member(:on_stack_failure, Shapes::ShapeRef.new(shape: OnStackFailure, location_name: "OnStackFailure"))
+    DescribeChangeSetOutput.add_member(:import_existing_resources, Shapes::ShapeRef.new(shape: ImportExistingResources, location_name: "ImportExistingResources"))
     DescribeChangeSetOutput.struct_class = Types::DescribeChangeSetOutput
 
     DescribeOrganizationsAccessInput.add_member(:call_as, Shapes::ShapeRef.new(shape: CallAs, location_name: "CallAs"))
@@ -1632,6 +1637,7 @@ module Aws::CloudFormation
     StackSetOperationPreferences.add_member(:failure_tolerance_percentage, Shapes::ShapeRef.new(shape: FailureTolerancePercentage, location_name: "FailureTolerancePercentage"))
     StackSetOperationPreferences.add_member(:max_concurrent_count, Shapes::ShapeRef.new(shape: MaxConcurrentCount, location_name: "MaxConcurrentCount"))
     StackSetOperationPreferences.add_member(:max_concurrent_percentage, Shapes::ShapeRef.new(shape: MaxConcurrentPercentage, location_name: "MaxConcurrentPercentage"))
+    StackSetOperationPreferences.add_member(:concurrency_mode, Shapes::ShapeRef.new(shape: ConcurrencyMode, location_name: "ConcurrencyMode"))
     StackSetOperationPreferences.struct_class = Types::StackSetOperationPreferences
 
     StackSetOperationResultSummaries.member = Shapes::ShapeRef.new(shape: StackSetOperationResultSummary)

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

@@ -32,8 +32,8 @@ module Aws::CloudFormation
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-              if Aws::Endpoints::Matchers.string_equals?("aws-us-gov", Aws::Endpoints::Matchers.attr(partition_result, "name"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
+              if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws-us-gov")
                 return Aws::Endpoints::Endpoint.new(url: "https://cloudformation.#{region}.amazonaws.com", headers: {}, properties: {})
               end
               return Aws::Endpoints::Endpoint.new(url: "https://cloudformation-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})

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

@@ -90,7 +90,7 @@ module Aws::CloudFormation
     # @option options [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. For more information, go to
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -102,7 +102,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to the
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -210,6 +210,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation macros to perform
     #     custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -241,6 +246,11 @@ module Aws::CloudFormation
     #   in IAM policies. For more information, see [Controlling Access with
     #   Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html

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

@@ -455,7 +455,7 @@ module Aws::CloudFormation
     # @option options [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. For more information, go to
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -467,7 +467,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to the
-    #   [Template anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -575,6 +575,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation macros to perform
     #     custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -606,6 +611,11 @@ module Aws::CloudFormation
     #   in IAM policies. For more information, see [Controlling Access with
     #   Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
@@ -796,7 +806,7 @@ module Aws::CloudFormation
     # @option options [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
     #   and a maximum length of 51,200 bytes. (For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -809,7 +819,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to a
     #   template that's located in an Amazon S3 bucket or a Systems Manager
     #   document. For more information, go to [Template Anatomy][1] in the
-    #   CloudFormation User Guide.
+    #   *CloudFormation User Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -927,6 +937,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation Macros to Perform
     #     Custom Processing on Templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -952,6 +967,11 @@ module Aws::CloudFormation
     #   in IAM policies. For more information, see [Controlling Access with
     #   Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html

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

@@ -580,6 +580,10 @@ module Aws::CloudFormation
     #   The root change set ID.
     #   @return [String]
     #
+    # @!attribute [rw] import_existing_resources
+    #   Indicates if the stack set imports resources that already exist.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetSummary AWS API Documentation
     #
     class ChangeSetSummary < Struct.new(
@@ -594,7 +598,8 @@ module Aws::CloudFormation
       :description,
       :include_nested_stacks,
       :parent_change_set_id,
-      :root_change_set_id)
+      :root_change_set_id,
+      :import_existing_resources)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -811,6 +816,11 @@ module Aws::CloudFormation
     #     For more information about macros, see [Using CloudFormation
     #     macros to perform custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -836,8 +846,13 @@ module Aws::CloudFormation
     #   grants permissions to all resource types. Identity and Access
     #   Management (IAM) uses this parameter for condition keys in IAM
     #   policies for CloudFormation. For more information, see [Controlling
-    #   access with Identity and Access Management][1] in the CloudFormation
-    #   User Guide.
+    #   access with Identity and Access Management][1] in the
+    #   *CloudFormation User Guide*.
+    #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
     #
     #
     #
@@ -958,6 +973,24 @@ module Aws::CloudFormation
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html
     #   @return [String]
     #
+    # @!attribute [rw] import_existing_resources
+    #   Indicates if the stack set imports resources that already exist.
+    #
+    #   <note markdown="1"> This parameter can only import resources that have custom names in
+    #   templates. For more information, see [name type][1] in the
+    #   *CloudFormation User Guide*. To import resources that do not accept
+    #   custom names, such as EC2 instances, use the resource import feature
+    #   instead. For more information, see [Bringing existing resources into
+    #   CloudFormation management][2] in the *CloudFormation User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSetInput AWS API Documentation
     #
     class CreateChangeSetInput < Struct.new(
@@ -978,7 +1011,8 @@ module Aws::CloudFormation
       :change_set_type,
       :resources_to_import,
       :include_nested_stacks,
-      :on_stack_failure)
+      :on_stack_failure,
+      :import_existing_resources)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1018,7 +1052,7 @@ module Aws::CloudFormation
     # @!attribute [rw] template_body
     #   Structure containing the template body with a minimum length of 1
     #   byte and a maximum length of 51,200 bytes. For more information, go
-    #   to [Template anatomy][1] in the CloudFormation User Guide.
+    #   to [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -1032,7 +1066,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to
     #   a template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to
-    #   the [Template anatomy][1] in the CloudFormation User Guide.
+    #   the [Template anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -1153,6 +1187,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation macros to perform
     #     custom processing on templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -1187,6 +1226,11 @@ module Aws::CloudFormation
     #   information, see [Controlling Access with Identity and Access
     #   Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
@@ -2401,6 +2445,21 @@ module Aws::CloudFormation
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html
     #   @return [String]
     #
+    # @!attribute [rw] import_existing_resources
+    #   Indicates if the stack set imports resources that already exist.
+    #
+    #   <note markdown="1"> This parameter can only import resources that have [custom names][1]
+    #   in templates. To import resources that do not accept custom names,
+    #   such as EC2 instances, use the [resource import][2] feature instead.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeChangeSetOutput AWS API Documentation
     #
     class DescribeChangeSetOutput < Struct.new(
@@ -2423,7 +2482,8 @@ module Aws::CloudFormation
       :include_nested_stacks,
       :parent_change_set_id,
       :root_change_set_id,
-      :on_stack_failure)
+      :on_stack_failure,
+      :import_existing_resources)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3665,7 +3725,7 @@ module Aws::CloudFormation
     # @!attribute [rw] template_body
     #   Structure containing the template body with a minimum length of 1
     #   byte and a maximum length of 51,200 bytes. (For more information, go
-    #   to [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   to [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
     #   are passed, only `TemplateBody` is used.
@@ -3679,7 +3739,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to
     #   a template that's located in an Amazon S3 bucket or a Systems
     #   Manager document. For more information, go to [Template Anatomy][1]
-    #   in the CloudFormation User Guide.
+    #   in the *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.
@@ -3835,8 +3895,8 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] stack_policy_body
     #   Structure containing the stack policy body. (For more information,
-    #   go to [ Prevent Updates to Stack Resources][1] in the CloudFormation
-    #   User Guide.)
+    #   go to [ Prevent Updates to Stack Resources][1] in the
+    #   *CloudFormation User Guide*.)
     #
     #
     #
@@ -3896,7 +3956,7 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] template_body
     #   Structure containing the template body. (For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   CloudFormation returns the same template that was used when the
     #   stack was created.
@@ -3928,8 +3988,8 @@ module Aws::CloudFormation
     # @!attribute [rw] template_body
     #   Structure containing the template body with a minimum length of 1
     #   byte and a maximum length of 51,200 bytes. For more information
-    #   about templates, see [Template anatomy][1] in the CloudFormation
-    #   User Guide.
+    #   about templates, see [Template anatomy][1] in the *CloudFormation
+    #   User Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3943,8 +4003,8 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to
     #   a template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information about
-    #   templates, see [Template anatomy][1] in the CloudFormation User
-    #   Guide.
+    #   templates, see [Template anatomy][1] in the *CloudFormation User
+    #   Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -5779,7 +5839,7 @@ module Aws::CloudFormation
     #
     #   For CloudFormation to assume the specified execution role, the role
     #   must contain a trust relationship with the CloudFormation service
-    #   principle (`resources.cloudformation.amazonaws.com`). For more
+    #   principal (`resources.cloudformation.amazonaws.com`). For more
     #   information about adding trust relationships, see [Modifying a role
     #   trust policy][1] in the *Identity and Access Management User Guide*.
     #
@@ -6309,8 +6369,8 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] stack_policy_body
     #   Structure containing the stack policy body. For more information, go
-    #   to [ Prevent updates to stack resources][1] in the CloudFormation
-    #   User Guide. You can specify either the `StackPolicyBody` or the
+    #   to [ Prevent updates to stack resources][1] in the *CloudFormation
+    #   User Guide*. You can specify either the `StackPolicyBody` or the
     #   `StackPolicyURL` parameter, but not both.
     #
     #
@@ -8177,9 +8237,10 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] max_concurrent_count
     #   The maximum number of accounts in which to perform this operation at
-    #   one time. This is dependent on the value of
-    #   `FailureToleranceCount`.`MaxConcurrentCount` is at most one more
-    #   than the `FailureToleranceCount`.
+    #   one time. This can depend on the value of `FailureToleranceCount`
+    #   depending on your `ConcurrencyMode`. `MaxConcurrentCount` is at most
+    #   one more than the `FailureToleranceCount` if you're using
+    #   `STRICT_FAILURE_TOLERANCE`.
     #
     #   Note that this setting lets you specify the *maximum* for
     #   operations. For large deployments, under certain circumstances the
@@ -8212,6 +8273,28 @@ module Aws::CloudFormation
     #   By default, `1` is specified.
     #   @return [Integer]
     #
+    # @!attribute [rw] concurrency_mode
+    #   Specifies how the concurrency level behaves during the operation
+    #   execution.
+    #
+    #   * `STRICT_FAILURE_TOLERANCE`: This option dynamically lowers the
+    #     concurrency level to ensure the number of failed accounts never
+    #     exceeds the value of `FailureToleranceCount` +1. The initial
+    #     actual concurrency is set to the lower of either the value of the
+    #     `MaxConcurrentCount`, or the value of `MaxConcurrentCount` +1. The
+    #     actual concurrency is then reduced proportionally by the number of
+    #     failures. This is the default behavior.
+    #
+    #     If failure tolerance or Maximum concurrent accounts are set to
+    #     percentages, the behavior is similar.
+    #
+    #   * `SOFT_FAILURE_TOLERANCE`: This option decouples
+    #     `FailureToleranceCount` from the actual concurrency. This allows
+    #     stack set operations to run at the concurrency level set by the
+    #     `MaxConcurrentCount` value, or `MaxConcurrentPercentage`,
+    #     regardless of the number of failures.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetOperationPreferences AWS API Documentation
     #
     class StackSetOperationPreferences < Struct.new(
@@ -8220,7 +8303,8 @@ module Aws::CloudFormation
       :failure_tolerance_count,
       :failure_tolerance_percentage,
       :max_concurrent_count,
-      :max_concurrent_percentage)
+      :max_concurrent_percentage,
+      :concurrency_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9220,7 +9304,7 @@ module Aws::CloudFormation
     # @!attribute [rw] template_body
     #   Structure containing the template body with a minimum length of 1
     #   byte and a maximum length of 51,200 bytes. (For more information, go
-    #   to [Template Anatomy][1] in the CloudFormation User Guide.)
+    #   to [Template Anatomy][1] in the *CloudFormation User Guide*.)
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -9235,7 +9319,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to
     #   a template that's located in an Amazon S3 bucket or a Systems
     #   Manager document. For more information, go to [Template Anatomy][1]
-    #   in the CloudFormation User Guide.
+    #   in the *CloudFormation User Guide*.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -9363,6 +9447,11 @@ module Aws::CloudFormation
     #     For more information, see [Using CloudFormation Macros to Perform
     #     Custom Processing on Templates][11].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
@@ -9390,6 +9479,11 @@ module Aws::CloudFormation
     #   condition keys in IAM policies. For more information, see
     #   [Controlling Access with Identity and Access Management][1].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
@@ -10092,7 +10186,7 @@ module Aws::CloudFormation
     # @!attribute [rw] template_body
     #   Structure containing the template body with a minimum length of 1
     #   byte and a maximum length of 51,200 bytes. For more information, go
-    #   to [Template Anatomy][1] in the CloudFormation User Guide.
+    #   to [Template Anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.
@@ -10106,7 +10200,7 @@ module Aws::CloudFormation
     #   Location of file containing the template body. The URL must point to
     #   a template (max size: 460,800 bytes) that is located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to
-    #   [Template Anatomy][1] in the CloudFormation User Guide.
+    #   [Template Anatomy][1] in the *CloudFormation User Guide*.
     #
     #   Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
     #   are passed, only `TemplateBody` is used.

data/lib/aws-sdk-cloudformation.rb

@@ -57,6 +57,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
 # @!group service
 module Aws::CloudFormation
 
-  GEM_VERSION = '1.91.0'
+  GEM_VERSION = '1.93.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.91.0
+  version: 1.93.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-16 00:00:00.000000000 Z
+date: 2023-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core