assistants HTTP dans $util.http

Note

Nous prenons désormais principalement en charge le runtime APPSYNC_JS et sa documentation. Pensez à utiliser le runtime APPSYNC_JS et ses guides ici.

L'$util.httputilitaire fournit des méthodes d'assistance que vous pouvez utiliser pour gérer les paramètres des requêtes HTTP et pour ajouter des en-têtes de réponse.

Liste des utilitaires de $util.http

$util.http.copyHeaders(Map) : Map

Copie l'en-tête de la carte sans l'ensemble restreint d'en-têtes HTTP. Vous pouvez l'utiliser pour transférer les en-têtes de requête vers votre point de terminaison HTTP en aval.

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

$util.http.addResponseHeader(String, Object)

Ajoute un seul en-tête personnalisé avec le nom (String) et la valeur (Object) de la réponse. Les limites suivantes s'appliquent :

• Les noms d'en-têtes ne peuvent correspondre à aucun des AWS AppSync en-têtes existants AWS ou restreints.

• Les noms d'en-tête ne peuvent pas commencer par des préfixes restreints, tels que x-amzn- oux-amz-.

• La taille des en-têtes de réponse personnalisés ne peut pas dépasser 4 Ko. Cela inclut les noms et les valeurs des en-têtes.

• Vous devez définir chaque en-tête de réponse une fois par opération GraphQL. Toutefois, si vous définissez plusieurs fois un en-tête personnalisé portant le même nom, la définition la plus récente apparaît dans la réponse. Tous les en-têtes sont pris en compte dans la limite de taille d'en-tête, quel que soit leur nom.

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

$util.http.addResponseHeaders(Map)

Ajoute plusieurs en-têtes de réponse à la réponse à partir de la carte de noms (String) et de valeurs (Object) spécifiée. Les mêmes limites répertoriées pour la addResponseHeader(String, Object) méthode s'appliquent également à cette méthode.

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