INTEGRITY Документация

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

Регионализированные привязки IP

Regionalized IP Bindings позволяют регионализировать трафик на уровне IP для префиксов, которые вы подключаете к Cloudflare через Использование собственного IP (BYOIP). Вы привязываете CIDR из одного из ваших префиксов к региону, и Cloudflare обрабатывает трафик, предназначенный для этих IP адресов, только в дата-центрах этого региона.

Это дополняет другие способы использования Regional Services: где Региональные имена хостов регионализируют трафик по хостнейму, тогда как Regionalized IP Bindings регионализируют трафик по IP-префиксу: этот вариант идеально подходит для развёртываний с address map и любых сервисов, к которым вы обращаетесь по IP, а не по хостнейму. Поскольку привязки полностью управляются через API, вы можете самостоятельно регионализировать широкие конфигурации после включения прав доступа, без необходимости настройки для каждой зоны со стороны команды по работе с аккаунтом.

Как это работает

Привязка префикса сопоставляет CIDR (внутри принадлежащего вам префикса BYOIP) с ключ региона (например, us или eu). После того как Cloudflare создаст привязку, трафик к адресам в этом CIDR завершает TLS и обрабатывается только внутри настроенного региона, следуя той же модели обработки внутри региона, описанной в Regional Services.

Привязки настраиваются через API Data Localization Suite в разделе /accounts/{account_id}/dls/.

Выберите, какой CIDR привязать

Привязка охватывает диапазон адресов внутри префикса, а не только один адрес, поэтому вам не не необходимо создать одну привязку для каждого IP-адреса. cidr который вы привязываете, должен:

Выбор CIDR зависит от того, как вы хотите разделить префикс между регионами:

Для каждого CIDR может быть только одна привязка. Если вы попытаетесь создать вторую привязку для CIDR, который уже привязан, API вернет ошибка конфликта. Чтобы изменить регион для существующей привязки, обновить его вместо создания нового.

Предварительные требования

Прежде чем создать привязку, убедитесь, что выполнены следующие условия:

Необходимые разрешения API-токена

Эти конечные точки авторизуются на уровне аккаунта. Необходимые разрешения зависят от операции:

Операция Необходимые разрешения токена
Просмотр регионов, получение региона, просмотр или получение привязок DLS: Read
Создать, обновить или удалить привязку префикса DLS: Write и IP Prefixes: Write

Операции записи требуют IP Prefixes: Write в дополнение к DLS: Write потому что привязка создаётся для префикса BYOIP, которым вы владеете в Адресация : Cloudflare проверяет, что у вас есть разрешение на изменение этого префикса. Токен только с DLS: Write может читать регионы и привязки, но получит отказ при попытке создать или изменить привязку.

Super Administrator и Administrator роли включают все эти разрешения. Пользовательская роль подойдёт, если она включает указанные выше группы разрешений.

Просмотреть доступные регионы

Каждая привязка ссылается на регион по его region_key (например, us или eu). Просмотрите список регионов, доступных для вашего аккаунта, чтобы найти действительный ключ.

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": ""
	}
}

Используйте type параметр запроса (managed или custom) для фильтрации результатов по тип региона. Результаты постранично разбиты, передайте cursor значение из ответа, чтобы получить следующую страницу.

Получить один регион

Получите регион по его region_key или ID.

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

Создать привязку префикса

Привяжите диапазон CIDR из одного из ваших префиксов BYOIP к региону. cidr должен находиться в пределах префикса, определённого prefix_id и быть более специфичный, чем сам префикс.

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"
	}
}

Обработать ошибку конфликта

Поскольку у каждого CIDR может быть только одна привязка, запрос на создание для CIDR, который уже привязан, завершается ошибкой HTTP 409 конфликт:

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

Эта ошибка возникает в двух случаях:

Чтобы устранить это:

Просмотреть привязки префиксов

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"

Обновить регион для привязки

Измените регион, на который указывает привязка. Изменить можно только region_key можно обновить. Чтобы изменить CIDR, удалите привязку и создайте новую.

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"
	}
}

Удалить привязку

Удалите привязку, чтобы прекратить регионализацию трафика для её 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
}