API Gateway での WebSocket API の概要

API Gateway では、AWS のサービス (Lambda や DynamoDB など) または HTTP エンドポイントのステートフルフロントエンドとして WebSocket API を作成できます。WebSocket API は、クライアントアプリから受信するメッセージのコンテンツに基づいて、バックエンドを呼び出します。

WebSocket API は、リクエストを受け取って応答する REST API とは異なり、クライアントアプリとバックエンド間の双方向通信をサポートします。バックエンドは、接続されたクライアントにコールバックメッセージを送信できます。

WebSocket API では、受信する JSON メッセージは設定したルートに基づいてバックエンド統合に転送されます (JSON 以外のメッセージは、設定した $default ルートに転送されます)。

ルートにはルートキーが含まれます。これは、ルート選択式が評価されたときに予期される値です。属性 routeSelectionExpression は、API レベルで定義されます。メッセージペイロードに存在することが予期される JSON プロパティを指定します。ルート選択式の詳細については、「ルート選択式」を参照してください。

たとえば、JSON メッセージに action プロパティが含まれていて、このプロパティに基づいてさまざまなアクションを実行する場合、ルート選択式は ${request.body.action} のようになります。ルーティングテーブルでは、このテーブルで定義したカスタムルートキーの値に対して、action プロパティの値を一致させることによって、実行するアクションを指定します。

WebSocket API のルートを使用する

3 つの事前定義されたルート ($connect、$disconnect、および $default) を使用できます。さらに、カスタムルートを作成することができます。

$connect および $disconnect ルートの詳細については、「接続されたユーザーとクライアントアプリを管理する: $connect ルートおよび $disconnect ルート」を参照してください。

$default ルートおよびカスタムルートの詳細については、「API Gateway の $default ルートおよびカスタムルートを使用してバックエンド統合を呼び出す」を参照してください。

接続されたクライアントアプリケーションにデータを送信する

バックエンドサービスは、接続されたクライアントアプリにデータを送信できます。以下を実行することにより、データを送信できます。

WebSocket API ステータスコード

API Gateway WebSocket API は、WebSocket Close Code Number Registry に説明されているように、サーバーからクライアントへの通信に次のステータスコードを使用します。