← Data Localization Suite / data-localization / regional-services

Regionalizované vazby IP

Regionalized IP Bindings umožňují regionalizovat provoz na úrovni IP u prefixů, které do Cloudflare přinášíte prostřednictvím Bring Your Own IP (BYOIP). CIDR z jednoho ze svých prefixů svážete s regionem a Cloudflare pak provoz směřující na tyto IP adresy zpracovává pouze v datových centrech daného regionu.

Toto doplňuje další způsoby, jak používat Regional Services: kde Regionální hostitelské názvy regionalizují provoz podle hostname, zatímco Regionalized IP Bindings regionalizují provoz podle IP prefixu, což je ideální pro nasazení s address maps a pro jakoukoli službu, ke které přistupujete podle IP adresy, a ne podle hostname. Protože se bindingy spravují výhradně přes API, můžete si rozsáhlé konfigurace regionalizovat sami, jakmile jsou vaše oprávnění povolena, bez nutnosti nastavení jednotlivých zón vaším account týmem.

Vazba prefixu mapuje CIDR (v rámci prefixu BYOIP, který vlastníte) na klíč regionu (například us nebo eu). Poté, co Cloudflare vazbu zřídí, se provoz na adresy v daném CIDR ukončuje po stránce TLS a zpracovává se pouze uvnitř nakonfigurovaného regionu, podle stejného modelu zpracování v rámci regionu popsaného v Regional Services.

Bindings jsou spravovány prostřednictvím API Data Localization Suite v části /accounts/{account_id}/dls/.

Vazba pokrývá rozsah adres v rámci prefixu, nikoli jen jednu adresu, ne je nutné vytvořit jeden binding pro každou IP adresu. Tento cidr který vážete, musí:

• Spadají do prefixu určeného prefix_id.
• Buďte specifičtější než samotný prefix : dílčí rozsah v jeho rámci. Například v rámci /24 prefixu můžete navázat libovolný rozsah z /25 až na jedinou adresu (tedy /32 pro IPv4, nebo /128 pro IPv6). Vytvoření bindingu pro celý prefix (tedy celý /24) je odmítnuta s chybou chyba konfliktu, protože celý rozsah prefixu je po zveřejnění Cloudflare již obsazen.

Výběr CIDR závisí na tom, jak chcete rozdělit prefix mezi jednotlivé regiony:

• Jeden region pro celý prefix : pokryjte prefix dílčími rozsahy, které všechny směřují do stejného regionu. Svažte například oba 203.0.113.0/25 a 203.0.113.128/25 na eu k regionalizaci každé adresy v /24.
• Různé regiony pro různé adresy : svažte každý rozsah s požadovaným regionem, například 203.0.113.0/25 na eu a 203.0.113.128/25 na us). Cloudflare uplatní nejkonkrétnější vazbu, která dané adrese odpovídá, takže užší vazba má přednost před širší, se kterou se překrývá.

Každý CIDR může mít pouze jednu vazbu. Pokud se pokusíte vytvořit druhou vazbu pro CIDR, který už je svázán, API vrátí chyba konfliktu. Chcete-li změnit region u existující vazby, aktualizovat ho místo vytváření nového.

Než vytvoříte binding, ujistěte se, že:

• Váš účet má zároveň Regional Services a Regional Services for BYOIP povolená oprávnění. Pokud je chcete povolit, obraťte se na svůj account tým.
• Máte zaregistrovali jste prefix BYOIP Cloudflare a znáte jeho prefix ID.
• Region, který chcete použít, existuje pro váš účet. Přečtěte si Zobrazit dostupné regiony.
• Váš API token má potřebná oprávnění. Informace najdete v Požadovaná oprávnění API tokenu.

Tyto endpointy jsou autorizovány na úrovni účtu. Oprávnění, která potřebujete, závisí na dané operaci:

Zápisové operace vyžadují IP Prefixes: Write kromě DLS: Zápis protože je vazba vytvořena vůči prefixu BYOIP, který vlastníte v Adresování : Cloudflare ověří, že máte oprávnění tento prefix upravovat. Token pouze s oprávněním DLS: Zápis může číst regiony a vazby, ale při pokusu o vytvoření nebo změnu vazby bude odmítnut.

