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. # REST-API von API Gateway importieren Sobald Sie eine REST-API in API Gateway erstellt und konfiguriert haben, können Sie sie mit der API Gateway-Konsole oder anderweitig in eine OpenAPI-Datei exportieren, und zwar mit der API Gateway-Export-API, die Teil des Amazon API Gateway-Control-Service ist. Um die API-Gateway-Export-API verwenden zu können, müssen Sie Ihre API-Anforderungen signieren. Weitere Informationen zum Signieren von Anfragen finden Sie unter [Signieren von AWS API-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) im *IAM-Benutzerhandbuch*. Ihnen stehen Optionen zur Verfügung, die API Gateway-Integrationserweiterungen sowie die [Postman](https://www.postman.com)-Erweiterungen in die exportierte OpenAPI-Definitionsdatei aufzunehmen. **Anmerkung** Achten Sie beim Exportieren der API mithilfe von darauf AWS CLI, den Erweiterungsparameter anzugeben, wie im folgenden Beispiel gezeigt, um sicherzustellen, dass die `x-amazon-apigateway-request-validator` Erweiterung enthalten ist: ``` aws apigateway get-export --parameters extensions='apigateway' --rest-api-id abcdefg123 --stage-name dev --export-type swagger latestswagger2.json ``` Sie können eine API nicht exportieren, wenn deren Nutzlast nicht vom Typ `application/json` ist. Wenn Sie dies versuchen, erhalten Sie eine Fehlermeldung, die besagt, dass JSON-Textmodelle nicht gefunden wurden. ## Anfordern zum Exportieren einer REST-API Mit der Export-API exportieren Sie eine vorhandene REST-API, indem Sie eine GET-Anfrage einreichen und die to-be-exported API als Teil der URL-Pfade angeben. Der Anforderungs-URL hat das folgende Format: ------ #### [ OpenAPI 3.0 ] ``` https:///restapis//stages//exports/oas30 ``` ------ #### [ OpenAPI 2.0 ] ``` https:///restapis//stages//exports/swagger ``` ------ Sie können die Abfragezeichenfolge `extensions` anhängen, um anzugeben, ob API Gateway-Erweiterungen (mit dem Wert `integration`) oder Postman-Erweiterungen (mit dem Wert `postman`) enthalten sein sollen. Darüber hinaus können Sie den Header `Accept` auf `application/json` oder `application/yaml` festlegen, um die API-Definitionsausgabe im JSON- bzw. YAML-Format zu erhalten. Weitere Informationen zum Einreichen von GET-Anfragen mit der API Gateway Export API finden Sie unter [GetExport](https://docs.aws.amazon.com/apigateway/latest/api/API_GetExport.html). **Anmerkung** Wenn Sie Modelle in Ihrer API definieren, müssen diese für den Inhaltstyp "application/json" sein, damit API Gateway das Modell exportieren kann. Andernfalls löst API Gateway eine Ausnahme mit der Fehlermeldung "Only found non-JSON body models for ..." aus. Modelle müssen Eigenschaften enthalten oder als ein bestimmter JSONSchema Typ definiert sein. ## Herunterladen der REST-API-OpenAPI-Definition als JSON So exportieren und laden Sie eine REST-API in OpenAPI-Definitionen im JSON-Format herunter: ------ #### [ OpenAPI 3.0 ] ``` GET /restapis//stages//exports/oas30 Host: apigateway..amazonaws.com Accept: application/json ``` ------ #### [ OpenAPI 2.0 ] ``` GET /restapis//stages//exports/swagger Host: apigateway..amazonaws.com Accept: application/json ``` ------ Hier kann `` beispielsweise `us-east-1` sein. Informationen zu den Regionen, in denen API Gateway verfügbar ist, finden Sie unter [Regionen und Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). ## Herunterladen der REST-API-OpenAPI-Definition als YAML So exportieren und laden Sie eine REST-API in OpenAPI-Definitionen im YAML-Format herunter: ------ #### [ OpenAPI 3.0 ] ``` GET /restapis//stages//exports/oas30 Host: apigateway..amazonaws.com Accept: application/yaml ``` ------ #### [ OpenAPI 2.0 ] ``` GET /restapis//stages//exports/swagger Host: apigateway..amazonaws.com Accept: application/yaml ``` ------ ## Herunterladen der REST-API-OpenAPI-Definition mit Postman-Erweiterungen als JSON So exportieren und laden Sie eine REST-API in OpenAPI-Definitionen mit Postman im JSON-Format herunter: ------ #### [ OpenAPI 3.0 ] ``` GET /restapis//stages//exports/oas30?extensions=postman Host: apigateway..amazonaws.com Accept: application/json ``` ------ #### [ OpenAPI 2.0 ] ``` GET /restapis//stages//exports/swagger?extensions=postman Host: apigateway..amazonaws.com Accept: application/json ``` ------ ## REST-API OpenAPI-Definition mit API Gateway-Integration in YAML herunterladen So exportieren Sie eine REST-API in OpenAPI-Definitionen mit API Gateway-Integration im YAML-Format und laden Sie herunter: ------ #### [ OpenAPI 3.0 ] ``` GET /restapis//stages//exports/oas30?extensions=integrations Host: apigateway..amazonaws.com Accept: application/yaml ``` ------ #### [ OpenAPI 2.0 ] ``` GET /restapis//stages//exports/swagger?extensions=integrations Host: apigateway..amazonaws.com Accept: application/yaml ``` ------ ## REST-API über die API-Gateway-Konsole exportieren Nach der [Bereitstellung Ihrer REST-API für eine Stufe](set-up-deployments.md#create-deployment) können Sie mit der API Gateway-Konsole die API in der Stufe in eine OpenAPI-Datei exportieren. Wählen Sie in der API-Gateway-Konsole im Bereich **Stufen** die Optionen **Stufenaktionen** und **Export** aus. ![\[REST-API über die API-Gateway-Konsole exportieren\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/export-new-console.png) Geben Sie einen **API-Spezifikationstyp**, ein **Format** und **Erweiterungen** an, um die OpenAPI-Definition Ihrer API herunterzuladen.