CreateFunctionUrlConfig - Amazon Lambda
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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 } }

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

类型:字符串

有效值: NONE | AWS_IAM

必需:是

Cors

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

类型:Cors 对象

必需:否

响应语法

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" }

响应元素

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

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

AuthType

函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的 IAM 用户,请设置为 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。

错误

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码:400

ResourceConflictException

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

HTTP 状态代码:409

ResourceNotFoundException

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

HTTP 状态代码:404

ServiceException

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

HTTP 状态代码:500

TooManyRequestsException

超出了请求吞吐量限制。

HTTP 状态代码:429

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: