クラウドのネットワークの図解と早見表

トップ › つなぎ方 › 3-16

3-16棚 3 つなぎ方

API Gateway の VPC リンク(V1 と V2 の違い、PrivateLink との違い)

  • 確かめた日 2026年11月3日
  • 確かめた事実 16 件
  • 料金と上限は東京リージョン(ap-northeast-1)

VPC リンクは、API Gateway が受けた要求を、自分の VPC の中にある外から見えないロードバランサーなどへ届けるための部品です(プライベート統合)。新しく作るのは V2 で、HTTP API と REST API の両方で使えます。旧型の V1 は REST API 用で、行き先は NLB です。

VPC リンクは API Gateway から VPC の中へ、プライベート API は VPC の中から外へVPC リンク V2 は API Gateway から自分の VPC の ENI を通って ALB・NLB へ、V1 は PrivateLink で NLB へつなぐ。プライベート API は逆に、VPC の中からインターフェース型エンドポイントを通って API Gateway へ向かうことを示す図VPC リンク V2(HTTP API・REST API)自分の VPCクライアントAPI Gateway1ENIセキュリティグループALB・NLB2コンテナのサービスVPC リンク V1(REST API・旧型)自分の VPCクライアントAPI Gateway1PrivateLinkNLBエンドポイントサービス2サーバー比べる:プライベート API(向きが逆)自分の VPCクライアントENIインターフェース型エンドポイント3API Gateway1VPC リンクは API Gateway から自分の VPC の中へ向かい、プライベート API は VPC の中から API Gateway へ向かいます。番号は、それぞれの料金ページに料金が載っている部品の例です(① API の呼び出し、② ロードバランサー、③ インターフェース型エンドポイント)。外への転送などの課金には番号を付けていません。VPC リンクそのものの料金の行は、API Gateway の料金ページにありません。
VPC リンクは API Gateway から VPC の中へ、プライベート API は VPC の中から外へVPC リンク V2 は API Gateway から自分の VPC の ENI を通って ALB・NLB へ、V1 は PrivateLink で NLB へつなぐ。プライベート API は逆に、VPC の中からインターフェース型エンドポイントを通って API Gateway へ向かうことを示す図VPC リンク V2(HTTP API・REST API)自分の VPCクライアントAPI Gateway1ENIセキュリティグループALB・NLB2コンテナのサービスVPC リンク V1(REST API・旧型)自分の VPCクライアントAPI Gateway1PrivateLinkNLBエンドポイントサービス2サーバー比べる:プライベート API(向きが逆)自分の VPCクライアントENIインターフェース型エンドポイント3API Gateway1VPC リンクは API Gateway から自分の VPC の中へ向かい、プライベート API は VPC の中から APIGateway へ向かいます。番号は、それぞれの料金ページに料金が載っている部品の例です(① API の呼び出し、② ロードバランサー、③ インターフェース型エンドポイント)。外への転送などの課金には番号を付けていません。VPC リンクそのものの料金の行は、APIGateway の料金ページにありません。

要点

  1. VPC リンクを使うつなぎ方を「プライベート統合」と呼びます。通信は API Gateway から自分の VPC の中へ向かいます。
  2. HTTP API は VPC リンク V2 で、ALB・NLB・Cloud Map に登録したリソースにつなげます。
  3. REST API も VPC リンク V2 を使えます。2025年11月21日から ALB に直接つなげるようになりました。REST API の行き先は ALB と NLB で、Cloud Map とのプライベート統合は使えません。
  4. 旧型の VPC リンク V1 は、REST API から NLB へつなぐものです。NLB を PrivateLink のエンドポイントサービスにして、API Gateway がそこへ接続します。ドキュメントは V1 を新しく作らないよう勧めています。
  5. V2 を作るときは、サブネットとセキュリティグループを選びます。API Gateway が自分のアカウントの中に ENI を作ります。サブネットとセキュリティグループは後から変えられません。
  6. インターフェース型エンドポイントで呼ぶ「プライベート API」とは向きが逆です。こちらは VPC の中から API Gateway へ向かいます。
  7. API Gateway の料金ページと Price List(東京)には、VPC リンクそのものの料金の行がありません。料金ページに書かれている課金には、API の呼び出しと、外への転送(EC2 の転送の単価)などがあります。後ろに置く ALB・NLB には、ロードバランサーの料金がかかります(2-13)。

V1 と V2 の違い

