Memanggil fungsi Lambda URLs

version

Versi format payload untuk acara ini. Fungsi Lambda URLs saat ini mendukung format payload versi 2.0.

2.0

routeKey

Fungsi URLs tidak menggunakan parameter ini. Lambda menetapkan ini $default sebagai placeholder.

$default

rawPath

Jalur permintaan. Misalnya, jika URL permintaan adalahhttps://{url-id}.lambda-url.{region}.on.aws/example/test/demo, maka nilai jalur mentah adalah/example/test/demo.

/example/test/demo

rawQueryString

String mentah yang berisi parameter string query permintaan. Karakter yang didukung termasuk a-zA-Z,0-9,.,_,-,%,,&,=, dan+.

"?parameter1=value1&parameter2=value2"

cookies

Array yang berisi semua cookie yang dikirim sebagai bagian dari permintaan.

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

headers

Daftar header permintaan, disajikan sebagai pasangan kunci-nilai.

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

queryStringParameters

Parameter kueri untuk permintaan. Misalnya, jika URL permintaan adalahhttps://{url-id}.lambda-url.{region}.on.aws/example?name=Jane, maka queryStringParameters nilainya adalah objek JSON dengan kunci name dan nilai. Jane

{"name": "Jane"}

requestContext

Objek yang berisi informasi tambahan tentang permintaan, sepertirequestId, waktu permintaan, dan identitas penelepon jika diotorisasi melalui AWS Identity and Access Management (IAM).

requestContext.accountId

Akun AWS ID pemilik fungsi.

"123456789012"

requestContext.apiId

ID URL fungsi.

"33anwqw8fj"

requestContext.authentication

Fungsi URLs tidak menggunakan parameter ini. Lambda mengatur ini ke. null

null

requestContext.authorizer

Objek yang berisi informasi tentang identitas pemanggil, jika URL fungsi menggunakan jenis AWS_IAM autentikasi. Jika tidak, Lambda menyetel ini ke. null

requestContext.authorizer.iam.accessKey

Kunci akses identitas penelepon.

"AKIAIOSFODNN7EXAMPLE"

requestContext.authorizer.iam.accountId

Akun AWS ID identitas penelepon.

"111122223333"

requestContext.authorizer.iam.callerId

ID (ID pengguna) penelepon.

"AIDACKCEVSQ6C2EXAMPLE"

requestContext.authorizer.iam.cognitoIdentity

Fungsi URLs tidak menggunakan parameter ini. Lambda menyetel ini ke null atau mengecualikan ini dari JSON.

null

requestContext.authorizer.iam.principalOrgId

ID organisasi utama yang terkait dengan identitas penelepon.

"AIDACKCEVSQORGEXAMPLE"

requestContext.authorizer.iam.userArn

Nama Sumber Daya Amazon (ARN) pengguna dari identitas penelepon.

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

requestContext.authorizer.iam.userId

ID pengguna dari identitas pemanggil.

"AIDACOSFODNN7EXAMPLE2"

requestContext.domainName

Nama domain dari URL fungsi.

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

requestContext.domainPrefix

Awalan domain dari URL fungsi.

"<url-id>"

requestContext.http

Objek yang berisi rincian tentang permintaan HTTP.

requestContext.http.method

Metode HTTP yang digunakan dalam permintaan ini. Nilai yang valid termasuk GET, POST, PUT, HEAD, OPTIONS, PATCH, dan DELETE.

GET

requestContext.http.path

Jalur permintaan. Misalnya, jika URL permintaan adalahhttps://{url-id}.lambda-url.{region}.on.aws/example/test/demo, maka nilai jalurnya adalah/example/test/demo.

/example/test/demo

requestContext.http.protocol

Protokol permintaan.

HTTP/1.1

requestContext.http.sourceIp

Alamat IP sumber dari koneksi TCP langsung membuat permintaan.

123.123.123.123

requestContext.http.userAgent

Nilai header permintaan User-Agent.

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

requestContext.requestId

ID permintaan pemanggilan. Anda dapat menggunakan ID ini untuk melacak log pemanggilan yang terkait dengan fungsi Anda.

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

requestContext.routeKey

Fungsi URLs tidak menggunakan parameter ini. Lambda menetapkan ini $default sebagai placeholder.

$default

requestContext.stage

Fungsi URLs tidak menggunakan parameter ini. Lambda menetapkan ini $default sebagai placeholder.

$default

requestContext.time

Stempel waktu permintaan.

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

requestContext.timeEpoch

Stempel waktu permintaan, dalam waktu zaman Unix.

"1631055022677"

body

Tubuh permintaan. Jika jenis konten permintaan adalah biner, isi dikodekan base64.

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

pathParameters

Fungsi URLs tidak menggunakan parameter ini. Lambda menyetel ini ke null atau mengecualikan ini dari JSON.

null

isBase64Encoded

TRUEjika tubuh adalah muatan biner dan dikodekan base64. FALSEjika tidak.

FALSE

stageVariables

Fungsi URLs tidak menggunakan parameter ini. Lambda menyetel ini ke null atau mengecualikan ini dari 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!"
}