

# UpdateFunctionUrlConfig
<a name="API_UpdateFunctionUrlConfig"></a>

Lambda 함수 URL의 구성을 업데이트합니다.

## Request Syntax
<a name="API_UpdateFunctionUrlConfig_RequestSyntax"></a>

```
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 요청 파라미터
<a name="API_UpdateFunctionUrlConfig_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [FunctionName](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-FunctionName"></a>
Lambda 함수의 이름입니다.  

**이름 형식**
+  **함수 이름** - `my-function`.
+  **함수 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **부분적 ARN** - `123456789012:function:my-function`.
길이 제한은 전체 ARN에만 적용됩니다. 함수 이름만 지정하는 경우, 길이가 64자로 제한됩니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이는 140입니다.  
Pattern: `(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) **   <a name="lambda-UpdateFunctionUrlConfig-request-Qualifier"></a>
별칭 이름입니다.  
길이 제약: 최소 길이 1자. 최대 길이 128.  
Pattern: `(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` 

## 요청 본문
<a name="API_UpdateFunctionUrlConfig_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [AuthType](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-AuthType"></a>
함수 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) **   <a name="lambda-UpdateFunctionUrlConfig-request-Cors"></a>
함수 URL에 대한 [교차 오리진 리소스 공유(CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 설정입니다.  
유형: [Cors](API_Cors.md)객체  
필수 항목 여부: 아니요

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-InvokeMode"></a>
다음 옵션 중 하나를 사용하십시오.  
+  `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`   
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateFunctionUrlConfig_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_UpdateFunctionUrlConfig_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AuthType](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-AuthType"></a>
함수 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) **   <a name="lambda-UpdateFunctionUrlConfig-response-Cors"></a>
함수 URL에 대한 [교차 오리진 리소스 공유(CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 설정입니다.  
유형: [Cors](API_Cors.md)객체

 ** [CreationTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-CreationTime"></a>
[ISO-8601 형식](https://www.w3.org/TR/NOTE-datetime)(YYYY-MM-DDThh:ss.sTZD)의 함수 URL이 생성된 시기입니다.  
유형: 문자열

 ** [FunctionArn](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionArn"></a>
함수의 Amazon 리소스 이름(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) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionUrl"></a>
함수에 대한 HTTP URL 엔드포인트입니다.  
유형: 문자열  
길이 제약: 최소 길이는 40입니다. 최대 길이는 100.

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-InvokeMode"></a>
다음 옵션 중 하나를 사용하십시오.  
+  `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) **   <a name="lambda-UpdateFunctionUrlConfig-response-LastModifiedTime"></a>
[ISO-8601 형식](https://www.w3.org/TR/NOTE-datetime)(YYYY-MM-DDThh:ss.sTZD)의 함수 URL 구성이 마지막으로 업데이트된 시기입니다.  
유형: 문자열

## Errors
<a name="API_UpdateFunctionUrlConfig_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](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 Status Code: 429

## 참고
<a name="API_UpdateFunctionUrlConfig_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [JavaScript V3용 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 