Usando HTTP resolvedores em AWS AppSync - AWS AppSync
Criando um REST APICriando seu GraphQL APICriar um esquema do GraphQLConfigure sua fonte HTTP de dadosConfiguração de resolvedoresInvocando serviços AWS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando HTTP resolvedores em AWS AppSync

AWS AppSync permite que você use fontes de dados compatíveis (ou seja, Amazon DynamoDB AWS Lambda, Amazon Service ou OpenSearch Amazon Aurora) para realizar várias operações, além de quaisquer endpoints HTTP arbitrários para resolver campos do GraphQL. Depois que seus HTTP endpoints estiverem disponíveis, você poderá se conectar a eles usando uma fonte de dados. Em seguida, configure um resolvedor no esquema para executar operações do GraphQL, como consultas, mutações e assinaturas. Esse tutorial apresentará alguns exemplos comuns.

Neste tutorial, você usa um REST API (criado usando Amazon API Gateway e Lambda) com um endpoint GraphQL AWS AppSync .

Criando um REST API

Você pode usar o AWS CloudFormation modelo a seguir para configurar um REST endpoint que funcione para este tutorial:

Blue button labeled "Launch Stack" with an arrow icon indicating an action to start.

A AWS CloudFormation pilha executa as seguintes etapas:

  1. Configura uma função do Lambda, que contém a lógica de negócios para o seu microsserviço.

  2. Configura um API Gateway REST API com a seguinte combinação endpoint/method/content de tipos:

APICaminho do recurso HTTPMétodo Tipo de conteúdo compatível

/v1/users

POST

application/json

/v1/users

GET

application/json

/v1/users/1

GET

application/json

/v1/users/1

PUT

application/json

/v1/users/1

DELETE

application/json

Criando seu GraphQL API

Para criar o GraphQL API em: AWS AppSync

  1. Abra o AWS AppSync console e escolha Criar API.

  2. Escolha GraphQL APIs e, em seguida, escolha Design do zero. Escolha Próximo.

  3. Para o API nome, digiteUserData. Escolha Próximo.

  4. Selecione Create GraphQL resources later. Escolha Próximo.

  5. Revise suas entradas e escolha Criar API.

O AWS AppSync console cria um novo GraphQL API para você usando o modo de autenticação de API chave. Você pode usar o console para configurar ainda mais seu GraphQL API e executar solicitações.

Criar um esquema do GraphQL

Agora que você tem um GraphQLAPI, vamos criar um esquema GraphQL. No editor de esquemas no AWS AppSync console, use o trecho abaixo:

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 sua fonte HTTP de dados

Para configurar sua fonte de HTTP dados, faça o seguinte:

  1. Na página Fontes de dados em seu AWS AppSync GraphQLAPI, escolha Criar fonte de dados.

  2. Insira um nome para a fonte de dados como HTTP_Example.

  3. Em Tipo de fonte de dados, escolha HTTPendpoint.

  4. Defina o endpoint como o endpoint do API Gateway que foi criado no início do tutorial. Você pode encontrar seu endpoint gerado pela pilha navegando até o console do Lambda e encontrando seu aplicativo em Aplicativos. Dentro das configurações do seu aplicativo, você deve ver um APIendpoint no qual será seu endpoint. AWS AppSync Lembre-se de não incluir o nome do estágio como parte do endpoint. Por exemplo, se o seu endpoint fosse https://aaabbbcccd.execute-api.us-east-1.amazonaws.com/v1, você digitaria https://aaabbbcccd.execute-api.us-east-1.amazonaws.com.

nota

No momento, somente endpoints públicos são suportados pelo AWS AppSync.

Para obter mais informações sobre as autoridades de certificação que são reconhecidas pelo AWS AppSync serviço, consulte Autoridades de certificação (CA) reconhecidas AWS AppSync por for HTTPS Endpoints.

Configuração de resolvedores

Nesta etapa, você conectará a fonte de HTTP dados às addUser consultas getUser e.

