aws-sdk-lambda 1.125.0 → 1.126.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40b3d33f4b2e56b8fc0b9c01478b440fe801d4acc908d2fd95a530436c4dfba7
-  data.tar.gz: 8e7edf24478d2fc571bb9aae8a37ceea0e06caf355ca05aac662a2b4d4c788d2
+  metadata.gz: a54010ae94a05040581a1afef5539329feb0d58a19fcd6093c38eeaed083043e
+  data.tar.gz: cf5c143be4454d9bc642bf5c377e1fbc6a7ec814346dc2c79f39a9ed197504d6
 SHA512:
-  metadata.gz: 87b0c01799c406f08a9f86ed387a71e19bf11966f2a4d3f2c4f863523df10f90700b170fd5167471d40004015e43e6a3f6c2a6d5d994c60f3b9faaf7701319af
-  data.tar.gz: f889aa647a68fa2feb2b8baf6838db582a8b5f299585c4e8574bfeb5e4f267a340bd9eb36c799a250ecf87cb58760b6064af1abcdff4c7857291f1bbcc812535
+  metadata.gz: f3eb80ef02225c35ce8fffb3bceac8d2b9c9954c31c0227d0a117186f817c304028f1d4c692b8b0b9d139d13f446fe8255098880a2ac2770017e87732899aafb
+  data.tar.gz: 42f64221e04f2e6f0ef8afb7df2d0e2cedcf3b0cd05f7eac15905a8091322a2068b760feb0d8a94b05efd791dfa6df971278da51745af1e58c8c9d5dfd4fbe82

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.126.0 (2024-08-19)
+------------------
+
+* Feature - Release Lambda FunctionRecursiveConfig, enabling customers to turn recursive loop detection on or off on individual functions. This release adds two new APIs, GetFunctionRecursionConfig and PutFunctionRecursionConfig.
+
 1.125.0 (2024-07-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.125.0
+1.126.0

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

@@ -937,16 +937,17 @@ module Aws::Lambda
     #   `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300
     #   seconds in increments of seconds.
     #
-    #   For streams and Amazon SQS event sources, the default batching window
-    #   is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ,
-    #   and DocumentDB event sources, the default batching window is 500 ms.
-    #   Note that because you can only change `MaximumBatchingWindowInSeconds`
-    #   in increments of seconds, you cannot revert back to the 500 ms default
-    #   batching window after you have changed it. To restore the default
-    #   batching window, you must create a new event source mapping.
-    #
-    #   Related setting: For streams and Amazon SQS event sources, when you
-    #   set `BatchSize` to a value greater than 10, you must set
+    #   For Kinesis, DynamoDB, and Amazon SQS event sources, the default
+    #   batching window is 0 seconds. For Amazon MSK, Self-managed Apache
+    #   Kafka, Amazon MQ, and DocumentDB event sources, the default batching
+    #   window is 500 ms. Note that because you can only change
+    #   `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot
+    #   revert back to the 500 ms default batching window after you have
+    #   changed it. To restore the default batching window, you must create a
+    #   new event source mapping.
+    #
+    #   Related setting: For Kinesis, DynamoDB, and Amazon SQS event sources,
+    #   when you set `BatchSize` to a value greater than 10, you must set
     #   `MaximumBatchingWindowInSeconds` to at least 1.
     #
     # @option params [Integer] :parallelization_factor
@@ -1252,16 +1253,24 @@ module Aws::Lambda
     #   only the function name, it is limited to 64 characters in length.
     #
     # @option params [String] :runtime
-    #   The identifier of the function's [runtime][1]. Runtime is required if
-    #   the deployment package is a .zip file archive.
+    #   The identifier of the function's [ runtime][1]. Runtime is required
+    #   if the deployment package is a .zip file archive. Specifying a runtime
+    #   results in an error if you're deploying a function using a container
+    #   image.
     #
-    #   The following list includes deprecated runtimes. For more information,
-    #   see [Runtime deprecation policy][2].
+    #   The following list includes deprecated runtimes. Lambda blocks
+    #   creating new functions and updating existing functions shortly after
+    #   each runtime is deprecated. For more information, see [Runtime use
+    #   after deprecation][2].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][3].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #
     # @option params [required, String] :role
     #   The Amazon Resource Name (ARN) of the function's execution role.
@@ -2786,6 +2795,37 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Returns your function's [recursive loop detection][1] configuration.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-recursion.html
+    #
+    # @option params [required, String] :function_name
+    #
+    # @return [Types::GetFunctionRecursionConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFunctionRecursionConfigResponse#recursive_loop #recursive_loop} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_function_recursion_config({
+    #     function_name: "UnqualifiedFunctionName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recursive_loop #=> String, one of "Allow", "Terminate"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunctionRecursionConfig AWS API Documentation
+    #
+    # @overload get_function_recursion_config(params = {})
+    # @param [Hash] params ({})
+    def get_function_recursion_config(params = {}, options = {})
+      req = build_request(:get_function_recursion_config, params)
+      req.send_request(options)
+    end
+
     # Returns details about a Lambda function URL.
     #
     # @option params [required, String] :function_name
@@ -4136,14 +4176,18 @@ module Aws::Lambda
     # [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
     #
     # @option params [String] :compatible_runtime
-    #   A runtime identifier. For example, `java21`.
+    #   A runtime identifier.
     #
     #   The following list includes deprecated runtimes. For more information,
-    #   see [Runtime deprecation policy][1].
+    #   see [Runtime use after deprecation][1].
     #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #
     # @option params [required, String] :layer_name
     #   The name or Amazon Resource Name (ARN) of the layer.
@@ -4214,14 +4258,18 @@ module Aws::Lambda
     # [3]: https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html
     #
     # @option params [String] :compatible_runtime
-    #   A runtime identifier. For example, `java21`.
+    #   A runtime identifier.
     #
     #   The following list includes deprecated runtimes. For more information,
-    #   see [Runtime deprecation policy][1].
+    #   see [Runtime use after deprecation][1].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #
     # @option params [String] :marker
     #   A pagination token returned by a previous call.
@@ -4993,6 +5041,91 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Sets your function's [recursive loop detection][1] configuration.
+    #
+    # When you configure a Lambda function to output to the same service or
+    # resource that invokes the function, it's possible to create an
+    # infinite recursive loop. For example, a Lambda function might write a
+    # message to an Amazon Simple Queue Service (Amazon SQS) queue, which
+    # then invokes the same function. This invocation causes the function to
+    # write another message to the queue, which in turn invokes the function
+    # again.
+    #
+    # Lambda can detect certain types of recursive loops shortly after they
+    # occur. When Lambda detects a recursive loop and your function's
+    # recursive loop detection configuration is set to `Terminate`, it stops
+    # your function being invoked and notifies you.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-recursion.html
+    #
+    # @option params [required, String] :function_name
+    #   The name or ARN of the Lambda function.
+    #
+    #   **Name formats**
+    #
+    #   * **Function name** – `my-function`.
+    #
+    #   * **Function ARN** –
+    #     `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+    #
+    #   * **Partial ARN** – `123456789012:function:my-function`.
+    #
+    #   The length constraint applies only to the full ARN. If you specify
+    #   only the function name, it is limited to 64 characters in length.
+    #
+    # @option params [required, String] :recursive_loop
+    #   If you set your function's recursive loop detection configuration to
+    #   `Allow`, Lambda doesn't take any action when it detects your function
+    #   being invoked as part of a recursive loop. We recommend that you only
+    #   use this setting if your design intentionally uses a Lambda function
+    #   to write data back to the same Amazon Web Services resource that
+    #   invokes it.
+    #
+    #   If you set your function's recursive loop detection configuration to
+    #   `Terminate`, Lambda stops your function being invoked and notifies you
+    #   when it detects your function being invoked as part of a recursive
+    #   loop.
+    #
+    #   By default, Lambda sets your function's configuration to `Terminate`.
+    #
+    #   If your design intentionally uses a Lambda function to write data back
+    #   to the same Amazon Web Services resource that invokes the function,
+    #   then use caution and implement suitable guard rails to prevent
+    #   unexpected charges being billed to your Amazon Web Services account.
+    #   To learn more about best practices for using recursive invocation
+    #   patterns, see [Recursive patterns that cause run-away Lambda
+    #   functions][1] in Serverless Land.
+    #
+    #
+    #
+    #   [1]: https://serverlessland.com/content/service/lambda/guides/aws-lambda-operator-guide/recursive-runaway
+    #
+    # @return [Types::PutFunctionRecursionConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutFunctionRecursionConfigResponse#recursive_loop #recursive_loop} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_function_recursion_config({
+    #     function_name: "UnqualifiedFunctionName", # required
+    #     recursive_loop: "Allow", # required, accepts Allow, Terminate
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recursive_loop #=> String, one of "Allow", "Terminate"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PutFunctionRecursionConfig AWS API Documentation
+    #
+    # @overload put_function_recursion_config(params = {})
+    # @param [Hash] params ({})
+    def put_function_recursion_config(params = {}, options = {})
+      req = build_request(:put_function_recursion_config, params)
+      req.send_request(options)
+    end
+
     # Adds a provisioned concurrency configuration to a function's alias or
     # version.
     #
@@ -5579,16 +5712,17 @@ module Aws::Lambda
     #   `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300
     #   seconds in increments of seconds.
     #
-    #   For streams and Amazon SQS event sources, the default batching window
-    #   is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ,
-    #   and DocumentDB event sources, the default batching window is 500 ms.
-    #   Note that because you can only change `MaximumBatchingWindowInSeconds`
-    #   in increments of seconds, you cannot revert back to the 500 ms default
-    #   batching window after you have changed it. To restore the default
-    #   batching window, you must create a new event source mapping.
-    #
-    #   Related setting: For streams and Amazon SQS event sources, when you
-    #   set `BatchSize` to a value greater than 10, you must set
+    #   For Kinesis, DynamoDB, and Amazon SQS event sources, the default
+    #   batching window is 0 seconds. For Amazon MSK, Self-managed Apache
+    #   Kafka, Amazon MQ, and DocumentDB event sources, the default batching
+    #   window is 500 ms. Note that because you can only change
+    #   `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot
+    #   revert back to the 500 ms default batching window after you have
+    #   changed it. To restore the default batching window, you must create a
+    #   new event source mapping.
+    #
+    #   Related setting: For Kinesis, DynamoDB, and Amazon SQS event sources,
+    #   when you set `BatchSize` to a value greater than 10, you must set
     #   `MaximumBatchingWindowInSeconds` to at least 1.
     #
     # @option params [Types::DestinationConfig] :destination_config
@@ -6072,16 +6206,24 @@ module Aws::Lambda
     #   execution.
     #
     # @option params [String] :runtime
-    #   The identifier of the function's [runtime][1]. Runtime is required if
-    #   the deployment package is a .zip file archive.
+    #   The identifier of the function's [ runtime][1]. Runtime is required
+    #   if the deployment package is a .zip file archive. Specifying a runtime
+    #   results in an error if you're deploying a function using a container
+    #   image.
     #
-    #   The following list includes deprecated runtimes. For more information,
-    #   see [Runtime deprecation policy][2].
+    #   The following list includes deprecated runtimes. Lambda blocks
+    #   creating new functions and updating existing functions shortly after
+    #   each runtime is deprecated. For more information, see [Runtime use
+    #   after deprecation][2].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][3].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #
     # @option params [Types::DeadLetterConfig] :dead_letter_config
     #   A dead-letter queue configuration that specifies the queue or topic
@@ -6543,7 +6685,7 @@ module Aws::Lambda
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-lambda'
-      context[:gem_version] = '1.125.0'
+      context[:gem_version] = '1.126.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -140,6 +140,8 @@ module Aws::Lambda
     GetFunctionConcurrencyResponse = Shapes::StructureShape.new(name: 'GetFunctionConcurrencyResponse')
     GetFunctionConfigurationRequest = Shapes::StructureShape.new(name: 'GetFunctionConfigurationRequest')
     GetFunctionEventInvokeConfigRequest = Shapes::StructureShape.new(name: 'GetFunctionEventInvokeConfigRequest')
+    GetFunctionRecursionConfigRequest = Shapes::StructureShape.new(name: 'GetFunctionRecursionConfigRequest')
+    GetFunctionRecursionConfigResponse = Shapes::StructureShape.new(name: 'GetFunctionRecursionConfigResponse')
     GetFunctionRequest = Shapes::StructureShape.new(name: 'GetFunctionRequest')
     GetFunctionResponse = Shapes::StructureShape.new(name: 'GetFunctionResponse')
     GetFunctionUrlConfigRequest = Shapes::StructureShape.new(name: 'GetFunctionUrlConfigRequest')
@@ -278,6 +280,8 @@ module Aws::Lambda
     PutFunctionCodeSigningConfigResponse = Shapes::StructureShape.new(name: 'PutFunctionCodeSigningConfigResponse')
     PutFunctionConcurrencyRequest = Shapes::StructureShape.new(name: 'PutFunctionConcurrencyRequest')
     PutFunctionEventInvokeConfigRequest = Shapes::StructureShape.new(name: 'PutFunctionEventInvokeConfigRequest')
+    PutFunctionRecursionConfigRequest = Shapes::StructureShape.new(name: 'PutFunctionRecursionConfigRequest')
+    PutFunctionRecursionConfigResponse = Shapes::StructureShape.new(name: 'PutFunctionRecursionConfigResponse')
     PutProvisionedConcurrencyConfigRequest = Shapes::StructureShape.new(name: 'PutProvisionedConcurrencyConfigRequest')
     PutProvisionedConcurrencyConfigResponse = Shapes::StructureShape.new(name: 'PutProvisionedConcurrencyConfigResponse')
     PutRuntimeManagementConfigRequest = Shapes::StructureShape.new(name: 'PutRuntimeManagementConfigRequest')
@@ -286,6 +290,7 @@ module Aws::Lambda
     Queue = Shapes::StringShape.new(name: 'Queue')
     Queues = Shapes::ListShape.new(name: 'Queues')
     RecursiveInvocationException = Shapes::StructureShape.new(name: 'RecursiveInvocationException')
+    RecursiveLoop = Shapes::StringShape.new(name: 'RecursiveLoop')
     RemoveLayerVersionPermissionRequest = Shapes::StructureShape.new(name: 'RemoveLayerVersionPermissionRequest')
     RemovePermissionRequest = Shapes::StructureShape.new(name: 'RemovePermissionRequest')
     RequestTooLargeException = Shapes::StructureShape.new(name: 'RequestTooLargeException')
@@ -349,6 +354,7 @@ module Aws::Lambda
     TracingMode = Shapes::StringShape.new(name: 'TracingMode')
     TumblingWindowInSeconds = Shapes::IntegerShape.new(name: 'TumblingWindowInSeconds')
     URI = Shapes::StringShape.new(name: 'URI')
+    UnqualifiedFunctionName = Shapes::StringShape.new(name: 'UnqualifiedFunctionName')
     UnreservedConcurrentExecutions = Shapes::IntegerShape.new(name: 'UnreservedConcurrentExecutions')
     UnsupportedMediaTypeException = Shapes::StructureShape.new(name: 'UnsupportedMediaTypeException')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
@@ -825,6 +831,12 @@ module Aws::Lambda
     GetFunctionEventInvokeConfigRequest.add_member(:qualifier, Shapes::ShapeRef.new(shape: Qualifier, location: "querystring", location_name: "Qualifier"))
     GetFunctionEventInvokeConfigRequest.struct_class = Types::GetFunctionEventInvokeConfigRequest
 
+    GetFunctionRecursionConfigRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: UnqualifiedFunctionName, required: true, location: "uri", location_name: "FunctionName"))
+    GetFunctionRecursionConfigRequest.struct_class = Types::GetFunctionRecursionConfigRequest
+
+    GetFunctionRecursionConfigResponse.add_member(:recursive_loop, Shapes::ShapeRef.new(shape: RecursiveLoop, location_name: "RecursiveLoop"))
+    GetFunctionRecursionConfigResponse.struct_class = Types::GetFunctionRecursionConfigResponse
+
     GetFunctionRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: NamespacedFunctionName, required: true, location: "uri", location_name: "FunctionName"))
     GetFunctionRequest.add_member(:qualifier, Shapes::ShapeRef.new(shape: Qualifier, location: "querystring", location_name: "Qualifier"))
     GetFunctionRequest.struct_class = Types::GetFunctionRequest
