調用 Lambda 函數 URLs

version

此事件的承載格式版本。Lambda 函數URLs目前支援有效載荷格式 2.0 版。

2.0

routeKey

函數URLs不使用此參數。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值是具有鍵name且值為的JSON對象Jane。

{"name": "Jane"}

requestContext

包含有關請求的其他信息的對象，例如requestId，請求的時間以及調用者的身份（如果通過 AWS Identity and Access Management （IAM）授權。

requestContext.accountId

函數擁有者的 AWS 帳戶 識別碼。

"123456789012"

requestContext.apiId

函數的識別碼URL。

"33anwqw8fj"

requestContext.authentication

函數URLs不使用此參數。Lambda 將此設為 null。

null

requestContext.authorizer

如果函數使用 AWS_IAM auth 類型，則包含有關調URL用者身份信息的對象。否則 Lambda 會將此設為 null。

requestContext.authorizer.iam.accessKey

呼叫者身分的存取金鑰。

"AKIAIOSFODNN7EXAMPLE"

requestContext.authorizer.iam.accountId

來電者識別 AWS 帳戶 碼。

"111122223333"

requestContext.authorizer.iam.callerId

呼叫者的 ID (使用者 ID)。

"AIDACKCEVSQ6C2EXAMPLE"

requestContext.authorizer.iam.cognitoIdentity

函數URLs不使用此參數。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

函數URLs不使用此參數。Lambda 將此設為 $default 作為預留位置使用。

$default

requestContext.stage

函數URLs不使用此參數。Lambda 將此設為 $default 作為預留位置使用。

$default

requestContext.time

請求的時間戳記。

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

requestContext.timeEpoch

Unix epoch 時間格式的請求時間戳記。

"1631055022677"

body

請求的本文。如果請求的內容屬於二進位類型，則本文會採用 base64 編碼。

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

pathParameters

函數URLs不使用此參數。Lambda 會將其設定為null或將其排除在JSON.

null

isBase64Encoded

如果本文為二進位承載並採用 base64 編碼，此值為 TRUE，否則為 FALSE。

FALSE

stageVariables

函數URLs不使用此參數。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!"
}