HTTP-Helfer in $util.http - AWS AppSync

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

HTTP-Helfer in $util.http

Anmerkung

Wir unterstützen jetzt hauptsächlich die APPSYNC_JS-Laufzeit und ihre Dokumentation. Bitte erwägen Sie, die APPSYNC_JS-Laufzeit und ihre Anleitungen hier zu verwenden.

Das $util.http Hilfsprogramm bietet Hilfsmethoden, mit denen Sie HTTP-Anforderungsparameter verwalten und Antwortheader hinzufügen können.

$util.http.copyHeaders(Map) : Map

Kopiert den Header aus der Map ohne den eingeschränkten Satz von HTTP-Headern. Sie können dies verwenden, um Anforderungsheader an Ihren Downstream-HTTP-Endpunkt weiterzuleiten.

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

Fügt einen einzelnen benutzerdefinierten Header mit dem Namen (String) und dem Wert (Object) der Antwort hinzu. Die folgenden Einschränkungen gelten:

  • Header-Namen dürfen mit keinem der vorhandenen oder eingeschränkten Header AWS oder AWS AppSync Header übereinstimmen.

  • Kopfzeilennamen dürfen nicht mit eingeschränkten Präfixen wie x-amzn- oder beginnen. x-amz-

  • Die Größe der benutzerdefinierten Antwort-Header darf 4 KB nicht überschreiten. Dazu gehören Header-Namen und Werte.

  • Sie sollten jeden Antwortheader einmal pro GraphQL-Operation definieren. Wenn Sie jedoch mehrmals einen benutzerdefinierten Header mit demselben Namen definieren, erscheint die neueste Definition in der Antwort. Alle Header werden unabhängig von der Benennung auf die Größenbeschränkung für Header angerechnet.

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

Fügt der Antwort mehrere Antwortheader aus der angegebenen Zuordnung von Namen (String) und Werten (Object) hinzu. Dieselben Einschränkungen, die für die addResponseHeader(String, Object) Methode aufgeführt sind, gelten auch für diese Methode.

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