创建和管理 Lambda 函数 URL - AWS Lambda
创建函数 URL（控制台）创建函数 URL (AWS CLI)向 CloudFormation 模板添加函数 URL跨源资源共享 (CORS)节流函数 URL停用函数 URL删除函数 URL

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建和管理 Lambda 函数 URL

函数 URL 是 Lambda 函数的专用 HTTP(S) 端点。您可以通过 Lambda 控制台或 Lambda API 创建和配置函数 URL。创建函数 URL 时，Lambda 会自动为您生成唯一的 URL 端点。创建函数 URL 后，其 URL 端点永远不会改变。函数 URL 的端点具有以下格式：

https://<url-id>.lambda-url.<region>.on.aws
注意

以下区域不支持函数 URL：亚太地区（海得拉巴）（ap-south-2）、亚太地区（墨尔本）（ap-southeast-4）、加拿大西部（卡尔加里）（ca-west-1）、欧洲（西班牙）（eu-south-2）、欧洲（苏黎世）（eu-central-2）、以色列（特拉维夫）（il-central-1）和中东（阿联酋）（me-central-1）。

以下部分介绍如何使用 Lambda 控制台、AWS CLI 和 AWS CloudFormation 模板创建和管理函数 URL

创建函数 URL（控制台）

按照以下步骤，使用控制台创建函数 URL。

  1. 打开 Lamba 控制台的函数页面。

  2. 选择您要为其创建函数 URL 的函数的名称。

  3. 选择 Configuration（配置）选项卡，然后选择 Function URL（函数 URL）。

  4. 选择 Create function URL（创建函数 URL）。

  5. 对于 Auth type（身份验证类型），选择 AWS_IAM 或 NONE。有关函数 URL 身份验证的更多信息，请参阅 安全性和身份验证模型。

  6. （可选）选择 Configure cross-origin resource sharing (CORS)（配置跨源资源共享），然后为函数 URL 配置 CORS 设置。有关 CORS 的更多信息，请参阅 跨源资源共享 (CORS)。

  7. 选择保存。

这将为函数的 $LATEST 未发布版本创建函数 URL。函数 URL 将显示在控制台的 Function overview（函数概览）部分。

  1. 打开 Lamba 控制台的函数页面。

  2. 选择具有您要为其创建函数 URL 的别名的函数的名称。

  3. 选择 Aliases（别名）选项卡，然后选择要为其创建函数 URL 的别名的名称。

  4. 选择 Configuration（配置）选项卡，然后选择 Function URL（函数 URL）。

  5. 选择 Create function URL（创建函数 URL）。

  6. 对于 Auth type（身份验证类型），选择 AWS_IAM 或 NONE。有关函数 URL 身份验证的更多信息，请参阅 安全性和身份验证模型。

  7. （可选）选择 Configure cross-origin resource sharing (CORS)（配置跨源资源共享），然后为函数 URL 配置 CORS 设置。有关 CORS 的更多信息，请参阅 跨源资源共享 (CORS)。

  8. 选择保存。

这将为函数别名创建函数 URL。函数 URL 将显示在控制台中您的别名的 Function overview（函数概览）部分。

创建具有函数 URL 的新函数（控制台）

  1. 打开 Lamba 控制台的 Functions page（函数页面）。

  2. 选择 Create function（创建函数）。

  3. 在 Basic information（基本信息）中，执行以下操作：

    1. 在 Function name（函数名称）中，输入您的函数的名称，例如 my-function。

    2. 对于 Runtime（运行时），请选择您首选的语言运行时，例如 Node.js 18.x。

    3. 对于 Architecture（架构），请选择 x86_64 或 arm64。

    4. 展开 Permissions（权限），然后选择是创建新的执行角色还是使用现有的执行角色。

  4. 展开 Advanced settings（高级设置），然后选择 Function URL（函数 URL）。

  5. 对于 Auth type（身份验证类型），选择 AWS_IAM 或 NONE（无）。有关函数 URL 身份验证的更多信息，请参阅 安全性和身份验证模型。

  6. （可选）选择 Configure cross-origin resource sharing (CORS)（配置跨源资源共享）。如果在函数创建过程中选择此选项，则原定设置下，函数 URL 将允许来自所有来源的请求。创建函数后，可以编辑函数 URL 的 CORS 设置。有关 CORS 的更多信息，请参阅 跨源资源共享 (CORS)。

  7. 选择创建函数。

这将为函数的 $LATEST 未发布版本创建一个具有函数 URL 的新函数。函数 URL 将显示在控制台的 Function overview（函数概览）部分。

创建函数 URL (AWS CLI)

要使用 AWS Command Line Interface (AWS CLI) 为现有 Lambda 函数创建函数 URL，请运行以下命令：

aws lambda create-function-url-config \
    --function-name my-function \
    --qualifier prod \ // optional
    --auth-type AWS_IAM
    --cors-config {AllowOrigins="https://example.com"} // optional

这会将函数 URL 添加到函数 my-function 的 prod 限定符中。有关这些配置参数的更多信息，请参阅 API 参考中的CreateFunctionUrlConfig。

注意

