"` |
| `requestContext.http` | Un objeto que contiene detalles sobre la solicitud HTTP. | |
| `requestContext.http.method` | El método HTTP utilizado en esta solicitud. Los valores válidos son `GET`, `POST`, `PUT`, `HEAD`, `OPTIONS`, `PATCH` y `DELETE`. | `GET` |
| `requestContext.http.path` | Ruta de acceso de la solicitud. Por ejemplo, si la URL de solicitud es `https://{url-id}.lambda-url.{region}.on.aws/example/test/demo`, el valor de la ruta es `/example/test/demo`. | `/example/test/demo` |
| `requestContext.http.protocol` | El protocolo de la solicitud. | `HTTP/1.1` |
| `requestContext.http.sourceIp` | La dirección IP de origen de la conexión TCP inmediata que realiza la solicitud. | `123.123.123.123` |
| `requestContext.http.userAgent` | El valor del encabezado de solicitud usuario-agente. | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0` |
| `requestContext.requestId` | El ID de la solicitud de invocación. Puede utilizar este ID para realizar un seguimiento de los registros de invocación relacionados con la función. | `e1506fd5-9e7b-434f-bd42-4f8fa224b599` |
| `requestContext.routeKey` | Las URL de funciones no utilizan este parámetro. Lambda establece `$default` como marcador de posición. | `$default` |
| `requestContext.stage` | Las URL de funciones no utilizan este parámetro. Lambda establece `$default` como marcador de posición. | `$default` |
| `requestContext.time` | La marca de tiempo de la solicitud. | `"07/Sep/2021:22:50:22 +0000"` |
| `requestContext.timeEpoch` | La marca de tiempo de la solicitud, en fecha de inicio Unix. | `"1631055022677"` |
| `body` | El cuerpo de la solicitud. Si el tipo de contenido de la solicitud es binario, el cuerpo está codificado en base64. | `{"key1": "value1", "key2": "value2"}` |
| `pathParameters` | Las URL de funciones no utilizan este parámetro. Lambda establece esto como `null` o lo excluye de JSON. | `null` |
| `isBase64Encoded` | `TRUE` si el cuerpo es una carga binaria y está codificado en base64. `FALSE` en caso contrario. | `FALSE` |
| `stageVariables` | Las URL de funciones no utilizan este parámetro. Lambda establece esto como `null` o lo excluye de JSON. | `null` |
### Formato de carga de respuesta
Cuando la función devuelve una respuesta, Lambda analiza la respuesta y la convierte en una respuesta HTTP. Las cargas de respuesta de la función tienen el siguiente 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
}
```
Lambda le infiere el formato de respuesta. Si la función devuelve JSON válido y no devuelve un `statusCode`, Lambda asume lo siguiente:
+ `statusCode` is `200`.
**nota**
Los `statusCode` válidos están dentro del rango de 100 a 599.
+ `content-type` is `application/json`.
+ `body` es la respuesta de la función.
+ `isBase64Encoded` is `false`.
En los ejemplos siguientes se muestra cómo se asigna la salida de la función de Lambda a la carga de respuesta y cómo se asigna la carga de respuesta a la respuesta HTTP final. Cuando el cliente invoca la URL de función, ve la respuesta HTTP.
**Ejemplo de salida para una respuesta de cadena**
| Salida de función de Lambda | Salida de respuesta interpretada | Respuesta HTTP (lo que ve el cliente) |
| --- | --- | --- |
| "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!"
|
**Ejemplo de salida para una respuesta JSON**
| Salida de función de Lambda | Salida de respuesta interpretada | Respuesta HTTP (lo que ve el cliente) |
| --- | --- | --- |
| {
"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!"
}
|
**Ejemplo de salida para una respuesta personalizada**
| Salida de función de Lambda | Salida de respuesta interpretada | Respuesta HTTP (lo que ve el cliente) |
| --- | --- | --- |
| {
"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 devolver las cookies de su función, no agregue encabezados `set-cookie` manualmente. En su lugar, incluya las cookies en su objeto de carga de respuesta. Lambda interpreta esto automáticamente y las agrega como encabezados `set-cookie` de la respuesta HTTP, como en el siguiente ejemplo.
| Salida de función de Lambda | Respuesta HTTP (lo que ve el cliente) |
| --- | --- |
| {
"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!"
}
|