先生と生徒の会話形式で理解しよう

生徒

「AWS Lambdaから外部のAPIを呼び出したいんですが、うまくいかないことが多くて困っています。」

先生

「Lambdaから外部APIを呼ぶ場合、HTTP通信の仕組みやエラーコードを理解しておくことが大切です。」

生徒

「HTTPのエラーで429とか403って表示されるんですが、何が原因なんですか？」

先生

「それぞれ意味があります。Lambdaの仕組みと合わせて、順番に確認していきましょう。」

1. AWS Lambdaで外部APIを呼び出すとは

AWS Lambdaは、サーバーを意識せずにプログラムを実行できるサーバーレスサービスです。 Lambdaの大きな特徴の一つが、外部APIと連携できる点です。例えば、天気情報API、決済API、社内システムのAPIなどをLambdaから呼び出すことで、処理を自動化したり、リアルタイムなデータを取得したりできます。

Lambdaで外部APIを呼び出す場合、HTTP通信を利用します。 HTTPリクエストを送信し、レスポンスを受け取るという基本的な流れは、通常のWebアプリケーションと同じです。

2. LambdaとHTTP通信の基本的な仕組み

AWS Lambdaから外部APIを呼び出す場合、HTTPSを使った通信が一般的です。 LambdaはAWSのデータセンター上で実行されるため、インターネット経由で外部APIにアクセスします。

外部APIにリクエストを送ると、ステータスコードとレスポンスデータが返ってきます。ステータスコードは処理結果を表し、200番台は成功、400番台や500番台はエラーを意味します。

3. JavaでAWS Lambdaから外部APIを呼び出す例

Javaを使ったAWS Lambdaでは、標準のHTTPクライアントを利用して外部APIを呼び出します。処理の流れは、リクエストを作成し、送信し、レスポンスを受け取るという形になります。


import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class ApiLambda {
    public String handleRequest() throws Exception {
        URL url = new URL("https://example.com/api");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String line;
        StringBuilder response = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();

        return response.toString();
    }
}

このように記述することで、AWS Lambdaから外部APIを呼び出すことができます。初心者の方は、まず正常にレスポンスが返ってくることを確認するのが重要です。

AWSの基本用語や仕組みを、図解でサクッと理解したい人には、入門の定番書がこちらです。

AWSの基本が全部わかる教科書をAmazonで見る

※ Amazon広告リンク