Memulai dengan API Gateway - APIGerbang Amazon
Langkah 1: Membuat fungsi LambdaLangkah 2: Buat HTTP APILangkah 3: Uji API(Opsional) Langkah 4: BersihkanLangkah selanjutnya

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

Memulai dengan API Gateway

Dalam latihan memulai ini, Anda membuat tanpa serverAPI. Tanpa server APIs 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 HTTP API menggunakan konsol API Gateway. Kemudian, Anda memohon AndaAPI.

catatan

Latihan ini menggunakan sebuah HTTPAPI. APIGateway juga mendukung RESTAPIs, yang mencakup lebih banyak fitur. Untuk tutorial menggunakan RESTAPI, lihatMemulai dengan REST API konsol.

Untuk informasi lebih lanjut tentang perbedaan antara HTTP APIs dan RESTAPIs, lihatPilih antara REST APIs dan HTTP APIs.

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

Ikhtisar HTTP API yang Anda buat dalam tutorial ini.

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

Langkah 1: Membuat fungsi Lambda

Anda menggunakan fungsi Lambda untuk backend Anda. API 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. Untuk semua opsi lain, gunakan pengaturan default.

  5. Pilih Buat fungsi.

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

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

Kode fungsi Lambda default akan terlihat mirip dengan yang berikut ini:

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

Langkah 2: Buat HTTP API

Selanjutnya, Anda membuat sebuah HTTPAPI. APIGateway juga mendukung REST APIs dan WebSocket APIs, tetapi HTTP API adalah pilihan terbaik untuk latihan ini. RESTAPIsmendukung lebih banyak fitur daripada HTTPAPIs, tetapi kami tidak memerlukan fitur tersebut untuk latihan ini. HTTPAPIsdirancang dengan fitur minimal sehingga dapat ditawarkan dengan harga lebih murah. WebSocket APIspertahankan koneksi persisten dengan klien untuk komunikasi dupleks penuh, yang tidak diperlukan untuk contoh ini.

HTTPAPIIni menyediakan HTTP titik akhir untuk fungsi Lambda Anda. APIGateway merutekan permintaan ke fungsi Lambda Anda, lalu mengembalikan respons fungsi ke klien.

Untuk membuat HTTP API

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

  2. Lakukan salah satu hal berikut ini:

    • Untuk membuat yang pertamaAPI, untuk HTTPAPI, pilih Build.

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

  3. Untuk Integrasi, pilih Tambahkan integrasi.

  4. Pilih Lambda.

  5. Untuk fungsi Lambda, masukkan. my-function

  6. Untuk APInama, masukkanmy-http-api.

  7. Pilih Berikutnya.

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

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

  10. Pilih Buat.

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

Langkah 3: Uji API

Selanjutnya, Anda menguji Anda API untuk memastikan bahwa itu bekerja. Untuk mempermudah, gunakan browser web untuk memanggil AndaAPI.

Untuk menguji API

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

  2. Pilih AndaAPI.

  3. Perhatikan panggilan AndaAPI. URL

    Setelah Anda membuatAPI, konsol menunjukkan pemanggilan AndaAPI. URL

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

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

    Browser Anda mengirimkan GET permintaan ke fileAPI.

  5. Verifikasi API tanggapan 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 fungsi Lambda Anda HTTPAPI, dan sumber daya terkait.

Untuk menghapus HTTP API

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

  2. Pada APIshalaman, pilih fileAPI. 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 yang sederhana HTTPAPI. HTTPAPIMemanggil fungsi Lambda dan mengembalikan respons ke klien.

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

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 langsung dari API Gateway AWS, lihat opsi dukungan di halaman AWS Support.

Lihat juga pertanyaan yang sering diajukan (FAQs), atau hubungi kami secara langsung.