Memulai dengan API Gateway

Dalam latihan memulai ini, Anda membuat API tanpa server. API tanpa server memungkinkan Anda fokus pada aplikasi Anda, alih-alih menghabiskan waktu untuk menyediakan dan mengelola server. Latihan ini membutuhkan waktu kurang dari 20 menit untuk diselesaikan, dan dimungkinkan dalam Tingkat AWS Gratis.

Pertama, Anda membuat fungsi Lambda menggunakan konsol. AWS Lambda Selanjutnya, Anda membuat API HTTP menggunakan konsol API Gateway. Kemudian, Anda menjalankan API Anda.

catatan

Latihan ini menggunakan API HTTP. API Gateway juga mendukung REST API, yang mencakup lebih banyak fitur. Untuk tutorial menggunakan REST API, lihatMemulai dengan konsol REST API.

Untuk informasi selengkapnya tentang perbedaan antara API HTTP dan REST API, lihatPilih antara REST API dan HTTP API.

Saat Anda memanggil API HTTP, API Gateway merutekan permintaan ke fungsi Lambda Anda. Lambda menjalankan fungsi Lambda dan mengembalikan respons ke API Gateway. API Gateway kemudian mengembalikan respons kepada Anda.

Untuk menyelesaikan latihan ini, Anda memerlukan AWS akun dan AWS Identity and Access Management pengguna dengan akses konsol. Untuk informasi selengkapnya, lihat Prasyarat untuk memulai dengan API Gateway.

Langkah 1: Membuat fungsi Lambda

Anda menggunakan fungsi Lambda untuk backend API Anda. Lambda menjalankan kode Anda hanya saat diperlukan dan menskalakan secara otomatis, dari beberapa permintaan per hari hingga ribuan per detik.

Untuk contoh ini, Anda menggunakan fungsi Node.js default dari konsol Lambda.

Untuk membuat fungsi Lambda

1. Masuk ke konsol Lambda di https://console.aws.amazon.com/lambda.

2. Pilih Buat fungsi.

3. Untuk Nama fungsi, masukkan my-function.

4. Pilih Buat fungsi.

Fungsi contoh mengembalikan 200 respon ke klien, dan teksHello from Lambda!.

Anda dapat memodifikasi fungsi Lambda, selama respons fungsi selaras dengan format yang dibutuhkan API Gateway.

Kode fungsi Lambda default akan terlihat mirip dengan berikut ini:

export const handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
    return response;
};

Langkah 2: Buat API HTTP

Selanjutnya, Anda membuat API HTTP. API Gateway juga mendukung REST WebSocket API dan API, tetapi HTTP API adalah pilihan terbaik untuk latihan ini. REST API mendukung lebih banyak fitur daripada API HTTP, tetapi kami tidak memerlukan fitur tersebut untuk latihan ini. HTTP API dirancang dengan fitur minimal sehingga dapat ditawarkan dengan harga lebih murah. WebSocket API mempertahankan koneksi persisten dengan klien untuk komunikasi dupleks penuh, yang tidak diperlukan untuk contoh ini.

HTTP API menyediakan endpoint HTTP untuk fungsi Lambda Anda. API Gateway merutekan permintaan ke fungsi Lambda Anda, lalu mengembalikan respons fungsi ke klien.

Untuk membuat API HTTP

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

2. Lakukan salah satu hal berikut ini:

   • Untuk membuat API pertama Anda, untuk HTTP API, pilih Build.

   • Jika Anda telah membuat API sebelumnya, pilih Buat API, lalu pilih Build for HTTP API.

3. Untuk Integrasi, pilih Tambahkan integrasi.

4. Pilih Lambda.

5. Untuk fungsi Lambda, masukkan. my-function

6. Untuk nama API, masukkanmy-http-api.

7. Pilih Selanjutnya.

8. Tinjau rute yang dibuat API Gateway untuk Anda, lalu pilih Berikutnya.

9. Tinjau tahapan yang dibuat API Gateway untuk Anda, lalu pilih Berikutnya.

10. Pilih Buat.

Sekarang Anda telah membuat API HTTP dengan integrasi Lambda yang siap menerima permintaan dari klien.

Langkah 3: Uji API Anda

Selanjutnya, Anda menguji API Anda untuk memastikan bahwa itu berfungsi. Untuk mempermudah, gunakan browser web untuk menjalankan API Anda.

Untuk menguji API Anda

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

2. Pilih API Anda.

3. Perhatikan URL pemanggilan API Anda.

   

4. Salin URL pemanggilan API Anda, dan masukkan di browser web. Tambahkan nama fungsi Lambda Anda ke URL pemanggilan Anda untuk memanggil fungsi Lambda Anda. Secara default, konsol API Gateway membuat rute dengan nama yang sama dengan fungsi Lambda Anda. my-function

   URL lengkap akan terlihat sepertihttps://abcdef123.execute-api.us-east-2.amazonaws.com/my-function.

   Browser Anda mengirimkan GET permintaan ke API.

5. Verifikasi respons API Anda. Anda akan melihat teks "Hello from Lambda!" di browser Anda.

(Opsional) Langkah 4: Bersihkan

Untuk mencegah biaya yang tidak perlu, hapus sumber daya yang Anda buat sebagai bagian dari latihan memulai ini. Langkah-langkah berikut menghapus API HTTP Anda, fungsi Lambda Anda, dan sumber daya terkait.

Untuk menghapus API HTTP

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

2. Pada halaman API, pilih API. Pilih Tindakan, lalu pilih Hapus.

3. Pilih Hapus.

Untuk menghapus fungsi Lambda

1. Masuk ke konsol Lambda di https://console.aws.amazon.com/lambda.

2. Pada halaman Fungsi, pilih fungsi. Pilih Tindakan, lalu pilih Hapus.

3. Pilih Hapus.

Untuk menghapus grup log fungsi Lambda

1. Di CloudWatch konsol Amazon, buka halaman Grup log.

2. Pada halaman Grup log, pilih grup log fungsi (/aws/lambda/my-function). Pilih Tindakan, lalu pilih Hapus grup log.

3. Pilih Hapus.

Untuk menghapus peran eksekusi fungsi Lambda

1. Di AWS Identity and Access Management konsol, buka halaman Peran.

2. Pilih peran fungsi, misalnya,my-function-31exxmpl.

3. Pilih Hapus peran.

4. Pilih Ya, Hapus.

Anda dapat mengotomatiskan pembuatan dan pembersihan AWS sumber daya dengan menggunakan AWS CloudFormation atau. AWS SAM Misalnya AWS CloudFormation template, lihat contoh AWS CloudFormation template.

Langkah selanjutnya

Untuk contoh ini, Anda menggunakan AWS Management Console untuk membuat HTTP API sederhana. HTTP API memanggil fungsi Lambda dan mengembalikan respons ke klien.

Berikut ini adalah langkah selanjutnya saat Anda terus bekerja dengan API Gateway.

• Konfigurasikan jenis integrasi API tambahan, termasuk:

  • Titik akhir HTTP

  • Sumber daya pribadi dalam VPC, seperti layanan Amazon ECS

  • AWS layanan seperti Amazon Simple Queue Service AWS Step Functions, dan Kinesis Data Streams

• Kontrol akses ke API Anda

• Aktifkan pencatatan untuk API Anda

• Konfigurasikan throttling untuk API Anda

• Konfigurasikan domain khusus untuk API Anda

Untuk mendapatkan bantuan terkait Amazon API Gateway dari komunitas, lihat Forum Diskusi API Gateway. Ketika Anda memasuki forum ini, AWS mungkin mengharuskan Anda untuk masuk.

Untuk mendapatkan bantuan dengan API Gateway langsung dari AWS, lihat opsi dukungan di halaman AWS Support.

Lihat juga Pertanyaan yang sering diajukan (FAQ), atau hubungi kami langsung.