"` |
| `requestContext.http` | Um objeto que contém detalhes sobre a solicitação HTTP. | |
| `requestContext.http.method` | O método HTTP usado na solicitação. Os valores válidos incluem `GET`, `POST`, `PUT`, `HEAD`, `OPTIONS`, `PATCH` e `DELETE`. | `GET` |
| `requestContext.http.path` | O caminho da solicitação. Por exemplo, se o URL de solicitação for `https://{url-id}.lambda-url.{region}.on.aws/example/test/demo`, o valor do caminho será `/example/test/demo`. | `/example/test/demo` |
| `requestContext.http.protocol` | O protocolo da solicitação. | `HTTP/1.1` |
| `requestContext.http.sourceIp` | O endereço IP de origem da conexão TCP imediata que está fazendo a solicitação. | `123.123.123.123` |
| `requestContext.http.userAgent` | O valor do cabeçalho da solicitação User-Agent. | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0` |
| `requestContext.requestId` | O ID da solicitação da invocação. Você pode usar esse ID para logs de invocações relacionadas à função. | `e1506fd5-9e7b-434f-bd42-4f8fa224b599` |
| `requestContext.routeKey` | URLs de função não usam esse parâmetro. O Lambda define isso como `$default` para marcar um espaço reservado. | `$default` |
| `requestContext.stage` | URLs de função não usam esse parâmetro. O Lambda define isso como `$default` para marcar um espaço reservado. | `$default` |
| `requestContext.time` | O timestamp da solicitação. | `"07/Sep/2021:22:50:22 +0000"` |
| `requestContext.timeEpoch` | O timestamp da solicitação, no horário da era UNIX. | `"1631055022677"` |
| `body` | O corpo da solicitação. Se o tipo de conteúdo da solicitação for binário, o corpo será codificado na base 64. | `{"key1": "value1", "key2": "value2"}` |
| `pathParameters` | URLs de função não usam esse parâmetro. O Lambda define isso como `null` ou exclui isso do JSON. | `null` |
| `isBase64Encoded` | `TRUE` se o corpo for uma carga útil binária e for codificado na base 64. `FALSE` nos demais casos. | `FALSE` |
| `stageVariables` | URLs de função não usam esse parâmetro. O Lambda define isso como `null` ou exclui isso do JSON. | `null` |
### Formato de carga útil de resposta
Quando a função retorna uma resposta, o Lambda analisa a resposta e converte-a em uma resposta HTTP. As cargas úteis de resposta de função têm o seguinte formato:
```
{
"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
}
```
O Lambda infere o formato de resposta para você. Se a função do Lambda retornar JSON válido e não retornar um `statusCode`, o Lambda pressupõe o seguinte:
+ `statusCode` is `200`.
**nota**
Os `statusCode` válidos vão de 100 a 599.
+ `content-type` is `application/json`.
+ `body` é a resposta da função.
+ `isBase64Encoded` is `false`.
Os exemplos a seguir mostram como a saída da função do Lambda é mapeada para a carga útil da resposta e como a carga útil da resposta é mapeada para a resposta HTTP final. Quando o cliente invoca o URL de função, ele vê a resposta HTTP.
**Exemplo de saída para uma resposta de string**
| Saída da função do Lambda | Saída de resposta interpretada | Resposta HTTP (o que o cliente vê) |
| --- | --- | --- |
| "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!"
|
**Exemplo de saída para uma resposta em JSON**
| Saída da função do Lambda | Saída de resposta interpretada | Resposta HTTP (o que o cliente vê) |
| --- | --- | --- |
| {
"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!"
}
|
**Exemplo de saída para uma resposta personalizada**
| Saída da função do Lambda | Saída de resposta interpretada | Resposta HTTP (o que o cliente vê) |
| --- | --- | --- |
| {
"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!"
}
|
### Cookies
Para retornar cookies da função, não adicione manualmente cabeçalhos `set-cookie`. Em vez disso, inclua os cookies no objeto de carga útil da resposta. O Lambda interpreta isso automaticamente e adiciona-os como cabeçalhos `set-cookie` na resposta HTTP, como no exemplo a seguir.
| Saída da função do Lambda | Resposta HTTP (o que o cliente vê) |
| --- | --- |
| {
"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!"
}
|