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

Exportieren Sie eine API-Definition als JSON-Datei, die mit AWS API Gateway kompatibel ist, über Talend Cloud API Designer.

## Vorbereitungen

* Sie haben cURL installiert. Weitere Informationen hierzu finden Sie in der [cURL-Dokumentation](https://curl.haxx.se/docs/).
* Sie haben über Talend Cloud ein persönliches Zugriffstoken generiert. Weitere Informationen finden Sie unter „[Generieren persönlicher Zugriffstoken](https://help.qlik.com/talend/r/de-DE/Cloud/management-console-user-guide/cloud-access-token)“.
* Sie haben in Talend Cloud API Designer eine API erstellt.

## Prozedur

1. Öffnen Sie eine Befehlszeile und geben Sie den folgenden Befehl ein, um Ihre API-Definition zu exportieren:
   ```
   curl --header "Authorization:Bearer {userToken}" -X GET -o {outFile}.json https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}?format=OpenApi3Aws
   ```
2. Fügen Sie die richtigen Parameter hinzu:
   | Parameter | Beschreibung |
   | --- | --- |
   | {userToken} | Über Talend Cloud generiertes Token. |
   | {outFile} | Pfad und Dateiname Ihrer API-Definition. Beispiel: contactsapi.json |
   | {region} | Region für Ihr Talend Cloud-Konto. Mögliche Werte:<br><br><ul> <li> <span>us-west</span> (USA Westen)                            </li> <li> <span>us</span> (USA)                            </li> <li> <span>eu</span> (Europa)                            </li> <li> <span>ap</span> (Asien-Pazifik)                            </li> <li> <span>au (Australien)</span> </li> </ul><br><br>Weitere Informationen finden Sie unter [Zugriff auf Talend Cloud-Anwendungen](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url?tr=de-DE). |
   | {api-id} | ID der abzurufenden API-Version. Sie finden die ID, wenn Sie Ihre API in Talend Cloud API Designer öffnen und Settings (Einstellungen) &gt; MANAGEMENT API (MANAGEMENT-API) aufrufen oder die GET-Methode am /api-definitions-Endpunkt vewenden. Dadurch wird eine Liste der API-Definitionen mit den zugehörigen IDs aufgerufen. |
3. Führen Sie den Befehl aus.

## Ergebnisse

Die API-Definition wird als JSON-Datei exportiert, die mit AWS API Gateway kompatibel ist, und im ausgewählten Verzeichnis gespeichert.

Weitere Informationen zum Export einer API-Definition mit dem Kompatibilitätsmodus für API-Gateways finden Sie im [Talend Cloud API Designer User Guide](https://help.qlik.com/talend/r/en-US/Cloud/api-designer-user-guide).