View a markdown version of this page

Helper HTTP in util.http - AWS AppSync GraphQL
util.http: elenco delle utilità

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Helper HTTP in util.http

L'util.httputilità fornisce metodi di supporto che è possibile utilizzare per gestire i parametri delle richieste HTTP e aggiungere intestazioni di risposta.

util.http: elenco delle utilità

util.http.copyHeaders(headers)

Copia le intestazioni dalla mappa, escluse le seguenti intestazioni HTTP soggette a restrizioni:

  • transfer-encoding

  • connection

  • host

  • expect

  • keep-alive

  • upgrade

  • proxy-authenticate

  • proxy-authorization

  • te

  • content-length

util.http.addResponseHeader(String, Object)

Aggiunge una singola intestazione personalizzata con il nome (String) e il valore (Object) della risposta. Si applicano le limitazioni seguenti:

  • Oltre all'elenco delle intestazioni soggette a restrizioni percopyHeaders(headers), i nomi delle intestazioni non possono corrispondere a nessuna delle seguenti:

    • 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

  • I nomi delle intestazioni non possono iniziare con i prefissi limitati o. x-amzn- x-amz-

  • La dimensione delle intestazioni di risposta personalizzate non può superare i 4 KB. Sono inclusi i nomi e i valori delle intestazioni.

  • È necessario definire ogni intestazione di risposta una volta per operazione GraphQL. Tuttavia, se si definisce più volte un'intestazione personalizzata con lo stesso nome, nella risposta viene visualizzata la definizione più recente. Tutte le intestazioni vengono conteggiate ai fini del limite di dimensione dell'intestazione indipendentemente dalla denominazione.

  • Le intestazioni con un nome vuoto o limitato (String) o un valore nullo verranno ignorate e (Object) genereranno un ResponseHeaderError errore che viene aggiunto all'output dell'operazione. errors

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

Aggiunge più intestazioni di risposta alla risposta dalla mappa di nomi e valori specificata. (String) (Object) Le stesse limitazioni elencate per il addResponseHeader(String, Object) metodo si applicano anche a questo metodo.

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