@@ -1250,6 +1262,13 @@ module Aws::Lambda
     PutFunctionEventInvokeConfigRequest.add_member(:destination_config, Shapes::ShapeRef.new(shape: DestinationConfig, location_name: "DestinationConfig"))
     PutFunctionEventInvokeConfigRequest.struct_class = Types::PutFunctionEventInvokeConfigRequest
 
+    PutFunctionRecursionConfigRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: UnqualifiedFunctionName, required: true, location: "uri", location_name: "FunctionName"))
+    PutFunctionRecursionConfigRequest.add_member(:recursive_loop, Shapes::ShapeRef.new(shape: RecursiveLoop, required: true, location_name: "RecursiveLoop"))
+    PutFunctionRecursionConfigRequest.struct_class = Types::PutFunctionRecursionConfigRequest
+
+    PutFunctionRecursionConfigResponse.add_member(:recursive_loop, Shapes::ShapeRef.new(shape: RecursiveLoop, location_name: "RecursiveLoop"))
+    PutFunctionRecursionConfigResponse.struct_class = Types::PutFunctionRecursionConfigResponse
+
     PutProvisionedConcurrencyConfigRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: FunctionName, required: true, location: "uri", location_name: "FunctionName"))
     PutProvisionedConcurrencyConfigRequest.add_member(:qualifier, Shapes::ShapeRef.new(shape: Qualifier, required: true, location: "querystring", location_name: "Qualifier"))
     PutProvisionedConcurrencyConfigRequest.add_member(:provisioned_concurrent_executions, Shapes::ShapeRef.new(shape: PositiveInteger, required: true, location_name: "ProvisionedConcurrentExecutions"))
