View a markdown version of this page

HTTP-Helfer in util.http - AWS AppSync GraphQL
util.http-Utils-Liste

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

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

util.http-Utils-Liste

util.http.copyHeaders(headers)

Kopiert die Header aus der Map, mit Ausnahme der folgenden eingeschränkten HTTP-Header:

  • transfer-encoding

  • connection

  • host

  • expect

  • keep-alive

  • upgrade

  • proxy-authenticate

  • proxy-authorization

  • te

  • content-length

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:

  • Zusätzlich zur Liste der eingeschränkten Header für copyHeaders(headers) dürfen Header-Namen keinem der folgenden Werte entsprechen:

    • Access-Control-Allow-Credentials

    • Access-Control-Allow-Origin

    • Access-Control-Expose-Headers

    • Access-Control-Max-Age

    • Access-Control-Allow-Methods

    • Access-Control-Allow-Headers

    • Vary

    • Content-Type

  • Header-Namen dürfen nicht mit den eingeschränkten Präfixen x-amzn- oder beginnen. x-amz-

  • Die Größe benutzerdefinierter Antwortheader darf 4 KB nicht überschreiten. Dies schließt Header-Namen und -Werte ein.

  • Sie sollten jeden Antwortheader einmal pro GraphQL-Operation definieren. Wenn Sie jedoch einen benutzerdefinierten Header mit demselben Namen mehrmals 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.

  • Header mit einem leeren oder eingeschränkten Namen (String) oder einem Nullwert (Object) werden ignoriert und führen zu einem ResponseHeaderError Fehler, der zur Ausgabe des errors Vorgangs hinzugefügt wird.

export function request(ctx) {
  util.http.addResponseHeader('itemsCount', 7)
  util.http.addResponseHeader('render', ctx.args.render)
  return {}
}
util.http.addResponseHeaders(Map)

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

export function request(ctx) {
  const headers = {
    headerInt: 12,
    headerString: 'stringValue',
    headerObject: {
      field1: 7,
      field2: 'string'
    }
  }
  util.http.addResponseHeaders(headers)
  return {}
}