Aiutanti HTTP in $util.http

Nota

Ora supportiamo principalmente il runtime APPSYNC_JS e la relativa documentazione. Prendi in considerazione l'utilizzo del runtime APPSYNC_JS e delle relative guide qui.

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

Elenco di utilità $util.http

$util.http.copyHeaders(Map) : Map

Copia l'intestazione dalla mappa senza il set limitato di intestazioni HTTP. Puoi usarlo per inoltrare le intestazioni di richiesta all'endpoint HTTP downstream.

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

$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:

• I nomi delle intestazioni non possono corrispondere a nessuna delle intestazioni esistenti AWS o AWS AppSync limitate.

• I nomi delle intestazioni non possono iniziare con prefissi limitati, ad esempio 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 definisci 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.

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

$util.http.addResponseHeaders(Map)

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

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