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

# Siapkan integrasi proxy HTTP dengan streaming respons payload di API Gateway
<a name="response-streaming-http"></a>

Saat mengatur streaming payload respons, Anda menentukan mode transfer respons dalam permintaan integrasi metode Anda. Anda mengonfigurasi setelan ini dalam permintaan integrasi untuk mengontrol perilaku API Gateway sebelum dan selama respons integrasi. Saat Anda menggunakan streaming respons, Anda dapat mengonfigurasi batas waktu integrasi hingga 15 menit.

Saat Anda menggunakan streaming respons payload dengan `HTTP_PROXY` integrasi, API Gateway tidak akan mengirim kode status respons HTTP atau header respons HTTP apa pun hingga sepenuhnya menerima semua header.

## Buat integrasi proxy HTTP dengan streaming respons payload
<a name="response-streaming-http-create"></a>

Prosedur berikut menunjukkan cara mengimpor API baru dengan `responseTransferMode` set ke`STREAM`. Jika Anda memiliki API integrasi yang ada dan ingin memodifikasinya`responseTransferMode`, lihat[Perbarui mode transfer respons untuk integrasi proxy HTTP](#response-streaming-http-update).

------
#### [ Konsol Manajemen AWS ]

**Untuk membuat integrasi proxy HTTP dengan streaming respons payload**

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

1. Pilih REST API.

1. Pilih **Buat sumber daya**.

1. Untuk **Nama sumber daya**, masukkan **streaming**.

1. Pilih **Buat sumber daya**.

1. Dengan sumber daya **/streaming** yang dipilih, pilih **Create method**.

1. Untuk **jenis Metode**, pilih **APAPUN**.

1. Untuk **jenis Integrasi**, pilih **HTTP**.

1. Pilih **integrasi proxy HTTP**.

1. Untuk **mode transfer Respons**, pilih **Streaming**.

1. Untuk **metode HTTP**, pilih metode.

1. Untuk **URL Endpoint**, masukkan titik akhir integrasi. Pastikan Anda memilih titik akhir yang menghasilkan muatan besar untuk dialirkan kembali kepada Anda.

1. Pilih **metode Buat**.

Setelah Anda membuat metode, terapkan API Anda.

**Untuk men-deploy API Anda**

1. Pilih **Deploy API**.

1. Untuk **Stage**, pilih **New stage**.

1. Untuk **nama Panggung**, masukkan**prod**.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi.

1. Pilih **Deploy**.

------
#### [ AWS CLI ]

**Untuk membuat API baru dengan streaming respons payload**

1. Salin file Open API berikut, lalu simpan sebagai`ResponseStreamDemoSwagger.yaml`. Dalam file ini, `responseTransferMode` diatur ke`STREAM`. Titik akhir integrasi diatur ke`https://example.com`, tetapi kami menyarankan Anda memodifikasinya ke titik akhir yang menghasilkan muatan besar untuk dialirkan kembali kepada Anda.

   ```
   openapi: "3.0.1"
   info:
     title: "ResponseStreamingDemo"
     version: "2025-04-28T17:28:25Z"
   servers:
   - url: "{basePath}"
     variables:
       basePath:
         default: "prod"
   paths:
     /streaming:
       get:
         x-amazon-apigateway-integration:
           httpMethod: "GET"
           uri: "https://example.com"
           type: "http_proxy"
           timeoutInMillis: 900000
           responseTransferMode: "STREAM"
   ```

1. Gunakan `import-rest-api` perintah berikut untuk mengimpor definisi OpenAPI Anda:

   ```
   aws apigateway import-rest-api \
     --body 'fileb://~/ResponseStreamDemoSwagger.yaml' \
     --parameters endpointConfigurationTypes=REGIONAL \
     --region us-west-1
   ```

1. Gunakan `create-deployment` perintah berikut untuk menerapkan API baru Anda ke panggung:

   ```
   aws apigateway create-deployment \
     --rest-api-id {{a1b2c3}} \
     --stage-name prod \
     --region us-west-1
   ```

------

## Perbarui mode transfer respons untuk integrasi proxy HTTP
<a name="response-streaming-http-update"></a>

Prosedur berikut menunjukkan cara memperbarui mode transfer respons untuk integrasi proxy HTTP.

------
#### [ Konsol Manajemen AWS ]

**Untuk memperbarui mode transfer respons untuk integrasi proxy HTTP**

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

1. Pilih REST API.

1. Pilih metode.

1. Pada tab **Permintaan integrasi**, di bawah **Pengaturan permintaan integrasi**, pilih **Edit**.

1. Untuk **mode transfer Respons**, pilih **Streaming**.

1. Pilih **Simpan**.

Setelah memperbarui metode, terapkan API Anda.

**Untuk men-deploy API Anda**

1. Pilih **Deploy API**.

1. Untuk **Stage**, pilih **New stage**.

1. Untuk **nama Panggung**, masukkan**prod**.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi.

1. Pilih **Deploy**.

------
#### [ AWS CLI ]

`update-integration`Perintah berikut memperbarui mode transfer integrasi dari `BUFFERED` ke`STREAM`. Untuk yang ada APIs, mode transfer respons untuk semua integrasi diatur ke`BUFFERED`.

```
aws apigateway update-integration \
 --rest-api-id {{a1b2c3}} \
 --resource-id {{aaa111}} \
 --http-method GET \
 --patch-operations "op='replace',path='/responseTransferMode',value=STREAM" \
 --region us-west-1
```

Anda perlu menerapkan ulang API agar perubahan diterapkan. Jika Anda menyesuaikan batas waktu integrasi, nilai batas waktu ini akan dihapus, karena API Gateway mengalirkan respons Anda hingga 5 menit.

`update-integration`Perintah berikut memperbarui mode transfer integrasi dari `STREAM` ke`BUFFERED`:

```
aws apigateway update-integration \
 --rest-api-id {{a1b2c3}} \
 --resource-id {{aaa111}} \
 --http-method GET \
 --patch-operations "op='replace',path='/responseTransferMode',value=BUFFERED" \
 --region us-west-1
```

Anda perlu menerapkan ulang API agar perubahan diterapkan.

------