← Cloudflare Rules / rules / transform / url-rewrite / reference

Parametry přepsání URL

Statické a dynamické přepisy URL mají odlišné parametry:

• Statický přepis URL vyžaduje statickou hodnotu pro cílovou URL.
• Dynamický přepis URL vyžaduje výraz, jehož vyhodnocením se určí cílová URL.

Přepis URL se vzory se zástupnými znaky je zjednodušené rozhraní v Cloudflare dashboardu pro vytváření dynamických přepisů URL pomocí porovnávání a nahrazování pomocí zástupných znaků.

Maximální délka všech hodnot parametrů v přepisu URL (dohromady) je 4,096 znaků. Můžete například zadat statickou hodnotu (nebo výraz) pro cestu URI s délkou 2,048 znaků a statickou hodnotu (nebo výraz) pro řetězec dotazu s délkou 2,048 znaků.

Úplná syntaxe action_parameters pole pro pravidlo statického přepsání URL, které přepisuje cestu URI i řetězec dotazu, vypadá takto:

"action_parameters": {
  "uri": {
    "path": {
      "value": "<URI_PATH_VALUE>"
    },
    "query": {
      "value": "<QUERY_STRING_VALUE>"
    }
  }
}

Pokud přepisujete pouze cestu URI nebo query string, vynechejte query nebo path parametr.

Úplná syntaxe action_parameters pole pro pravidlo dynamického přepsání URL, které přepisuje cestu URI i řetězec dotazu, vypadá takto:

"action_parameters": {
  "uri": {
    "path": {
      "expression": "<URI_PATH_EXPRESSION>"
    },
    "query": {
      "expression": "<QUERY_STRING_EXPRESSION>"
    }
  }
}

Pokud přepisujete pouze cestu URI nebo query string, vynechejte query nebo path parametr.

Syntaxe dynamického pravidla přepisu URL, které přepisuje cestu URI i řetězec dotazu na základě porovnání a nahrazení zástupných znaků, je následující:

{
	"expression": "(http.request.full_uri wildcard r\"<REQUEST_URL>\")",
	"action_parameters": {
		"uri": {
			"path": {
				"expression": "wildcard_replace(http.request.uri.path, r\"<PATH_TARGET_PATH>\", r\"<PATH_REWRITE_TO>\")"
			},
			"query": {
				"expression": "wildcard_replace(http.request.uri.query, r\"<QUERY_TARGET_QUERY>\", r\"<QUERY_REWRITE_TO>\")"
			}
		}
	},
	"action": "rewrite"
	// ...
}

<REQUEST_URL>, <PATH_TARGET_PATH>, <PATH_REWRITE_TO>, <QUERY_TARGET_QUERY>, a <QUERY_REWRITE_TO> zástupné symboly hodnot odpovídají polím dostupným na dashboardu Cloudflare, když vyberete Vzor se zástupným znakem možnost. Další informace najdete v Parametry vzoru se zástupným znakem.

Stejné pravidlo může mít různé typy přepisů URL pro cestu URI i řetězec dotazu. Jedno pravidlo tak může provést dynamický přepis URL cesty URI a static přepis URL řetězce dotazu. Syntaxe takového pravidla by vypadala následovně:

"action_parameters": {
  "uri": {
    "path": {
      "expression": "<URI_PATH_EXPRESSION>"
    },
    "query": {
      "value": "<QUERY_STRING_VALUE>"
    }
  }
}