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
<a name="api-gateway-enable-compression"></a>

Sie können die Komprimierung für eine API mithilfe der API Gateway Gateway-Konsole AWS CLI, des oder eines 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.

**Topics**
+ [Payload-Komprimierung für eine API über die API Gateway-Konsole aktivieren](#api-gateway-enable-compression-console)
+ [Aktivieren Sie die Payload-Komprimierung für eine API mithilfe von AWS CLI](#api-gateway-enable-compression-cli)
+ [Von API Gateway unterstützte Inhaltskodierungen](#api-gateway-supported-content-encodings)

## Payload-Komprimierung für eine API über die API Gateway-Konsole aktivieren
<a name="api-gateway-enable-compression-console"></a>

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:**

1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway).

1. Wählen Sie eine vorhandene API oder erstellen Sie eine neue.

1. Wählen Sie im Hauptnavigationsbereich **API-Einstellungen**. 

1. Wählen Sie im Abschnitt **API-Details** die Option **Bearbeiten** aus.

1. 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.

1. Wählen Sie **Änderungen speichern ** aus.

## Aktivieren Sie die Payload-Komprimierung für eine API mithilfe von AWS CLI
<a name="api-gateway-enable-compression-cli"></a>



Der folgende [create-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-rest-api.html)Befehl erstellt eine API mit Payload-Komprimierung:

```
aws apigateway create-rest-api \
    --name "My test API" \
    --minimum-compression-size 0
```

Der folgende [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Befehl aktiviert die Payload-Komprimierung für eine bestehende 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](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Befehl deaktiviert die Payload-Komprimierung:

```
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
<a name="api-gateway-supported-content-encodings"></a>

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](https://datatracker.ietf.org/doc/html/rfc7231#section-5.3.4):
+ `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`