@@ -1848,6 +1867,18 @@ module Aws::Lambda
         o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
       end)
 
+      api.add_operation(:get_function_recursion_config, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetFunctionRecursionConfig"
+        o.http_method = "GET"
+        o.http_request_uri = "/2024-08-31/functions/{FunctionName}/recursion-config"
+        o.input = Shapes::ShapeRef.new(shape: GetFunctionRecursionConfigRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetFunctionRecursionConfigResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceException)
+      end)
+
       api.add_operation(:get_function_url_config, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetFunctionUrlConfig"
         o.http_method = "GET"
@@ -2296,6 +2327,19 @@ module Aws::Lambda
         o.errors << Shapes::ShapeRef.new(shape: ResourceConflictException)
       end)
 
+      api.add_operation(:put_function_recursion_config, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutFunctionRecursionConfig"
+        o.http_method = "PUT"
+        o.http_request_uri = "/2024-08-31/functions/{FunctionName}/recursion-config"
+        o.input = Shapes::ShapeRef.new(shape: PutFunctionRecursionConfigRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutFunctionRecursionConfigResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceException)
+      end)
+
       api.add_operation(:put_provisioned_concurrency_config, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutProvisionedConcurrencyConfig"
         o.http_method = "PUT"

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

@@ -376,6 +376,20 @@ module Aws::Lambda
       end
     end
 
+    class GetFunctionRecursionConfig
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Lambda::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetFunctionUrlConfig
       def self.build(context)
         unless context.config.regional_endpoint
@@ -754,6 +768,20 @@ module Aws::Lambda
       end
     end
 
+    class PutFunctionRecursionConfig
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Lambda::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class PutProvisionedConcurrencyConfig
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -110,6 +110,8 @@ module Aws::Lambda
             Aws::Lambda::Endpoints::GetFunctionConfiguration.build(context)
           when :get_function_event_invoke_config
             Aws::Lambda::Endpoints::GetFunctionEventInvokeConfig.build(context)
+          when :get_function_recursion_config
+            Aws::Lambda::Endpoints::GetFunctionRecursionConfig.build(context)
           when :get_function_url_config
             Aws::Lambda::Endpoints::GetFunctionUrlConfig.build(context)
           when :get_layer_version
@@ -164,6 +166,8 @@ module Aws::Lambda
             Aws::Lambda::Endpoints::PutFunctionConcurrency.build(context)
           when :put_function_event_invoke_config
             Aws::Lambda::Endpoints::PutFunctionEventInvokeConfig.build(context)
+          when :put_function_recursion_config
+            Aws::Lambda::Endpoints::PutFunctionRecursionConfig.build(context)
           when :put_provisioned_concurrency_config
             Aws::Lambda::Endpoints::PutProvisionedConcurrencyConfig.build(context)
           when :put_runtime_management_config

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

@@ -735,18 +735,18 @@ module Aws::Lambda
     #   `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300
     #   seconds in increments of seconds.
     #
-    #   For streams and Amazon SQS event sources, the default batching
-    #   window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka,
-    #   Amazon MQ, and DocumentDB event sources, the default batching window
-    #   is 500 ms. Note that because you can only change
+    #   For Kinesis, DynamoDB, and Amazon SQS event sources, the default
+    #   batching window is 0 seconds. For Amazon MSK, Self-managed Apache
+    #   Kafka, Amazon MQ, and DocumentDB event sources, the default batching
+    #   window is 500 ms. Note that because you can only change
     #   `MaximumBatchingWindowInSeconds` in increments of seconds, you
     #   cannot revert back to the 500 ms default batching window after you
     #   have changed it. To restore the default batching window, you must
     #   create a new event source mapping.
     #
-    #   Related setting: For streams and Amazon SQS event sources, when you
-    #   set `BatchSize` to a value greater than 10, you must set
-    #   `MaximumBatchingWindowInSeconds` to at least 1.
+    #   Related setting: For Kinesis, DynamoDB, and Amazon SQS event
+    #   sources, when you set `BatchSize` to a value greater than 10, you
+    #   must set `MaximumBatchingWindowInSeconds` to at least 1.
     #   @return [Integer]
     #
     # @!attribute [rw] parallelization_factor
@@ -889,16 +889,24 @@ module Aws::Lambda
     #   @return [String]
     #
     # @!attribute [rw] runtime
-    #   The identifier of the function's [runtime][1]. Runtime is required
-    #   if the deployment package is a .zip file archive.
+    #   The identifier of the function's [ runtime][1]. Runtime is required
+    #   if the deployment package is a .zip file archive. Specifying a
+    #   runtime results in an error if you're deploying a function using a
+    #   container image.
     #
-    #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][2].
+    #   The following list includes deprecated runtimes. Lambda blocks
+    #   creating new functions and updating existing functions shortly after
+    #   each runtime is deprecated. For more information, see [Runtime use
+    #   after deprecation][2].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][3].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [String]
     #
     # @!attribute [rw] role
@@ -2154,16 +2162,24 @@ module Aws::Lambda
     #   @return [String]
     #
     # @!attribute [rw] runtime
-    #   The identifier of the function's [runtime][1]. Runtime is required
-    #   if the deployment package is a .zip file archive.
+    #   The identifier of the function's [ runtime][1]. Runtime is required
+    #   if the deployment package is a .zip file archive. Specifying a
+    #   runtime results in an error if you're deploying a function using a
+    #   container image.
     #
-    #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][2].
+    #   The following list includes deprecated runtimes. Lambda blocks
+    #   creating new functions and updating existing functions shortly after
+    #   each runtime is deprecated. For more information, see [Runtime use
+    #   after deprecation][2].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][3].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [String]
     #
     # @!attribute [rw] role
@@ -2760,6 +2776,40 @@ module Aws::Lambda
       include Aws::Structure
     end
 
+    # @!attribute [rw] function_name
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunctionRecursionConfigRequest AWS API Documentation
+    #
+    class GetFunctionRecursionConfigRequest < Struct.new(
+      :function_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] recursive_loop
+    #   If your function's recursive loop detection configuration is
+    #   `Allow`, Lambda doesn't take any action when it detects your
+    #   function being invoked as part of a recursive loop.
+    #
+    #   If your function's recursive loop detection configuration is
+    #   `Terminate`, Lambda stops your function being invoked and notifies
+    #   you when it detects your function being invoked as part of a
+    #   recursive loop.
+    #
+    #   By default, Lambda sets your function's configuration to
+    #   `Terminate`. You can update this configuration using the
+    #   PutFunctionRecursionConfig action.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunctionRecursionConfigResponse AWS API Documentation
+    #
+    class GetFunctionRecursionConfigResponse < Struct.new(
+      :recursive_loop)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] function_name
     #   The name or ARN of the Lambda function, version, or alias.
     #
@@ -3032,11 +3082,15 @@ module Aws::Lambda
     #   The layer's compatible runtimes.
     #
     #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][1].
+    #   information, see [Runtime use after deprecation][1].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [Array<String>]
     #
     # @!attribute [rw] license_info
@@ -3939,11 +3993,15 @@ module Aws::Lambda
     #   The layer's compatible runtimes.
     #
     #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][1].
+    #   information, see [Runtime use after deprecation][1].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [Array<String>]
     #
     # @!attribute [rw] license_info
@@ -4376,14 +4434,18 @@ module Aws::Lambda
     end
 
     # @!attribute [rw] compatible_runtime
-    #   A runtime identifier. For example, `java21`.
+    #   A runtime identifier.
     #
     #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][1].
+    #   information, see [Runtime use after deprecation][1].
     #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [String]
     #
     # @!attribute [rw] layer_name
@@ -4437,14 +4499,18 @@ module Aws::Lambda
     end
 
     # @!attribute [rw] compatible_runtime
-    #   A runtime identifier. For example, `java21`.
+    #   A runtime identifier.
     #
     #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][1].
+    #   information, see [Runtime use after deprecation][1].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [String]
     #
     # @!attribute [rw] marker
@@ -4733,8 +4799,13 @@ module Aws::Lambda
     end
 
     # The RevisionId provided does not match the latest RevisionId for the
