$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) ...