区分VPC リンク V2VPC リンク V1(旧型)
使う APIHTTP API・REST APIREST API
行き先(HTTP API)ALB・NLB・Cloud Map に登録したリソース—
行き先(REST API)ALB・NLB(Cloud Map は使えない)NLB
つなぎ方API Gateway が自分のアカウントに ENI を作るNLB をエンドポイントサービスにし、API Gateway のアカウントが接続する
セキュリティグループV2 を作るときに選ぶ(後から変えられない)NLB のセキュリティグループで、PrivateLink の通信へのインバウンドのルールの適用を外す
使わないとき60 日通信が無いと INACTIVE になり、ENI が消える(ドキュメントに記載なし)

どちらも、ロードバランサー・VPC リンク・API は同じアカウントのものでなければなりません。

V2 で ALB に直接つなぐ

2025年11月21日の告知によると、それまで REST API から ALB へは、間に NLB を挟む必要がありました(API Gateway → NLB → ALB)。この日から、REST API でも V2 で ALB に直接つなげます(東京・大阪を含む)。

ALB に直接つなぐと、パスやヘッダーによる振り分け、HTTP・HTTPS のヘルスチェックなど、ALB の機能をそのまま使えます。NLB を挟んでいた構成で NLB を外せば、その NLB の料金はかかりません。V1 の統合は、コンソールの統合リクエストの設定で V2 に切り替えられます(切り替えた後に API をデプロイし直す)。

V2 の ENI とセキュリティグループ

V2 を作ると、API Gateway が選んだサブネットに ENI を作り、管理します。できるまで数分かかり、状態が PENDING から AVAILABLE になれば使えます。1 つの V2 は、複数の API・統合から使い回せます。

  • 作るときに選んだサブネットとセキュリティグループは、後から変えられません。変えるときは V2 を作り直します
  • 後ろの ALB・NLB にセキュリティグループを付けているときは、そのセキュリティグループで、VPC リンクの ENI からの通信を許可します(ENI から ALB・NLB へ通信が入るため。推論)
  • 60 日通信が無いと INACTIVE になり、ENI が消えます。この間の要求は失敗します。要求が来ると ENI を作り直しますが、数分かかります

東京リージョンで V2 を使える AZ は、AZ ID が apne1-az1・apne1-az2・apne1-az4 のものです(apne1-az3 は一覧にありません)。AZ の名前(ap-northeast-1a など)はアカウントごとに違うので、AZ ID で確かめます(1-2)。

PrivateLink・VPC エンドポイントとの違い

名前が似ていますが、向きが違います。

区分通信の向き自分の VPC に置くもの
VPC リンク V2(プライベート統合)API Gateway → 自分の VPC の中の ALB・NLB などAPI Gateway が作る ENI
VPC リンク V1(プライベート統合)API Gateway → 自分の VPC の中の NLBNLB(エンドポイントサービス)
プライベート API自分の VPC の中 → API Gatewayインターフェース型エンドポイント(execute-api)
PrivateLink のエンドポイントサービス(3-3)使う側の VPC → 提供する側の NLB使う側はインターフェース型エンドポイント

外の利用者に VPC の中のサービスを API として出すときは VPC リンク、VPC の中からだけ呼べる API にするときはプライベート API です。

選ぶとき・避けるとき

選ぶとき

  • VPC の中の外から見えない ALB・NLB・コンテナのサービスを、API Gateway の API として外の利用者に出したいとき
  • 後ろが ALB で、パスやヘッダーの振り分けを ALB でしたいとき(V2 なら NLB を挟まない)
  • API の認可を API Gateway の側で行い、後ろのサービスはインターネットに出したくないとき

避けるとき・ほかと比べるとき

  • API を VPC の中からだけ呼べるようにしたいとき(プライベート API とインターフェース型エンドポイントを使う)
  • 別のアカウントの VPC のロードバランサーにつなぎたいとき(VPC リンクは同じアカウントのものだけ。PrivateLink のエンドポイントサービス(3-3)や VPC Lattice(3-4)を比べる)
  • 新しく作る構成で V1 を選ぶとき(V2 を使う)

この項目の料金

  • API Gateway の料金ページと、Price List の API Gateway(東京、2026-10-13 公開)には、VPC リンクそのものの料金の行がありません(2026-11-03 に確認)。Price List の行は、API の呼び出し・HTTP API の要求・REST API のキャッシュ・WebSocket・ポータルです。
  • 料金ページには、HTTP API と REST API では受けた API の呼び出しと外への転送量に支払うこと、プライベート API には外への転送の料金が無いこと、外への転送には EC2 の転送の単価がかかることが書かれています(このページの下の「引用」の節)。
  • 後ろの ALB・NLB には、ロードバランサーの料金(時間と使用量)がかかります(2-13)。V1 のときに ALB の前に置いていた NLB を外せば、その NLB の料金はかかりません。
  • プライベート API(VPC の中から呼ぶ API)を使うときは、API の呼び出しの料金に加えて、インターフェース型エンドポイントの料金がかかります(料金ページ。単価は 3-3)。

