Lambda 함수 URL 호출

version

이 이벤트에 대한 페이로드 포맷 버전입니다. Lambda 함수 URL은 현재 페이로드 포맷 버전 2.0을 지원합니다.

2.0

routeKey

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 자리표시자를 의미하는 $default로 설정합니다.

$default

rawPath

요청 경로입니다. 예를 들어, 요청 URL이 https://{url-id}.lambda-url.{region}.on.aws/example/test/demo인 경우 원시 경로 값은 /example/test/demo입니다.

/example/test/demo

rawQueryString

요청의 쿼리 문자열 파라미터를 포함하는 원시 문자열입니다. 지원되는 문자에는 a-z, A-Z, 0-9, ., _, -, %, &, = 및 +가 포함됩니다.

"?parameter1=value1&parameter2=value2"

cookies

요청의 일부로 전송되는 모든 쿠키를 포함하는 배열입니다.

["Cookie_1=Value_1", "Cookie_2=Value_2"]

headers

요청 헤더 목록으로, 키-값 페어로 표시됩니다.

{"header1": "value1", "header2": "value2"}

queryStringParameters

요청의 쿼리 파라미터입니다. 예를 들어, 요청 URL이 https://{url-id}.lambda-url.{region}.on.aws/example?name=Jane인 경우 queryStringParameters 값은 키가 name이고 값이 Jane인 JSON 객체입니다.

{"name": "Jane"}

requestContext

요청에 대한 추가 정보를 포함하는 객체입니다(예: requestId, 요청 시간, AWS Identity and Access Management(IAM)를 통해 승인된 호출자의 ID).

requestContext.accountId

함수 소유자의 AWS 계정 ID입니다.

"123456789012"

requestContext.apiId

함수 URL의 ID입니다.

"33anwqw8fj"

requestContext.authentication

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 null로 설정합니다.

null

requestContext.authorizer

함수 URL에서 AWS_IAM 인증 유형을 사용하는 경우 호출자 자격 증명에 관한 정보를 포함하는 객체입니다. 그렇지 않으면 Lambda가 이 파라미터를 null로 설정합니다.

requestContext.authorizer.iam.accessKey

호출자 자격 증명의 액세스 키입니다.

"AKIAIOSFODNN7EXAMPLE"

requestContext.authorizer.iam.accountId

호출자 자격 증명의 AWS 계정 ID입니다.

"111122223333"

requestContext.authorizer.iam.callerId

호출자의 ID(사용자 ID)입니다.

"AIDACKCEVSQ6C2EXAMPLE"

requestContext.authorizer.iam.cognitoIdentity

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 null로 설정하거나 JSON에서 제외합니다.

null

requestContext.authorizer.iam.principalOrgId

호출자 자격 증명과 연결된 보안 주체 조직 ID입니다.

"AIDACKCEVSQORGEXAMPLE"

requestContext.authorizer.iam.userArn

호출자 자격 증명의 사용자 Amazon 리소스 이름(ARN)입니다.

"arn:aws:iam::111122223333:user/example-user"

requestContext.authorizer.iam.userId

호출자 자격 증명의 사용자 ID입니다.

"AIDACOSFODNN7EXAMPLE2"

requestContext.domainName

함수 URL의 도메인 이름입니다.

"<url-id>.lambda-url.us-west-2.on.aws"

requestContext.domainPrefix

함수 URL의 도메인 접두사입니다.

"<url-id>"

requestContext.http

HTTP 요청에 대한 세부 정보를 포함하는 객체입니다.

requestContext.http.method

이 요청에 사용되는 HTTP 메서드입니다. 유효한 값에는 GET, POST, PUT, HEAD, OPTIONS, PATCH 및 DELETE가 있습니다.

GET

requestContext.http.path

요청 경로입니다. 예를 들어, 요청 URL이 https://{url-id}.lambda-url.{region}.on.aws/example/test/demo인 경우 경로 값은 /example/test/demo입니다.

/example/test/demo

requestContext.http.protocol

요청의 프로토콜입니다.

HTTP/1.1

requestContext.http.sourceIp

요청하는 즉시 TCP 연결의 소스 IP 주소입니다.

123.123.123.123

requestContext.http.userAgent

사용자 에이전트 요청 헤더 값입니다.

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0

requestContext.requestId

호출 요청의 ID입니다. 이 ID를 사용하여 함수와 관련된 호출 로그를 추적할 수 있습니다.

e1506fd5-9e7b-434f-bd42-4f8fa224b599

requestContext.routeKey

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 자리표시자를 의미하는 $default로 설정합니다.

$default

requestContext.stage

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 자리표시자를 의미하는 $default로 설정합니다.

$default

requestContext.time

요청의 타임스탬프입니다.

"07/Sep/2021:22:50:22 +0000"

requestContext.timeEpoch

Unix Epoch 시간으로 표시된 요청의 타임스탬프입니다.

"1631055022677"

body

요청의 본문입니다. 요청의 콘텐츠 유형이 바이너리인 경우 본문은 base64로 인코딩됩니다.

{"key1": "value1", "key2": "value2"}

pathParameters

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 null로 설정하거나 JSON에서 제외합니다.

null

isBase64Encoded

본문이 이진 페이로드이고 base64로 인코딩되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

FALSE

stageVariables

함수 URL은 이 파라미터를 사용하지 않습니다. Lambda는 이 파라미터를 null로 설정하거나 JSON에서 제외합니다.

null

"Hello, world!"

{
  "statusCode": 200,
  "body": "Hello, world!",
  "headers": {
    "content-type": "application/json"
  },
  "isBase64Encoded": false
}

HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 15

"Hello, world!"

{
  "message": "Hello, world!"
}

{
  "statusCode": 200,
  "body": {
    "message": "Hello, world!"
  },
  "headers": {
    "content-type": "application/json"
  },
  "isBase64Encoded": false
}

HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 34

{
  "message": "Hello, world!"
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "isBase64Encoded": false
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "isBase64Encoded": false
}

HTTP/2 201
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 27
my-custom-header: Custom Value

{
  "message": "Hello, world!"
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "cookies": [
        "Cookie_1=Value1; Expires=21 Oct 2021 07:48 GMT",
        "Cookie_2=Value2; Max-Age=78000"
    ],
    "isBase64Encoded": false
}

HTTP/2 201
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 27
my-custom-header: Custom Value
set-cookie: Cookie_1=Value2; Expires=21 Oct 2021 07:48 GMT
set-cookie: Cookie_2=Value2; Max-Age=78000

{
  "message": "Hello, world!"
}