-    # Lambda function or alias. Call the `GetFunction` or the `GetAlias` API
-    # operation to retrieve the latest RevisionId for your resource.
+    # Lambda function or alias.
+    #
+    # * **For AddPermission and RemovePermission API operations:** Call
+    #   `GetPolicy` to retrieve the latest RevisionId for your resource.
+    #
+    # * **For all other API operations:** Call `GetFunction` or `GetAlias`
+    #   to retrieve the latest RevisionId for your resource.
     #
     # @!attribute [rw] type
     #   The exception type.
@@ -4918,11 +4989,15 @@ module Aws::Lambda
     #   The layer's compatible runtimes.
     #
     #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][1].
+    #   information, see [Runtime use after deprecation][1].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [Array<String>]
     #
     # @!attribute [rw] license_info
@@ -5148,6 +5223,81 @@ module Aws::Lambda
       include Aws::Structure
     end
 
+    # @!attribute [rw] function_name
+    #   The name or ARN of the Lambda function.
+    #
+    #   **Name formats**
+    #
+    #   * **Function name** – `my-function`.
+    #
+    #   * **Function ARN** –
+    #     `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+    #
+    #   * **Partial ARN** – `123456789012:function:my-function`.
+    #
+    #   The length constraint applies only to the full ARN. If you specify
+    #   only the function name, it is limited to 64 characters in length.
+    #   @return [String]
+    #
+    # @!attribute [rw] recursive_loop
+    #   If you set your function's recursive loop detection configuration
+    #   to `Allow`, Lambda doesn't take any action when it detects your
+    #   function being invoked as part of a recursive loop. We recommend
+    #   that you only use this setting if your design intentionally uses a
+    #   Lambda function to write data back to the same Amazon Web Services
+    #   resource that invokes it.
+    #
+    #   If you set your function's recursive loop detection configuration
+    #   to `Terminate`, Lambda stops your function being invoked and
+    #   notifies you when it detects your function being invoked as part of
+    #   a recursive loop.
+    #
+    #   By default, Lambda sets your function's configuration to
+    #   `Terminate`.
+    #
+    #   If your design intentionally uses a Lambda function to write data
+    #   back to the same Amazon Web Services resource that invokes the
+    #   function, then use caution and implement suitable guard rails to
+    #   prevent unexpected charges being billed to your Amazon Web Services
+    #   account. To learn more about best practices for using recursive
+    #   invocation patterns, see [Recursive patterns that cause run-away
+    #   Lambda functions][1] in Serverless Land.
+    #
+    #
+    #
+    #   [1]: https://serverlessland.com/content/service/lambda/guides/aws-lambda-operator-guide/recursive-runaway
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PutFunctionRecursionConfigRequest AWS API Documentation
+    #
+    class PutFunctionRecursionConfigRequest < Struct.new(
+      :function_name,
+      :recursive_loop)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] recursive_loop
+    #   The status of your function's recursive loop detection
+    #   configuration.
+    #
+    #   When this value is set to `Allow`and Lambda detects your function
+    #   being invoked as part of a recursive loop, it doesn't take any
+    #   action.
+    #
+    #   When this value is set to `Terminate` and Lambda detects your
+    #   function being invoked as part of a recursive loop, it stops your
+    #   function being invoked and notifies you.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PutFunctionRecursionConfigResponse AWS API Documentation
+    #
+    class PutFunctionRecursionConfigResponse < Struct.new(
+      :recursive_loop)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] function_name
     #   The name or ARN of the Lambda function.
     #
