# 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](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 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](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AuthType](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` 必需：否 ** [Cors](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象必需：否 ** [InvokeMode](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`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](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` ** [Cors](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象 ** [CreationTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 创建函数 URL 时，使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [FunctionArn](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数的 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](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数的 HTTP URL 端点。类型：字符串长度限制：最小长度为 40。最大长度为 100。 ** [InvokeMode](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` ** [LastModifiedTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 上次更新函数 URL 时，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionUrlConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionUrlConfig)