クラウド資格の試験ガイドを、公式ドキュメントで読む

API Gateway(REST API と HTTP API、エンドポイントの種類、スロットリングとキャッシュ)

API Gateway は、API(プログラムどうしの窓口)を作って公開し、守り、流量を抑えるサービスです。機能の多い REST API と、機能を絞って安い HTTP API があります。

試験ガイドを確かめた日:2026年11月17日試験ガイドを確かめた日:2026年11月17日(7 日を過ぎています)

原稿を確かめた日:2026年11月17日

何をするサービスか

Amazon API Gateway は、REST・HTTP・WebSocket の API を作り、公開し、保守し、監視し、守るための AWS のサービスです。作った API の裏側には、AWS のサービスやほかのウェブサービスをつなげられます。出典1

API Gateway は、同時に届く大量の API の呼び出しを受けて処理するための仕事(通信の管理、認可とアクセス制御、監視、API の版の管理など)を引き受けます。出典1

REST API と HTTP API

どちらも RESTful(HTTP の決まりに沿った、状態を持たない形)の API ですが、機能と料金が違います。API Gateway のドキュメントは、次のように使い分けを書いています。出典2

  • REST API: 機能が多い。API キー、利用者ごとのスロットリング、要求の検証、AWS WAF との連携、プライベートの API エンドポイントなどが要るならこちら
  • HTTP API: 機能を最小限にして安く提供する。REST API だけにある機能が要らないならこちら

双方向の通信を続ける用途には WebSocket API があります。メッセージの中身で行き先を振り分けます。出典1

エンドポイントの種類(REST API)

REST API のエンドポイント(API の住所)には 3 種類あり、通信の多くがどこから来るかで選びます。出典3出典2

種類内容HTTP API で使えるか
エッジ最適化多くの場合、最も近い CloudFront の拠点(POP)を通って届きます。利用者が地理的に散らばっている場合に役立ちます。REST API の既定使えない
リージョン同じリージョンの利用者向け。同じリージョンの EC2 から呼ぶ場合などに接続の手間を減らします使える
プライベートVPC の中から、インターフェース型の VPC エンドポイントを通してだけ呼べます使えない

インターフェース型の VPC エンドポイントそのものは、cloudnet の項目で説明しています。出典3

スロットリング(流量の制限)

API Gateway では、API が大量の要求であふれないよう、スロットリングと利用量の上限(クォータ)を決められます。どちらも「できる限り守る」目標の値で、必ずその数で止まる上限ではありません。出典4

API Gateway は、アカウント・リージョンごとに、一定の速さ(定常のレート)と、一時的な超過の許容(バースト)で要求を数えます。超えると要求を抑え、利用者には 429 Too Many Requests の応答が返ることがあります。API のステージやメソッドごとに目標の値を決めたり、使用量プランで利用者ごとに速さと上限を決めたりできます。出典4

キャッシュ(REST API)

REST API では、ステージごとに API のキャッシュを有効にできます。決めた時間(TTL)の間はキャッシュから応答を返すので、裏側の呼び出しが減り、応答も速くなります。既定の TTL は 300 秒、最大は 3,600 秒で、0 にするとキャッシュしません。キャッシュは「できる限り」の働きで、CloudWatch の CacheHitCount・CacheMissCount で当たり外れを見られます。出典5

当たる試験ガイドの箇条(SAA-C03)

箇条の文は SAA-C03 試験ガイドの英語の原文です。出典:Content Domain 2・Content Domain 4、著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0。訳と、読むドキュメントの一覧はタスクのページにあります。

cloudnet の項目(ネットワーク)

あわせて読むページ

出典

  1. 1
    Amazon API Gateway Developer Guide「What is Amazon API Gateway?」著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0、確かめた日:2026年11月17日https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html
  2. 2
    Amazon API Gateway Developer Guide「Choose between REST APIs and HTTP APIs」著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0、確かめた日:2026年11月17日https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vs-rest.html
    REST APIs support more features than HTTP APIs, while HTTP APIs are designed with minimal features so that they can be offered at a lower price.
  3. 3
    Amazon API Gateway Developer Guide「API endpoint types for REST APIs in API Gateway」著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0、確かめた日:2026年11月17日https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html
    This is the default endpoint type for API Gateway REST APIs.
  4. 4
    Amazon API Gateway Developer Guide「Throttle requests to your REST APIs for better throughput in API Gateway」著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0、確かめた日:2026年11月17日https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html
    Both throttles and quotas are applied on a best-effort basis and should be thought of as targets rather than guaranteed request ceilings.
  5. 5
    Amazon API Gateway Developer Guide「Cache settings for REST APIs in API Gateway」著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0、確かめた日:2026年11月17日https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html
    The default TTL value for API caching is 300 seconds.