INTEGRITY Dokumentace

← Cloudflare Rules / rules / url-forwarding / bulk-redirects / reference

Parametry přesměrování URL

Přesměrování URL má zdrojovou URL, cílovou URL, stavový kód a několik dalších parametrů, které ovlivňují chování při shodě URL a chování za běhu.

Zdrojová URL

Pole API: source_url String

Řetězec URL, kterému musí odpovídat URL příchozího požadavku, aby se přesměrování použilo. Tato vlastnost je povinná. Maximální délka zdrojové URL je 32 KB.

Hodnota musí být platná URL, schéma URL však není povinné (například https); pokud schéma chybí, přesměrování platí pro obě http a https schémata URL.

Bulk Redirect List nemůže obsahovat více přesměrování URL se stejnou zdrojovou URL. Přesné chování Algoritmus porovnávání URL adres, které porovnává příchozí požadavek se zdrojovou URL adresou přesměrování, závisí na hodnotách Zahrnout subdomény a Porovnávání podcest parametry.

Další informace o podporovaných komponentách URL naleznete v Podporované komponenty URL v Bulk Redirects.

Cílová URL

Pole API: target_url String

URL, na kterou bude klient přesměrován při shodě s přesměrováním URL. Tato vlastnost je povinná. Maximální délka cílové URL je 32 KB.

Hodnota musí být platná URL. Konečná cílová URL závisí na hodnotách Preserve query string a Preserve path suffix parametry.

Další informace o podporovaných komponentách URL naleznete v Podporované komponenty URL v Bulk Redirects.

Porovnávání podcest

Pole API: subpath_matching Boolean výchozí: false

Pokud true, aktuální přesměrování při zjišťování shody použije na URL adresu požadavku algoritmus porovnávání podcest.

Například přesměrování URL z /my-folder/ na /other-folder/ hodnotou Porovnávání podcest po povolení také přesměruje požadavek z /my-folder/item na /other-folder/item. Přesměrování však bude obsahovat pouze item část, když Preserve path suffix je true.

Další informace najdete v tématu Porovnávání zdrojové adresy URL přesměrování.

Zahrnout subdomény

Pole API: include_subdomains Boolean výchozí: false

Pokud true, název hostitele zdrojové URL adresy se vztahuje i na všechny subdomény: přesměrování bude odpovídat všem subdoménám nalevo od doménové části zdrojové URL adresy i uvedené doméně samotné.

Například přesměrování se zdrojovou URL definovanou jako http://example.com/about se použije i na požadavky se zdrojovou URL adresou http://a.example.com/about nebo http://a.b.example.com/about.

Další informace najdete v tématu Porovnávání zdrojové adresy URL přesměrování.

Preserve query string

Pole API: preserve_query_string Boolean výchozí: false

Pokud true, URL adresa přesměrování zachová řetězec dotazu původního požadavku.

Například přesměrování URL z /my-folder/ na /other-folder/ hodnotou Preserve query string po povolení přesměruje požadavek z /my-folder/?name=value na /other-folder/?name=value. Pokud Preserve query string je vypnuto, požadavek bude přesměrován z /my-folder/?name=value na /other-folder/.

Preserve path suffix

Pole API: preserve_path_suffix Boolean výchozí: true

Platí pouze v případě, že Porovnávání podcest je zapnuto. Pokud true, určuje, že cílová URL adresa přesměrování bude obsahovat zbývající (neshodující se) prvky cesty zdrojové URL adresy, pokud nějaké existují.

Například když jsou obě Porovnávání podcest a Preserve path suffix jsou povoleny, přesměrování URL z /my-folder/ na /another-folder/ přesměruje příchozí požadavek z /my-folder/foo na /another-folder/foo. Pokud Preserve path suffix je vypnuto, stejný požadavek by stále odpovídal URL redirect, ale přesměrování by proběhlo z /my-folder/foo na /another-folder/.

Stavový kód

Pole API: status_code Integer výchozí: 301
Hodnoty API: 301, 302, 307, nebo 308.

Stavový kód HTTP vrácený klientovi při přesměrování: