AWS Hands-on for Beginners Serverless #1: サーバーレスアーキテクチャで翻訳 Web API を構築する　~ Amazon API Gateway編1/2 ~

f:id:osushi_engineer:20200821142751p:plain

hisacomです。

今回は以下のAWSのハンズオン体験記事の続きで、Amazon API Gatewayの概要とMock API作成部分をまとめたものとなります。

osushi-engineer.hatenablog.com

ハンズオン内容

f:id:osushi_engineer:20200821173003p:plain

AWS Lambda、Amazon API Gateway、Amazon DynamoDBのサービスを組み合わせ、HTTPリクエストで「こんにちは」と送信すると、翻訳された「Hello」というレスポンスが返ってくるようなサーバーレスなWeb APIを作成します。

用語の補足

■API（Application Program Interface）
プログラム同士が互いにやり取りするのに使用する入出力の取り決め（仕様）のこと。APIというと幅広い範囲を指すがここではWeb APIを対象としている。
■Amazon API Gateway
APIを作成、公開、管理、モニタリング、保護するためのAWSサービス。AWSまたは他のウェブサービス、AWS クラウドに保存されているデータにアクセスするAPIを作成できる。
■REST API（REpresentational State Transfer）
RESTと呼ばれる設計原則にしたがって策定されたAPI。原則として以下の4つが存在する。
- アドレス可能性
- ステートレス性
- 接続性
- 統一インタフェース

■プロビジョニング
必要に応じてネットワークやコンピューターの設備などのリソースを提供できるよう予測し準備しておくこと。

Amazon API Gateway の概要

Amazon API Gatewayがどういうものなのかについての説明があります。

Amazon API GatewayはREST API（REpresentational State Transfer）、WebSocketに対応しており、今回のハンズオンではREST APIの開発を行うようです。

API Gatewayのメリット

普通にAPIを開発する場合、サーバープロビジョニングや管理、可用性の担保、スケーリング、APIのキー管理といった開発以外の事項についても注力する必要がありますが、API Gatewayにそれらを任せることにより、開発者はビジネスの差別化に繋がる作業にのみ集中することができます。つまりAPI作成の共通作業をAPI Gatewayが担ってくれるということですね

API Gatewayのフロー

下図はAPI Gatewayの表示ですが、クライアントのリクエストからバックエンドを通って、レスポンスがクライアントに戻ってくるフローを表しています。直感的でわかりやすいです。

f:id:osushi_engineer:20200821161453p:plain
フロー内の各ポイントで以下のように設定を行うことができます。

はじめにメソッドリクエストにおいて、リクエストを受けたときに何を行うかを定義します。（必須とするHTTPヘッダーを設定したりする）
統合リクエストにおいて、バックエンド処理を行う前どのような変換を行うのか定義します。（バックエンドの種類を選択する）
統合バックエンドにおいて、裏側で処理を行う。
統合リスエストと統合レスポンスにおいて、バックエンドへのInput、Outputを変換することができる。（今回はプロキシ統合という変換をおこなわないという行動をとる）