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

Transformasi data untuk WebSocket APIs di API Gateway

Di API Gateway, permintaan metode WebSocket API dapat mengambil payload dalam format yang berbeda dari payload permintaan integrasi yang sesuai, seperti yang diperlukan di backend. Demikian pula, backend dapat mengembalikan payload respons integrasi yang berbeda dari payload respons metode, seperti yang diharapkan oleh frontend.

API Gateway memungkinkan Anda menggunakan transformasi template pemetaan untuk memetakan payload dari permintaan metode ke permintaan integrasi yang sesuai dan dari respons integrasi ke respons metode yang sesuai. Anda membuat template pemetaan dan Anda menentukan ekspresi pemilihan template untuk menentukan template mana yang akan digunakan untuk melakukan transformasi data yang diperlukan.

Anda dapat menggunakan pemetaan data untuk memetakan data dari permintaan rute ke integrasi backend. Untuk mempelajari selengkapnya, lihat Mengatur pemetaan data WebSocket APIs di API Gateway.

Memetakan template dan model

Template pemetaan adalah skrip yang dinyatakan dalam Velocity Template Language (VTL) dan diterapkan pada payload menggunakan ekspresi. JSONPath Untuk informasi selengkapnya tentang template pemetaan API Gateway, lihatMemetakan transformasi template untuk REST APIs di API Gateway.

Muatan dapat memiliki model data sesuai dengan rancangan skema JSON 4. Anda tidak perlu mendefinisikan model untuk membuat template pemetaan. Namun, model dapat membantu Anda membuat template karena API Gateway menghasilkan cetak biru template berdasarkan model yang disediakan. Untuk informasi selengkapnya tentang model API Gateway, lihatModel data untuk REST APIs.

Ekspresi pemilihan template

Untuk mengubah payload dengan template pemetaan, Anda menentukan ekspresi pemilihan template WebSocket API dalam permintaan integrasi atau respons integrasi. Ekspresi ini dievaluasi untuk menentukan template input atau output (jika ada) yang akan digunakan untuk mengubah badan permintaan menjadi badan permintaan integrasi (melalui template input) atau badan respons integrasi ke badan respons rute (melalui template keluaran).

Integration.TemplateSelectionExpressionmendukung ${request.body.jsonPath} dan nilai statis.

IntegrationResponse.TemplateSelectionExpressionmendukung${request.body.jsonPath},${integration.response.statuscode},${integration.response.header.headerName},${integration.response.multivalueheader.headerName}, dan nilai-nilai statis.

Ekspresi pemilihan respons integrasi

Saat menyiapkan respons integrasi untuk WebSocket API, Anda dapat menentukan ekspresi pemilihan respons integrasi secara opsional. Ekspresi ini menentukan apa yang IntegrationResponse harus dipilih ketika integrasi kembali. Nilai ekspresi ini saat ini dibatasi oleh API Gateway, seperti yang didefinisikan di bawah ini. Sadarilah bahwa ekspresi ini hanya relevan untuk integrasi non-proxy; integrasi proxy hanya meneruskan payload respons kembali ke pemanggil tanpa pemodelan atau modifikasi.

Tidak seperti ekspresi seleksi sebelumnya lainnya, ekspresi ini saat ini mendukung format pencocokan pola. Ekspresi harus dibungkus dengan garis miring ke depan.

Saat ini nilainya tetap tergantung padaintegrationType: