AWS AppSync riferimento al modello di mappatura del resolver per HTTP - AWS AppSync
Richiedi un modello di mappaturaVersioneMetodoResourcePathCampi dei parametriRisposta

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à.

AWS AppSync riferimento al modello di mappatura del resolver per HTTP

Nota

Ora supportiamo principalmente il runtime APPSYNC _JS e la relativa documentazione. Valuta la possibilità di utilizzare il runtime APPSYNC _JS e le relative guide qui.

I modelli di mappatura del AWS AppSync HTTP resolver ti consentono di inviare richieste da qualsiasi HTTP endpoint e di AWS AppSync inviare risposte dal tuo endpoint a. HTTP AWS AppSync Utilizzando i modelli di mappatura, è possibile fornire suggerimenti AWS AppSync sulla natura dell'operazione da richiamare. Questa sezione descrive i diversi modelli di mappatura per il resolver supportato. HTTP

Richiedi un modello di mappatura

{
    "version": "2018-05-29",
    "method": "PUT|POST|GET|DELETE|PATCH",
    "params": {
        "query": Map,
        "headers": Map,
        "body": any
    },
    "resourcePath": string
}

Dopo la risoluzione del modello di mappatura della HTTP richiesta, la rappresentazione JSON dello schema del modello di mappatura della richiesta è la seguente:

{
    "$id": "https://aws.amazon.com/appsync/request-mapping-template.json",
    "type": "object",
    "properties": {
        "version": {
        "$id": "/properties/version",
        "type": "string",
        "title": "The Version Schema ",
        "default": "",
        "examples": [
            "2018-05-29"
        ],
        "enum": [
            "2018-05-29"
        ]
        },
        "method": {
        "$id": "/properties/method",
        "type": "string",
        "title": "The Method Schema ",
        "default": "",
        "examples": [
            "PUT|POST|GET|DELETE|PATCH"
        ],
        "enum": [
            "PUT",
            "PATCH",
            "POST",
            "DELETE",
            "GET"
        ]
        },
        "params": {
        "$id": "/properties/params",
        "type": "object",
        "properties": {
            "query": {
            "$id": "/properties/params/properties/query",
            "type": "object"
            },
            "headers": {
            "$id": "/properties/params/properties/headers",
            "type": "object"
            },
            "body": {
            "$id": "/properties/params/properties/body",
            "type": "string",
            "title": "The Body Schema ",
            "default": "",
            "examples": [
                ""
            ]
            }
        }
        },
        "resourcePath": {
        "$id": "/properties/resourcePath",
        "type": "string",
        "title": "The Resourcepath Schema ",
        "default": "",
        "examples": [
            ""
        ]
        }
    },
    "required": [
        "version",
        "method",
        "resourcePath"
    ]
}

Di seguito è riportato un esempio di HTTP POST richiesta, con un text/plain corpo:

{
    "version": "2018-05-29",
    "method": "POST",
    "params": {
        "headers":{
        "Content-Type":"text/plain"
        },
        "body":"this is an example of text body"
    },
    "resourcePath": "/"
}

Versione

Nota

Questo vale solo per il modello di mappatura Request.

Definisce la versione usata dal modello. version è comune a tutti i modelli di mappatura della richiesta ed è obbligatorio.

"version": "2018-05-29"

Metodo

Nota

Questo vale solo per il modello di mappatura Request.

HTTPmetodo o verbo (GET,POST, PUTPATCH, oDELETE) che AWS AppSync invia all'HTTPendpoint.

"method": "PUT"

ResourcePath

Nota

Questo vale solo per il modello di mappatura Request.

Il percorso delle risorse a cui si desidera accedere. Oltre all'endpoint nell'origine HTTP dati, il percorso della risorsa costituisce il percorso a URL cui il AWS AppSync servizio effettua una richiesta.

"resourcePath": "/v1/users"

Quando il modello di mappatura viene valutato, questo percorso viene inviato come parte della HTTP richiesta, incluso l'endpoint. HTTP Ad esempio, l'esempio precedente potrebbe diventare il seguente:

PUT <endpoint>/v1/users

Campi dei parametri

Nota

Questo vale solo per il modello di mappatura Request.

Usato per specificare l'operazione eseguita dalla ricerca, in genere impostando il valore query all'interno di body. Ci sono tuttavia numerose altre funzionalità che è possibile configurare, ad esempio la formattazione delle risposte.

headers

Informazioni dell'intestazione, come coppie chiave-valore. Sia la chiave che il valore devono essere stringhe.

Per esempio:

"headers" : {
    "Content-Type" : "application/json"
}

Le intestazioni Content-Type attualmente supportate sono:

text/*
application/xml
application/json
application/soap+xml
application/x-amz-json-1.0
application/x-amz-json-1.1
application/vnd.api+json
application/x-ndjson

Nota: non puoi impostare le seguenti HTTP intestazioni:

HOST
CONNECTION
USER-AGENT
EXPECTATION
TRANSFER_ENCODING
CONTENT_LENGTH
query

Coppie chiave-valore che specificano opzioni comuni, come la formattazione del codice per le risposte. JSON Sia la chiave che il valore devono essere stringhe. L'esempio seguente mostra in che modo è possibile inviare una stringa di query come ?type=json:

"query" : {
    "type" : "json"
}
body

Il corpo contiene il corpo della HTTP richiesta che avete scelto di impostare. Il corpo della richiesta è sempre una stringa con codifica UTF -8 a meno che il tipo di contenuto non specifichi il set di caratteri.

"body":"body string"

Risposta

Consulta un esempio qui.