メニュー
Amazon API Gateway
開発者ガイド

既知の問題

  • プレーンテキストパイプ文字 (|) はリクエスト URL クエリ文字列にサポートされておらず、URL エンコードされている必要があります。

  • /ping/sping のパスは、サービスのヘルスチェック専用です。カスタムドメインを使用した API ルートレベルでの使用は良い結果を生みません。

  • 別の AWS サービスに統合されている API の呼び出しを認証するために IAM を使用する場合、デプロイされた API と統合された AWS サービスは同一の AWS アカウントである必要があると言う意味で、API Gateway ではクロスアカウント認証は現在サポートされていません。API 発信者は、API 所有者の AWS アカウントの IAM ユーザーか、API 所有者によって信頼されている IAM ロールである必要があります。

  • API Gateway コンソールを使用して API をテストする場合、バックエンドに自己署名証明書が存在すると「不明なエンドポイントのエラー」レスポンスが返される、中間証明書が証明書チェーンにない、または他の認識されない証明書関連の例外がバックエンドからスローされることがあります。

  • API Gateway は現在、ログイベントを 1024 バイトに制限しています。リクエストやレスポンスの本文など、1024 バイトを超えるログイベントは、CloudWatch Logs への送信前に API ゲートウェイによって切り捨てられます。

  • 以下のバックエンドでは、API Gateway と互換性のある方法では SSL クライアント認証がサポートされない場合があります。

  • API Gateway では、以下を除いて、ほとんどの Swagger 仕様がサポートされます。

    • API Gateway モデルは、Swagger が使用する JSON スキーマではなく、JSON スキーマを使用して定義されます。

    • additionalProperties フィールドは、モデルではサポートされません。

    • allOf フィールドは、モデルではサポートされません。

    • discriminatorパラメーターは、どのスキーマオブジェクトでもサポートされません。

    • example タグはサポートされません。

    • exclusiveMinimumは API Gateway によってサポートされていません

    • 単純なリクエストの検証には maxItems タグと minItems タグが含まれません。この問題を回避するには、インポートした後で、検証を行う前にモデルを更新します。

    • oneOfは API Gateway によってサポートされていません

    • patternは API Gateway によってサポートされていません

    • readOnly フィールドはサポートされません。

    • "500": {"$ref": "#/responses/UnexpectedError"} フォームのレスポンス定義は、Swagger ドキュメントルートではサポートされません。回避策として、参照をインラインスキーマに置き換えます。

    • Int32 タイプまたは Int64 タイプの数値はサポートされません。例を以下に示します。

      Copy
      "elementId": { "description": "Working Element Id", "format": "int32", "type": "number" }
    • 10 進数型 ("format": "decimal") は、スキーマ定義でサポートされません。

    • メソッドレスポンスでは、スキーマ定義をオブジェクト型にする必要があり、プリミティブ型にすることはできません。たとえば、"schema": { "type": "string"} はサポートされません。ただし、回避策として次のオブジェクト型を使用できます。

      Copy
      "schema": { "$ref": "#/definitions/StringResponse" } "definitions": { "StringResponse": { "type": "string" } }
  • API Gateway は、Lambda プロキシ統合または HTTP プロキシ統合を使用した処理方法に以下の制約と制限を設定しています。

    • 重複したクエリ文字列パラメーターはサポートされていません。

    • 重複したヘッダーはサポートされていません。

    • Host ヘッダーは HTTP エンドポイントに転送されません。

    • 以下のヘッダーは、統合エンドポイントに送信されたり、統合エンドポイントから戻ったりしたときに、x-amzn-Remapped-HEADER に再マップされることがあります。

      • Accept

      • Accept-Charset

      • Accept-Encoding

      • Age

      • Authorization

      • Connection

      • Content-Encoding

      • Content-Length

      • Content-MD5

      • Content-Type

      • Date

      • Expect

      • Host

      • Max-Forwards

      • Pragma

      • Proxy-Authenticate

      • Range

      • Referer

      • Server

      • TE

      • Trailer

      • Transfer-Encoding

      • Upgrade

      • User-Agent

      • Via

      • Warn

      • WWW-Authenticate

  • API Gateway で生成された API の Android SDK では、java.net.HttpURLConnection クラスを使用します。このクラスは、Android 4.4 以前を実行するデバイスでは、WWW-Authenticate ヘッダーから X-Amzn-Remapped-WWW-Authenticate への再マッピングに伴う 401 レスポンスに対して、処理されない例外をスローします。

  • API Gateway で生成された Java や、API の Android および iOS SDK とは異なり、API Gateway で生成された API の JavaScript SDK では、500 レベルのエラーの再試行はサポートされていません。

  • メソッドのテスト呼び出しでは、application/json のデフォルトコンテンツタイプを使用し、その他のコンテンツタイプの使用は無視されます。