---
title: "API Gatewayを使用したフォールバックの実装 - API7.ai"
description: "APISIX API Gatewayを使用して、フォールバック戦略に焦点を当てた効率的なレジリエントAPIの実装方法を探ってみましょう。"
url: "https://api7.ai/ja/blog/fallback-api-resilience-design-patterns"
---

[Blog](https://api7.ai/ja/blog)

[Products](https://api7.ai/ja/category/products)[Technology](https://api7.ai/ja/category/technology)[Ecosystem](https://api7.ai/ja/category/ecosystem)[Case Study](https://api7.ai/ja/category/usercase)[Team & Community](https://api7.ai/ja/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Technology

# API Gatewayを使用したフォールバックの実装

[![Bobur Umurzokov](https://avatars.githubusercontent.com/u/14247607)](https://www.linkedin.com/in/boburumurzokov/)

[Bobur Umurzokov](https://www.linkedin.com/in/boburumurzokov/)

November 10, 2023

[Technology](https://api7.ai/category/technology)

APIのレジリエンスとは、エラーや高トラフィック、部分的なシステム障害に直面した際に、APIが迅速に失敗するか、障害後も機能し続ける能力のことです。これには、リトライ、タイムアウト、サーキットブレーカー、フェイルオーバー、フォールバックなどの[一般的なAPIレジリエンス設計パターン](https://api7.ai/blog/10-common-api-resilience-design-patterns)を実装することが含まれます。API Gatewayを使用したフォールバックは、APIのプランBです。プライマリAPIサービスが失敗した場合、API Gatewayはトラフィックをセカンダリサービスにリダイレクトするか、事前に定義された応答を返すことができます。この記事では、既存のフォールバック技術の**課題**と、APISIX API Gatewayを使用してそれらを効率的に**実装する方法**について探ります。

![APISIX Gatewayでのフォールバック](https://static.api7.ai/uploads/2024/12/25/VYtJ6l0J_fallback-with-api-gateway.png?imageMogr2/format/webp)

## APISIXを使用したフォールバックの実装

APISIXでフォールバックメカニズムを実装するには、組み込みの[アップストリーム優先度](https://apisix.apache.org/docs/apisix/admin-api/#example-api-usage-3:~:text=As%20the%20default%20priority%20is%200)機能を使用するか、[response-rewrite](https://apisix.apache.org/docs/apisix/plugins/response-rewrite/)プラグインを使用して、サービス呼び出しが失敗した場合に事前に定義された応答を返すことができます。以下に、両方のフォールバック方法を設定するためのステップバイステップの例を示します。

### 前提条件

このガイドでは、以下のツールがローカルにインストールされていることを前提としています：

- 開始する前に、APISIXの基本的な理解があることが望ましいです。[API Gateway](https://apisix.apache.org/docs/apisix/terminology/api-gateway/)とその主要な概念（[ルート](https://docs.api7.ai/apisix/key-concepts/routes)、[アップストリーム](https://docs.api7.ai/apisix/key-concepts/upstreams)、[Admin API](https://apisix.apache.org/docs/apisix/admin-api/)、[プラグイン](https://docs.api7.ai/apisix/key-concepts/plugins)、HTTPプロトコル）に精通していることも有益です。
- [Docker](https://docs.docker.com/get-docker/)を使用して、コンテナ化されたetcdとAPISIXをインストールします。
- サービスにリクエストを送信して検証するために、[cURL](https://curl.se/)をインストールします。

### APISIX Dockerプロジェクトの開始

このプロジェクトでは、事前に定義された[Docker Compose設定](https://github.com/apache/apisix-docker/blob/master/example/docker-compose.yml)ファイルを活用して、APISIX、etcd、Prometheus、その他のサービスを単一のコマンドでセットアップ、デプロイ、実行します。まず、GitHubで[apisix-docker](https://github.com/apache/apisix-docker)リポジトリをクローンし、お気に入りのエディタで開き、`example`フォルダに移動して、プロジェクトのルートフォルダからターミナルで`docker compose up`コマンドを実行してプロジェクトを開始します。

プロジェクトを開始すると、Dockerは実行に必要なイメージをダウンロードします。また、2つの例のバックエンドサービス`web1`と`web2`を実行します。サービスの完全なリストは[docker-compose.yaml](https://github.com/apache/apisix-docker/blob/master/example/docker-compose.yml)ファイルで確認できます。

### APISIXアップストリーム優先度を有効にしたフォールバック

各アップストリームノードに特定の優先度レベルを設定して有効にすることができます。優先度の高いノードエンドポイントが失敗した場合、API Gatewayは優先度の低いセカンダリノードにトラフィックをリダイレクトできます。すべてのノードのデフォルトの優先度は0で、負の優先度を持つノードはバックアップとして設定できます。

![APISIXアップストリーム優先度を有効にしたフォールバック](https://static.api7.ai/uploads/2023/11/14/0W4zLUBv_8.png?imageMogr2/format/webp)

2つのサービスへのルートを作成し、各アップストリームサービスのノードに優先度属性を設定します：

```
curl "http://127.0.0.1:9180/apisix/admin/routes" -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" -X PUT -d '
{
   "id":"backend-service-route",
   "methods":[
      "GET"
   ],
   "uri":"/get",
   "upstream":{
      "nodes":[
         {
            "host":"web1",
            "port":80,
            "weight":1,
            "priority":0
         },
         {
            "host":"web2",
            "port":80,
            "weight":1,
            "priority":-1
         }
      ]
   }
}'
```

- `methods`: このルートが一致するHTTPメソッドを指定します。この場合、`GET`リクエストに一致するように設定されています。
- `uri`: このルートが一致するパスです。したがって、`/get`への`GET`リクエストはこのルートによって処理されます。
- `nodes`: バックエンドサーバーの配列です。配列内の各オブジェクトは、`host`、`port`、`weight`を持つサーバーを表します。`weight`はロードバランシングに使用されます。この場合、両方のサーバーの`weight`は`1`で、通常はトラフィックを均等に共有することを意味します。
- `priority`: これは2つのノード（`web1`、`web2`）の追加設定です。`priority`フィールドは、ノードが選択される順序を決定するために使用されます。優先度の低いノード（より高い負の数）は、優先度の高いノード（より低い負の数または正の数）が利用できない場合にのみ使用されます。

ルートにリクエストを送信したときに`web1`サービスからの応答のみが得られることを確認します：

```
curl "http://127.0.0.1:9080/get"
```

次のような応答が表示されるはずです：

```
hello web1
```

これは、`web1`が最初に実行されたことを意味します。次に、`web1`サービスのコンテナを停止して、APISIXが`web2`サービスにフォールバックすることを確認します。

```
docker container stop example-web1-1
```

再度ルートにリクエストを送信すると、指定したフォールバックサービスからの応答が得られます。

```
curl "http://127.0.0.1:9080/get"
hello web2
```

デフォルトでは、リクエストが最初にサービス1に送られ、利用できない場合にサービス2にフォールバックするまでに60秒かかります。この時間は、[Upstream](https://apisix.apache.org/docs/apisix/admin-api/#upstream)オブジェクトの`timeout`属性を設定することで変更することもできます。別のフォールバック戦略として、リリース中に新しいバージョンのAPIにバグがある場合、APISIXの[トラフィック分割](https://apisix.apache.org/docs/apisix/plugins/traffic-split/)機能を使用して、スタンバイ中の古いバージョンにトラフィックをルーティングすることができます。新しいバージョンに問題がある場合、以前のバージョンにフォールバックします。このフォールバック方法は、[Upstreamヘルスチェック](https://docs.api7.ai/apisix/how-to-guide/traffic-management/health-check)ともうまく連携します。

### APISIX Response Rewriteプラグインを使用したフォールバック

APISIXの[response-rewrite](https://apisix.apache.org/docs/apisix/plugins/response-rewrite/)プラグインを使用すると、クライアントに返す前に応答のステータスコード、本文、ヘッダーを変更できます。これは、アップストリームサービスが失敗した場合にデフォルトの応答を提供するフォールバックメカニズムを実装するのに特に役立ちます。

![APISIX response rewriteプラグインを使用したフォールバック](https://static.api7.ai/uploads/2023/11/14/HCVm8LSt_7.png?imageMogr2/format/webp)

最初のアプローチに従った場合、Dockerで`web1`サービスのコンテナを再実行します：

```
docker container start example-web1-1
```

フォールバックにresponse-rewriteプラグインを使用するには、ルートで設定する必要があります。以下は、`curl`コマンドを使用してプラグインを有効にする方法の例です：

```
curl "http://127.0.0.1:9180/apisix/admin/routes" -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" -X PUT -d '
{
   "id":"backend-service-route",
   "methods":[
      "GET"
   ],
   "uri":"/get",
   "plugins":{
      "response-rewrite":{
         "status_code":200,
         "body":"{\"message\":\"This is a fallback response when the service is unavailable\"}",
         "vars":[
            [
               "status",
               "==",
               503
            ]
         ]
      }
   },
   "upstream":{
      "nodes":{
         "web1:80":1
      }
   }
}'
```

上記の例では、このルートが一致したときにトラフィックが向けられる単一のバックエンドサービス（`web1:80`）を定義しました。アップストリームサービス（`web1:80`）が`503 Service Unavailable`ステータスで応答した場合、`response-rewrite`プラグインは応答を`200 OK`ステータスとカスタムJSON本文に変更します。これにより、アップストリームサービスが利用できない場合にフォールバック応答が作成されます。

> `"vars": [["status", "==", 503]]`: この条件は、応答の元のステータスコードが`503 Service Unavailable`の場合にのみプラグインがリライトを適用するように指示します。

ルートにリクエストを送信すると、変更された応答が得られるはずです：

```
curl "http://127.0.0.1:9080/get"

{"message":"This is a fallback response when the service is unavailable"}
```

## フォールバックメカニズムの実装における課題

フォールバックは、レジリエントなシステム設計の重要なコンポーネントです。しかし、誤って実装されると、さらに多くの問題を引き起こす可能性があります。フォールバック戦略について議論する際、単一マシン環境と分散システムの間で直面する課題は異なる場合があります。APISIXを使用してそれらを回避する方法を理解するために、例を挙げてそれらを確認しましょう。

### フォールバックロジックのテストの難しさ

単一マシンのコンテキストでは、データベースの障害などのアプリケーション障害条件を正確にシミュレートするのは困難です。分散システムでは、複数のマシンとサービスが関与するため、フォールバック戦略のテストはさらに複雑になり、すべての可能な障害モードを再現するのが難しくなります。たとえば、ローカルサーバー上のAPIは、データベースが到達不能な場合にキャッシュされた応答にフォールバックします。このシナリオをテストするには、データベースのダウンタイムをシミュレートする必要がありますが、これは通常のテストの一部ではないため、実際の本番負荷下でフォールバックコードがテストされない可能性があります。

APISIXは、フォールバック条件を含むさまざまなシナリオをシミュレートするためにトラフィックをルーティングするように設定できます。これにより、制御された条件下でフォールバックロジックをより現実的にテストし、フォールバックサービスが本番トラフィックを処理できることを確認できます。

### フォールバック自体が失敗する可能性

フォールバックソリューションが期待どおりにレジリエントでない場合、それが呼び出されたときに発生する増加した負荷に耐えられず、連鎖的な障害を引き起こす可能性があります。また、効率の低いサービスへのフォールバックは、応答時間と負荷を増加させ、システム全体の速度低下や停止を引き起こす可能性があります。たとえば、リモートロギングサービスが利用できない場合にローカルファイルシステムにログを書き込むフォールバックがあるAPIは、同期ファイルI/O操作によりパフォーマンスが低下する可能性があります。

APISIXを使用すると、重要なリクエストが最初に処理されるようにトラフィックを優先順位付けできます。これにより、フォールバックサービスが過負荷になり、システムのパフォーマンスが悪化するのを防ぐことができます。

### フォールバックには運用リスクがある

フォールバックを実装すると、プライマリと同期されていないセカンダリデータベースなどの新しい障害点が導入され、データの不整合が発生する可能性があります。

APISIXのロギング、メトリクス、トレースなどの監視機能を使用すると、プライマリとフォールバックサービスの健全性とパフォーマンスを監視できます。このリアルタイム監視により、フォールバック戦略に関連するリスクを特定して軽減することができます。

### フォールバックには潜在的なバグがある

フォールバックコードパスには、特定の障害条件下でのみ発生する非アクティブなバグが含まれている可能性があり、これらは頻繁に発生しないため、予測が難しく、数ヶ月または数年後に発見される可能性があります。たとえば、IDサービスが停止している間に異なる認証方法に切り替えるAPIのフォールバックメカニズムには、フォールバックがトリガーされたときにのみ現れるバグが含まれている可能性があり、これはまれなイベントである可能性があります。

APISIXは継続的なA/Bテストとカナリアリリースをサポートしており、チームは本番環境で少量のトラフィックを使用してフォールバックパスをテストできます。この継続的な露出により、潜在的なバグが重大になる前に発見されることがあります。

### フォールバックは頻繁に使用されない

フォールバックメカニズムは頻繁に使用されないため、トリガーされたときに期待どおりに動作しない可能性があります。たとえば、地理データを提供するAPIは、動的データソースが利用できない場合に静的データセットにフォールバックする場合があります。このフォールバックがまれに使用される場合、アクティブ化されたときに古い情報を提供する可能性があります。これは、定期的に更新またはテストされていないためです。

一方、APISIXを使用すると、動的ルーティングを設定し、定期的にトラフィックの一部をフォールバックサービスにリダイレクトすることができます。これにより、フォールバックパスが定期的に実行され、使用可能な状態に保たれます。

## 結論

フォールバックは、APIに問題が発生した場合の安全網です。APISIXのアップストリーム設定またはresponse-rewriteプラグインを使用することで、開発者は、システムが機能し続け、ユーザーとの信頼を維持するための思慮深くユーザーフレンドリーな応答を提供できます。重要なのは、潜在的な障害点を予測し、状況下で最良のエクスペリエンスを提供するフォールバックを設計することです。

### 関連リソース

- [API Gatewayを使用した10の一般的なAPIレジリエンス設計パターン](https://api7.ai/blog/10-common-api-resilience-design-patterns)
- [信頼性の高いAPIを構築するためのベストプラクティス](https://api7.ai/blog/best-practices-for-building-reliable-apis-with-api-gateways)

Tags:

[API Resilience](https://api7.ai/tags/api-resilience)

[API Fallback](https://api7.ai/tags/api-fallback)

Share article link

Share

Related Posts

[![APIライフサイクル管理：成功のための主要戦略](https://static.api7.ai/uploads/2025/02/19/gsEjQi5A_api-lifecycle-management.png)](https://api7.ai/blog/api-lifecycle-management-strategies)

## [APIライフサイクル管理：成功のための主要戦略](https://api7.ai/blog/api-lifecycle-management-strategies)

[![AIを活用したAPI管理の最大化：ベストプラクティスと洞察](https://static.api7.ai/uploads/2025/02/19/cVn3NoxN_maximize-api-management-with-ai.png)](https://api7.ai/blog/maximize-api-management-with-ai)

## [AIを活用したAPI管理の最大化：ベストプラクティスと洞察](https://api7.ai/blog/maximize-api-management-with-ai)

Table of Contents

- [APISIXを使用したフォールバックの実装](#apisix%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%9F%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%AE%E5%AE%9F%E8%A3%85)

  - [前提条件](#%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6)
  - [APISIX Dockerプロジェクトの開始](#apisix-docker%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E9%96%8B%E5%A7%8B)
  - [APISIXアップストリーム優先度を有効にしたフォールバック](#apisix%E3%82%A2%E3%83%83%E3%83%97%E3%82%B9%E3%83%88%E3%83%AA%E3%83%BC%E3%83%A0%E5%84%AA%E5%85%88%E5%BA%A6%E3%82%92%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%97%E3%81%9F%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF)
  - [APISIX Response Rewriteプラグインを使用したフォールバック](#apisix-response-rewrite%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%9F%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF)

- [フォールバックメカニズムの実装における課題](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%83%A1%E3%82%AB%E3%83%8B%E3%82%BA%E3%83%A0%E3%81%AE%E5%AE%9F%E8%A3%85%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E8%AA%B2%E9%A1%8C)

  - [フォールバックロジックのテストの難しさ](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%83%AD%E3%82%B8%E3%83%83%E3%82%AF%E3%81%AE%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E9%9B%A3%E3%81%97%E3%81%95)
  - [フォールバック自体が失敗する可能性](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E8%87%AA%E4%BD%93%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%99%E3%82%8B%E5%8F%AF%E8%83%BD%E6%80%A7)
  - [フォールバックには運用リスクがある](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%AB%E3%81%AF%E9%81%8B%E7%94%A8%E3%83%AA%E3%82%B9%E3%82%AF%E3%81%8C%E3%81%82%E3%82%8B)
  - [フォールバックには潜在的なバグがある](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%AB%E3%81%AF%E6%BD%9C%E5%9C%A8%E7%9A%84%E3%81%AA%E3%83%90%E3%82%B0%E3%81%8C%E3%81%82%E3%82%8B)
  - [フォールバックは頻繁に使用されない](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%AF%E9%A0%BB%E7%B9%81%E3%81%AB%E4%BD%BF%E7%94%A8%E3%81%95%E3%82%8C%E3%81%AA%E3%81%84)

- [結論](#%E7%B5%90%E8%AB%96)

  - [関連リソース](#%E9%96%A2%E9%80%A3%E3%83%AA%E3%82%BD%E3%83%BC%E3%82%B9)

## Related Posts

[![10个常见的API弹性设计模式与API Gateway](https://static.api7.ai/uploads/2024/12/25/2EIlR0a5_10-resilience-pattern-in-api-gateway.png)](https://api7.ai/ja/blog/10-common-api-resilience-design-patterns)

Technology

November 1, 2023

#### [10个常见的API弹性设计模式与API Gateway](https://api7.ai/ja/blog/10-common-api-resilience-design-patterns)

この記事では、10の一般的なAPIレジリエンス設計パターンと、それらをAPISIXを使用して実装する方法について探ります。

[API Resilience](https://api7.ai/tags/api-resilience)

[Design patterns](https://api7.ai/tags/design-patterns)

[Robust APIs](https://api7.ai/tags/robust-apis)

[![実世界におけるAPIゲートウェイの選定：技術評価プロセスの内側](https://static.api7.ai/uploads/2025/06/03/E7OqOddo_api-gateway-decision.webp)](https://api7.ai/ja/blog/api-gateway-decision-inside-technical-evaluation)

Technology

June 3, 2025

#### [実世界におけるAPIゲートウェイの選定：技術評価プロセスの内側](https://api7.ai/ja/blog/api-gateway-decision-inside-technical-evaluation)

実世界におけるAPIゲートウェイの評価プロセスを探り、Apache APISIXの柔軟性、パフォーマンス、オープンソースとしての利点を明らかにします。

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[![2025年Kong最新定价解析与最佳Kong替代方案](https://static.api7.ai/uploads/2025/03/10/FKRWNsq8_2025-kong-pricing.webp)](https://api7.ai/ja/blog/kong-konnect-pricing)

Technology

March 10, 2025

#### [2025年Kong最新定价解析与最佳Kong替代方案](https://api7.ai/ja/blog/kong-konnect-pricing)

Explore careful analytics of 2025 Kong Konnect pricing models and best Kong alternatives for enterprise API management.

[API Trends](https://api7.ai/tags/api-trends)

[API Management](https://api7.ai/tags/api-management)
