REST API コンソールの使用を開始する

この入門演習では、API Gateway REST API コンソールを使用してサーバーレス REST API を作成します。サーバーレス API を使用すると、サーバーのプロビジョニングや管理に時間をとられる事なく、アプリケーションに集中することができます。このエクササイズの所要時間は 20 分未満で、AWS の無料利用枠内で実行できます。

まずはじめに、Lambda コンソールを使用して Lambda 関数を作成します。次に、API Gateway REST API コンソールを使用してREST API を作成します。次に、API メソッドを作成し、Lambda プロキシ統合を使用して Lambda 関数と統合します。最後に、API をデプロイして呼び出します。

REST API を呼び出すと、API Gateway はリクエストを Lambda 関数にルーティングします。Lambda は関数を実行し、API Gateway に応答を返します。それから API Gateway はレスポンスを返します。

この演習を完了するには、AWS アカウント アカウントと、コンソールへのアクセス権がある AWS Identity and Access Management (IAM) ユーザーが必要です。詳細については、「API Gateway を使用するようにセットアップする」を参照してください。

ステップ 1: Lambda 関数を作成する

API のバックエンドには Lambda 関数を使用します。Lambda は必要に応じてコードを実行し、1 日あたり数個のリクエストから 1 秒あたり数千のリクエストまで自動的にスケールします。

この演習では、Lambda コンソールで既定の Node.js 関数を使用します。

デフォルトの Lambda 関数コードは、次のようになります。

export const handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('The API Gateway REST API console is great!'),
    };
    return response;
};

この演習の関数の応答が API Gateway が必要とする形式と一致している限り、Lambda 関数を変更できます。

デフォルトのレスポンスの本文 (Hello from Lambda!) を The API Gateway REST API console is great! に置き換えます。サンプル関数を呼び出すと、更新されたレスポンスとともにクライアントに 200 レスポンスが返されます。

ステップ 2: REST API を作成する

次に、ルートリソース (/) を使用して REST API を作成します。

ステップ 3: Lambda プロキシ統合を作成する

次に、ルートリソース (/) に REST API の API メソッドを作成し、プロキシ統合を使用して Lambda 関数とそのメソッドと統合します。Lambda プロキシ統合では、API Gateway はクライアントからの受信リクエストを直接Lambda関数に渡します。

ステップ 4: API をデプロイする

次に、API デプロイを作成し、それをステージに関連付けます。

これで、クライアントは API を呼び出すことができます。API をデプロイする前に API をテストするには、オプションで ANY メソッドを選択し、[テスト] タブに移動して [テスト] を選択することもできます。

ステップ 5: API を呼び出す

(オプション) ステップ 6: クリーンアップする

AWS アカウント にかかる不要なコストを回避するには、この演習で作成したリソースを削除します。次の手順では、REST API、Lambda 関数、および関連リソースを削除します。