Tutorial: Menggunakan Lambda dengan API Gateway

Untuk membuat kebijakan

1. Buka halaman Kebijakan konsol IAM.

2. Pilih Buat Kebijakan.

3. Pilih tab JSON, lalu tempelkan kebijakan khusus berikut ke editor JSON.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "Stmt1428341300017",
         "Action": [
           "dynamodb:DeleteItem",
           "dynamodb:GetItem",
           "dynamodb:PutItem",
           "dynamodb:Query",
           "dynamodb:Scan",
           "dynamodb:UpdateItem"
         ],
         "Effect": "Allow",
         "Resource": "*"
       },
       {
         "Sid": "",
         "Resource": "*",
         "Action": [
           "logs:CreateLogGroup",
           "logs:CreateLogStream",
           "logs:PutLogEvents"
         ],
         "Effect": "Allow"
       }
     ]
   }

4. Pilih Selanjutnya: Tag.

5. Pilih Berikutnya: Tinjau.

6. Di bawah Kebijakan peninjauan, untuk Nama kebijakan, masukkanlambda-apigateway-policy.

7. Pilih Buat kebijakan.

Untuk membuat peran eksekusi dan melampirkan kebijakan izin kustom

1. Buka halaman Peran dari konsol IAM.

2. Pilih Buat peran.

3. Untuk jenis entitas tepercaya, pilih AWS layanan, lalu untuk kasus penggunaan, pilih Lambda.

4. Pilih Berikutnya.

5. Dalam kotak pencarian kebijakan, masukkan lambda-apigateway-policy.

6. Di hasil penelusuran, pilih kebijakan yang Anda buat (lambda-apigateway-policy), lalu pilih Berikutnya.

7. Di bawah Rincian peran, untuk nama Peran, masukkanlambda-apigateway-role, lalu pilih Buat peran.

Untuk menjalankan fungsi Lambda dengan AWS CLI

1. Simpan JSON berikut sebagai file bernamainput.txt.

   {
       "operation": "echo",
       "payload": {
           "somekey1": "somevalue1",
           "somekey2": "somevalue2"
       }
   }

2. Jalankan perintah invoke AWS CLI berikut.

   aws lambda invoke \
   --function-name LambdaFunctionOverHttps \
   --payload file://input.txt outputfile.txt \
   --cli-binary-format raw-in-base64-out

   cli-binary-formatOpsi ini diperlukan jika Anda menggunakan AWS CLI versi 2. Untuk menjadikan ini pengaturan default, jalankanaws configure set cli-binary-format raw-in-base64-out. Untuk informasi selengkapnya, lihat opsi baris perintah global yang AWS CLI didukung di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

   Anda akan melihat tanggapan berikut:

   {
       "StatusCode": 200,
       "ExecutedVersion": "LATEST"
   }

3. Konfirmasikan bahwa fungsi Anda melakukan echo operasi yang Anda tentukan dalam acara pengujian JSON. Periksa outputfile.txt file dan verifikasi berisi yang berikut:

   {"somekey1": "somevalue1", "somekey2": "somevalue2"}

Untuk membuat API

1. Buka konsol API Gateway.

2. Pilih Buat API.

3. Di kotak REST API, pilih Build.

4. Di bawah detail API, biarkan API Baru dipilih, dan untuk Nama API, masukkanDynamoDBOperations.

5. Pilih Buat API.

Untuk membuat sumber daya

1. Di konsol API Gateway, pada halaman Resources untuk API Anda, pilih Create Resource.

2. Dalam Rincian sumber daya, untuk nama Sumber daya masukkanDynamoDBManager.

3. Pilih Buat Sumber Daya.

Untuk membuat metode POST

1. Pada halaman Resources untuk API Anda, pastikan /DynamoDBManager sumber daya disorot. Kemudian, di panel Methods, pilih Create method.

2. Untuk jenis Metode, pilih POST.

