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

Объекты JSON API Bulk Redirects

Полностью заполненный объект Bulk Redirect Rule имеет следующую структуру JSON:

{
	"action": "redirect",
	"expression": "http.request.full_uri in $<LIST_NAME>",
	"action_parameters": {
		"from_list": {
			"name": "<LIST_NAME>",
			"key": "http.request.full_uri"
		}
	}
}

Свойства объекта JSON должны соответствовать следующим требованиям:

• action должен быть redirect

• action_parameters должен содержать from_list объект с дополнительными настройками.

• from_list должен содержать следующие свойства:

  • name: Имя существующего Bulk Redirect List, который нужно связать с текущим Bulk Redirect Rule.
  • key: выражение, которое определяет значение для сопоставления с исходным URL-адресом настроенного перенаправления URL, согласно правилам Алгоритм сопоставления URL. См. Основные понятия Bulk Redirects, где это описано подробнее.

• expression должен ссылаться на поле запроса, используемое в key свойство. См. Основные понятия Bulk Redirects, где это описано подробнее.

Полностью заполненный объект элемента списка URL redirect имеет следующую структуру JSON:

{
	"id": "7c5dae5552338874e5053f2534d2767a",
	"redirect": {
		"source_url": "https://example.com/blog",
		"target_url": "https://example.com/blog/latest",
		"status_code": 301,
		"include_subdomains": false,
		"subpath_matching": false,
		"preserve_query_string": false,
		"preserve_path_suffix": true
	},
	"created_on": "2021-10-11T12:39:02Z",
	"modified_on": "2021-10-11T12:39:02Z"
}

Подробнее о redirect свойств объекта см. в Параметры URL redirect.