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.
Aktivieren der Nutzlastkomprimierung für eine API
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.
-
Wählen Sie Änderungen speichern.
Aktivieren der Nutzlastkomprimierung für eine API mithilfe der AWS CLI
Zur Verwendung der AWS CLI zum Erstellen einer neuen API und zum Aktivieren der Komprimierung rufen Sie den Befehl create-rest-api
wie folgt auf:
aws apigateway create-rest-api \ --name "My test API" \ --minimum-compression-size 0
Zur Verwendung der AWS CLI zum Aktivieren der Komprimierung für eine vorhandene API rufen Sie den Befehl update-rest-api
wie folgt auf:
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.
Zur Verwendung der AWS CLI zum Deaktivieren der Komprimierung rufen Sie den Befehl update-rest-api
wie folgt auf:
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