aws-sdk-cloudformation 1.41.0 → 1.131.0

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

@@ -2,7 +2,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing for info on making contributions:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws::CloudFormation
+  # Endpoint parameters used to influence endpoints per request.
+  #
+  # @!attribute region
+  #   The AWS region used to dispatch the request.
+  #
+  #   @return [String]
+  #
+  # @!attribute use_dual_stack
+  #   When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
+  #
+  #   @return [Boolean]
+  #
+  # @!attribute use_fips
+  #   When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
+  #
+  #   @return [Boolean]
+  #
+  # @!attribute endpoint
+  #   Override the endpoint used to send this request
+  #
+  #   @return [String]
+  #
+  EndpointParameters = Struct.new(
+    :region,
+    :use_dual_stack,
+    :use_fips,
+    :endpoint,
+  ) do
+    include Aws::Structure
+
+    # @api private
+    class << self
+      PARAM_MAP = {
+        'Region' => :region,
+        'UseDualStack' => :use_dual_stack,
+        'UseFIPS' => :use_fips,
+        'Endpoint' => :endpoint,
+      }.freeze
+    end
+
+    def initialize(options = {})
+      self[:region] = options[:region]
+      self[:use_dual_stack] = options[:use_dual_stack]
+      self[:use_dual_stack] = false if self[:use_dual_stack].nil?
+      self[:use_fips] = options[:use_fips]
+      self[:use_fips] = false if self[:use_fips].nil?
+      self[:endpoint] = options[:endpoint]
+    end
+
+    def self.create(config, options={})
+      new({
+        region: config.region,
+        use_dual_stack: config.use_dualstack_endpoint,
+        use_fips: config.use_fips_endpoint,
+        endpoint: (config.endpoint.to_s unless config.regional_endpoint),
+      }.merge(options))
+    end
+  end
+end

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws::CloudFormation
+  class EndpointProvider
+    def resolve_endpoint(parameters)
+      if Aws::Endpoints::Matchers.set?(parameters.endpoint)
+        if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: parameters.endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(parameters.region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(parameters.region))
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://cloudformation-fips.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
+            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.#{parameters.region}.amazonaws.com", headers: {}, properties: {})
+              end
+              return Aws::Endpoints::Endpoint.new(url: "https://cloudformation-fips.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://cloudformation.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          end
+          return Aws::Endpoints::Endpoint.new(url: "https://cloudformation.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+        end
+      end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
+      raise ArgumentError, 'No endpoint could be resolved'
+
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::CloudFormation
+  # @api private
+  module Endpoints
+
+
+    def self.parameters_for_operation(context)
+      Aws::CloudFormation::EndpointParameters.create(context.config)
+    end
+  end
+end

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -30,26 +30,46 @@ module Aws::CloudFormation
   # * {AlreadyExistsException}
   # * {CFNRegistryException}
   # * {ChangeSetNotFoundException}
+  #    * This error class is not used. `ChangeSetNotFound` is used during parsing instead.
+  # * {ConcurrentResourcesLimitExceededException}
+  #    * This error class is not used. `ConcurrentResourcesLimitExceeded` is used during parsing instead.
   # * {CreatedButModifiedException}
+  # * {GeneratedTemplateNotFoundException}
+  #    * This error class is not used. `GeneratedTemplateNotFound` is used during parsing instead.
+  # * {HookResultNotFoundException}
+  #    * This error class is not used. `HookResultNotFound` is used during parsing instead.
   # * {InsufficientCapabilitiesException}
   # * {InvalidChangeSetStatusException}
+  #    * This error class is not used. `InvalidChangeSetStatus` is used during parsing instead.
   # * {InvalidOperationException}
   # * {InvalidStateTransitionException}
+  #    * This error class is not used. `InvalidStateTransition` is used during parsing instead.
   # * {LimitExceededException}
   # * {NameAlreadyExistsException}
   # * {OperationIdAlreadyExistsException}
   # * {OperationInProgressException}
   # * {OperationNotFoundException}
   # * {OperationStatusCheckFailedException}
+  #    * This error class is not used. `ConditionalCheckFailed` is used during parsing instead.
+  # * {ResourceScanInProgressException}
+  #    * This error class is not used. `ResourceScanInProgress` is used during parsing instead.
+  # * {ResourceScanLimitExceededException}
+  #    * This error class is not used. `ResourceScanLimitExceeded` is used during parsing instead.
+  # * {ResourceScanNotFoundException}
+  #    * This error class is not used. `ResourceScanNotFound` is used during parsing instead.
   # * {StackInstanceNotFoundException}
+  # * {StackNotFoundException}
+  # * {StackRefactorNotFoundException}
   # * {StackSetNotEmptyException}
   # * {StackSetNotFoundException}
   # * {StaleRequestException}
   # * {TokenAlreadyExistsException}
+  # * {TypeConfigurationNotFoundException}
   # * {TypeNotFoundException}
   #
   # Additionally, error classes are dynamically generated for service errors based on the error code
   # if they are not defined above.
+  # Some existing error classes may use a different class name than the one documented.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -79,6 +99,8 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ChangeSetNotFound` instead.
     class ChangeSetNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -89,6 +111,18 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ConcurrentResourcesLimitExceeded` instead.
+    class ConcurrentResourcesLimitExceededException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::ConcurrentResourcesLimitExceededException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class CreatedButModifiedException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -99,6 +133,30 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `GeneratedTemplateNotFound` instead.
+    class GeneratedTemplateNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::GeneratedTemplateNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    # @deprecated This error class is not used during parsing.
+    #   Please use `HookResultNotFound` instead.
+    class HookResultNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::HookResultNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class InsufficientCapabilitiesException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -109,6 +167,8 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidChangeSetStatus` instead.
     class InvalidChangeSetStatusException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -129,6 +189,8 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidStateTransition` instead.
     class InvalidStateTransitionException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -189,6 +251,8 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ConditionalCheckFailed` instead.
     class OperationStatusCheckFailedException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -199,6 +263,42 @@ module Aws::CloudFormation
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ResourceScanInProgress` instead.
+    class ResourceScanInProgressException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::ResourceScanInProgressException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ResourceScanLimitExceeded` instead.
+    class ResourceScanLimitExceededException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::ResourceScanLimitExceededException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ResourceScanNotFound` instead.
+    class ResourceScanNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::ResourceScanNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class StackInstanceNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -209,6 +309,26 @@ module Aws::CloudFormation
       end
     end
 
+    class StackNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::StackNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class StackRefactorNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::StackRefactorNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class StackSetNotEmptyException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -249,6 +369,16 @@ module Aws::CloudFormation
       end
     end
 
+    class TypeConfigurationNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudFormation::Types::TypeConfigurationNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class TypeNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -60,8 +60,9 @@ module Aws::CloudFormation
       data[:physical_resource_id]
     end
 
-    # Type of resource. (For more information, go to [ AWS Resource Types
-    # Reference][1] in the AWS CloudFormation User Guide.)
+    # Type of resource. For more information, see [Amazon Web Services
+    # resource and property types reference][1] in the *CloudFormation User
+    # Guide*.
     #
     #
     #
@@ -115,6 +116,67 @@ module Aws::CloudFormation
       data[:client_request_token]
     end
 
+    # The name of the hook.
+    # @return [String]
+    def hook_type
+      data[:hook_type]
+    end
+
+    # Provides the status of the change set hook.
+    # @return [String]
+    def hook_status
+      data[:hook_status]
+    end
+
+    # Provides the reason for the hook status.
+    # @return [String]
+    def hook_status_reason
+      data[:hook_status_reason]
+    end
+
+    # Invocation points are points in provisioning logic where Hooks are
+    # initiated.
+    # @return [String]
+    def hook_invocation_point
+      data[:hook_invocation_point]
+    end
+
+    # Specify the hook failure mode for non-compliant resources in the
+    # followings ways.
+    #
+    # * `FAIL` Stops provisioning resources.
+    #
+    # * `WARN` Allows provisioning to continue with a warning message.
+    # @return [String]
+    def hook_failure_mode
+      data[:hook_failure_mode]
+    end
+
+    # An optional field containing information about the detailed status of
+    # the stack event.
+    #
+    # * `CONFIGURATION_COMPLETE` - all of the resources in the stack have
+    #   reached that event. For more information, see [Understand
+    #   CloudFormation stack creation events][1] in the *CloudFormation User
+    #   Guide*.
+    #
+    # ^
+    # ^
+    #
+    # * `VALIDATION_FAILED` - template validation failed because of invalid
+    #   properties in the template. The `ResourceStatusReason` field shows
+    #   what properties are defined incorrectly.
+    #
+    # ^
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
+    # @return [String]
+    def detailed_status
+      data[:detailed_status]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -239,7 +301,9 @@ module Aws::CloudFormation
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @deprecated

data/lib/aws-sdk-cloudformation/plugins/endpoints.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::CloudFormation
+  module Plugins
+    class Endpoints < Seahorse::Client::Plugin
+      option(
+        :endpoint_provider,
+        doc_type: 'Aws::CloudFormation::EndpointProvider',
+        rbs_type: 'untyped',
+        docstring: <<~DOCS) do |_cfg|
+The endpoint provider used to resolve endpoints. Any object that responds to
+`#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
+`Aws::CloudFormation::EndpointParameters`.
+        DOCS
+        Aws::CloudFormation::EndpointProvider.new
+      end
+
+      # @api private
+      class Handler < Seahorse::Client::Handler
+        def call(context)
+          unless context[:discovered_endpoint]
+            params = Aws::CloudFormation::Endpoints.parameters_for_operation(context)
+            endpoint = context.config.endpoint_provider.resolve_endpoint(params)
+
+            context.http_request.endpoint = endpoint.url
+            apply_endpoint_headers(context, endpoint.headers)
+
+            context[:endpoint_params] = params
+            context[:endpoint_properties] = endpoint.properties
+          end
+
+          context[:auth_scheme] =
+            Aws::Endpoints.resolve_auth_scheme(context, endpoint)
+
+          with_metrics(context) { @handler.call(context) }
+        end
+
+        private
+
+        def with_metrics(context, &block)
+          metrics = []
+          metrics << 'ENDPOINT_OVERRIDE' unless context.config.regional_endpoint
+          if context[:auth_scheme] && context[:auth_scheme]['name'] == 'sigv4a'
+            metrics << 'SIGV4A_SIGNING'
+          end
+          if context.config.credentials&.credentials&.account_id
+            metrics << 'RESOLVED_ACCOUNT_ID'
+          end
+          Aws::Plugins::UserAgent.metric(*metrics, &block)
+        end
+
+        def apply_endpoint_headers(context, headers)
+          headers.each do |key, values|
+            value = values
+              .compact
+              .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) }
+              .join(',')
+
+            context.http_request.headers[key] = value
+          end
+        end
+      end
+
+      def add_handlers(handlers, _config)
+        handlers.add(Handler, step: :build, priority: 75)
+      end
+    end
+  end
+end