# Aktualisieren einer API-Definition für AWS API Gateway

Importieren Sie eine JSON-Datei in AWS API Gateway, um eine vorhandene Definition zu aktualisieren.

## Vorbereitungen

* Sie haben Zugriff auf AWS API Gateway.
* Sie haben AWS CLI installiert. Weitere Informationen finden Sie unter [Installation oder Aktualisierung auf die neueste Version von AWS CLI](https://docs.aws.amazon.com/de_de/cli/latest/userguide/getting-started-install.html).
* Sie haben Ihre API-Definition als JSON-Datei exportiert.
* Sie haben eine vorherige Version der API-Definition an AWS API Gateway hochgeladen.

## Prozedur

1. Öffnen Sie eine Befehlszeile und geben Sie folgenden Befehl ein, um die Datei hochzuladen:
   ```
   aws apigateway put-rest-api --rest-api-id {api-id} --mode {mode} --body 'file://{yourfile}.json'
   ```
2. Fügen Sie die richtigen Parameter hinzu:
   | Parameter | Beschreibung |
   | --- | --- |
   | {api-id} | AWS API Gateway-ID der zu aktualisierenden API. |
   | {mode} | Verhalten beim Import. Der Wert kann entweder overwrite sein, um die vorherige Version der API mit der neuen Version zu überschreiben, oder merge, um die beiden Versionen zusammenzuführen. |
   | {yourfile} | Pfad und Dateiname der exportierten API-Definition. |
3. Führen Sie den Befehl aus.

## Ergebnisse

Ihre API-Definition wird zusammengeführt oder überschrieben, je nach dem definierten Modus. Sie können die Aktualisierung auf der AWS API Gateway-Konsole prüfen.

In diesem Beispiel wurde eine erste Version der API-Definition hochgeladen, die nur die Ressource /contacts und ihre Vorgänge enthielt. Dann wurde eine zweite Version mit der Ressource /companies hochgeladen und mit der vorherigen Version zusammengeführt.

![Screenshot der zusammengeführten API-Definition.](https://help.qlik.com/talend/de-DE/api-designer-user-guide/Resources/images/aws_2.png)

Weitere Informationen zum Befehl put-rest-api finden Sie in der [AWS-Dokumentation](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html).