Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwendung von HTTP-Resolvern in AWS AppSync **Anmerkung** Wir unterstützen jetzt hauptsächlich die APPSYNC\$1JS-Laufzeit und ihre Dokumentation. [Bitte erwägen Sie, die APPSYNC\$1JS-Laufzeit und ihre Anleitungen hier zu verwenden.](https://docs.aws.amazon.com/appsync/latest/devguide/tutorials-js.html) AWS AppSync ermöglicht es Ihnen, unterstützte Datenquellen (d. h. Amazon DynamoDB AWS Lambda, Amazon OpenSearch Service oder Amazon Aurora) zu verwenden, um verschiedene Operationen durchzuführen, zusätzlich zu beliebigen HTTP-Endpunkten zur Auflösung von GraphQL-Feldern. Sobald die HTTP-Endpunkte verfügbar sind, können Sie sie mit einer Datenquelle verbinden. Anschließend können Sie einen Resolver im Schema konfigurieren, um GraphQL-Operationen wie Abfragen, Mutationen und Abonnements auszuführen. Dieses Tutorial führt Sie durch einige häufig auftretende Beispiele. In diesem Tutorial verwenden Sie eine REST-API (erstellt mit Amazon API Gateway und Lambda) mit einem AWS AppSync GraphQL-Endpunkt. ## One-Click-Setup Wenn Sie automatisch einen GraphQL-Endpunkt AWS AppSync mit einem konfigurierten HTTP-Endpunkt einrichten möchten (mit Amazon API Gateway und Lambda), können Sie die folgende AWS CloudFormation Vorlage verwenden: [https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?templateURL=https://s3.us-west-2.amazonaws.com/awsappsync/resources/http/http-full.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?templateURL=https://s3.us-west-2.amazonaws.com/awsappsync/resources/http/http-full.yaml) ## Erstellen einer REST-API Sie können die folgende AWS CloudFormation Vorlage verwenden, um einen REST-Endpunkt einzurichten, der für dieses Tutorial funktioniert: [https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?templateURL=https://s3.us-west-2.amazonaws.com/awsappsync/resources/http/http-api-gw.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?templateURL=https://s3.us-west-2.amazonaws.com/awsappsync/resources/http/http-api-gw.yaml) Der AWS CloudFormation Stack führt die folgenden Schritte aus: 1. Richtet eine Lambda-Funktion ein, die die Geschäftslogik für den Mikroservice enthält. 1. Richtet eine API-Gateway-REST-API mit der folgenden endpoint/method/content Typkombination ein: **** | API-Ressourcenpfad | HTTP-Methode | Unterstützter Inhaltstyp | | --- | --- | --- | | /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 | ## Erstellen der GraphQL-API Um die GraphQL-API zu erstellen in AWS AppSync: + Öffnen Sie die AWS AppSync Konsole und wählen Sie **Create API**. + Geben Sie für den API-Namen `UserData` ein. + Wählen Sie **Custom schema (Benutzerdefiniertes Schema)**. + Wählen Sie **Erstellen** aus. Die AWS AppSync Konsole erstellt mithilfe des API-Schlüsselauthentifizierungsmodus eine neue GraphQL-API für Sie. Sie können in der Konsole den Rest der GraphQL-API einrichten und im weiteren Verlauf dieses Tutorials abfragen. ## Erstellen eines GraphQL-Schemas Da wir jetzt eine GraphQL-API haben, erstellen Sie ein GraphQL-Schema. Stellen Sie im Schema-Editor in der AWS AppSync Konsole sicher, dass Ihr Schema dem folgenden Schema entspricht: ``` 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 } ``` ## Konfigurieren der HTTP-Datenquelle Gehen Sie wie folgt vor, um die HTTP-Datenquelle zu konfigurieren: + Wählen Sie auf der **DataSources**Registerkarte **Neu** aus, und geben Sie dann einen benutzerfreundlichen Namen für die Datenquelle ein (z. B.`HTTP`). + Wählen Sie für **Data source type (Datenquellentyp)** die Option **HTTP** aus. + Legen Sie den Endpunkt auf den erstellten API-Gateway-Endpunkt fest. Stellen Sie sicher, dass Sie den Namen der Stufe nicht in den Namen des Endpunkts einschließen. **Hinweis:** Derzeit werden nur öffentliche Endpunkte von AWS AppSync unterstützt. **Hinweis:** Weitere Informationen zu den Zertifizierungsstellen, die vom AWS AppSync Dienst anerkannt werden, finden Sie unter [Zertifizierungsstellen (CA) Recognized by AWS AppSync for HTTPS Endpoints](http-cert-authorities.md#aws-appsync-http-certificate-authorities). ## Konfigurieren von Resolvern In diesem Schritt verbinden Sie die HTTP-Datenquelle mit der Abfrage **getUser**. Richten Sie den Resolver wie folgt ein: + Wählen Sie die Registerkarte **Schema** aus. + Suchen Sie im Bereich **Data types (Datentypen)** rechts unter dem **Query type (Abfragetyp)** das Feld **getUser** und wählen Sie **Attach(Anfügen)** aus. + Wählen Sie für **Data source name (Datenquellenname)** die Option **HTTP** aus. + Fügen Sie unter **Configure the request mapping template (Zuweisungsvorlage für Anforderungen konfigurieren)** den folgenden Code ein: ``` { "version": "2018-05-29", "method": "GET", "params": { "headers": { "Content-Type": "application/json" } }, "resourcePath": $util.toJson("/v1/users/${ctx.args.id}") } ``` + Fügen Sie unter **Configure the response mapping template (Zuweisungsvorlage für Antworten konfigurieren)** den folgenden Code ein: ``` ## 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 ``` + Wählen Sie auf der Registerkarte **Query (Abfrage)** und führen Sie dann folgende Abfrage aus: ``` query GetUser{ getUser(id:1){ id username } } ``` Folgende Antwort sollte zurückgegeben werden: ``` { "data": { "getUser": { "id": "1", "username": "nadia" } } } ``` + Wählen Sie die Registerkarte **Schema** aus. + Suchen Sie im Bereich **Data types (Datentypen)** rechts unter **Mutation** das Feld **addUser** und wählen Sie **Attach (Anfügen)** aus. + Wählen Sie für **Data source name (Datenquellenname)** die Option **HTTP** aus. + Fügen Sie unter **Configure the request mapping template (Zuweisungsvorlage für Anforderungen konfigurieren)** den folgenden Code ein: ``` { "version": "2018-05-29", "method": "POST", "resourcePath": "/v1/users", "params":{ "headers":{ "Content-Type": "application/json", }, "body": $util.toJson($ctx.args.userInput) } } ``` + Fügen Sie unter **Configure the response mapping template (Zuweisungsvorlage für Antworten konfigurieren)** den folgenden Code ein: ``` ## 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 ``` + Wählen Sie auf der Registerkarte **Query (Abfrage)** und führen Sie dann folgende Abfrage aus: ``` mutation addUser{ addUser(userInput:{ id:"2", username:"shaggy" }){ id username } } ``` Folgende Antwort sollte zurückgegeben werden: ``` { "data": { "getUser": { "id": "2", "username": "shaggy" } } } ``` ## Dienste aufrufen AWS Sie können HTTP-Resolver verwenden, um eine GraphQL-API-Schnittstelle für AWS Dienste einzurichten. HTTP-Anfragen an AWS müssen mit dem [Signature Version 4-Prozess](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) signiert werden, damit identifiziert werden AWS kann, wer sie gesendet hat. AWS AppSync berechnet die Signatur in Ihrem Namen, wenn Sie der HTTP-Datenquelle eine IAM-Rolle zuordnen. Sie stellen zwei zusätzliche Komponenten bereit, um AWS Dienste mit HTTP-Resolvern aufzurufen: + Eine IAM-Rolle mit Berechtigungen zum Aufrufen des Dienstes AWS APIs + Signierkonfiguration in der Datenquelle Wenn Sie den [ListGraphqlApis Vorgang](https://docs.aws.amazon.com/appsync/latest/APIReference/API_ListGraphqlApis.html) beispielsweise mit HTTP-Resolvern aufrufen möchten, [erstellen Sie zunächst eine IAM-Rolle](attaching-a-data-source.md#aws-appsync-getting-started-build-a-schema-from-scratch), der die folgende AWS AppSync Richtlinie zugewiesen ist: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "appsync:ListGraphqlApis" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Als Nächstes erstellen Sie die HTTP-Datenquelle für. AWS AppSync In diesem Beispiel rufen Sie AWS AppSync in der Region USA West (Oregon) auf. Richten Sie die folgende HTTP-Konfiguration in einer Datei mit dem Namen `http.json` ein, die die Signierregion und den Servicenamen enthält: ``` { "endpoint": "https://appsync.us-west-2.amazonaws.com/", "authorizationConfig": { "authorizationType": "AWS_IAM", "awsIamConfig": { "signingRegion": "us-west-2", "signingServiceName": "appsync" } } } ``` Verwenden Sie dann die, AWS CLI um die Datenquelle mit einer zugehörigen Rolle wie folgt zu erstellen: ``` aws appsync create-data-source --api-id \ --name AWSAppSync \ --type HTTP \ --http-config file:///http.json \ --service-role-arn ``` Wenn Sie einen Resolver an das Feld im Schema anhängen, verwenden Sie zum Aufrufen AWS AppSync die folgende Vorlage für die Anforderungszuweisung: ``` { "version": "2018-05-29", "method": "GET", "resourcePath": "/v1/apis" } ``` Wenn Sie eine GraphQL-Abfrage für diese Datenquelle ausführen, AWS AppSync signiert die Anfrage mit der von Ihnen angegebenen Rolle und fügt die Signatur in die Anfrage ein. Die Abfrage gibt eine Liste von AWS AppSync GraphQL APIs in Ihrem Konto in dieser AWS Region zurück.