"` |
| `requestContext.http` | 包含有关 HTTP 请求的详细信息的对象。 | |
| `requestContext.http.method` | 此请求中使用的 HTTP 方法。有效值包括 `GET`、`POST`、`PUT`、`HEAD`、`OPTIONS`、`PATCH` 和 `DELETE`。 | `GET` |
| `requestContext.http.path` | 请求路径。例如，如果请求 URL 为 `https://{url-id}.lambda-url.{region}.on.aws/example/test/demo`，则路径值为 `/example/test/demo`。 | `/example/test/demo` |
| `requestContext.http.protocol` | 请求的协议。 | `HTTP/1.1` |
| `requestContext.http.sourceIp` | 发出请求的即时 TCP 连接的源 IP 地址。 | `123.123.123.123` |
| `requestContext.http.userAgent` | 用户代理请求标头值。 | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0` |
| `requestContext.requestId` | 调用请求的 ID。可以使用此 ID 跟踪与函数相关的调用日志。 | `e1506fd5-9e7b-434f-bd42-4f8fa224b599` |
| `requestContext.routeKey` | 函数 URL 不使用此参数。Lambda 将其设置为 `$default`，作为占位符。 | `$default` |
| `requestContext.stage` | 函数 URL 不使用此参数。Lambda 将其设置为 `$default`，作为占位符。 | `$default` |
| `requestContext.time` | 请求的时间戳。 | `"07/Sep/2021:22:50:22 +0000"` |
| `requestContext.timeEpoch` | 请求的时间戳，用 Unix epoch 时间表示。 | `"1631055022677"` |
| `body` | 请求的正文。如果请求的内容类型为二进制，则正文为 base64 编码。 | `{"key1": "value1", "key2": "value2"}` |
| `pathParameters` | 函数 URL 不使用此参数。Lambda 会将其设置为 `null`，或将其从 JSON 中排除。 | `null` |
| `isBase64Encoded` | 如果正文为二进制有效负载，并且为 base64 编码，则为 `TRUE`。否则为 `FALSE`。 | `FALSE` |
| `stageVariables` | 函数 URL 不使用此参数。Lambda 会将其设置为 `null`，或将其从 JSON 中排除。 | `null` |
### 响应有效负载格式
当函数返回响应时，Lambda 会解析响应并将其转换为 HTTP 响应。函数响应有效负载的格式如下：
```
{
"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 会为您推断响应格式。如果您的函数返回有效的 JSON 并且没有返回 `statusCode`，Lambda 会做出以下假设：
+ `statusCode`is(`200` )
**注意**
有效的 `statusCode` 在 100 至 599 范围内。
+ `content-type`is(`application/json` )
+ `body` 是函数响应。
+ `isBase64Encoded`is(`false` )
以下示例显示了 Lambda 函数的输出如何映射到响应有效负载，以及响应有效负载如何映射到最终 HTTP 响应。当客户端调用函数 URL 时，就会看到 HTTP 响应。
**字符串响应的输出示例**
| Lambda 函数输出 | 解释响应输出 | HTTP 响应（客户端看到的内容） |
| --- | --- | --- |
| "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!"
|
**JSON 响应的输出示例**
| Lambda 函数输出 | 解释响应输出 | HTTP 响应（客户端看到的内容） |
| --- | --- | --- |
| {
"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!"
}
|
**自定义响应的输出示例**
| Lambda 函数输出 | 解释响应输出 | HTTP 响应（客户端看到的内容） |
| --- | --- | --- |
| {
"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
要从函数返回 Cookie，请不要手动添加 `set-cookie` 标头。相反，请在响应有效负载对象中包含 Cookie。Lambda 会自动进行解释，并将其作为 `set-cookie` 标头添加到 HTTP 响应中，如下例所示。
| Lambda 函数输出 | HTTP 响应（客户端看到的内容） |
| --- | --- |
| {
"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!"
}
|