公式の EAS SDK は Java、Python、Golang で提供されており、 VPC 直接接続 シナリオでサービスを呼び出す際に推奨される方法です。SDK は、サービスディスカバリー、負荷分散、トークンの署名、失敗時のリトライをカプセル化しているため、サービス呼び出しを迅速に完了できます。
ユースケース
公式 EAS SDK の典型的なユースケースは、 VPC 直接接続 です。このシナリオでは、SDK を使用することで、サービスディスカバリーと負荷分散を自分で実装する必要がなくなります。
共有ゲートウェイや専用ゲートウェイを経由する呼び出しなど、その他の呼び出し方法では、通常、標準の HTTP クライアントで十分であり、SDK は必須ではありません。
呼び出し方法の選択については、「サービス呼び出し」をご参照ください。
仕組み
SDK は、 ゲートウェイアクセス と VPC 直接接続 の 2 つのエンドポイントタイプをサポートしています。この 2 つのタイプは、リクエストルーティングの方法は異なりますが、同じ呼び出しプロセスに従います。呼び出しプロセスは、次の 3 つの段階で構成されます。
-
クライアントの初期化：
PredictClientを作成し、エンドポイント、サービス名、トークンを設定します。トークンは、EAS コンソールのサービス詳細ページから取得できます。init()を呼び出して、初期化を完了します。 -
リクエストの作成： サービスの入出力フォーマットに基づいて、
StringRequest、TFRequest、TorchRequestなどのリクエストオブジェクトを作成します。リクエストのタイプは、サービスが想定するタイプと一致する必要があります。プロセッサを使用してデプロイされたサービスについては、「プロセッサデプロイメント」で、各プロセッサに対応するリクエストタイプをご確認ください。 -
サービスの呼び出し：
predict()メソッドを呼び出して、リクエストを送信し、応答を受信します。SDK は、トークンの署名、失敗時のリトライ (デフォルトで 5 回)、応答のデシリアライズを自動的に処理するため、ユーザーによる操作は不要です。
VPC 直接接続 シナリオでは、公式 SDK がサービスディスカバリーと負荷分散のロジックをカプセル化しています。詳細については、「VPC 直接接続 - 公式 SDK を使用した呼び出し」をご参照ください。
上記の同期推論呼び出しに加えて、SDK は キューサービス 呼び出し方法も提供しています：
-
QueueClientを使用して、リクエストを非同期で入力キューにプッシュします。サービスはリクエストを消費 (デキュー) し、結果を出力キューに書き込みます。 -
クライアントは、出力キューをサブスクライブ (ウォッチ) することで結果を受信します。
この方法は、非同期推論や長時間実行タスクに適しています。詳細な手順については、各言語固有の SDK ガイドの例をご参照ください。
呼び出しのトラブルシューティング
SDK 呼び出しが失敗した場合、次の順序で段階的にトラブルシューティングを行ってください：クライアント → ネットワーク → サーバーサイド。一般的な問題の分類と、対応するトラブルシューティングの方向性は次のとおりです：
-
認証 (401 / 403)： トークンが正しく渡されているか、ターゲットサービスと一致しているか、またはコンソールでリセットされていないかを確認してください。
-
ルーティング (404)： エンドポイントとサービス名が、EAS コンソールのサービス詳細ページの値と一致していることを確認してください。VPC 直接接続を使用している場合は、サービスディスカバリーがインスタンスリストを取得していることを確認してください。
-
接続性 (接続拒否 / タイムアウト / DNS 名前解決の失敗)： クライアントとサーバーが同じ VPC 内にあること、セキュリティグループルールがトラフィックを許可していること、エンドポイントドメインが解決できることを確認してください。
-
サーバーサイド (5xx / 空の応答 / 無効な応答フォーマット)： サービスログを確認して、これらの問題の根本原因を特定してください。
サービスステータスコード、典型的なエラーメッセージ、推奨される解決策の完全なリストについては、「付録: サービスステータスコードと一般的なエラー」をご参照ください。