UpdateFunctionUrlConfig - Amazon Lambda
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
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
   }
}

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 对象

必需：否

响应语法

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",
   "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。

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 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：