Tutorial: risolutori 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.

AWS AppSync consente di utilizzare fonti di dati supportate (ad esempio Amazon DynamoDBAWS Lambda, Amazon Service o Amazon Aurora) per eseguire varie operazioni, oltre a qualsiasi endpoint HTTP arbitrario per risolvere i campi GraphQL. OpenSearch Quando gli endpoint HTTP sono disponibili, è possibile connettersi a questi utilizzando un'origine dati. Quindi, è possibile configurare un resolver nello schema per eseguire operazioni GraphQL, ad esempio query, mutazioni e sottoscrizioni. Questo tutorial fornirà una guida di alcuni esempi comuni.

In questo tutorial utilizzi un'API REST (creata utilizzando Amazon API Gateway e Lambda) con un endpoint GraphQL AWS AppSync .

Impostazione One-Click

Se desideri configurare automaticamente un endpoint GraphQL AWS AppSync con un endpoint HTTP configurato (utilizzando Amazon API Gateway e Lambda), puoi utilizzare il seguente modello: AWS CloudFormation

Creazione di un'API REST

È possibile utilizzare il seguente modello AWS CloudFormation per configurare un endpoint REST che funziona per questo tutorial.

Lo stack AWS CloudFormation esegue i seguenti passaggi:

1. Imposta una funzione Lambda che contiene la logica di business per il tuo microservizio.

2. Configura un'API REST di API Gateway con la seguente combinazione di endpoint/metodo/tipo di contenuto:

Percorso risorsa API	Metodo HTTP	Tipo di contenuto supportato
/v1/utenti	POST	application/json
/v1/utenti	GET	application/json
/v1/utenti/1	GET	application/json
/v1/utenti/1	PUT	application/json
/v1/utenti/1	DELETE	application/json

Creazione dell'API GraphQL

Per creare l'API GraphQL in AWS AppSync:

• Apri la console AWS AppSync e scegli Create API (Crea API).

• Per il nome API, digita UserData.

• Scegli Custom schema (Schema personalizzato).

• Seleziona Create (Crea).

La console AWS AppSync crea una nuova API GraphQL per l'uso della modalità di autenticazione delle chiavi API. Puoi usare la console per configurare ulteriormente l'API GraphQL ed eseguire query sull'API per il resto di questo tutorial.

Creazione di uno schema GraphQL

Ora che hai un'API GraphQL, è possibile creare uno schema GraphQL. Nell'editor dello schema disponibile nella console di AWS AppSync , verifica che lo schema corrisponda a quello riportato di seguito:

schema {
    query: Query
    mutation: Mutation
}

type Mutation {
    addUser(userInput: UserInput!): User
    deleteUser(id: ID!): User
}

type Query {
    getUser(id: ID): User
    listUser: [User!]!
}

type User {
    id: ID!
    username: String!
    firstname: String
    lastname: String
    phone: String
    email: String
}

input UserInput {
    id: ID!
    username: String!
    firstname: String
    lastname: String
    phone: String
    email: String
}

Configurazione dell'origine dati HTTP

Per configurare l'origine dati HTTP, effettua le seguenti operazioni:

• Nella DataSourcesscheda, scegli Nuovo, quindi digita un nome descrittivo per l'origine dati (ad esempio,). HTTP

• In Data source type (Tipo di origine dati), scegliere HTTP.

• Imposta l'endpoint sull'endpoint API Gateway che viene creato. Assicurarsi di non includere il nome della fase come parte dell'endpoint.

Nota: al momento solo gli endpoint pubblici sono supportati da AWS AppSync.

Nota: per ulteriori informazioni sulle autorità di certificazione riconosciute dal AWS AppSync servizio, consulta Autorità di certificazione (CA) riconosciute da AWS AppSync per gli endpoint HTTPS.

Configurazione dei resolver

In questa fase, è possibile connettere l'origine dati http alla query getUser.

Per configurare il resolver:

• Scegli la scheda Schema.

• Nel riquadro Data types (Tipi di dati) a destra sotto il tipo Query, individuare il campo getUser e scegliere Attach (Collega).

• In Data source name (Nome origine dati), scegliere HTTP.

• In Configure the request mapping template (Configura il modello di mappatura della richiesta), incollare il codice seguente:

{
    "version": "2018-05-29",
    "method": "GET",
    "params": {
        "headers": {
            "Content-Type": "application/json"
        }
    },
    "resourcePath": $util.toJson("/v1/users/${ctx.args.id}")
}