要通过 AWS CLI 创建函数 URL，该函数必须已经存在。

向 CloudFormation 模板添加函数 URL

要向 AWS CloudFormation 模板中添加 AWS::Lambda::Url 资源，请使用以下语法：

JSON

{
  "Type" : "AWS::Lambda::Url",
  "Properties" : {
      "AuthType" : String,
      "Cors" : Cors,
      "Qualifier" : String,
      "TargetFunctionArn" : String
    }
}

YAML

Type: AWS::Lambda::Url
Properties: 
  AuthType: String
  Cors: 
    Cors
  Qualifier: String
  TargetFunctionArn: String

参数

  • （必需）AuthType – 定义函数 URL 的身份验证类型。可能的值为 AWS_IAM 或 NONE。若要将访问权限限制为仅经过身份验证的用户，请设置为 AWS_IAM。要绕过 IAM 身份验证并允许任何用户对您的函数发出请求，请设置为 NONE。

  • （可选）Cors – 定义函数 URL 的 CORS settings（CORS 设置）。要在 CloudFormation 中向 AWS::Lambda::Url 资源添加 Cors，请使用以下语法。

    例 AWS::Lambda::Url.Cors (JSON)
    {
  "AllowCredentials" : Boolean,
  "AllowHeaders" : [ String, ... ],
  "AllowMethods" : [ String, ... ],
  "AllowOrigins" : [ String, ... ],
  "ExposeHeaders" : [ String, ... ],
  "MaxAge" : Integer
}
    例 AWS::Lambda::Url.Cors (YAML)
      AllowCredentials: Boolean
  AllowHeaders: 
    - String
  AllowMethods: 
    - String
  AllowOrigins: 
    - String
  ExposeHeaders: 
    - String
  MaxAge: Integer

  • （可选）Qualifier – 别名。

  • （必需）TargetFunctionArn – Lambda 函数的名称或 Amazon 资源名称（ARN）。有效的名称格式包括：

    • 函数名称 – my-function

    • 函数 ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function

    • 部分 ARN – 123456789012:function:my-function

跨源资源共享 (CORS)

要定义不同来源如何访问函数 URL，请使用 跨源资源共享 (CORS)。如果要从其他域调用函数 URL，建议配置 CORS。Lambda 支持函数 URL 的以下 CORS 标头。

CORS 标头 CORS 配置属性 示例值

Access-Control-Allow-Origin

AllowOrigins

*（允许所有源）

https://www.example.com

http://localhost:60905

Access-Control-Allow-Methods

AllowMethods

GET, POST, DELETE, *

Access-Control-Allow-Headers

AllowHeaders

Date, Keep-Alive, X-Custom-Header

Access-Control-Expose-Headers

ExposeHeaders

Date, Keep-Alive, X-Custom-Header

Access-Control-Allow-Credentials

AllowCredentials

TRUE

Access-Control-Max-Age

MaxAge

5 (默认值)300

使用 Lambda 控制台或 AWS CLI 为函数 URL 配置 CORS 时，Lambda 会通过函数 URL 自动将 CORS 标头添加到所有响应中。或者，您也可以手动将 CORS 标头添加到函数响应中。如果存在冲突的标头，则以函数 URL 上配置的 CORS 标头为准。

节流函数 URL

节流限制了函数处理请求的速率。这在很多情况下都很有用，比如防止函数过载下游资源，或者处理请求突然激增的情况。

通过配置预留并发，可以节流 Lambda 函数通过函数 URL 处理请求的速率。预留并发限制了函数的最大并发调用次数。函数的最大每秒请求速率 (RPS) 相当于配置的预留并发的 10 倍。例如，如果将函数配置为预留并发 100，则最大 RPS 为 1,000。

当函数并发超过预留并发时，函数 URL 将返回 HTTP 429 状态码。如果您的函数收到的请求超过了基于您配置的预留并发的最大 10 倍 RPS，那么您也会收到一个 HTTP 429 错误。有关预留并发的更多信息，请参阅 配置预留并发。

停用函数 URL

在紧急情况下，您可能希望拒绝函数 URL 的所有流量。要停用函数 URL，请将预留并发设置为零。这会节流对函数 URL 的所有请求，从而产生 HTTP 429 状态响应。要重新激活函数 URL，请删除预留的并发配置，或将配置设置为大于零的数量。

删除函数 URL

删除函数 URL 后，将无法恢复。创建一个新函数 URL 将导致不同的 URL 地址。

注意

如果您删除身份验证类型为 NONE 的函数 URL，Lambda 不会自动删除关联的基于资源的策略。如果要删除此策略，您必须手动执行该操作。

  1. 打开 Lamba 控制台的函数页面。

  2. 选择此函数的名称。

  3. 选择 Configuration（配置）选项卡，然后选择 Function URL（函数 URL）。

  4. 选择 删除。

  5. 在此字段中输入 delete（删除）短语以确认删除。

  6. 选择 删除。

注意

删除具有函数 URL 的函数后，Lambda 会异步删除函数 URL。如果您立即在同一个账户中创建具有相同名称的新函数，则原始函数 URL 可能会被映射到新函数，而不是被删除。