UpdateFunctionUrlConfig - AWS Lambda
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

UpdateFunctionUrlConfig

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

Request Syntax

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.

  • 함수 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

별칭 이름입니다.

길이 제약: 최소 길이 1자. 최대 길이 128.

Pattern: (^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))

요청 본문

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

AuthType

함수 URL에서 사용하는 인증 유형입니다. 액세스 권한을 인증된 사용자로 제한하려면 AWS_IAM으로 설정합니다. 퍼블릭 엔드포인트를 생성하기 위해 IAM 인증을 우회하려면 NONE으로 설정합니다. 자세한 내용은 Lambda 함수 URL에 대한 보안 및 인증 모델 섹션을 참조하세요.

유형: 문자열

유효 값: NONE | AWS_IAM

필수 항목 여부: 아니요

Cors

함수 URL에 대한 교차 오리진 리소스 공유(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에 대한 교차 오리진 리소스 공유(CORS) 설정입니다.

유형: Cors객체

CreationTime

ISO-8601 형식(YYYY-MM-DDThh:ss.sTZD)의 함수 URL이 생성된 시기입니다.

유형: 문자열

FunctionArn

함수의 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

함수에 대한 HTTP URL 엔드포인트입니다.

유형: 문자열

길이 제약: 최소 길이는 40입니다. 최대 길이는 100.

InvokeMode

다음 옵션 중 하나를 사용하십시오.

  • BUFFERED - 기본 옵션입니다. Lambda는 Invoke API 작업을 사용하여 함수를 호출합니다. 페이로드가 완료되면 호출 결과를 사용할 수 있습니다. 최대 페이로드 크기는 6MB입니다.

  • RESPONSE_STREAM - 페이로드 결과를 사용할 수 있게 되면 함수가 스트리밍합니다. Lambda는 InvokeWithResponseStream API 작업을 사용하여 함수를 호출합니다. 최대 응답 페이로드 크기는 20MB이지만 할당량 증가를 요청할 수 있습니다.

유형: 문자열

유효 값: BUFFERED | RESPONSE_STREAM

LastModifiedTime

ISO-8601 형식(YYYY-MM-DDThh:ss.sTZD)의 함수 URL 구성이 마지막으로 업데이트된 시기입니다.

유형: 문자열

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

InvalidParameterValueException

요청의 파라미터 중 하나가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceConflictException

리소스가 이미 있거나 다른 작업이 진행 중입니다.

HTTP 상태 코드: 409

ResourceNotFoundException

요청에 지정된 리소스가 없습니다.

HTTP 상태 코드: 404

ServiceException

AWS Lambda 서비스에 내부 오류가 발생했습니다.

HTTP 상태 코드: 500

TooManyRequestsException

요청 처리량 제한을 초과했습니다. 자세한 내용은 Lambda 할당량을 참조하세요.

HTTP Status Code: 429

참고

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.