API Gateway(REST API と HTTP API、エンドポイントの種類、スロットリングとキャッシュ)
API Gateway は、API(プログラムどうしの窓口)を作って公開し、守り、流量を抑えるサービスです。機能の多い REST API と、機能を絞って安い HTTP API があります。
試験ガイドを確かめた日:2026年11月17日試験ガイドを確かめた日:2026年11月17日(7 日を過ぎています)
何をするサービスか
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)
- 2.1知識 1:
API creation and management (for example, Amazon API Gateway, REST API)
- 2.1知識 3:
Caching strategies
- 4.4スキル 6:
Selecting an appropriate throttling strategy
箇条の文は SAA-C03 試験ガイドの英語の原文です。出典:Content Domain 2・Content Domain 4、著作者:Amazon Web Services、ライセンス:CC BY-SA 4.0。訳と、読むドキュメントの一覧はタスクのページにあります。
cloudnet の項目(ネットワーク)
あわせて読むページ
出典
- 1Amazon 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 - 2Amazon 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.
- 3Amazon 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.
- 4Amazon 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.
- 5Amazon 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.