aws-sdk-lambda 1.82.0 → 1.83.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28cd519a3e87a105f27fb37647a04227ecb6530e1303c7bc295e0cb03544ae2d
-  data.tar.gz: 66bd2c883ef159b3f055337cd3ccd10a899e77004118907030634a594f4ad28f
+  metadata.gz: 7f378afd87356e54f74a7702f945567b86eb0cde0305bd4e08147732ee470956
+  data.tar.gz: b217dc0da5a60b6c1f8bc3591318bac37ad7446298346a1cbff02898c0fed7d1
 SHA512:
-  metadata.gz: c441622320dd16bd405761826a4ed8316101b0321d7277cca5d7ab999818b0971c9ed4460ced5ed5c29b365507b3ed36637ec6c0448704b93b6027ec9dc4d24d
-  data.tar.gz: b2f3a998f57930ee17565d7febffa9be22c52813365a5233a53ec07a31d24514c362d4c02af6f7208977e520a1343cfa968dadf57e3bfb9af950e29e45115259
+  metadata.gz: b1158775fe928900236297a931b1404251ad1c47af8c87942f620d508f072eb0c3fb3517d2b7d06f9beb4b1db7d28659bd7eaf8a0a1c0db652d558721d3892c0
+  data.tar.gz: 9c44a60d808e8d59255f4655b6eaa03ae0672c4f17a6fee164793e41e846cd403422dd8f7be20c40452c49428f5824aea2ce462a148595d08eeeb9ec7280c8a8

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.83.0 (2022-04-06)
+------------------
+
+* Feature - This release adds new APIs for creating and managing Lambda Function URLs and adds a new FunctionUrlAuthType parameter to the AddPermission API. Customers can use Function URLs to create built-in HTTPS endpoints on their functions.
+
 1.82.0 (2022-03-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.82.0
+1.83.0

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

@@ -512,6 +512,17 @@ module Aws::Lambda
     #   grant permissions to all the Amazon Web Services accounts under this
     #   organization.
     #
+    # @option params [String] :function_url_auth_type
+    #   The type of authentication that your function URL uses. Set to
+    #   `AWS_IAM` if you want to restrict access to authenticated `IAM` users
+    #   only. Set to `NONE` if you want to bypass IAM authentication to create
+    #   a public endpoint. For more information, see [ Security and auth model
+    #   for Lambda function URLs][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html
+    #
     # @return [Types::AddPermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AddPermissionResponse#statement #statement} => String
@@ -529,6 +540,7 @@ module Aws::Lambda
     #     qualifier: "Qualifier",
     #     revision_id: "String",
     #     principal_org_id: "PrincipalOrgID",
+    #     function_url_auth_type: "NONE", # accepts NONE, AWS_IAM
     #   })
     #
     # @example Response structure
@@ -1371,6 +1383,97 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Creates a Lambda function URL with the specified configuration
+    # parameters. A function URL is a dedicated HTTP(S) endpoint that you
+    # can use to invoke your function.
+    #
+    # @option params [required, String] :function_name
+    #   The name 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 [String] :qualifier
+    #   The alias name.
+    #
+    # @option params [required, String] :auth_type
+    #   The type of authentication that your function URL uses. Set to
+    #   `AWS_IAM` if you want to restrict access to authenticated `IAM` users
+    #   only. Set to `NONE` if you want to bypass IAM authentication to create
+    #   a public endpoint. For more information, see [ Security and auth model
+    #   for Lambda function URLs][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html
+    #
+    # @option params [Types::Cors] :cors
+    #   The [cross-origin resource sharing (CORS)][1] settings for your
+    #   function URL.
+    #
+    #
+    #
+    #   [1]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS
+    #
+    # @return [Types::CreateFunctionUrlConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateFunctionUrlConfigResponse#function_url #function_url} => String
+    #   * {Types::CreateFunctionUrlConfigResponse#function_arn #function_arn} => String
+    #   * {Types::CreateFunctionUrlConfigResponse#auth_type #auth_type} => String
+    #   * {Types::CreateFunctionUrlConfigResponse#cors #cors} => Types::Cors
+    #   * {Types::CreateFunctionUrlConfigResponse#creation_time #creation_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_function_url_config({
+    #     function_name: "FunctionName", # required
+    #     qualifier: "FunctionUrlQualifier",
+    #     auth_type: "NONE", # required, accepts NONE, AWS_IAM
+    #     cors: {
+    #       allow_credentials: false,
+    #       allow_headers: ["Header"],
+    #       allow_methods: ["Method"],
+    #       allow_origins: ["Origin"],
+    #       expose_headers: ["Header"],
+    #       max_age: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.function_url #=> String
+    #   resp.function_arn #=> String
+    #   resp.auth_type #=> String, one of "NONE", "AWS_IAM"
+    #   resp.cors.allow_credentials #=> Boolean
+    #   resp.cors.allow_headers #=> Array
+    #   resp.cors.allow_headers[0] #=> String
+    #   resp.cors.allow_methods #=> Array
+    #   resp.cors.allow_methods[0] #=> String
+    #   resp.cors.allow_origins #=> Array
+    #   resp.cors.allow_origins[0] #=> String
+    #   resp.cors.expose_headers #=> Array
+    #   resp.cors.expose_headers[0] #=> String
+    #   resp.cors.max_age #=> Integer
+    #   resp.creation_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/CreateFunctionUrlConfig AWS API Documentation
+    #
+    # @overload create_function_url_config(params = {})
+    # @param [Hash] params ({})
+    def create_function_url_config(params = {}, options = {})
+      req = build_request(:create_function_url_config, params)
+      req.send_request(options)
+    end
+
     # Deletes a Lambda function [alias][1].
     #
     #
@@ -1685,6 +1788,46 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Deletes a Lambda function URL. When you delete a function URL, you
+    # can't recover it. Creating a new function URL results in a different
+    # URL address.
+    #
+    # @option params [required, String] :function_name
+    #   The name 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 [String] :qualifier
+    #   The alias name.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_function_url_config({
+    #     function_name: "FunctionName", # required
+    #     qualifier: "FunctionUrlQualifier",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/DeleteFunctionUrlConfig AWS API Documentation
+    #
+    # @overload delete_function_url_config(params = {})
+    # @param [Hash] params ({})
+    def delete_function_url_config(params = {}, options = {})
+      req = build_request(:delete_function_url_config, params)
+      req.send_request(options)
+    end
+
     # Deletes a version of an [Lambda layer][1]. Deleted versions can no
     # longer be viewed or added to functions. To avoid breaking functions, a
     # copy of the version remains in Lambda until no functions refer to it.
@@ -2365,6 +2508,69 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Returns details about a Lambda function URL.
+    #
+    # @option params [required, String] :function_name
+    #   The name 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 [String] :qualifier
+    #   The alias name.
+    #
+    # @return [Types::GetFunctionUrlConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFunctionUrlConfigResponse#function_url #function_url} => String
+    #   * {Types::GetFunctionUrlConfigResponse#function_arn #function_arn} => String
+    #   * {Types::GetFunctionUrlConfigResponse#auth_type #auth_type} => String
+    #   * {Types::GetFunctionUrlConfigResponse#cors #cors} => Types::Cors
+    #   * {Types::GetFunctionUrlConfigResponse#creation_time #creation_time} => Time
+    #   * {Types::GetFunctionUrlConfigResponse#last_modified_time #last_modified_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_function_url_config({
+    #     function_name: "FunctionName", # required
+    #     qualifier: "FunctionUrlQualifier",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.function_url #=> String
+    #   resp.function_arn #=> String
+    #   resp.auth_type #=> String, one of "NONE", "AWS_IAM"
+    #   resp.cors.allow_credentials #=> Boolean
+    #   resp.cors.allow_headers #=> Array
+    #   resp.cors.allow_headers[0] #=> String
+    #   resp.cors.allow_methods #=> Array
+    #   resp.cors.allow_methods[0] #=> String
+    #   resp.cors.allow_origins #=> Array
+    #   resp.cors.allow_origins[0] #=> String
+    #   resp.cors.expose_headers #=> Array
+    #   resp.cors.expose_headers[0] #=> String
+    #   resp.cors.max_age #=> Integer
+    #   resp.creation_time #=> Time
+    #   resp.last_modified_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunctionUrlConfig AWS API Documentation
+    #
+    # @overload get_function_url_config(params = {})
+    # @param [Hash] params ({})
+    def get_function_url_config(params = {}, options = {})
+      req = build_request(:get_function_url_config, params)
+      req.send_request(options)
+    end
+
     # Returns information about a version of an [Lambda layer][1], with a
     # link to download the layer archive that's valid for 10 minutes.
     #
@@ -3095,6 +3301,76 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Returns a list of Lambda function URLs for the specified function.
+    #
+    # @option params [required, String] :function_name
+    #   The name 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 [String] :marker
+    #   Specify the pagination token that's returned by a previous request to
+    #   retrieve the next page of results.
+    #
+    # @option params [Integer] :max_items
+    #   The maximum number of function URLs to return in the response. Note
+    #   that `ListFunctionUrlConfigs` returns a maximum of 50 items in each
+    #   response, even if you set the number higher.
+    #
+    # @return [Types::ListFunctionUrlConfigsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListFunctionUrlConfigsResponse#function_url_configs #function_url_configs} => Array<Types::FunctionUrlConfig>
+    #   * {Types::ListFunctionUrlConfigsResponse#next_marker #next_marker} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_function_url_configs({
+    #     function_name: "FunctionName", # required
+    #     marker: "String",
+    #     max_items: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.function_url_configs #=> Array
+    #   resp.function_url_configs[0].function_url #=> String
+    #   resp.function_url_configs[0].function_arn #=> String
+    #   resp.function_url_configs[0].creation_time #=> Time
+    #   resp.function_url_configs[0].last_modified_time #=> Time
+    #   resp.function_url_configs[0].cors.allow_credentials #=> Boolean
+    #   resp.function_url_configs[0].cors.allow_headers #=> Array
+    #   resp.function_url_configs[0].cors.allow_headers[0] #=> String
+    #   resp.function_url_configs[0].cors.allow_methods #=> Array
+    #   resp.function_url_configs[0].cors.allow_methods[0] #=> String
+    #   resp.function_url_configs[0].cors.allow_origins #=> Array
+    #   resp.function_url_configs[0].cors.allow_origins[0] #=> String
+    #   resp.function_url_configs[0].cors.expose_headers #=> Array
+    #   resp.function_url_configs[0].cors.expose_headers[0] #=> String
+    #   resp.function_url_configs[0].cors.max_age #=> Integer
+    #   resp.function_url_configs[0].auth_type #=> String, one of "NONE", "AWS_IAM"
+    #   resp.next_marker #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListFunctionUrlConfigs AWS API Documentation
+    #
+    # @overload list_function_url_configs(params = {})
+    # @param [Hash] params ({})
+    def list_function_url_configs(params = {}, options = {})
+      req = build_request(:list_function_url_configs, params)
+      req.send_request(options)
+    end
+
     # Returns a list of Lambda functions, with the version-specific
     # configuration of each. Lambda returns up to 50 functions per call.
     #
@@ -5302,6 +5578,97 @@ module Aws::Lambda
       req.send_request(options)
     end
 
+    # Updates the configuration for a Lambda function URL.
+    #
+    # @option params [required, String] :function_name
+    #   The name 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 [String] :qualifier
+    #   The alias name.
+    #
+    # @option params [String] :auth_type
+    #   The type of authentication that your function URL uses. Set to
+    #   `AWS_IAM` if you want to restrict access to authenticated `IAM` users
+    #   only. Set to `NONE` if you want to bypass IAM authentication to create
+    #   a public endpoint. For more information, see [ Security and auth model
+    #   for Lambda function URLs][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html
+    #
+    # @option params [Types::Cors] :cors
+    #   The [cross-origin resource sharing (CORS)][1] settings for your
+    #   function URL.
+    #
+    #
+    #
+    #   [1]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS
+    #
+    # @return [Types::UpdateFunctionUrlConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateFunctionUrlConfigResponse#function_url #function_url} => String
+    #   * {Types::UpdateFunctionUrlConfigResponse#function_arn #function_arn} => String
+    #   * {Types::UpdateFunctionUrlConfigResponse#auth_type #auth_type} => String
+    #   * {Types::UpdateFunctionUrlConfigResponse#cors #cors} => Types::Cors
+    #   * {Types::UpdateFunctionUrlConfigResponse#creation_time #creation_time} => Time
+    #   * {Types::UpdateFunctionUrlConfigResponse#last_modified_time #last_modified_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_function_url_config({
+    #     function_name: "FunctionName", # required
+    #     qualifier: "FunctionUrlQualifier",
+    #     auth_type: "NONE", # accepts NONE, AWS_IAM
+    #     cors: {
+    #       allow_credentials: false,
+    #       allow_headers: ["Header"],
+    #       allow_methods: ["Method"],
+    #       allow_origins: ["Origin"],
+    #       expose_headers: ["Header"],
+    #       max_age: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.function_url #=> String
+    #   resp.function_arn #=> String
+    #   resp.auth_type #=> String, one of "NONE", "AWS_IAM"
+    #   resp.cors.allow_credentials #=> Boolean
+    #   resp.cors.allow_headers #=> Array
+    #   resp.cors.allow_headers[0] #=> String
+    #   resp.cors.allow_methods #=> Array
+    #   resp.cors.allow_methods[0] #=> String
+    #   resp.cors.allow_origins #=> Array
+    #   resp.cors.allow_origins[0] #=> String
+    #   resp.cors.expose_headers #=> Array
+    #   resp.cors.expose_headers[0] #=> String
+    #   resp.cors.max_age #=> Integer
+    #   resp.creation_time #=> Time
+    #   resp.last_modified_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/UpdateFunctionUrlConfig AWS API Documentation
+    #
+    # @overload update_function_url_config(params = {})
+    # @param [Hash] params ({})
+    def update_function_url_config(params = {}, options = {})
+      req = build_request(:update_function_url_config, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -5315,7 +5682,7 @@ module Aws::Lambda
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-lambda'
-      context[:gem_version] = '1.82.0'
+      context[:gem_version] = '1.83.0'
       Seahorse::Client::Request.new(handlers, context)
     end