Mengaktifkan dukungan biner menggunakan konsol API Gateway - Amazon API Gateway

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

Mengaktifkan dukungan biner menggunakan konsol API Gateway

Bagian ini menjelaskan cara mengaktifkan dukungan biner menggunakan konsol API Gateway. Sebagai contoh, kami menggunakan API yang terintegrasi dengan Amazon S3. Kami fokus pada tugas untuk mengatur jenis media yang didukung dan untuk menentukan bagaimana payload harus ditangani. Untuk informasi terperinci tentang cara membuat API yang terintegrasi dengan Amazon S3, lihat. Tutorial: Buat REST API sebagai proxy Amazon S3

Untuk mengaktifkan dukungan biner dengan menggunakan konsol API Gateway

  1. Tetapkan tipe media biner untuk API:

    1. Buat API baru atau pilih API yang sudah ada. Untuk contoh ini, kami memberi nama APIFileMan.

    2. Di bawah API yang dipilih di panel navigasi utama, pilih pengaturan API.

    3. Di panel pengaturan API, pilih Kelola jenis media di bagian Jenis Media Biner.

    4. Pilih Tambahkan tipe media biner.

    5. Masukkan jenis media yang diperlukan, misalnyaimage/png, di bidang teks input. Jika perlu, ulangi langkah ini untuk menambahkan lebih banyak jenis media. Untuk mendukung semua jenis media biner, tentukan*/*.

    6. Pilih Simpan perubahan.

  2. Mengatur cara payload pesan ditangani untuk metode API:

    1. Buat yang baru atau pilih sumber daya yang ada di API. Untuk contoh ini, kami menggunakan /{folder}/{item} sumber daya.

    2. Buat yang baru atau pilih metode yang ada pada sumber daya. Sebagai contoh, kami menggunakan GET /{folder}/{item} metode yang terintegrasi dengan Object GET tindakan di Amazon S3.

    3. Untuk penanganan Konten, pilih opsi.

      Siapkan GET metode di konsol API Gateway.

      Pilih Passthrough jika Anda tidak ingin mengonversi isi ketika klien dan backend menerima format biner yang sama. Pilih Konversi ke teks untuk mengonversi badan biner menjadi string yang dikodekan base64 ketika, misalnya, backend mengharuskan payload permintaan biner diteruskan sebagai properti JSON. Dan pilih Konversi ke biner ketika klien mengirimkan string yang dikodekan base64 dan backend memerlukan format biner asli, atau ketika titik akhir mengembalikan string yang dikodekan base64 dan klien hanya menerima output biner.

    4. Untuk passthrough badan Permintaan, pilih Bila tidak ada templat yang ditentukan (disarankan) untuk mengaktifkan perilaku passthrough pada badan permintaan.

      Anda juga bisa memilih Never. Ini berarti bahwa API akan menolak data dengan tipe konten yang tidak memiliki template pemetaan.

    5. Pertahankan Accept header permintaan masuk dalam permintaan integrasi. Anda harus melakukan ini jika Anda telah mengatur passthrough dan contentHandling ingin mengganti pengaturan itu saat runtime.

      Simpan Accept header dalam permintaan integrasi.

    6. Untuk konversi ke teks, tentukan template pemetaan untuk menempatkan data biner yang dikodekan base64 ke dalam format yang diperlukan.

      Contoh template pemetaan untuk dikonversi ke teks adalah sebagai berikut:

      {
  "operation": "thumbnail",
  "base64Image": "$input.body"
}

      Format template pemetaan ini tergantung pada persyaratan titik akhir input.

    7. Pilih Simpan.