지정된 구성 파라미터를 사용하여 Lambda 함수 URL을 생성합니다. 함수 URL은 함수를 호출하는 데 사용할 수 있는 전용 HTTP(S) 엔드포인트입니다.
Request Syntax
POST /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는InvokeAPI 작업을 사용하여 함수를 호출합니다. 페이로드가 완료되면 호출 결과를 사용할 수 있습니다. 최대 페이로드 크기는 6MB입니다. -
RESPONSE_STREAM- 페이로드 결과를 사용할 수 있게 되면 함수가 스트리밍합니다. Lambda는InvokeWithResponseStreamAPI 작업을 사용하여 함수를 호출합니다. 최대 응답 페이로드 크기는 20MB이지만 할당량 증가를 요청할 수 있습니다.
유형: 문자열
유효 값:
BUFFERED | RESPONSE_STREAM필수 항목 여부: 아니요
-
응답 구문
HTTP/1.1 201
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"
}응답 요소
작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 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는InvokeAPI 작업을 사용하여 함수를 호출합니다. 페이로드가 완료되면 호출 결과를 사용할 수 있습니다. 최대 페이로드 크기는 6MB입니다. -
RESPONSE_STREAM- 페이로드 결과를 사용할 수 있게 되면 함수가 스트리밍합니다. Lambda는InvokeWithResponseStreamAPI 작업을 사용하여 함수를 호출합니다. 최대 응답 페이로드 크기는 20MB이지만 할당량 증가를 요청할 수 있습니다.
유형: 문자열
유효 값:
BUFFERED | RESPONSE_STREAM -
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
요청의 파라미터 중 하나가 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceConflictException
-
리소스가 이미 있거나 다른 작업이 진행 중입니다.
HTTP 상태 코드: 409
- ResourceNotFoundException
-
요청에 지정된 리소스가 없습니다.
HTTP 상태 코드: 404
- ServiceException
-
AWS Lambda 서비스에 내부 오류가 발생했습니다.
HTTP 상태 코드: 500
- TooManyRequestsException
-
요청 처리량 제한을 초과했습니다. 자세한 내용은 Lambda 할당량을 참조하세요.
HTTP Status Code: 429
참고
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
