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

Objekty JSON API pro Bulk Redirects

Plně vyplněný objekt Bulk Redirect Rule má následující strukturu JSON:

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

Vlastnosti objektu JSON musí splňovat následující:

• action musí být redirect

• action_parameters musí obsahovat from_list objekt s dalšími nastaveními.

• from_list musí obsahovat následující vlastnosti:

  • name: Název existujícího Bulk Redirect List, který chcete přiřadit k aktuálnímu Bulk Redirect Rule.
  • key: Výraz, který definuje hodnotu porovnávanou se zdrojovými URL adresami nakonfigurovaného přesměrování URL, podle pravidel Algoritmus porovnávání URL adres. Viz Koncepty Bulk Redirects s dalšími informacemi.

• expression musí odkazovat na pole požadavku použité v key vlastnost. Viz Koncepty Bulk Redirects s dalšími informacemi.

Plně vyplněný objekt položky seznamu přesměrování URL má následující strukturu 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"
}

Podrobnosti o redirect vlastnosti objektu, viz Parametry přesměrování URL.