@@ -6100,18 +6250,18 @@ module Aws::Lambda
     #   `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300
     #   seconds in increments of seconds.
     #
-    #   For streams and Amazon SQS event sources, the default batching
-    #   window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka,
-    #   Amazon MQ, and DocumentDB event sources, the default batching window
-    #   is 500 ms. Note that because you can only change
+    #   For Kinesis, DynamoDB, and Amazon SQS event sources, the default
+    #   batching window is 0 seconds. For Amazon MSK, Self-managed Apache
+    #   Kafka, Amazon MQ, and DocumentDB event sources, the default batching
+    #   window is 500 ms. Note that because you can only change
     #   `MaximumBatchingWindowInSeconds` in increments of seconds, you
     #   cannot revert back to the 500 ms default batching window after you
     #   have changed it. To restore the default batching window, you must
     #   create a new event source mapping.
     #
-    #   Related setting: For streams and Amazon SQS event sources, when you
-    #   set `BatchSize` to a value greater than 10, you must set
-    #   `MaximumBatchingWindowInSeconds` to at least 1.
+    #   Related setting: For Kinesis, DynamoDB, and Amazon SQS event
+    #   sources, when you set `BatchSize` to a value greater than 10, you
+    #   must set `MaximumBatchingWindowInSeconds` to at least 1.
     #   @return [Integer]
     #
     # @!attribute [rw] destination_config
