Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aktifkan kompresi payload untuk API di API Gateway
<a name="api-gateway-enable-compression"></a>

Anda dapat mengaktifkan kompresi untuk API menggunakan konsol API Gateway, the AWS CLI, atau AWS SDK.

Untuk API yang ada, Anda harus menerapkan API setelah mengaktifkan kompresi agar perubahan diterapkan. Untuk API baru, Anda dapat menerapkan API setelah penyiapan API selesai.

**catatan**  
Pengkodean konten dengan prioritas tertinggi harus didukung oleh API Gateway. Jika tidak, kompresi tidak diterapkan pada muatan respons.

**Topics**
+ [Mengaktifkan kompresi payload untuk API menggunakan konsol API Gateway](#api-gateway-enable-compression-console)
+ [Aktifkan kompresi payload untuk API menggunakan AWS CLI](#api-gateway-enable-compression-cli)
+ [Pengkodean konten yang didukung oleh API Gateway](#api-gateway-supported-content-encodings)

## Mengaktifkan kompresi payload untuk API menggunakan konsol API Gateway
<a name="api-gateway-enable-compression-console"></a>

Prosedur berikut menjelaskan cara mengaktifkan kompresi payload untuk API. 

**Untuk mengaktifkan kompresi payload dengan menggunakan konsol API Gateway**

1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. Pilih API yang sudah ada atau buat yang baru.

1. Di panel navigasi utama, pilih **pengaturan API**. 

1. Di bagian **detail API**, pilih **Edit**.

1. Aktifkan **pengkodean konten** untuk mengaktifkan kompresi muatan. Untuk **ukuran tubuh Minimum**, masukkan angka untuk ukuran kompresi minimum (dalam byte). Untuk mematikan kompresi, matikan opsi **Pengkodean konten**.

1. Pilih **Simpan perubahan**.

## Aktifkan kompresi payload untuk API menggunakan AWS CLI
<a name="api-gateway-enable-compression-cli"></a>



[create-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-rest-api.html)Perintah berikut membuat API dengan kompresi payload:

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

[update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Perintah berikut memungkinkan kompresi payload untuk API yang ada:

```
aws apigateway update-rest-api \
    --rest-api-id 1234567890 \
    --patch-operations op=replace,path=/minimumCompressionSize,value=0
```

`minimumCompressionSize`Properti memiliki nilai integer non-negatif antara 0 dan 10485760 (10M byte). Ini mengukur ambang kompresi. Jika ukuran muatan lebih kecil dari nilai ini, kompresi atau dekompresi tidak diterapkan pada muatan. Pengaturan ke nol memungkinkan kompresi untuk ukuran muatan apa pun.

[update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Perintah berikut mematikan kompresi payload:

```
aws apigateway update-rest-api \
    --rest-api-id 1234567890 \
    --patch-operations op=replace,path=/minimumCompressionSize,value=
```

Anda juga dapat mengatur `value` ke string kosong `""` atau menghilangkan `value` properti sama sekali dalam panggilan sebelumnya.

## Pengkodean konten yang didukung oleh API Gateway
<a name="api-gateway-supported-content-encodings"></a>

API Gateway mendukung pengkodean konten berikut:
+ `deflate`
+ `gzip`
+ `identity`

API Gateway juga mendukung format `Accept-Encoding` header berikut, sesuai dengan spesifikasi [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`