API HTTP menggunakan protokol HTTP untuk mengekspos layanan internal dalam sistem terdistribusi secara cepat. Topik ini menjelaskan cara membuat API HTTP di Konsol.
Kasus Penggunaan
API dapat dibuat di dalam atau di luar instans, tergantung pada kasus penggunaan Anda.
Buat API di dalam instans
-
Manajemen resource khusus: API hanya mengelola resource atau logika internal dalam instans tertentu.
-
Keamanan dan isolasi: Data atau fitur memerlukan isolasi ketat dan hanya dapat dipanggil dari dalam instans tersebut.
-
Konfigurasi layanan yang disederhanakan: Membatasi konfigurasi pada instans tertentu menyederhanakan manajemen API.
Buat API di luar instans
-
Akses bersama lintas-instans: Beberapa instans berbagi satu definisi API.
-
Manajemen dan pemantauan terpusat: Kontrol izin, logging, dan manajemen traffic yang terpadu.
API yang dibuat di dalam instans hanya terlihat dan dapat dikelola dalam instans tersebut.
API yang dibuat di luar instans tidak dapat diedit atau dihapus dari dalam instans. Anda harus mengelolanya dari daftar API eksternal.
Buat API HTTP di Konsol
Anda dapat membuat API di Cloud-native API Gateway dengan dua cara:
API Eksternal
Masuk ke Konsol Cloud-native API Gateway. Di panel navigasi sebelah kiri, pilih API. Di bilah menu atas, pilih wilayah.
Klik Create API, lalu klik Create pada kartu HTTP API.
API di dalam Instans
Masuk ke konsol Cloud-native API Gateway. Di panel navigasi kiri, pilih Instance, lalu pilih wilayah di bilah menu atas.
Pada halaman Instance, klik ID instans gateway target. Di panel navigasi sebelah kiri, pilih API. Di pojok kanan atas, klik Create API.
Klik Create pada kartu HTTP API.
Pada panel Create REST API, konfigurasikan parameter dan klik OK.
Configuration item
Description
API Name
Nama kustom untuk API. Nama API harus unik secara global.
Description
Masukkan deskripsi untuk API.
resource
Pilih kelompok sumber daya target. Anda dapat mengklik Create Resource Group di sebelah kanan.
Buat API HTTP dengan mengimpor Ingress
Prasyarat
Anda harus membuat sumber Container Service di Cloud-native API Gateway. Untuk informasi selengkapnya, lihat Manage service sources.
Prosedur
Anda dapat membuat API di Cloud-native API Gateway dengan dua cara:
Di luar instans
Masuk ke Konsol Cloud-native API Gateway. Di panel navigasi sebelah kiri, pilih API. Di bilah menu atas, pilih wilayah.
Klik Create API, lalu klik Import Ingress pada kartu HTTP API.
API Dalam-Instans
Masuk ke Konsol Cloud-native API Gateway. Di panel navigasi sebelah kiri, pilih Instance. Di bilah menu atas, pilih wilayah.
Pada halaman Instance, klik ID instans gateway target. Di panel navigasi sebelah kiri, pilih API. Di pojok kanan atas, klik Create API.
Klik Import Ingress pada kartu HTTP API.
Pada bagian HTTP API, klik Import Ingress. Pada halaman Import Ingress, konfigurasikan parameter Ingress dan klik OK.
Configuration item
Description
API Name
Nama API. Anda juga dapat mengklik Add Description untuk menambahkan deskripsi rute.
Description
Deskripsi API. Panjangnya maksimal 255 karakter.
Instance
Pilih instans Cloud-native API Gateway.
Source Cluster
Sumber layanan adalah kluster Container Service tempat Ingress berada.
resource
Pilih kelompok sumber daya.
Namespace
Namespace yang akan didengarkan. Jika dikosongkan, gateway akan mendengarkan resource Ingress di semua namespace.
IngressClass
IngressClass yang akan didengarkan. Jika dikosongkan, gateway akan mendengarkan semua jenis resource Ingress.
Update Ingress Status
Jika Anda mengaktifkan fitur ini, Titik Akhir Status (Status Endpoint) pada Ingress yang didengarkan akan diganti dengan titik akhir entri gateway.