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. # Wichtige Hinweise zu Amazon API Gateway Im folgenden Abschnitt finden Sie Hinweise, die sich auf Ihre Verwendung von API Gateway auswirken könnten. **Topics** + [Amazon API Gateway: Wichtige Hinweise für HTTP APIs](#api-gateway-known-issues-http-apis) + [Amazon API Gateway wichtige Hinweise für HTTP und WebSocket APIs](#api-gateway-known-issues-http-and-websocket-apis) + [Amazon API Gateway wichtige Hinweise für REST und WebSocket APIs](#api-gateway-known-issues-rest-and-websocket-apis) + [Amazon API Gateway wichtige Hinweise für WebSocket APIs](#api-gateway-known-issues-websocket-apis) + [Amazon API Gateway — wichtige Hinweise für REST APIs](#api-gateway-known-issues-rest-apis) ## Amazon API Gateway: Wichtige Hinweise für HTTP APIs + HTTP APIs übersetzt eingehende `X-Forwarded-*` Header in einen `Forwarded` Standard-Header und fügt die Ausgangs-IP, den Host und das Protokoll an. + API Gateway fügt Ihrer Anfrage den Inhaltstyp-Header hinzu, wenn keine Nutzdaten vorhanden sind und die Content-Length 0 ist. ## Amazon API Gateway wichtige Hinweise für HTTP und WebSocket APIs + Signature Version 4A wird von Amazon API Gateway für HTTP und nicht offiziell unterstützt WebSocket APIs. ## Amazon API Gateway wichtige Hinweise für REST und WebSocket APIs + API Gateway unterstützt nicht die gemeinsame Nutzung eines benutzerdefinierten Domainnamens über REST und WebSocket APIs. + Phasennamen dürfen nur alphanumerische Zeichen sowie Binde- und Unterstriche enthalten. Die maximale Länge beträgt 128 Zeichen. + Die Pfade `/ping` und `/sping` sind für die Servicezustandsprüfung reserviert. Wenn diese für API-Ressourcen auf Stammebene mit benutzerdefinierten Domains verwendet werden, liefern sie nicht das erwartete Ergebnis. + API Gateway begrenzt Protokollereignisse derzeit auf 1024 Bytes. Protokollereignisse, die größer als 1024 Byte sind, wie Anforderungs- und Antworttexte, werden von API Gateway vor der Übermittlung an CloudWatch Logs gekürzt. + CloudWatch Metrics begrenzt derzeit Dimensionsnamen und -werte auf 255 gültige XML-Zeichen. (Weitere Informationen finden Sie im [CloudWatch Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension).) Dimensionenwerte sind eine Funktion benutzerdefinierter Namen, einschließlich API-Name, Bezeichnung (Stufenname) und Ressourcenname. Achten Sie bei der Auswahl dieser Namen darauf, die CloudWatch Metrik-Grenzwerte nicht zu überschreiten. + Die maximale Größe einer Zuordnungsvorlage beträgt 300 KB. ## Amazon API Gateway wichtige Hinweise für WebSocket APIs + API Gateway unterstützt Nachrichten-Payloads bis zu 128 KB mit einer maximalen Frame-Größe von 32 KB. Sie müssen Nachrichten, die 32 KB überschreiten, in mehrere Frames aufteilen, die jeweils 32 KB oder kleiner sind. Wenn eine größere Nachricht empfangen wird, wird die Verbindung mit Code 1009 geschlossen. ## Amazon API Gateway — wichtige Hinweise für REST APIs + Das Pipe-Klartextzeichen (`|`) und das Zeichen für geschweifte Klammer (`{` oder `}`) wird in Abfragezeichenfolgen zur Anforderung einer URL nicht unterstützt und muss URL-kodiert werden. + Das Semikolon (`;`) wird in Abfragezeichenfolgen zur Anforderung einer URL nicht unterstützt und führt dazu, dass die Daten aufgeteilt werden. + REST APIs dekodiert URL-kodierte Anforderungsparameter, bevor sie an Backend-Integrationen übergeben werden. Bei UTF-8-Anforderungsparametern APIs dekodiert REST die Parameter und übergibt sie dann als Unicode an Backend-Integrationen. APIs REST-URL-kodieren Sie das Prozentzeichen (`%`), bevor Sie es an Backend-Integrationen übergeben. + Beim Verwenden der Amazon API Gateway-Konsole zum Testen einer API können Sie die Antwort "unknown endpoint errors" erhalten, wenn auf dem Backend ein selbstsigniertes Zertifikat präsentiert wird, in der Zertifikatkette ein Zwischenzertifikat fehlt oder das Backend eine andere, nicht erkennbare zertifikatbezogenen Ausnahme auslöst. + Sie sollten eine API-[https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) oder [https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html)-Entität mit einer privaten Integration löschen, nachdem Sie hartcodierte Referenzen eines [https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html) entfernt haben. Andernfalls ist die Integration nicht abgeschlossen und Sie erhalten eine Fehlermeldung mit dem Hinweis, dass der VPC-Link noch verwendet wird, obwohl die Entität `Resource` oder `Method` gelöscht wurde. Dieses Verhalten liegt nicht vor, wenn die private Integration über eine Stufenvariable auf `VpcLink` verweist. + Die folgenden Backends unterstützen die SSL-Clientauthentifizierung möglicherweise nicht auf eine mit API Gateway kompatible Weise: + [NGINX](https://nginx.org/en/) + [Heroku](https://www.heroku.com/) + API Gateway unterstützt die meisten der [OpenAPI-2.0-Spezifikation](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) und der [OpenAPI-3.0-Spezifikation](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md) mit den folgenden Ausnahmen: + Pfadsegmente dürfen nur alphanumerische Zeichen, Unterstriche, Bindestriche, Punkte, Kommas, Doppelpunkte und geschweifte Klammern enthalten. Pfadparameter müssen als separate Pfadsegmente vorliegen. Beispiel: "resource/\$1path\$1parameter\$1name\$1" ist gültig, "resource\$1path\$1parameter\$1name\$1" nicht. + Modellnamen dürfen nur alphanumerische Zeichen enthalten. + Als Eingabeparameter werden nur die folgenden Attribute unterstützt: `name`, `in`, `required`, `type`, `description`. Andere Attribute werden ignoriert. + Der `securitySchemes`-Typ muss bei Verwendung `apiKey` lauten. OAuth [2- und HTTP Basic-Authentifizierung werden jedoch über [Lambda-Autorisierer](apigateway-use-lambda-authorizer.md) unterstützt; die OpenAPI-Konfiguration wird über Herstellererweiterungen erreicht.](api-gateway-swagger-extensions-authorizer.md) + Das `deprecated` Feld wird nicht unterstützt und wird beim Export gelöscht. APIs + API Gateway-Modelle werden unter Verwendung von [JSON-Schemaentwurf 4](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04) anstelle des von OpenAPI verwendeten JSON-Schemas definiert. + Der Parameter `discriminator` wird in Schemaobjekten nicht unterstützt. + Das Tag `example` wird nicht unterstützt. + Das Feld `nullable` wird nicht unterstützt. + `exclusiveMinimum` wird von API Gateway nicht unterstützt. + Die Tags `maxItems` und `minItems` werden bei der [einfachen Anforderungsvalidierung](api-gateway-method-request-validation.md) nicht berücksichtigt. Um dieses Problem zu umgehen, aktualisieren Sie das Modell nach dem Import, bevor Sie die Validierung vornehmen. + Für OpenAPI 3.0 dürfen `oneOf`, `anyOf` oder `allOf` nicht auf eine Definition innerhalb desselben Schemas über `$ref` verweisen. Sie können Ihr Schema entweder direkt eingeben oder eine separate API-Gateway-Modellressource definieren. Weitere Informationen finden Sie unter [Erstellen komplexerer Modelle](models-mappings-models.md#api-gateway-request-validation-model-more-complex). + `oneOf` wird für OpenAPI 2.0 oder die SDK-Generierung nicht unterstützt. + Das Feld `readOnly` wird nicht unterstützt. + `$ref` kann nicht für den Verweis auf andere Dateien verwendet werden. + Antwortdefinitionen des Formulars `"500": {"$ref": "#/responses/UnexpectedError"}` werden im OpenAPI-Basisverzeichnis nicht unterstützt. Ersetzen Sie die Referenz durch das Inline-Schema, um dieses Problem zu umgehen. + Zahlen vom Typ `Int32` oder `Int64` werden nicht unterstützt. Ein Beispiel sehen Sie unten: ``` "elementId": { "description": "Working Element Id", "format": "int32", "type": "number" } ``` + Der Formattyp Dezimalzahl (`"format": "decimal"`) wird in Schemadefinitionen nicht unterstützt. + In Methodenantworten muss die Schemadefinition ein Objekttyp sein und darf keine primitiven Datentypen umfassen. Beispielsweise wird `"schema": { "type": "string"}` nicht unterstützt. Sie können dies jedoch umgehen, indem Sie den folgenden Objekttyp verwenden: ``` "schema": { "$ref": "#/definitions/StringResponse" } "definitions": { "StringResponse": { "type": "string" } } ``` + API Gateway verwendet keine in der OpenAPI-Spezifikation definierte Sicherheit auf Stammebene. Daher muss die Sicherheit auf Vorgangsebene definiert werden, um korrekt angewendet werden zu können. + Das `default`-Schlüsselwort wird nicht unterstützt. + API Gateway führt die folgenden Beschränkungen und Limitierungen bei der Handhabung von Methoden mit Lambda- oder HTTP-Integration durch. + Bei der Verarbeitung von Header-Namen und Abfrageparametern wird die Groß- und Kleinschreibung beachtet. + Die folgende Tabelle listet die Header auf, die gelöscht, erneut zugewiesen oder anderweitig modifiziert werden können, wenn sie an den Integrationsendpunkt oder von diesem zurückgesendet werden. In dieser Tabelle: + `Remapped` bedeutet, dass der Header-Name von `` in `X-Amzn-Remapped-` geändert wird. `Remapped Overwritten` bedeutet, dass der Header-Name von `` in `X-Amzn-Remapped-` geändert und der Wert überschrieben wird. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/api-gateway-known-issues.html) \$1 Der `Authorization`-Header wird gelöscht, wenn er eine [Signaturversion 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)-Signatur enthält oder `AWS_IAM`-Autorisierung verwendet wird. + Das Android-SDK einer von API Gateway generierten API verwendet die Klasse `java.net.HttpURLConnection`. Diese Klasse löst auf Geräten, auf denen Android 4.4 und früher ausgeführt wird, eine unbehandelte Ausnahme für eine 401-Antwort aus, die aus der Neuzuordnung des Headers `WWW-Authenticate` zu `X-Amzn-Remapped-WWW-Authenticate` resultiert. + Im Gegensatz zu API Gateway-generierten Java-, Android- und SDKs iOS-APIs unterstützt das JavaScript SDK einer von API Gateway generierten API keine Wiederholungsversuche bei Fehlern der Stufe 500. + Der Test-Aufruf einer Methode verwendet den Standard-Inhaltstyp `application/json` und ignoriert Spezifikationen anderer Inhaltstypen. + Beim Senden von Anfragen an eine API durch Übergabe des `X-HTTP-Method-Override`-Headers überschreibt API Gateway die Methode. Um den Header an das Backend zu übergeben, muss der Header der Integrationsanforderung hinzugefügt werden. + Wenn eine Anfrage mehrere Medientypen in ihrem `Accept`-Header enthält, berücksichtigt API Gateway nur den ersten `Accept`-Medientyp. Wenn Sie die Reihenfolge der `Accept`-Medientypen nicht steuern können und der Medientyp Ihres binären Inhalts nicht der erste in der Liste ist, können Sie den ersten `Accept`-Medientyp in der Liste `binaryMediaTypes` Ihrer API hinzufügen. Amazon API Gateway gibt Ihren Inhalt dann im Binärformat zurück. Um z. B. eine JPEG-Datei mit einem ``-Element in einem Browser zu übermitteln, sendet der Browser möglicherweise `Accept:image/webp,image/*,*/*;q=0.8` in einer Anforderung. Bei Hinzufügen von `image/webp` zur Liste `binaryMediaTypes` erhält der Endpunkt die JPEG-Datei als Binärdatei. + Das Anpassen der Standard-Gateway-Antwort für `413 REQUEST_TOO_LARGE` wird derzeit nicht unterstützt. + API Gateway enthält einen `Content-Type`-Header für alle Integrationsantworten. Der Inhaltstyp ist standardmäßig „`application/json`“.