API Gateway の VPC リンク(V1 と V2 の違い、PrivateLink との違い)
VPC リンクは、API Gateway が受けた要求を、自分の VPC の中にある外から見えないロードバランサーなどへ届けるための部品です(プライベート統合)。新しく作るのは V2 で、HTTP API と REST API の両方で使えます。旧型の V1 は REST API 用で、行き先は NLB です。
要点
- VPC リンクを使うつなぎ方を「プライベート統合」と呼びます。通信は API Gateway から自分の VPC の中へ向かいます。
- HTTP API は VPC リンク V2 で、ALB・NLB・Cloud Map に登録したリソースにつなげます。
- REST API も VPC リンク V2 を使えます。2025年11月21日から ALB に直接つなげるようになりました。REST API の行き先は ALB と NLB で、Cloud Map とのプライベート統合は使えません。
- 旧型の VPC リンク V1 は、REST API から NLB へつなぐものです。NLB を PrivateLink のエンドポイントサービスにして、API Gateway がそこへ接続します。ドキュメントは V1 を新しく作らないよう勧めています。
- V2 を作るときは、サブネットとセキュリティグループを選びます。API Gateway が自分のアカウントの中に ENI を作ります。サブネットとセキュリティグループは後から変えられません。
- インターフェース型エンドポイントで呼ぶ「プライベート API」とは向きが逆です。こちらは VPC の中から API Gateway へ向かいます。
- API Gateway の料金ページと Price List(東京)には、VPC リンクそのものの料金の行がありません。料金ページに書かれている課金には、API の呼び出しと、外への転送(EC2 の転送の単価)などがあります。後ろに置く ALB・NLB には、ロードバランサーの料金がかかります(2-13)。
V1 と V2 の違い
| 区分 | VPC リンク V2 | VPC リンク V1(旧型) |
|---|---|---|
| 使う API | HTTP API・REST API | REST 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 の中の NLB | NLB(エンドポイントサービス) |
| プライベート 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 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:HTTP API は VPC リンク V2 を作ってから、ALB・NLB・Cloud Map のサービスに登録したリソースへのプライベート統合を作れる
値:ALB・NLB・Cloud Map全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 2:REST API のプライベート統合は VPC リンク V2 で ALB か NLB につなぐ。Cloud Map とのプライベート統合は使えない
値:ALB・NLB全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 3:VPC リンク V1 は旧型(legacy)で、ドキュメントは新しく V1 を作らず V2 を使うよう勧めている。V1 では先に NLB を作り、VPC リンクで API と NLB をつなぐ
値:V1 = NLB全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 4:V1 の VpcLink を作ると、リージョンごとの API Gateway のアカウントが、VPC エンドポイントサービスの許可するプリンシパル(AllowedPrincipals)に自動で足される
値:AllowedPrincipals全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 5:V1 の NLB の準備では、NLB のセキュリティグループの設定「Enforce inbound rules on PrivateLink traffic」を外す。API Gateway の CIDR に依存しない(予告なく変わる)
値:PrivateLink の通信へのルールの適用を外す全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 6:VPC リンク V2 を作ると、API Gateway が自分のアカウントの中に ENI を作って管理する。数分かかり、使えるようになると状態が PENDING から AVAILABLE になる
値:ENI全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 7:VPC リンクに 60 日通信が無いと INACTIVE になり、API Gateway は ENI を全部消す。その間の要求は失敗し、要求が再開すると ENI を作り直す(数分かかる)
値:60 日全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 8:VPC リンク V2 は作った後にサブネットとセキュリティグループを変えられない
値:immutable全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 9:プライベート統合のロードバランサー(か Cloud Map のサービス)・VPC リンク・API は、すべて同じ AWS アカウントのものでなければならない
値:same-account全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 10:東京リージョンで VPC リンク V2 を使える AZ は AZ ID が apne1-az1・apne1-az2・apne1-az4 のもの
値:apne1-az1・apne1-az2・apne1-az4東京2026年11月3日に確認出典:AWS のドキュメント(apigateway)
機能
事実 11:REST API のプライベート統合で ALB に直接つなげる(2025年11月21日の告知。東京・大阪を含む)。L4 の NLB との統合も引き続き使える
値:rest-api-alb2025年11月21日から東京2026年11月3日に確認出典:AWS の新着情報
仕組み
事実 12:V1 を使っている REST API の統合は、コンソールの統合リクエストの設定で V2 に変えられる。変更を反映するには API をデプロイし直す
値:V1 → V2全リージョン共通2026年11月3日に確認出典:AWS のドキュメント(apigateway)
仕組み
事実 13:プライベート統合は VPC リンクで VPC の中の HTTP・HTTPS のリソースへ要求を送る。プライベート API は VPC の中から VPC エンドポイントを通してだけ呼べる
値:向きが逆全リージョン共通2026年11月3日に確認出典:AWS のページ
料金
事実 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:API Gateway の料金ページは、HTTP API と REST API では受けた API の呼び出しと外への転送量に支払うと説明し、プライベート API には外への転送の料金が無いと書いている。外への転送には EC2 の転送の単価がかかる
値:EC2 の転送の単価全リージョン共通2026年11月3日に確認出典:AWS の料金ページ
料金
事実 16:プライベート API を使うときは PrivateLink(インターフェース型エンドポイント)の料金がかかる
値:PrivateLink の料金全リージョン共通2026年11月3日に確認出典:AWS の料金ページ
引用
引用(著作権法32条)。出典:Amazon Web Services「AWS の新着情報「Amazon API Gateway REST APIs now supports private integration with Application Load Balancer」(2025年11月21日)」(2026年11月3日に確認)。原文のままAmazon API Gateway REST APIs now support direct private integration with Application Load Balancer (ALB), enabling inter-VPC connectivity to internal ALBs.
引用(著作権法32条)。出典:Amazon Web Services「Amazon API Gateway の料金ページ」(2026年11月3日に確認)。原文のままFor HTTP APIs and REST APIs, you pay only for the API calls you receive and the amount of data transferred out. There are no data transfer out charges for Private APIs.
引用(著作権法32条)。出典:Amazon Web Services「Amazon API Gateway の料金ページ」(2026年11月3日に確認)。原文のままHowever, AWS PrivateLink charges apply when using Private APIs in API Gateway.