Référence du modèle de mappage Resolver pour la source de données None

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.

Le modèle de mappage du AWS AppSync résolveur utilisé avec la source de données de type None vous permet de façonner les demandes pour les opérations AWS AppSync locales.

Modèle de mappage des demandes

Le modèle de mappage est simple et vous permet de transmettre autant d'informations contextuelles que possible via le champ payload.

{
   "version": string,
   "payload": any type
}

Voici la représentation du schéma JSON du modèle de mappage de demande, une fois qu'il est résolu :

{
    "definitions": {},
    "$schema": "https://json-schema.org/draft-06/schema#",
    "$id": "https://aws.amazon.com/appsync/request-mapping-template.json",
    "type": "object",
    "properties": {
        "version": {
            "$id": "/properties/version",
            "type": "string",
            "enum": [
                "2018-05-29"
            ],
            "title": "The Mapping template version.",
            "default": "2018-05-29"
        },
        "payload": {}
    },
    "required": [
        "version"
    ],
    "additionalProperties": false
}

Voici un exemple où les arguments du champ sont transmis via la propriété $context.arguments de contexte VTL :

{
    "version": "2018-05-29",
    "payload": $util.toJson($context.arguments)
}

La valeur du champ payload est transmise au modèle de mappage de réponse et est alors disponible dans la propriété de contexte VTL ($context.result).

Voici un exemple représentant la valeur interpolée du champ payload :

{
    "id": "postId1"
}

Version

Commun à tous les modèles de mappage de demandes, le version champ définit la version utilisée par le modèle.

Le champ version est obligatoire.

Exemple :

"version": "2018-05-29"

Charge utile

Le champ payload est un conteneur qui peut être utilisé pour transmettre tout élément JSON de format correct au modèle de mappage de réponse.

Le champ payload est facultatif.

Modèle de mappage des réponses

Étant donné qu'il n'y a pas de source de données, la valeur du champ payload est transmise au modèle de mappage de réponse et définie sur l'objet context qui est disponible via la propriété VTL $context.result.

Si la forme de la valeur du champ payload correspond exactement à celle du type GraphQL, vous pouvez transmettre la réponse à l'aide du modèle de mappage de réponse suivant :

$util.toJson($context.result)

Il n'y a pas de champs obligatoires ni de restrictions des formes qui s'appliquent au modèle de mappage de la réponse. Toutefois, dans la mesure où GraphQL est fortement typé, le modèle de mappage résolu doit correspondre au type GraphQL prévu.