コンテンツにスキップ

利用可能な設定

以下のセクションでは、静的および動的URLリダイレクトを構成するためのリダイレクトルールの設定について説明します。

ワイルドカードURLリダイレクト

複数のリクエストに一致させるためにワイルドカードパターンを使用してURLリダイレクトを実行します。この方法は、複雑な式を必要とせずにソースおよびターゲットURLパターンを定義するのを簡素化します。

ワイルドカードURLリダイレクトには、以下の構成パラメータがあります。

  • Request URL: 複数のリクエストに一致させるためにアスタリスク(*)文字を使用してワイルドカードパターンを入力します。例えば、https://*.example.com/files/*

  • Target URL: ターゲットURLを入力します。これは静的(例えば、https://example.com)または動的(例えば、https://example.com/${1}/files/${2})であることができます。ワイルドカード置換を使用して、動的ターゲットを定義します(例:${1}${2}など)。

  • Status code: リダイレクトレスポンスのHTTPステータスコード(デフォルトは_301_)。次のいずれかでなければなりません:301(恒久的に移動)、302(見つかりました、一時的に移動とも呼ばれる)、307(一時的リダイレクト)、または_308_(恒久的リダイレクト)。

  • Preserve query string: リダイレクト時にクエリ文字列を保持するかどうか(デフォルトでは無効)。

静的URLリダイレクト

指定されたHTTPステータスコードで静的URLリダイレクトを実行し、オプションでクエリ文字列を保持します。

静的URLリダイレクトには、以下の構成パラメータがあります。

  • URL: リダイレクトレスポンスで返されるLocation HTTPヘッダーに使用されるリテラル文字列。

  • Status code: リダイレクトレスポンスのHTTPステータスコード(デフォルトは_301_)。次のいずれかでなければなりません:301(恒久的に移動)、302(見つかりました、一時的に移動とも呼ばれる)、307(一時的リダイレクト)、または_308_(恒久的リダイレクト)。

  • Preserve query string: リダイレクト時にクエリ文字列を保持するかどうか(デフォルトでは無効)。

API情報

静的URLリダイレクトを実行するリダイレクトルールの"action_parameters"フィールドの完全な構文は次のとおりです。

"action_parameters": {
"from_value": {
"target_url": {
"value": "<STATIC_URL_VALUE>"
},
"status_code": <STATUS_CODE>,
"preserve_query_string": <BOOLEAN_VALUE>
}
}

唯一の必須パラメータは<STATIC_URL_VALUE>です。

The optional parameters can have the following values:

  • "status_code" (integer): 301 (Moved permanently), 302 (Found, also known as Moved temporarily), 307 (Temporary redirect), or 308 (Permanent redirect).
  • "preserve_query_string" (boolean): true or false.

動的URLリダイレクト

式によってターゲットURLが決定される動的URLリダイレクトを実行します。リダイレクトHTTPステータスコードと、リダイレクト時にクエリ文字列を保持するかどうかを構成できます。

動的URLリダイレクトには、以下の構成パラメータがあります。

  • Expression: リダイレクトのターゲットURLを定義する。この式を評価した結果が、リダイレクトレスポンスで返されるLocation HTTPヘッダーに使用されます。フィールドおよび関数を参照して、式で使用できるものを確認してください。

  • Status code: リダイレクトレスポンスのHTTPステータスコード(デフォルトは_301_)。次のいずれかでなければなりません:301(恒久的に移動)、302(見つかりました、一時的に移動とも呼ばれる)、307(一時的リダイレクト)、または_308_(恒久的リダイレクト)。

  • Preserve query string: リダイレクト時にクエリ文字列を保持するかどうか(デフォルトでは無効)。

API情報

動的URLリダイレクトを実行するリダイレクトルールの"action_parameters"フィールドの完全な構文は次のとおりです。

"action_parameters": {
"from_value": {
"target_url": {
"expression": "<DYNAMIC_URL_EXPRESSION>"
},
"status_code": <STATUS_CODE>,
"preserve_query_string": <BOOLEAN_VALUE>
}
}

唯一の必須パラメータは<DYNAMIC_URL_EXPRESSION>です。

The optional parameters can have the following values:

  • "status_code" (integer): 301 (Moved permanently), 302 (Found, also known as Moved temporarily), 307 (Temporary redirect), or 308 (Permanent redirect).
  • "preserve_query_string" (boolean): true or false.