この項目には料金の額を載せていません。額はそれぞれの料金ページで確かめてください。

確かめた事実

値・リージョン・確かめた日・出典です。料金は AWS Price List API(認証の要らない一括ファイル)の値で、Price List の公開日も書いています。

  1. 仕組み

    事実 1:HTTP API は VPC リンク V2 を作ってから、ALB・NLB・Cloud Map のサービスに登録したリソースへのプライベート統合を作れる

    値:ALB・NLB・Cloud Map全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  2. 仕組み

    事実 2:REST API のプライベート統合は VPC リンク V2 で ALB か NLB につなぐ。Cloud Map とのプライベート統合は使えない

    値:ALB・NLB全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  3. 仕組み

    事実 3:VPC リンク V1 は旧型(legacy)で、ドキュメントは新しく V1 を作らず V2 を使うよう勧めている。V1 では先に NLB を作り、VPC リンクで API と NLB をつなぐ

    値:V1 = NLB全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  4. 仕組み

    事実 4:V1 の VpcLink を作ると、リージョンごとの API Gateway のアカウントが、VPC エンドポイントサービスの許可するプリンシパル(AllowedPrincipals)に自動で足される

    値:AllowedPrincipals全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  5. 仕組み

    事実 5:V1 の NLB の準備では、NLB のセキュリティグループの設定「Enforce inbound rules on PrivateLink traffic」を外す。API Gateway の CIDR に依存しない(予告なく変わる)

    値:PrivateLink の通信へのルールの適用を外す全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  6. 仕組み

    事実 6:VPC リンク V2 を作ると、API Gateway が自分のアカウントの中に ENI を作って管理する。数分かかり、使えるようになると状態が PENDING から AVAILABLE になる

    値:ENI全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  7. 仕組み

    事実 7:VPC リンクに 60 日通信が無いと INACTIVE になり、API Gateway は ENI を全部消す。その間の要求は失敗し、要求が再開すると ENI を作り直す(数分かかる)

    値:60 日全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  8. 仕組み

    事実 8:VPC リンク V2 は作った後にサブネットとセキュリティグループを変えられない

    値:immutable全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  9. 仕組み

    事実 9:プライベート統合のロードバランサー(か Cloud Map のサービス)・VPC リンク・API は、すべて同じ AWS アカウントのものでなければならない

    値:same-account全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  10. 仕組み

    事実 10:東京リージョンで VPC リンク V2 を使える AZ は AZ ID が apne1-az1・apne1-az2・apne1-az4 のもの

    値:apne1-az1・apne1-az2・apne1-az4東京2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  11. 機能

    事実 11:REST API のプライベート統合で ALB に直接つなげる(2025年11月21日の告知。東京・大阪を含む)。L4 の NLB との統合も引き続き使える

    値:rest-api-alb2025年11月21日から東京2026年11月3日に確認出典:AWS の新着情報

  12. 仕組み

    事実 12:V1 を使っている REST API の統合は、コンソールの統合リクエストの設定で V2 に変えられる。変更を反映するには API をデプロイし直す

    値:V1 → V2全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)

  13. 仕組み

    事実 13:プライベート統合は VPC リンクで VPC の中の HTTP・HTTPS のリソースへ要求を送る。プライベート API は VPC の中から VPC エンドポイントを通してだけ呼べる

    値:向きが逆全リージョン共通2026年11月3日に確認出典:AWS のページ

  14. 料金

    事実 14:API Gateway の Price List(東京、2026-10-13 公開)の行は API の呼び出し・HTTP API の要求・キャッシュ・WebSocket・ポータルで、VPC リンクの行は無い。料金ページにも VPC リンクの項目は無い

    値:行なし東京2026年11月3日に確認Price List の公開日 2026年10月13日出典:Price List API の一括ファイル(AmazonApiGateway)

  15. 料金

    事実 15:API Gateway の料金ページは、HTTP API と REST API では受けた API の呼び出しと外への転送量に支払うと説明し、プライベート API には外への転送の料金が無いと書いている。外への転送には EC2 の転送の単価がかかる

    値:EC2 の転送の単価全リージョン共通2026年11月3日に確認出典:AWS の料金ページ

引用