调用 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。

["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 值是一个 JSON 对象，其键为 name，值为 Jane。

{"name": "Jane"}

requestContext

一个包含有关请求的附加信息的对象，例如 requestId、请求的时间以及通过 AWS Identity and Access Management (IAM) 授权的调用者身份。

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