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

API Gateway:キャッシュコントロール

最終更新日:Sep 10, 2026

cache-control プラグインは、URL ファイルのサフィックスに基づいて Expires および Cache-Control レスポンスヘッダーを追加し、jpg や png などの静的リソースのブラウザキャッシュを有効にします。

実行属性

実行ステージ: 権限付与。 実行優先度: 200。

フィールド

フィールド

データ型

必須

デフォルト値

説明

suffix

string

いいえ。 照合するファイルのサフィックス (例: jpg、png)。

複数のサフィックスを照合するには、縦棒 (|) で区切ります。 例: png|jpg。

指定しない場合、すべてのサフィックスが照合されます。

-

照合するファイルのサフィックス。

expires

string

はい。 最大キャッシュ期間。

数値を指定する場合、単位は秒です。 たとえば、1 時間の場合は 3600 と入力します。

特別な値である エポック と max もサポートされています。

nginx と同じセマンティクスです。

-

照合されたファイルの最大キャッシュ期間。

設定例

  1. サフィックスが jpg、png、または jpeg のファイルを 1 時間キャッシュします:

    suffix: jpg|png|jpeg
    expires: 3600

    この設定により、次のようなリクエストに対するレスポンスに Expires および Cache-Control ヘッダーが追加され、照合されたファイルが 1 時間キャッシュされます:

    curl http://example.com/test.png
    curl http://example.com/test.jpg
  2. すべてのファイルを Thu, 31 Dec 2037 23:55:55 GMT までキャッシュします:

    expires: max