$util.http 中的 HTTP 帮助程序 - Amazon AppSync
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

$util.http 中的 HTTP 帮助程序

这些区域有：$util.http实用程序提供了帮助方法，您可以使用这些方法来管理 HTTP 请求参数和添加响应标头。

$util.http.copyHeaders(Map) : Map

从映射中复制标头，不包括限制的 HTTP 标头集。您可以使用它将请求标头转发给下游 HTTP 终端节点。

{
    ...
    "params": {
        ...
        "headers": $util.http.copyHeaders($ctx.request.headers),
        ...
    },
    ...
}
$util.http.addResponseHeader(String, Object)

添加一个带有名称的自定义标题 (String) 和价值 (Object）的响应。适用以下限制：

  • 标题名称不能与任何现有的或受限的Amazon要么Amazon AppSync 标头。

  • 标头名称不能以限制的前缀开头，例如x-amzn-要么x-amz-.

  • 自定义响应标头的大小不能超过 4 KB。这包括标题名称和值。

  • 每个 GraphQL 操作应定义每个响应标头一次。但是，如果您多次定义具有相同名称的自定义标题，则响应中将显示最新的定义。无论命名如何，所有标题都计入标题大小限制。

...
$util.http.addResponseHeader("itemsCount", 7)
$util.http.addResponseHeader("render", $ctx.args.render)
...
$util.http.addResponseHeaders(Map)

从指定名称映射向响应添加多个响应标头 (String) 和值 (Object)。列出的相同限制addResponseHeader(String, Object)方法也适用于此方法。

...
#set($headersMap = {})
$util.qr($headersMap.put("headerInt", 12))
$util.qr($headersMap.put("headerString", "stringValue"))
$util.qr($headersMap.put("headerObject", {"field1": 7, "field2": "string"}))
$util.http.addResponseHeaders($headersMap)
...