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

UpdateFunctionUrlConfig

更新 Lambda 函数 URL 的配置。

请求语法

PUT /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

  • 函数 ARNarn:aws:lambda:us-west-2:123456789012:function:my-function

  • 部分 ARN123456789012: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 200 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", "LastModifiedTime": "string" }

响应元素

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

服务以 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

LastModifiedTime

上次更新函数 URL 时,采用 ISO-8601 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。

类型:字符串

错误

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

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码:400

ResourceConflictException

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

HTTP 状态代码:409

ResourceNotFoundException

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

HTTP 状态代码:404

ServiceException

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

HTTP 状态代码:500

TooManyRequestsException

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

HTTP 状态代码:429

另请参阅

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