"` |
| `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 adalah`https://{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` | `TRUE`jika tubuh adalah muatan biner dan dikodekan base64. `FALSE`jika tidak. | `FALSE` |
| `stageVariables` | Fungsi URLs tidak menggunakan parameter ini. Lambda menyetel ini ke `null` atau mengecualikan ini dari JSON. | `null` |
### Format payload respon
Saat fungsi Anda mengembalikan respons, Lambda mem-parsing respons dan mengubahnya menjadi respons HTTP. Muatan respons fungsi memiliki format berikut:
```
{
"statusCode": 201,
"headers": {
"Content-Type": "application/json",
"My-Custom-Header": "Custom Value"
},
"body": "{ \"message\": \"Hello, world!\" }",
"cookies": [
"Cookie_1=Value1; Expires=21 Oct 2021 07:48 GMT",
"Cookie_2=Value2; Max-Age=78000"
],
"isBase64Encoded": false
}
```
Lambda menyimpulkan format respons untuk Anda. Jika fungsi Anda mengembalikan JSON yang valid dan tidak mengembalikan a`statusCode`, Lambda mengasumsikan hal berikut:
+ `statusCode` adalah `200`.
**catatan**
Yang valid `statusCode` berada dalam kisaran 100 hingga 599.
+ `content-type` adalah `application/json`.
+ `body`adalah respon fungsi.
+ `isBase64Encoded` adalah `false`.
Contoh berikut menunjukkan bagaimana output fungsi Lambda Anda memetakan ke payload respons, dan bagaimana payload respons memetakan ke respons HTTP akhir. Saat klien memanggil URL fungsi Anda, mereka melihat respons HTTP.
**Contoh output untuk respon string**
| Keluaran fungsi Lambda | Output respons yang ditafsirkan | Respons HTTP (apa yang dilihat klien) |
| --- | --- | --- |
| "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!"
|
**Contoh keluaran untuk respons JSON**
| Keluaran fungsi Lambda | Output respons yang ditafsirkan | Respons HTTP (apa yang dilihat klien) |
| --- | --- | --- |
| {
"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!"
}
|
**Contoh keluaran untuk respons kustom**
| Keluaran fungsi Lambda | Output respons yang ditafsirkan | Respons HTTP (apa yang dilihat klien) |
| --- | --- | --- |
| {
"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!"
}
|
### Cookie
Untuk mengembalikan cookie dari fungsi Anda, jangan menambahkan `set-cookie` header secara manual. Sebagai gantinya, sertakan cookie di objek payload respons Anda. Lambda secara otomatis menafsirkan ini dan menambahkannya sebagai `set-cookie` header dalam respons HTTP Anda, seperti pada contoh berikut.
| Keluaran fungsi Lambda | Respons HTTP (apa yang dilihat klien) |
| --- | --- |
| {
"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!"
}
|