• In Configure the response mapping template (Configura il modello di mappatura della risposta), incollare il codice seguente:

## return the body
#if($ctx.result.statusCode == 200)
    ##if response is 200
    $ctx.result.body
#else
    ##if response is not 200, append the response to error block.
    $utils.appendError($ctx.result.body, "$ctx.result.statusCode")
#end

• Scegliere la scheda Query quindi eseguire la seguente query:

query GetUser{
    getUser(id:1){
        id
        username
    }
}

Viene restituita la risposta seguente:

{
    "data": {
        "getUser": {
            "id": "1",
            "username": "nadia"
        }
    }
}

• Scegli la scheda Schema.

• Nel riquadro Data types (Tipi di dati) a destra sotto Mutation (Mutazione), individuare il campo addUser e scegliere Attach (Collega).

• In Data source name (Nome origine dati), scegliere HTTP.

• In Configure the request mapping template (Configura il modello di mappatura della richiesta), incollare il codice seguente:

{
    "version": "2018-05-29",
    "method": "POST",
    "resourcePath": "/v1/users",
    "params":{
      "headers":{
        "Content-Type": "application/json",
      },
      "body": $util.toJson($ctx.args.userInput)
    }
}

• In Configure the response mapping template (Configura il modello di mappatura della risposta), incollare il codice seguente:

## Raise a GraphQL field error in case of a datasource invocation error
#if($ctx.error)
    $util.error($ctx.error.message, $ctx.error.type)
#end
## if the response status code is not 200, then return an error. Else return the body **
#if($ctx.result.statusCode == 200)
    ## If response is 200, return the body.
    $ctx.result.body
#else
    ## If response is not 200, append the response to error block.
    $utils.appendError($ctx.result.body, "$ctx.result.statusCode")
#end

• Scegliere la scheda Query quindi eseguire la seguente query:

mutation addUser{
    addUser(userInput:{
        id:"2",
        username:"shaggy"
    }){
        id
        username
    }
}

Viene restituita la risposta seguente:

{
    "data": {
        "getUser": {
        "id": "2",
        "username": "shaggy"
        }
    }
}

Richiamo dei servizi AWS

È possibile utilizzare i resolver HTTP per configurare un'interfaccia API GraphQL per i servizi. AWS Le richieste HTTP AWS devono essere firmate con il processo Signature Version 4 in modo da AWS poter identificare chi le ha inviate. AWS AppSync calcola la firma per tuo conto quando associ un ruolo IAM all'origine dati HTTP.

Fornisci due componenti aggiuntivi per richiamare i AWS servizi con resolver HTTP:

• Un ruolo IAM con autorizzazioni per chiamare le API di servizio AWS

• Configurazione della firma nell'origine dati

Ad esempio, se desideri chiamare l'ListGraphqlApis operazione con resolver HTTP, devi prima creare un ruolo IAM che AWS AppSync presuppone la seguente policy allegata:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "appsync:ListGraphqlApis"
            ],
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Quindi, crea l'origine dati HTTP per AWS AppSync. In questo esempio, chiami AWS AppSync nella regione Stati Uniti occidentali (Oregon). Imposta la seguente configurazione HTTP in un file denominato http.json, che include la regione di firma e il nome del servizio:

{
    "endpoint": "https://appsync.us-west-2.amazonaws.com/",
    "authorizationConfig": {
        "authorizationType": "AWS_IAM",
        "awsIamConfig": {
            "signingRegion": "us-west-2",
            "signingServiceName": "appsync"
        }
    }
}

Quindi, usa il AWS CLI per creare l'origine dati con un ruolo associato come segue:

aws appsync create-data-source --api-id <API-ID> \
                               --name AWSAppSync \
                               --type HTTP \
                               --http-config file:///http.json \
                               --service-role-arn <ROLE-ARN>

Quando colleghi un resolver al campo nello schema, utilizza il seguente modello di mappatura della richiesta per chiamare AWS AppSync:

{
    "version": "2018-05-29",
    "method": "GET",
    "resourcePath": "/v1/apis"
}

Quando esegui una query GraphQL per questa origine dati, AWS AppSync firma la richiesta utilizzando il ruolo fornito e include la firma nella richiesta. La query restituisce un elenco di API AWS AppSync GraphQL nel tuo account in quella regione. AWS