Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de solucionadores de HTTP en AWS AppSync

AWS AppSync le permite utilizar orígenes de datos compatibles (es decir, AWS Lambda, Amazon DynamoDB, Amazon OpenSearch Service o Amazon Aurora) para realizar diversas operaciones, además de cualquier punto de conexión HTTP arbitrario para resolver campos de GraphQL. Una vez que los puntos de enlace HTTP están disponibles, puede conectar con ellos mediante un origen de datos. A continuación, puede configurar un solucionador en el esquema para realizar operaciones de GraphQL como consultas, mutaciones, y suscripciones. Este tutorial le guiará a lo largo de algunos ejemplos comunes.

En este tutorial, se utiliza una API de REST (creada mediante Amazon API Gateway y Lambda) con un punto de conexión de GraphQL de AWS AppSync.

Configuración en un clic

Si desea crear automáticamente un punto de conexión de GraphQL en AWS AppSync con un punto de conexión HTTP configurado (mediante Amazon API Gateway y Lambda), puede utilizar la siguiente plantilla de AWS CloudFormation:

Creación de una API de REST

Puede utilizar la siguiente plantilla de AWS CloudFormation para establecer un punto de enlace REST que funcione con este tutorial:

La pila de AWS CloudFormation realiza los siguientes pasos:

Creación de la API de GraphQL

Para crear la API de GraphQL en AWS AppSync:

La consola de AWS AppSync crea una nueva API de GraphQL automáticamente utilizando el modo de autenticación de clave de API. Puede utilizar la consola para configurar el resto de la API de GraphQL y ejecutar consultas en ella durante el resto de este tutorial.

Creación de un esquema de GraphQL

Ahora que tiene una API de GraphQL, vamos a crear un esquema de GraphQL. En el editor de esquemas de la consola de AWS AppSync, asegúrese de que el esquema coincida con el siguiente:

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
}

Configure el origen de datos HTTP

Para configurar el origen de datos HTTP, haga lo siguiente:

Nota: En estos momentos, solo los puntos de conexión públicos son compatibles con AWS AppSync.

Nota: Para obtener más información acerca de las entidades de certificación que reconoce el servicio de AWS AppSync, consulte Certificate Authorities (CA) Recognized by AWS AppSync for HTTPS Endpoints.

Configuración de solucionadores

En este paso conectará el origen de datos HTTP a la consulta getUser.

Para configurar el solucionador de :

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

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

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

Debe obtener la siguiente respuesta:

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

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

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

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

Debe obtener la siguiente respuesta:

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

Invocación de servicios de AWS

Puede utilizar los solucionadores de HTTP para establecer una interfaz de API de GraphQL para los servicios de AWS. Las solicitudes HTTP a AWS deben firmarse con el proceso de Signature Version 4 para que AWS pueda identificar quién las envió. AWS AppSync calcula la firma en su nombre cuando asocia un rol de IAM al origen de datos HTTP.

Debe proporcionar dos componentes adicionales para invocar los servicios de AWS con solucionadores de HTTP:

Por ejemplo, si desea realizar una llamada a la operación ListGraphqlApis con los solucionadores de HTTP, primero debe crear un rol de IAM que AWS AppSync asume con la siguiente política asociada:

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

A continuación, cree el origen de datos HTTP para AWS AppSync. En este ejemplo, debe realizar una llamada a AWS AppSync en la región Oeste de EE. UU. (Oregón). Ajuste la siguiente configuración HTTP en un archivo denominado http.json, que incluye la región de la firma y el nombre del servicio:

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

A continuación, utilice la AWS CLI para crear el origen de datos con un rol asociado de la siguiente forma:

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

Cuando asocie un solucionador al campo del esquema, utilice la siguiente plantilla de mapeo de solicitudes para realizar una llamada a AWS AppSync:

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

Cuando ejecuta una consulta de GraphQL para este origen de datos, AWS AppSync firma la solicitud mediante el rol que ha proporcionado e incluye la firma en la solicitud. La consulta devuelve una lista de API de GraphQL de AWS AppSync en su cuenta de dicha región de AWS.