@@ -6354,16 +6504,24 @@ module Aws::Lambda
     #   @return [Types::Environment]
     #
     # @!attribute [rw] runtime
-    #   The identifier of the function's [runtime][1]. Runtime is required
-    #   if the deployment package is a .zip file archive.
+    #   The identifier of the function's [ runtime][1]. Runtime is required
+    #   if the deployment package is a .zip file archive. Specifying a
+    #   runtime results in an error if you're deploying a function using a
+    #   container image.
     #
-    #   The following list includes deprecated runtimes. For more
-    #   information, see [Runtime deprecation policy][2].
+    #   The following list includes deprecated runtimes. Lambda blocks
+    #   creating new functions and updating existing functions shortly after
+    #   each runtime is deprecated. For more information, see [Runtime use
+    #   after deprecation][2].
+    #
+    #   For a list of all currently supported runtimes, see [Supported
+    #   runtimes][3].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported
     #   @return [String]
     #
     # @!attribute [rw] dead_letter_config

data/lib/aws-sdk-lambda.rb

@@ -54,6 +54,6 @@ require_relative 'aws-sdk-lambda/event_streams'
 # @!group service
 module Aws::Lambda
 
-  GEM_VERSION = '1.125.0'
+  GEM_VERSION = '1.126.0'
 
 end

