すべてのプロダクト
Search
ドキュメントセンター

API Gateway:インスタンス間のAPIグループの移行

最終更新日:Jan 26, 2025

異なるインスタンスのシナリオ

  • サーバーレスインスタンス (VPC): テナントは同じアウトバウンドIPアドレスと帯域幅を共有します。 サーバーレスインスタンスは、テスト環境や小規模な本番環境に優れたスケーラビリティを提供します。

  • 専用インスタンス (VPC): サービスレベル契約 (SLA) でより高いレベルの保証を取得するには、専用リソースを使用するためのより高い要求 /秒 (RPS) を含む仕様を購入します。 リソースには、インバウンドパブリックIPアドレス、仮想プライベートクラウド (VPC) のIPアドレス、アウトバウンドインターネット帯域幅、および分離されたサーバークラスターが含まれます。

移行手順

  1. API Gatewayコンソールにログインします。 上部のナビゲーションバーで、リージョンを選択します。

  2. 左側のナビゲーションウィンドウで、[APIの管理] > [APIグループ] を選択します。 移行するAPIグループをクリックします。

  3. [グループの詳細] ページで、[APIグループデプロイのインスタンスの変更] をクリックします。

  4. 表示されるダイアログボックスで、[宛先インスタンス] ドロップダウンリストから宛先インスタンスを選択し、注意事項を読み、[上記のステートメントを読み、移行に関連する潜在的なリスクを把握した] を選択して、[移行] をクリックします。 移行は、ドメインネームシステム (DNS) キャッシュに応じて1〜10分で有効になります。

説明

仕様がビジネス要件を満たすことができない専用インスタンスを使用している場合は、インスタンスをより高い仕様にアップグレードできます。 詳細については、「インスタンス仕様の変更」をご参照ください。

重要

DNSキャッシュのため、移行後に一部のリクエストが前のインスタンスに送信されます。 前のインスタンスをリリースする前に、すべてのリクエストが新しいインスタンスに転送されていることを確認してください。

移行ノート

RPSを変更したAPIグループを移行する必要がある場合は、チケットを起票してください。 APIグループを移行する前に、移行前と移行後の違いについて、以下の各技術的な詳細を確認してください。

APIグループをサーバーレスインスタンスから専用インスタンスに移行する

  • APIグループを専用インスタンスに移行すると、移行先の専用インスタンスの最大RPSとHTTPSセキュリティポリシーがAPIグループに適用されます。

  • API GatewayインスタンスのアウトバウンドIPアドレスが変更される場合があります。 [インスタンス] ページに移動して、アウトバウンドIPアドレスを表示できます。 API GatewayインスタンスのアウトバウンドIPアドレスが、バックエンドサービスへのアクセスを許可されているIPアドレスのホワイトリストに含まれていることを確認します。

  • APIグループで特定の機能が有効になっている場合は、APIグループを移行する前に、移行先インスタンスで同じ機能が有効になっていることを確認してください。 APIグループの特定の機能には、VPCを介したアクセスの第2レベルドメイン名、API GatewayからのAPI呼び出しの内部ドメイン名、インバウンドIPv6トラフィック、およびアウトバウンドIPv6トラフィックが含まれます。

  • ターゲットインスタンスがVPC統合インスタンスの場合、バックエンドサービスのIPアドレスまたはCIDRブロックが、ターゲットインスタンスにバインドされているElastic Network Interface (ENI) のセキュリティグループによって許可されていることを確認します。

専用インスタンスから別の専用インスタンスへのAPIグループの移行

  • APIグループを別の専用インスタンスに移行すると、移行先の専用インスタンスの最大RPSとHTTPSセキュリティポリシーがAPIグループに適用されます。

  • API GatewayインスタンスのアウトバウンドIPアドレスが変更される場合があります。 [インスタンス] ページに移動して、アウトバウンドIPアドレスを表示できます。 API GatewayインスタンスのアウトバウンドIPアドレスが、バックエンドサービスへのアクセスを許可されているIPアドレスのホワイトリストに含まれていることを確認します。

  • APIグループで特定の機能が有効になっている場合は、APIグループを移行する前に、移行先インスタンスで同じ機能が有効になっていることを確認してください。 APIグループの特定の機能には、VPCを介したアクセスの第2レベルドメイン名、API GatewayからのAPI呼び出しの内部ドメイン名、インバウンドIPv6トラフィック、およびアウトバウンドIPv6トラフィックが含まれます。

  • ターゲットインスタンスがVPC統合インスタンスの場合、バックエンドサービスのIPアドレスまたはCIDRブロックが、ターゲットインスタンスにバインドされているENIのセキュリティグループによって許可されていることを確認します。