"` |
| `requestContext.http` | Un oggetto contenente i dettagli sulla richiesta HTTP. | |
| `requestContext.http.method` | Il metodo HTTP utilizzato nella richiesta. I valori validi includono `GET`, `POST`, `PUT`, `HEAD`, `OPTIONS`, `PATCH` e `DELETE`. | `GET` |
| `requestContext.http.path` | Percorso della richiesta. Ad esempio, se l'URL della richiesta è `https://{url-id}.lambda-url.{region}.on.aws/example/test/demo`, il valore del percorso è `/example/test/demo`. | `/example/test/demo` |
| `requestContext.http.protocol` | Il protocollo della richiesta. | `HTTP/1.1` |
| `requestContext.http.sourceIp` | L'indirizzo IP di origine della connessione TCP immediata da cui proviene la richiesta. | `123.123.123.123` |
| `requestContext.http.userAgent` | Il valore dell'intestazione della richiesta User-Agent. | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0` |
| `requestContext.requestId` | L'l'ID della richiesta di richiamo. È possibile utilizzare questo ID per tenere traccia dei registri dei richiami correlati alla funzione. | `e1506fd5-9e7b-434f-bd42-4f8fa224b599` |
| `requestContext.routeKey` | Gli URL della funzione non utilizzano questo parametro. Lambda lo imposta su `$default` come segnaposto. | `$default` |
| `requestContext.stage` | Gli URL della funzione non utilizzano questo parametro. Lambda lo imposta su `$default` come segnaposto. | `$default` |
| `requestContext.time` | Il timestamp della richiesta. | `"07/Sep/2021:22:50:22 +0000"` |
| `requestContext.timeEpoch` | Il timestamp della richiesta, in formato temporale Unix epoch. | `"1631055022677"` |
| `body` | Il corpo della richiesta. Se il tipo di contenuto della richiesta è binario, il corpo è con codifica base64. | `{"key1": "value1", "key2": "value2"}` |
| `pathParameters` | Gli URL della funzione non utilizzano questo parametro. Lambda lo imposta su `null` o lo esclude dal JSON. | `null` |
| `isBase64Encoded` | `TRUE` se il corpo è un payload binario e con codifica base64. `FALSE` in caso contrario. | `FALSE` |
| `stageVariables` | Gli URL della funzione non utilizzano questo parametro. Lambda lo imposta su `null` o lo esclude dal JSON. | `null` |
### Formato del payload di risposta
Quando la funzione restituisce una risposta, Lambda analizza la risposta e la converte in una risposta HTTP. I payload di risposta della funzione hanno il formato seguente:
```
{
"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 deduce il formato di risposta per l'utente. Se la funzione Lambda restituisce un JSON valido e non restituisce un `statusCode`, Lambda presuppone quanto segue:
+ `statusCode` is `200`.
**Nota**
I valori validi `statusCode` sono compresi tra 100 e 599.
+ `content-type` is `application/json`.
+ `body` è la risposta della funzione.
+ `isBase64Encoded` is `false`.
Gli esempi seguenti mostrano come l'output della funzione Lambda viene mappato al payload della risposta e come il payload della risposta viene mappato alla risposta HTTP finale. Quando il client richiama l'URL della funzione, viene visualizzata la risposta HTTP.
**Esempio di output per una risposta stringa**
| Risultato della funzione Lambda | Output di risposta interpretata | Risposta HTTP (cosa vede il client) |
| --- | --- | --- |
| "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!"
|
**Esempio di output per una risposta JSON**
| Risultato della funzione Lambda | Output di risposta interpretata | Risposta HTTP (cosa vede il client) |
| --- | --- | --- |
| {
"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!"
}
|
**Esempio di output per una risposta personalizzata**
| Risultato della funzione Lambda | Output di risposta interpretata | Risposta HTTP (cosa vede il client) |
| --- | --- | --- |
| {
"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
Per restituire i cookie della funzione, non aggiungere manualmente intestazioni `set-cookie`. Al contrario, includi i cookie nell'oggetto payload di risposta. Lambda li interpreta automaticamente e li aggiunge come intestazioni `set-cookie` nella risposta HTTP, come nell'esempio seguente.
| Risultato della funzione Lambda | Risposta HTTP (cosa vede il client) |
| --- | --- |
| {
"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!"
}
|