data/sig/client.rbs

@@ -633,6 +633,16 @@ module Aws
                                             ) -> _GetFunctionEventInvokeConfigResponseSuccess
                                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetFunctionEventInvokeConfigResponseSuccess
 
+      interface _GetFunctionRecursionConfigResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetFunctionRecursionConfigResponse]
+        def recursive_loop: () -> ("Allow" | "Terminate")
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#get_function_recursion_config-instance_method
+      def get_function_recursion_config: (
+                                           function_name: ::String
+                                         ) -> _GetFunctionRecursionConfigResponseSuccess
+                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetFunctionRecursionConfigResponseSuccess
+
       interface _GetFunctionUrlConfigResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetFunctionUrlConfigResponse]
         def function_url: () -> ::String
@@ -1070,6 +1080,17 @@ module Aws
                                             ) -> _PutFunctionEventInvokeConfigResponseSuccess
                                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _PutFunctionEventInvokeConfigResponseSuccess
 
+      interface _PutFunctionRecursionConfigResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::PutFunctionRecursionConfigResponse]
+        def recursive_loop: () -> ("Allow" | "Terminate")
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#put_function_recursion_config-instance_method
+      def put_function_recursion_config: (
+                                           function_name: ::String,
+                                           recursive_loop: ("Allow" | "Terminate")
+                                         ) -> _PutFunctionRecursionConfigResponseSuccess
+                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _PutFunctionRecursionConfigResponseSuccess
+
       interface _PutProvisionedConcurrencyConfigResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::PutProvisionedConcurrencyConfigResponse]
         def requested_provisioned_concurrent_executions: () -> ::Integer

data/sig/types.rbs

@@ -563,6 +563,16 @@ module Aws::Lambda
       SENSITIVE: []
     end
 
+    class GetFunctionRecursionConfigRequest
+      attr_accessor function_name: ::String
+      SENSITIVE: []
+    end
+
+    class GetFunctionRecursionConfigResponse
+      attr_accessor recursive_loop: ("Allow" | "Terminate")
+      SENSITIVE: []
+    end
+
     class GetFunctionRequest
       attr_accessor function_name: ::String
       attr_accessor qualifier: ::String
@@ -1124,6 +1134,17 @@ module Aws::Lambda
       SENSITIVE: []
     end
 
+    class PutFunctionRecursionConfigRequest
+      attr_accessor function_name: ::String
+      attr_accessor recursive_loop: ("Allow" | "Terminate")
+      SENSITIVE: []
+    end
+
+    class PutFunctionRecursionConfigResponse
+      attr_accessor recursive_loop: ("Allow" | "Terminate")
+      SENSITIVE: []
+    end
+
     class PutProvisionedConcurrencyConfigRequest
       attr_accessor function_name: ::String
       attr_accessor qualifier: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-lambda
 version: !ruby/object:Gem::Version
-  version: 1.125.0
+  version: 1.126.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-02 00:00:00.000000000 Z
+date: 2024-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core