翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
オリジンリクエストの制御
へのビューワーリクエスト CloudFront によってキャッシュミスが発生すると (リクエストされたオブジェクトはエッジロケーションでキャッシュされません)、 はオブジェクトを取得するリクエストをオリジン CloudFront に送信します。これは、オリジンリクエストと呼ばれます。オリジンリクエストには、ビューワークエストの次の情報が常に含まれます。
-
URL パス (URL クエリ文字列またはドメイン名を含まないパスのみ)
-
リクエストボディ (存在する場合)
-
、、 など
User-Agent
、すべてのオリジンリクエストに自動的に CloudFront 含まれる HTTPHost
ヘッダーX-Amz-Cf-Id
ビューワーリクエストのその他の情報 (URL クエリ文字列、HTTP ヘッダー、Cookie など) は、デフォルトではオリジンリクエストに含まれません。(例外: レガシーキャッシュ設定では、 はデフォルトでヘッダーをオリジン CloudFront に転送します)。ただし、分析やテレメトリーのためにデータを収集するなど、オリジンでこのその他の情報を受信することができます。オリジンリクエストポリシー を使用して、オリジンリクエストに含まれる情報を制御できます。
オリジンリクエストポリシーは、キャッシュキーを制御するキャッシュポリシーとは別のものです。この分離により、オリジンで追加情報を受信し、適切なキャッシュヒット率 (キャッシュヒットとなるビューワーリクエストの割合) を維持することができます。これを行うには、オリジンリクエストに含める情報 (オリジンリクエストポリシーを使用) とキャッシュキーに含める情報 (キャッシュポリシーを使用) を個別に制御します。
2 種類のポリシーは別々のものですが、関連性があります。キャッシュキーに含めるすべての URL クエリ文字列、HTTP ヘッダー、および Cookie (キャッシュポリシーを使用) は、オリジンリクエストに自動的に含まれます。オリジンリクエストポリシーを使用して、オリジンリクエストに含めるが、キャッシュキーには含めない情報を指定します。キャッシュポリシーと同様に、オリジンリクエストポリシーを CloudFront ディストリビューションの 1 つ以上のキャッシュ動作にアタッチします。
オリジンリクエストポリシーを使用して、ビューワーリクエストに含まれていないオリジンリクエストに追加の HTTP ヘッダーを追加することもできます。これらの追加のヘッダーは、オリジンリクエストを送信する CloudFront 前に によって追加され、ビューワーリクエストに基づいて自動的に決定されるヘッダー値が含まれます。詳細については、「 CloudFront リクエストヘッダーの追加」を参照してください。
トピック
オリジンリクエストポリシーの作成
オリジンリクエストポリシーを使用して、 がオリジン CloudFront に送信するリクエストに含まれる値 (URL クエリ文字列、HTTP ヘッダー、Cookie) を制御できます。オリジンリクエストポリシーは、 CloudFront コンソール、 AWS Command Line Interface (AWS CLI)、または CloudFront API を使用して作成できます。
オリジンリクエストポリシーを作成したら、ディス CloudFront トリビューションの 1 つ以上のキャッシュ動作にアタッチします。
オリジンリクエストポリシーは必須ではありません。キャッシュ動作にオリジンリクエストポリシーがアタッチされていない場合、オリジンリクエストには、キャッシュポリシーで指定されたすべての値が含まれますが、それ以上は含まれません。
注記
オリジンリクエストポリシーを使用するには、キャッシュ動作でもキャッシュポリシーを使用する必要があります。キャッシュポリシーがないと、キャッシュ動作でオリジンリクエストポリシーを使用することはできません。
オリジンリクエストポリシーについて
CloudFront では、一般的なユースケース向けに、管理ポリシー と呼ばれる事前定義されたオリジンリクエストポリシーを提供しています。これらのマネージドポリシーを使用することも、ユーザーのニーズ別に独自のオリジンリクエストポリシーを作成することもできます。マネージドポリシーの詳細については、「管理オリジンリクエストポリシーの使用」を参照してください。
オリジンリクエストポリシーには以下の設定が含まれます。設定は、ポリシー情報と オリジンリクエスト設定に分類されます。
ポリシー情報
- 名前
-
オリジンリクエストポリシーを識別する名前。コンソールでは、名前を使用して、オリジンリクエストポリシーをキャッシュ動作にアタッチします。
- 説明
-
オリジンリクエストポリシーを説明するコメント。これはオプションです。
オリジンリクエスト設定
オリジンリクエスト設定では、 がオリジン CloudFront に送信するリクエスト (オリジンリクエストと呼ばれる) に含まれるビューワーリクエストの値を指定します。値には、URL クエリ文字列、HTTP ヘッダー、および Cookie を含めることができます。指定した値は、オリジンリクエストに含まれますが、キャッシュキーには含まれません。キャッシュキーの制御については、「キャッシュキーの管理」を参照してください。
- ヘッダー
-
オリジンリクエストに含まれるビューワーリクエスト CloudFront の HTTP ヘッダー。ヘッダーには、以下のいずれかの設定を選択できます。
-
[Note (なし)] – ビューワーリクエストの HTTP ヘッダーは、オリジンリクエストに含まれません。
-
[All viewer headers (すべてのビューワーヘッダー)] – ビューワーリクエストのすべての HTTP ヘッダーは、オリジンリクエストに含まれます。
-
すべてのビューワーヘッダーと以下の CloudFrontヘッダー – ビューワーリクエストのすべての HTTP ヘッダーは、オリジンリクエストに含まれます。さらに、オリジンリクエストに追加する CloudFront ヘッダーを指定します。 CloudFront ヘッダーの詳細については、「」を参照してください CloudFront リクエストヘッダーの追加。
-
[次のヘッダーを含める] – オリジンリクエストに含める HTTP ヘッダーを指定します。
注記
[オリジンのカスタムヘッダー] 設定に既に含まれているヘッダーを指定しないでください。詳細については、「オリジンリクエスト CloudFront にカスタムヘッダーを追加するための の設定」を参照してください。
-
[以下を除くすべてのビューワーヘッダー] — オリジンリクエストに含まれない HTTP ヘッダーを指定します。指定されたものを除いて、ビューワーリクエストの他のすべての HTTP ヘッダーが含まれます。
すべてのビューワーヘッダーと次の CloudFront ヘッダー 、次のヘッダー を含める、または 設定を除くすべてのビューワーヘッダーを使用する場合、ヘッダー名のみで HTTP ヘッダーを指定します。オリジンリクエストには、その値を含む完全なヘッダー CloudFront が含まれます。
注記
設定以外のすべてのビューワーヘッダーを使用してビューワーの
Host
ヘッダーを削除すると、 はオリジンのドメイン名を含む新しいHost
ヘッダーをオリジンリクエスト CloudFront に追加します。 -
- Cookie
-
オリジンリクエストに含まれるビューワーリクエスト CloudFront の Cookie。Cookie には、以下のいずれかの設定を選択できます。
-
[None (なし)] – ビューワーリクエストの Cookie は、オリジンリクエストに含まれません。
-
[All (すべて)] – ビューワーリクエストのすべての Cookie は、オリジンリクエストに含まれます。
-
[次のヘッダーを含める] – ビューワーリクエストのどの Cookie をオリジンリクエストに含めるかを指定します。
-
[次を除くすべての Cookie] – ビューワーリクエストのどの Cookie をオリジンリクエストに含めないかを指定します。ビューワーリクエストの他のすべての Cookie が含まれます。
次の Cookie を含める または 設定を除くすべての Cookie を使用する場合は、名前のみを使用して Cookie を指定します。オリジンリクエストには、その値を含む完全な Cookie CloudFront が含まれます。
-
- クエリ文字列
-
オリジンリクエストに含まれるビューワーリクエスト CloudFront の URL クエリ文字列。クエリ文字列には、以下のいずれかの設定を選択できます。
-
[None (なし)] – ビューワーリクエストのクエリ文字列は、オリジンリクエストに含まれません。
-
[All (すべて)] – ビューワーリクエストのすべてのクエリ文字列は、オリジンリクエストに含まれます。
-
[次のクエリ文字列を含める] - ビューワーリクエストのどのクエリ文字列をオリジンリクエストに含めるかを指定します。
-
[次を除くすべてのクエリ文字列] - ビューワーリクエストのどのクエリ文字列をオリジンリクエストに含めないかを指定します。その他すべてのクエリ文字列が含まれます。
次のクエリ文字列を含めるまたは設定以外のすべてのクエリ文字列を使用する場合は、名前のみを使用してクエリ文字列を指定します。オリジンリクエストには、その値を含む完全なクエリ文字列 CloudFront が含まれます。
-