← Правила Cloudflare / rules / url-forwarding / bulk-redirects / reference

Параметры URL redirect

URL redirect содержит исходный URL, целевой URL, код состояния и ряд дополнительных параметров, которые влияют на сопоставление URL и поведение во время выполнения.

Поле API: source_url String

Строка URL, которой должен соответствовать URL входящего запроса, чтобы применилось перенаправление. Это свойство обязательно. Максимальная длина исходного URL составляет 32 КБ.

Значение должно быть корректным URL, но указывать схему URL не обязательно (например, https); если схема не указана, редирект применяется к обеим http и https схемы URL.

Bulk Redirect List не может содержать несколько URL redirect с одинаковым исходным URL. Точное поведение Алгоритм сопоставления URL, которое сопоставляет входящий запрос с исходным URL перенаправления, зависит от значений Включить поддомены и Сопоставление подпутей параметры.

Сведения о поддерживаемых компонентах URL см. в Поддерживаемые компоненты URL в Bulk Redirects.

Поле API: target_url String

URL, на который будет перенаправлен клиент при совпадении с URL redirect. Это свойство обязательно. Максимальная длина целевого URL составляет 32 КБ.

Значение должно быть корректным URL. Итоговый целевой URL зависит от значений Сохранять строку запроса и Сохранять суффикс пути параметры.

Сведения о поддерживаемых компонентах URL см. в Поддерживаемые компоненты URL в Bulk Redirects.

Поле API: subpath_matching Boolean по умолчанию: false

Если true, текущее перенаправление применит алгоритм сопоставления подпутей к URL запроса при определении, соответствует ли он текущему перенаправлению URL.

Например, перенаправление URL с /my-folder/ к /other-folder/ с Сопоставление подпутей при включении также перенаправляет запрос с /my-folder/item к /other-folder/item. Однако перенаправление будет включать только item часть, когда Сохранять суффикс пути это true.

Подробнее см. в Сопоставление исходного URL перенаправлений.

Поле API: include_subdomains Boolean по умолчанию: false

Если true, имя хоста исходного URL также будет применяться ко всем поддоменам: перенаправление будет соответствовать всем поддоменам слева от доменной части исходного URL, а также самому указанному домену.

Например, перенаправление с исходным URL, заданным как http://example.com/about также будет применяться к запросам с исходным URL-адресом http://a.example.com/about или http://a.b.example.com/about.

Подробнее см. в Сопоставление исходного URL перенаправлений.

Поле API: preserve_query_string Boolean по умолчанию: false

Если true, URL перенаправления сохранит строку запроса исходного запроса.

Например, перенаправление URL с /my-folder/ к /other-folder/ с Сохранять строку запроса при включении перенаправляет запрос с /my-folder/?name=value к /other-folder/?name=value. Если Сохранять строку запроса отключено, запрос будет перенаправлен с /my-folder/?name=value к /other-folder/.

Поле API: preserve_path_suffix Boolean по умолчанию: true

Применимо только если Сопоставление подпутей включено. Если true, определяет, что URL редиректа будет включать оставшиеся (не совпавшие) элементы пути исходного URL, если они есть.

Например, когда оба Сопоставление подпутей и Сохранять суффикс пути включены, перенаправление URL с /my-folder/ к /another-folder/ будет перенаправлять входящий запрос с /my-folder/foo к /another-folder/foo. Если Сохранять суффикс пути отключено, тот же запрос все равно будет соответствовать редиректу URL, но перенаправление будет с /my-folder/foo к /another-folder/.

Поле API: status_code Integer по умолчанию: 301
Значения API: 301, 302, 307, или 308.

Код состояния HTTP, возвращаемый клиенту при перенаправлении:

• 301: постоянное перенаправление: Страница окончательно перемещена на новый адрес. Для POST запросов клиент или браузер может изменить метод HTTP на GET при переходе по редиректу.
• 302: временное перенаправление: Страница временно перемещена на новый адрес. Для POST запросов клиент или браузер может изменить метод HTTP на GET при переходе по редиректу.
• 307: расширенный вариант, временное перенаправление с сохранением исходного метода HTTP: Страница временно перемещена на новый адрес. Клиент или браузер должен сохранить исходный HTTP метод (например, POST) при переходе по редиректу.
• 308: расширенный вариант, постоянное перенаправление с сохранением исходного метода HTTP: Страница окончательно перемещена на новый адрес. Клиент или браузер должен сохранить исходный HTTP метод (например, POST) при переходе по редиректу.