Super Administrator a Administrator role zahrnují všechna tato oprávnění. Vlastní role funguje, pokud zahrnuje výše uvedené skupiny oprávnění.

Každá vazba odkazuje na region podle jeho region_key (například us nebo eu). Platný klíč zjistíte tak, že si vypíšete regiony dostupné pro váš účet.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regions" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": [
		{
			"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
			"name": "Europe",
			"region_key": "eu",
			"created_on": "2026-01-13T23:59:45.276558Z",
			"modified_on": "2026-01-13T23:59:45.276558Z",
			"version": 1,
			"version_created_on": "2026-01-13T23:59:45.276558Z"
		}
	],
	"result_info": {
		"count": 1,
		"per_page": 25,
		"cursor": ""
	}
}

Použijte type parametr dotazu (managed nebo custom) k filtrování výsledků podle typ regionu. Výsledky jsou stránkované, předejte cursor z odpovědi, abyste načetli další stránku.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regions/eu" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Přiřaďte CIDR z jednoho ze svých prefixů BYOIP k regionu. Tento cidr musí spadat do prefixu určeného prefix_id a být specifičtější než samotný prefix.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regional_services/prefix_bindings" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"prefix_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"cidr": "203.0.113.0/25",
		"region_key": "eu"
	}'

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": {
		"id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
		"prefix_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"cidr": "203.0.113.0/25",
		"region_key": "eu"
	}
}

Protože každý blok CIDR může mít pouze jednu vazbu, požadavek na vytvoření pro CIDR, který je již svázán, selže s chybou HTTP 409 konflikt:

{
	"result": null,
	"success": false,
	"errors": [
		{
			"code": 1108,
			"message": "conflict: binding already exists for CIDR 203.0.113.0/24"
		}
	],
	"messages": []
}

K této chybě dochází ve dvou případech:

• Pokusili jste se vytvořit binding pro celý prefix. Celý rozsah prefixu (například celý /24) je po zveřejnění vašeho prefixu Cloudflare již obsazena, takže ji nelze svázat s regionem přímo. Místo toho svažte konkrétnější rozsah v rámci prefixu, například /25 až na jediný /32 : a pokryjte prefix několika dílčími rozsahy, pokud potřebujete regionalizovat všechny jeho adresy.
• Tento CIDR je již navázán. Vazba pro tento přesný rozsah již existuje, například z dřívějšího úspěšného požadavku.

Řešení:

• Zobrazte si existující vazby a zjistíte, co je již nakonfigurováno.
• Chcete-li přesunout existující navázání do jiného regionu, aktualizovat ho místo vytváření nového.
• Chcete-li navázat jiný rozsah, zvolte CIDR, který ještě není navázán. Chcete-li nahradit existující navázání jiným CIDR, odstranit ho a poté vytvořte nový.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regional_services/prefix_bindings" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": [
		{
			"id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
			"prefix_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
			"cidr": "203.0.113.0/25",
			"region_key": "eu"
		}
	],
	"result_info": {
		"count": 1,
		"per_page": 25,
		"cursor": ""
	}
}

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regional_services/prefix_bindings/%7Bbinding_id%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Změňte region, na který binding ukazuje. Pouze region_key lze aktualizovat. Chcete-li změnit CIDR, smažte vazbu a vytvořte novou.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regional_services/prefix_bindings/%7Bbinding_id%7D" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"region_key": "us"
	}'

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": {
		"id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
		"prefix_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"cidr": "203.0.113.0/25",
		"region_key": "us"
	}
}

Odstraňte binding, čímž zastavíte regionalizaci provozu pro jeho CIDR.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/dls/regional_services/prefix_bindings/%7Bbinding_id%7D" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": null
}

• Regional Services : přehled a model zpracování v rámci regionu.
• Dostupné regiony a podpora produktů : úplný seznam regionů a jejich definic.
• Bring Your Own IP (BYOIP) : zaregistrujte si vlastní prefixy IP adres u Cloudflare.