fc2ブログ

記事一覧

API Gawteway で Lambdaプロキシ統合を使用する・使用しないの挙動の違い | AWS

TOP > AWS > Lambda

Visual Studio C# のコードから AWS Lambda にデプロイする方法を覚え書きしたことから始まり、Lambda のスロットリングの挙動について や Lambda の502エラーの対応方法について ご紹介してきましたが、今回も Lambda 関連で続きまして API Gateway で Lambda プロキシ統合を使用するのと使用しないのとの違いにつきまして、調査してみました。



前提条件
・Windows10 Pro 64Bit 2004
・Visual Studio 2019 Community v16.9.4
・C# .NET Core 3.1
・AWS Lambda



1.プロキシ統合の設定について

AWS API Gateway のコンソール を開きます。
API Gateway > API 名 > ANY > 統合リクエスト を辿り、以下の画像のように「Lambda プロキシ統合の使用」のチェックをON/OFFすることにより設定を変更可能です。設定を変更した場合は、API をデプロイするまで設定が反映されませんので、注意が必要です。

aws_lambda_502_01.png




2.違いについて

API Gateway の Lambda プロキシ統合を使用する設定とそうでない場合の違いを以下にまとめてみました。違いは主にリクエスト・レスポンスの形式が異なってくるという点です。

プロキシ統合
使用する
プロキシ統合
使用しない
リクエスト bodyの内部のみ送信可能 body以外にもheaderやその他の項目をつけて送信可能
レスポンス bodyの内部のみ受信可能
JSONのフォーマット違いでHTTPステータスコード502のエラーになる。
body以外にもheaderやその他の項目も含めてbody扱いされて受信可能
JSONのフォーマット違いでHTTPステータスコード502のエラーになることはない。


上記の違いについてそれぞれ確認した結果を以下に掲載します。



3.リクエストの形式

プロキシ統合を使用する場合は、Body の内部のみを JSON で送信します。
プロキシ統合を使用しない場合は、Body の記述も含めて JSON で送信します。

※以下の JSON は以前の記事「Visual Studio C# のコードから AWS Lambda にデプロイする方法」で実装している Lambda 関数に対するリクエスト方法の例です。

プロキシ統合を使用する場合
{
  "value1": 3, "value2": 4
}

プロキシ統合を使用しない場合
{
  "body": "{\"value1\": 3, \"value2\": 4}"
}



4.レスポンスの形式

Lambda の C# ソースからは同じ JSON を返却していますが、
プロキシ統合を使用する場合は、Body の内部のみが JSON で受信できます。また、Lambda から返す JSON のフォーマットが厳格になります。
プロキシ統合を使用しない場合は、Body やほかの項目の記述も含めて任意の JSON で受信できます。

※以下の JSON は以前の記事「Visual Studio C# のコードから AWS Lambda にデプロイする方法」で実装している Lambda 関数からのレスポンスの例です。

プロキシ統合を使用する場合
{
  "result": 24
}

プロキシ統合を使用しない場合
{
  "isBase64Encoded": false,
  "statusCode": 200,
  "headers": {
    "x-custom-header": "my custom header value"
  },
  "body": "{\"result\": 24}"
}




5.エビデンス

念のため以下に上記のエビデンスを貼っておきます。
※API Gateway の外から API Gateway 経由で Lambda を実行しています。

プロキシ統合を使用する場合
aws_lambda_proxy_01.png



プロキシ統合を使用しない場合
aws_lambda_vs_12.png




以上が、Lambda プロキシ統合を使用する場合と使用しない場合の違いについてまとめてみた結果となります。





関連記事

コメント

コメントの投稿

※名前とタイトルが入力されていないコメントでは他のコメントとの区別ができません。

 入力されていないコメントには返信しませんのであらかじめご了承くださいませ。

※ニックネームでも良いので必ずご入力ください。

    

※必ずご入力ください。

    
    

※必ずご入力ください。

※技術的な質問には環境やエラーについて正確かつ詳細にお教えください。

・正確なエラーの内容

・Windowsのバージョン番号

・Visual Studioのバージョン

・機器の型番

・アプリやソフトのバージョン

    

カテゴリ別記事一覧

広告

プロフィール

石河 純


著者名 :石河 純
自己紹介:素人上がりのIT技術者。趣味は卓球・車・ボウリング

IT関連の知識はざっくりとこんな感じです。
【OS関連】
WindowsServer: 2012/2008R2/2003/2000/NT4
Windows: 10/8/7/XP/2000/me/NT4/98
Linux: CentOS RedHatLinux9
Mac: macOS Catalina 10.15 / Mojave 10.14 / High Sierra 10.13 / Sierra 10.12 / OSX Lion 10.7.5 / OSX Snow Leopard 10.6.8
【言語】
VB.net ASP.NET C#.net Java VBA
Xamarin.Forms
【データベース】
Oracle 10g/9i
SQLServer 2016/2008R2/2005/2000
SQLAnywhere 16/11/8
【BI/レポートツール】
Cognos ReportNet (IBM)
Microsoft PowerBI
ActiveReport (GrapeCity)
CrystalReport
【OCX関連】
GrapeCity InputMan SPREAD MultiRow GridView
【ネットワーク関連】
CCNP シスコ技術者認定
Cisco Catalyst シリーズ
Yamaha RTXシリーズ
FireWall関連
【WEB関連】
SEO SEM CSS jQuery IIS6/7 apache2

休みの日は卓球をやっています。
現在、卓球用品通販ショップは休業中です。