CreateFunctionUrlConfig - Amazon Lambda
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

CreateFunctionUrlConfig

使用指定的配置参数创建 Lambda 函数 URL。函数 URL 是专用的 HTTP(S) 端点，可用于调用函数。

请求语法

POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}

URI 请求参数

请求使用以下 URI 参数。

FunctionName

Lambda 函数的名称。

名称格式

  • 函数名称 – my-function。

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

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

长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。

长度限制：最小长度为 1。长度上限为 140。

模式：(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

必需：是

Qualifier

别名。

长度限制：最小长度为 1。长度上限为 128。

模式：(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))

请求正文

请求接受采用 JSON 格式的以下数据。

AuthType

函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 AWS_IAM。如果想绕过 IAM 身份验证以创建公有端点，请设置为 NONE。有关更多信息，请参阅 Lambda 函数 URL 的安全性和身份验证模型。

类型：字符串

有效值：NONE | AWS_IAM

必需：是

Cors

适用于函数 URL 的 cross-origin resource sharing (CORS)（跨源资源共享）设置。

类型：Cors 对象

必需：否

InvokeMode

使用以下选项之一：

  • BUFFERED – 这是默认选项。Lambda 通过 Invoke API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。

  • RESPONSE_STREAM – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 InvokeWithResponseStream API 操作调用函数。最大响应负载大小为 20MB，但是，您可以请求提高限额。

类型：字符串

有效值：BUFFERED | RESPONSE_STREAM

必需：否

响应语法

HTTP/1.1 201
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 201 响应。

服务以 JSON 格式返回的以下数据。

AuthType

函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 AWS_IAM。如果想绕过 IAM 身份验证以创建公有端点，请设置为 NONE。有关更多信息，请参阅 Lambda 函数 URL 的安全性和身份验证模型。

类型：字符串

有效值：NONE | AWS_IAM

Cors

适用于函数 URL 的 cross-origin resource sharing (CORS)（跨源资源共享）设置。

类型：Cors 对象

CreationTime

创建函数 URL 时，使用 ISO-8601 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。

类型：字符串

FunctionArn

函数的 Amazon Resource Name (ARN)。

类型：字符串

模式：arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

FunctionUrl

函数的 HTTP URL 端点。

类型：字符串

长度限制：最小长度为 40。最大长度为 100。

InvokeMode

使用以下选项之一：

  • BUFFERED – 这是默认选项。Lambda 通过 Invoke API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。

  • RESPONSE_STREAM – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 InvokeWithResponseStream API 操作调用函数。最大响应负载大小为 20MB，但是，您可以请求提高限额。

类型：字符串

有效值：BUFFERED | RESPONSE_STREAM

错误

有关所有操作返回的常见错误的信息，请参阅 常见错误。

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码：400

ResourceConflictException

资源已存在，或者其他操作正在进行中。

HTTP 状态代码：409

ResourceNotFoundException

请求中指定的资源不存在。

HTTP 状态代码：404

ServiceException

Amazon Lambda 服务遇到了内部错误。

HTTP 状态代码：500

TooManyRequestsException

超出了请求吞吐量限制。有关更多信息，请参阅 Lambda 限额。

HTTP 状态代码：429

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：