Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memetakan API tahapan ke nama domain khusus untuk HTTP APIs
Anda menggunakan API pemetaan untuk menghubungkan API tahapan ke nama domain kustom. Setelah Anda membuat nama domain dan mengonfigurasi DNS catatan, Anda menggunakan API pemetaan untuk mengirim lalu lintas ke Anda APIs melalui nama domain kustom Anda.
APIPemetaan menentukanAPI, tahap, dan opsional jalur yang akan digunakan untuk pemetaan. Misalnya, Anda dapat memetakan production
tahap API tohttps://api.example.com/orders
.
Anda dapat memetakan HTTP dan REST API tahapan ke nama domain kustom yang sama.
Sebelum Anda membuat API pemetaan, Anda harus memilikiAPI, panggung, dan nama domain khusus. Untuk mempelajari selengkapnya tentang membuat nama domain kustom, lihatSiapkan nama domain kustom Regional di API Gateway.
Permintaan perutean API
Anda dapat mengonfigurasi API pemetaan dengan beberapa level, misalnya orders/v1/items
dan. orders/v2/items
Untuk API pemetaan dengan beberapa level, API Gateway merutekan permintaan ke API pemetaan yang memiliki jalur pencocokan terpanjang. APIGateway hanya mempertimbangkan jalur yang dikonfigurasi untuk API pemetaan, dan bukan API rute, untuk memilih yang akan dipanggilAPI. Jika tidak ada jalur yang cocok dengan permintaan, API Gateway mengirimkan permintaan ke API yang telah Anda petakan ke jalur (none)
kosong.
Untuk nama domain kustom yang menggunakan API pemetaan dengan beberapa level, API Gateway merutekan permintaan ke API pemetaan yang memiliki awalan pencocokan terpanjang.
Misalnya, pertimbangkan nama domain khusus https://api.example.com
dengan API pemetaan berikut:
-
(none)
dipetakan ke API 1. -
orders
dipetakan ke API 2. -
orders/v1/items
dipetakan ke API 3. -
orders/v2/items
dipetakan ke API 4. -
orders/v2/items/categories
dipetakan ke API 5.
Permintaan | Dipilih API | Penjelasan |
---|---|---|
|
|
Permintaan sama persis dengan API pemetaan ini. |
|
|
Permintaan sama persis dengan API pemetaan ini. |
|
|
Permintaan sama persis dengan API pemetaan ini. |
|
|
APIGateway memilih pemetaan yang memiliki jalur pencocokan terpanjang. |
|
|
APIGateway memilih pemetaan yang memiliki jalur pencocokan terpanjang. |
|
|
APIGateway menggunakan pemetaan kosong sebagai catch-all. |
|
|
APIGateway memilih pemetaan yang memiliki awalan pencocokan terpanjang. Untuk nama domain khusus yang dikonfigurasi dengan pemetaan tingkat tunggal, seperti hanya |
Pembatasan
-
Dalam API pemetaan, nama domain khusus dan dipetakan APIs harus berada di akun yang sama AWS .
-
APIpemetaan harus hanya berisi huruf, angka, dan karakter berikut:.
$-_.+!*'()/
-
Panjang maksimum untuk jalur dalam API pemetaan adalah 300 karakter.
-
Anda dapat memiliki 200 API pemetaan dengan beberapa level untuk setiap nama domain.
-
Anda hanya dapat memetakan HTTP APIs ke nama domain kustom regional dengan kebijakan keamanan TLS 1.2.
-
Anda tidak dapat memetakan WebSocket APIs ke nama domain kustom yang sama dengan HTTP API atau RESTAPI.
Buat API pemetaan
Untuk membuat API pemetaan, Anda harus terlebih dahulu membuat nama domain kustom,API, dan panggung. Untuk informasi tentang membuat nama domain kustom, lihatSiapkan nama domain kustom Regional di API Gateway.
Misalnya AWS Serverless Application Model templat yang membuat semua sumber daya, lihat Sesi Dengan SAM