Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan konsol REST API
Dalam latihan memulai ini, Anda membuat REST API tanpa server menggunakan konsol API Gateway REST API. Tanpa server APIs memungkinkan Anda fokus pada aplikasi Anda alih-alih menghabiskan waktu Anda menyediakan dan mengelola server. Latihan ini harus memakan waktu kurang dari 20 menit untuk diselesaikan, dan dimungkinkan dalam [Tingkat AWS Gratis](https://aws.amazon.com/free/).
Pertama, Anda membuat fungsi Lambda menggunakan konsol Lambda. Selanjutnya, Anda membuat REST API menggunakan konsol API Gateway REST API. Kemudian, Anda membuat metode API dan mengintegrasikannya dengan fungsi Lambda menggunakan integrasi proxy Lambda. Terakhir, Anda menerapkan dan menjalankan API Anda.
Saat Anda menjalankan REST API, API Gateway merutekan permintaan ke fungsi Lambda Anda. Lambda menjalankan fungsi dan mengembalikan respons ke API Gateway. API Gateway kemudian mengembalikan respons itu kepada Anda.
![\[Ikhtisar REST API yang Anda buat dalam tutorial ini.\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/getting-started-overview-rest.png)
Untuk menyelesaikan latihan ini, Anda memerlukan pengguna Akun AWS dan AWS Identity and Access Management (IAM) dengan akses konsol. Untuk informasi selengkapnya, lihat [Siapkan untuk menggunakan API Gateway](setting-up.md).
**Topics**
+ [Langkah 1: Membuat fungsi Lambda](#getting-started-rest-new-console-create-function)
+ [Langkah 2: Buat REST API](#getting-started-rest-new-console-create-api)
+ [Langkah 3: Buat integrasi proxy Lambda](#getting-started-rest-new-console-create-integration)
+ [Langkah 4: Menerapkan API Anda](#getting-started-rest-new-console-deploy)
+ [Langkah 5: Panggil API Anda](#getting-started-rest-new-console-invoke-api)
+ [(Opsional) Langkah 6: Hapus](#getting-started-cleanup-rest)
## 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 latihan ini, Anda menggunakan fungsi Node.js default di konsol Lambda.
**Untuk membuat fungsi Lambda**
1. [Masuk ke konsol Lambda di https://console.aws.amazon.com /lambda.](https://console.aws.amazon.com/lambda)
1. Pilih **Buat fungsi**.
1. Di bagian **Informasi dasar**, untuk **Nama fungsi**, masukkan **my-function**.
1. Untuk semua opsi lain, gunakan pengaturan default.
1. Pilih **Buat fungsi**.
Kode fungsi Lambda default akan terlihat mirip dengan yang berikut ini:
```
export const handler = async (event) => {
const response = {
statusCode: 200,
body: JSON.stringify('The API Gateway REST API console is great!'),
};
return response;
};
```
Anda dapat memodifikasi fungsi Lambda untuk latihan ini, selama respons fungsi selaras dengan [format yang dibutuhkan API Gateway](set-up-lambda-proxy-integrations.md#api-gateway-simple-proxy-for-lambda-output-format).
Ganti body respons default (`Hello from Lambda!`) dengan`The API Gateway REST API console is great!`. Ketika Anda memanggil fungsi contoh, ia mengembalikan `200` respons ke klien, bersama dengan respons yang diperbarui.
## Langkah 2: Buat REST API
Selanjutnya, Anda membuat REST API dengan sumber daya root (`/`).
**Untuk membuat REST API**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Lakukan salah satu tindakan berikut:
+ Untuk membuat API pertama Anda, untuk **REST API**, pilih **Build**.
+ Jika Anda pernah membuat API sebelumnya, pilih **Create API**, lalu pilih **Build** for **REST API**.
1. Untuk **nama API**, masukkan**my-rest-api**.
1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi.
1. Tetap tetapkan **jenis endpoint API** ke **Regional**.
1. Untuk **jenis alamat IP**, pilih **IPv4**.
1. Pilih **Buat API**.
## Langkah 3: Buat integrasi proxy Lambda
Selanjutnya, Anda membuat metode API untuk REST API di root resource (`/`) dan mengintegrasikan metode tersebut dengan fungsi Lambda Anda menggunakan integrasi proxy. Dalam integrasi proxy Lambda, API Gateway meneruskan permintaan masuk dari klien langsung ke fungsi Lambda.
**Untuk membuat integrasi proxy Lambda**
1. Pilih `/` sumber daya, lalu pilih **Create method**.
1. Untuk **jenis Metode**, pilih`ANY`.
1. Untuk **jenis Integrasi**, pilih **Lambda**.
1. Aktifkan **integrasi proxy Lambda**.
1. Untuk **fungsi Lambda**, masukkan**my-function**, lalu pilih fungsi Lambda Anda.
1. Pilih **metode Buat**.
## Langkah 4: Menerapkan API Anda
Selanjutnya, Anda membuat penerapan API dan mengaitkannya dengan sebuah panggung.
**Untuk men-deploy API Anda**
1. Pilih **Deploy API**.
1. Untuk **Stage**, pilih **New stage**.
1. Untuk **nama Panggung**, masukkan**Prod**.
1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi.
1. Pilih **Deploy**.
Sekarang klien dapat menghubungi API Anda. **Untuk menguji API Anda sebelum menerapkannya, Anda dapat memilih metode **APAPUN** secara opsional, menavigasi ke tab **Uji**, lalu pilih Uji.**
## Langkah 5: Panggil API Anda
**Untuk menjalankan API Anda**
1. Dari panel navigasi utama, pilih **Stage**.
1. Di bawah **Detail tahap**, pilih ikon salin untuk menyalin URL pemanggilan API Anda.
![\[Setelah Anda membuat REST API, konsol akan menampilkan URL pemanggilan API Anda.\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/getting-started-rest-invoke-url.png)
1. Masukkan URL pemanggilan di browser web.
URL lengkap akan terlihat seperti`https://abcd123.execute-api.us-east-2.amazonaws.com/Prod`.
Browser Anda mengirimkan `GET` permintaan ke API.
1. Verifikasi respons API Anda. Anda akan melihat teks `"The API Gateway REST API console is great!"` di browser Anda.
## (Opsional) Langkah 6: Hapus
Untuk mencegah biaya yang tidak perlu untuk Anda Akun AWS, hapus sumber daya yang Anda buat sebagai bagian dari latihan ini. Langkah-langkah berikut menghapus REST API Anda, fungsi Lambda Anda, dan sumber daya terkait.
**Untuk menghapus REST API**
1. Di panel **Sumber Daya**, pilih **tindakan API**, **Hapus API**.
1. Di kotak dialog **Delete API**, masukkan **konfirmasi**, lalu pilih **Hapus**.
**Untuk menghapus fungsi Lambda**
1. [Masuk ke konsol Lambda di https://console.aws.amazon.com /lambda.](https://console.aws.amazon.com/lambda)
1. Pada halaman **Fungsi**, pilih fungsi Anda. Pilih **Tindakan**, **Hapus**.
1. Di kotak dialog **Hapus 1 fungsi**, masukkan**delete**, lalu pilih **Hapus**.
**Untuk menghapus grup log fungsi Lambda**
1. Buka [Halaman grup log](https://console.aws.amazon.com/cloudwatch/home#logs:) di konsol Amazon CloudWatch.
1. Pada halaman **Grup log**, pilih grup log fungsi Anda (`/aws/lambda/my-function`). Kemudian, untuk **Tindakan**, pilih **Hapus grup log**.
1. Di kotak dialog **Hapus grup log**, pilih **Hapus**.
**Untuk menghapus peran eksekusi fungsi Lambda**
1. Buka [halaman Peran](https://console.aws.amazon.com/iam/home?#/roles) dari konsol IAM.
1. (Opsional) Pada halaman **Peran**, di kotak pencarian, masukkan**my-function**.
1. Pilih peran fungsi Anda (misalnya,`my-function-31exxmpl`), lalu pilih **Hapus**.
1. Di **Hapus`my-function-31exxmpl`?** kotak dialog, masukkan nama peran, lalu pilih **Hapus**.
**Tip**
Anda dapat mengotomatiskan pembuatan dan pembersihan AWS sumber daya dengan menggunakan AWS CloudFormation atau AWS Serverless Application Model ()AWS SAM. Untuk beberapa contoh CloudFormation template, lihat [contoh template untuk API Gateway](https://github.com/awsdocs/amazon-api-gateway-developer-guide/tree/main/cloudformation-templates) di repositori **awsdocs** GitHub .