Como configurar o resolvedor getUser:

  1. No seu AWS AppSync GraphQLAPI, escolha a guia Esquema.

  2. À direita do editor Esquema, no painel Resolvedores e em tipo Consulta, encontre o campo getUser e escolha Anexar.

  3. Mantenha o tipo de resolvedor como Unit e o runtime como APPSYNC_JS.

  4. Em Nome da fonte de dados, escolha o HTTP endpoint que você criou anteriormente.

  5. Escolha Criar.

  6. No editor de código Resolvedor, adicione o seguinte trecho como seu manipulador de solicitação:

    import { util } from '@aws-appsync/utils'

export function request(ctx) {
	return {
		version: '2018-05-29',
		method: 'GET',
		params: {
			headers: {
				'Content-Type': 'application/json',
			},
		},
		resourcePath: `/v1/users/${ctx.args.id}`,
	}
}

  7. Adicione o seguinte trecho como seu manipulador de respostas:

    export function response(ctx) {
	const { statusCode, body } = ctx.result
	// if response is 200, return the response
	if (statusCode === 200) {
		return JSON.parse(body)
	}
	// if response is not 200, append the response to error block.
	util.appendError(body, statusCode)
}

  8. Escolha a guia Consulta e, depois, execute a seguinte consulta:

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

    Isso deve retornar a seguinte resposta:

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

Como configurar o resolvedor addUser:

  1. Escolha a guia Esquema.

  2. À direita do editor Esquema, no painel Resolvedores e em tipo Consulta, encontre o campo addUser e escolha Anexar.

  3. Mantenha o tipo de resolvedor como Unit e o runtime como APPSYNC_JS.

  4. Em Nome da fonte de dados, escolha o HTTP endpoint que você criou anteriormente.

  5. Escolha Criar.

  6. No editor de código Resolvedor, adicione o seguinte trecho como seu manipulador de solicitação:

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

  7. Adicione o seguinte trecho como seu manipulador de respostas:

    export function response(ctx) {
    if(ctx.error) {
        return util.error(ctx.error.message, ctx.error.type)
    }
    if (ctx.result.statusCode == 200) {
        return ctx.result.body
    } else {
        return util.appendError(ctx.result.body, "ctx.result.statusCode")
    }
}

  8. Escolha a guia Consulta e, depois, execute a seguinte consulta:

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

    Se você executar a consulta getUser novamente, ela deverá retornar a seguinte resposta:

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

Invocando serviços AWS

Você pode usar HTTP resolvedores para configurar uma interface API AWS GraphQL para serviços. HTTPas solicitações AWS devem ser assinadas com o processo Signature Version 4 para que seja AWS possível identificar quem as enviou. AWS AppSync calcula a assinatura em seu nome quando você associa uma IAM função à fonte de HTTP dados.

Você fornece dois componentes adicionais para invocar AWS serviços com HTTP resolvedores:

  • Uma IAM função com permissões para chamar o AWS serviço APIs

  • Configurar a assinatura na fonte de dados

Por exemplo, se você quiser chamar a ListGraphqlApis operação com HTTP resolvedores, primeiro crie uma IAM função que AWS AppSync assuma com a seguinte política anexada:

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

Em seguida, crie a fonte de HTTP dados para AWS AppSync. Neste exemplo, você liga para a AWS AppSync região Oeste dos EUA (Oregon). Defina a seguinte HTTP configuração em um arquivo chamadohttp.json, que inclui a região de assinatura e o nome do serviço:

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

Em seguida, use o AWS CLI para criar a fonte de dados com uma função associada da seguinte forma:

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

Ao anexar um resolvedor ao campo no esquema, use o seguinte modelo de mapeamento de solicitações para chamar AWS AppSync:

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

Quando você executa uma consulta GraphQL para essa fonte de dados, AWS AppSync assina a solicitação usando a função fornecida e inclui a assinatura na solicitação. A consulta retorna uma lista do AWS AppSync GraphQL APIs na sua conta nessa AWS região.