3. Untuk jenis Integrasi, biarkan fungsi Lambda dipilih.

4. Untuk fungsi Lambda, pilih Amazon Resource Name (ARN) untuk function (). LambdaFunctionOverHttps

5. Pilih metode Buat.

Untuk membuat tabel DynamoDB

1. Buka halaman Tabel di konsol DynamoDB.

2. Pilih Buat tabel.

3. Di bawah Rincian tabel, lakukan hal berikut:

   1. Untuk Nama tabel, masukkan lambda-apigateway.

   2. Untuk kunci Partition, masukkanid, dan simpan tipe data yang ditetapkan sebagai String.

4. Di bawah Pengaturan tabel, pertahankan pengaturan Default.

5. Pilih Buat tabel.

Tes 1: Untuk membuat item baru di tabel DynamoDB Anda

1. Di konsol API Gateway, pilih API (DynamoDBOperations) Anda.

2. Pilih metode POST di bawah DynamoDBManager sumber daya.

   

3. Pilih tab Uji. Anda mungkin perlu memilih tombol panah kanan untuk menampilkan tab.

4. Di bawah metode Test, biarkan string Query dan Header kosong. Untuk badan Permintaan, tempel JSON berikut:

   {
     "operation": "create",
     "payload": {
       "Item": {
         "id": "1234ABCD",
         "number": 5
       }
     }
   }

5. Pilih Uji.

   Hasil yang ditampilkan saat tes selesai harus menunjukkan status200. Kode status ini menunjukkan bahwa create operasi berhasil.

   Untuk mengonfirmasi, periksa apakah tabel DynamoDB Anda sekarang berisi item baru.

6. Buka halaman Tabel konsol DynamoDB dan pilih tabel. lambda-apigateway

7. Pilih Jelajahi item tabel. Di panel Item yang dikembalikan, Anda akan melihat satu item dengan id 1234ABCD dan nomornya5. Contoh:

   

Tes 2: Untuk memperbarui item di tabel DynamoDB Anda

1. Di konsol API Gateway, kembali ke tab Test metode POST Anda.

2. Di bawah metode Test, biarkan string Query dan Header kosong. Untuk badan Permintaan, tempel JSON berikut:

   {
       "operation": "update",
       "payload": {
           "Key": {
               "id": "1234ABCD"
           },
           "UpdateExpression": "SET #num = :newNum",
           "ExpressionAttributeNames": {
               "#num": "number"
           },
           "ExpressionAttributeValues": {
               ":newNum": 10
           }
       }
   }

3. Pilih Uji.

   Hasil yang ditampilkan saat tes selesai harus menunjukkan status200. Kode status ini menunjukkan bahwa update operasi berhasil.

   Untuk mengonfirmasi, periksa apakah item di tabel DynamoDB Anda telah dimodifikasi.

4. Buka halaman Tabel konsol DynamoDB dan pilih tabel. lambda-apigateway

5. Pilih Jelajahi item tabel. Di panel Item yang dikembalikan, Anda akan melihat satu item dengan id 1234ABCD dan nomornya10.

   

Untuk menerapkan API

1. Buka APIshalaman konsol API Gateway dan pilih DynamoDBOperations API.

2. Pada halaman Sumber Daya untuk API Anda, pilih Deploy API.

3. Untuk Stage, pilih *Tahap baru*, lalu untuk nama Stage, masukkan. test

4. Pilih Deploy.

5. Di panel Detail tahap, salin URL Panggilan. Anda akan menggunakan ini di langkah berikutnya untuk memanggil fungsi Anda menggunakan permintaan HTTP.

Untuk membuat item di tabel DynamoDB Anda menggunakan curl

1. Jalankan curl perintah berikut menggunakan URL pemanggilan yang Anda salin pada langkah sebelumnya. Saat Anda menggunakan curl dengan opsi -d (data), secara otomatis menggunakan metode HTTP POST.

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "create", "payload": {"Item": {"id": "5678EFGH", "number": 15}}}'

   Jika operasi berhasil, Anda akan melihat respons yang dikembalikan dengan kode status HTTP 200.

