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.
Nutzlastkomprimierung für eine API in API Gateway aktivieren
Sie können die Komprimierung für eine API über die API-Gateway-Konsole, die AWS CLI oder ein AWS SDK aktivieren.
Im Fall einer vorhandenen API müssen Sie nach der Aktivierung der Komprimierung die API bereitstellen, damit die Änderungen wirksam werden. Im Fall einer neuen API können Sie die API nach Abschluss der API-Einrichtung bereitstellen.
Anmerkung
Die Inhaltskodierung mit der höchsten Priorität muss von API Gateway unterstützt werden. Wenn dies nicht der Fall ist, wird keine Komprimierung auf die Antwortnutzlast angewendet.
Themen
Payload-Komprimierung für eine API über die API Gateway-Konsole aktivieren
Im folgenden Verfahren wird beschrieben, wie Sie die Nutzlastkomprimierung für eine API aktivieren.
So aktivieren Sie die Payload-Komprimierung über die API Gateway-Konsole:
-
Melden Sie sich bei der API-Gateway-Konsole unter https://console.aws.amazon.com/apigateway
an. -
Wählen Sie eine vorhandene API oder erstellen Sie eine neue.
-
Wählen Sie im Hauptnavigationsbereich API-Einstellungen.
-
Wählen Sie im Abschnitt API-Details die Option Bearbeiten aus.
-
Aktivieren Sie die Inhaltskodierung, um die Nutzlast-Komprimierung zu aktivieren. Geben Sie einen Wert für die Mindestkomprimierungsgröße (in Byte) unter Mindesttextgröße ein. Um die Komprimierung zu deaktivieren, schalten Sie die Option Inhaltskodierung aus.
-
Klicken Sie auf Änderungen speichern.
Aktivieren der Nutzlastkomprimierung für eine API mithilfe der AWS CLI
Der folgende create-rest-api-Befehl erstellt eine API mit Nutzdatenkomprimierung:
aws apigateway create-rest-api \ --name "My test API" \ --minimum-compression-size 0
Der folgende update-rest-api-Befehl aktiviert die Nutzdatenkomprimierung für eine vorhandene API:
aws apigateway update-rest-api \ --rest-api-id 1234567890 \ --patch-operations op=replace,path=/minimumCompressionSize,value=0
Die Eigenschaft minimumCompressionSize weist eine nicht negative ganze Zahl zwischen 0 und 10485760 (10 M Bytes) auf. Mit ihr wird die Komprimierung gemessen. Wenn die Nutzlastgröße kleiner als dieser Wert ist, wird die Komprimierung oder Dekomprimierung nicht auf die Nutzlast angewendet. Wenn er auf Null festgelegt ist, ist die Komprimierung für jede beliebige Nutzlastgröße erlaubt.
Der folgende update-rest-api-Befehl deaktiviert die Nutzdatenkomprimierung:
aws apigateway update-rest-api \ --rest-api-id 1234567890 \ --patch-operations op=replace,path=/minimumCompressionSize,value=
Sie können value auch auf eine leere Zeichenfolge "" festlegen oder die Eigenschaft value im vorhergehenden Aufruf vollständig weglassen.
Von API Gateway unterstützte Inhaltskodierungen
API Gateway unterstützt die folgenden Inhaltskodierungen:
-
deflate -
gzip -
identity
API Gateway unterstützt auch das folgende Accept-Encoding Header-Format gemäß der Spezifikation RFC 7231
-
Accept-Encoding:deflate,gzip -
Accept-Encoding: -
Accept-Encoding:* -
Accept-Encoding:deflate;q=0.5,gzip;q=1.0 -
Accept-Encoding:gzip;q=1.0,identity;q=0.5,*;q=0