2. Anda juga dapat menggunakan konsol DynamoDB untuk memverifikasi bahwa item baru ada di tabel Anda dengan melakukan hal berikut:

   1. Buka halaman Tabel konsol DynamoDB dan pilih tabel. lambda-apigateway

   2. Pilih Jelajahi item tabel. Di panel Item yang dikembalikan, Anda akan melihat item dengan id 5678EFGH dan nomornya15.

Untuk membaca item di tabel DynamoDB Anda menggunakan curl

• Jalankan curl perintah berikut untuk membaca nilai item yang baru saja Anda buat. Gunakan URL pemanggilan Anda sendiri.

  curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager -d \
  '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

  Anda akan melihat output seperti salah satu dari berikut ini tergantung pada apakah Anda memilih kode fungsi Node.js atau Python:

  Node.js

  {"$metadata":{"httpStatusCode":200,"requestId":"7BP3G5Q0C0O1E50FBQI9NS099JVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "attempts":1,"totalRetryDelay":0},"Item":{"id":"5678EFGH","number":15}}

  Python

  {"Item":{"id":"5678EFGH","number":15},"ResponseMetadata":{"RequestId":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "HTTPStatusCode":200,"HTTPHeaders":{"server":"Server","date":"Wed, 31 Jul 2024 00:37:01 GMT","content-type":"application/x-amz-json-1.0",
  "content-length":"52","connection":"keep-alive","x-amzn-requestid":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG","x-amz-crc32":"2589610852"},
  "RetryAttempts":0}}

Untuk memperbarui item dalam tabel DynamoDB Anda menggunakan curl

1. Jalankan curl perintah berikut untuk memperbarui item yang baru saja Anda buat dengan mengubah number nilainya. Gunakan URL pemanggilan Anda sendiri.

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "update", "payload": {"Key": {"id": "5678EFGH"}, "UpdateExpression": "SET #num = :new_value", "ExpressionAttributeNames": {"#num": "number"}, "ExpressionAttributeValues": {":new_value": 42}}}'

2. Untuk mengonfirmasi bahwa nilai number item telah diperbarui, jalankan perintah baca lainnya:

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

Untuk menghapus item dalam tabel DynamoDB Anda menggunakan curl

1. Jalankan curl perintah berikut untuk menghapus item yang baru saja Anda buat. Gunakan URL pemanggilan Anda sendiri.

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "delete", "payload": {"Key": {"id": "5678EFGH"}}}'

2. Konfirmasikan bahwa operasi penghapusan berhasil. Di panel Item yang dikembalikan dari halaman item Jelajahi konsol DynamoDB, verifikasi bahwa item dengan 5678EFGH id tidak lagi ada di tabel.

Untuk menghapus fungsi Lambda

1. Buka halaman Fungsi di konsol Lambda.

2. Pilih fungsi yang Anda buat.

3. Pilih Tindakan, Hapus.

4. Ketik confirm kolom input teks dan pilih Hapus.

Untuk menghapus peran eksekusi

1. Buka halaman Peran dari konsol IAM.

2. Pilih peran eksekusi yang Anda buat.

3. Pilih Hapus.

4. Masukkan nama peran di bidang input teks dan pilih Hapus.

Untuk menghapus API

1. Buka halaman APIs di konsol API Gateway.

2. Pilih API yang Anda buat.

3. Pilih Tindakan, Hapus.

4. Pilih Hapus.

Untuk menghapus tabel DynamoDB

1. Buka halaman Tabel di konsol DynamoDB.

2. Pilih tabel yang Anda buat.

3. Pilih Hapus.

4. Masukkan delete di kotak teks.

5. Pilih Hapus tabel.