← Cloudflare DDoS Protection / ddos-protection / advanced-ddos-systems / api

Advanced TCP Protection

Вы можете настроить Advanced TCP Protection с помощью Advanced TCP Protection API.

API Advanced TCP Protection поддерживает только Аутентификация по API-токену.

Примеры вызовов API см. в Типичные вызовы API.

Конечные точки

Чтобы получить полный адрес конечной точки, добавьте перечисленные ниже конечные точки API Advanced TCP Protection к базовому URL API Cloudflare.

Базовый URL-адрес Cloudflare API:

https://api.cloudflare.com/client/v4

{account_id} аргумент представляет собой account ID (шестнадцатеричная строка). Это значение можно найти в панели управления Cloudflare.

В таблицах в следующих разделах приведены доступные операции.

Общие операции

Операция	Метод и конечная точка / Описание
Получить статус Advanced TCP Protection	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status` Возвращает глобальный статус Advanced TCP Protection (включён или отключён).
Обновление статуса Advanced TCP Protection	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status` Включает или отключает Advanced TCP Protection.

Операции с префиксами

Операция	Метод и конечная точка / Описание
Получить список префиксов	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes` Получает все префиксы Advanced TCP Protection в аккаунте.
Добавить префиксы пакетно	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/bulk` Добавляет в аккаунт несколько префиксов одновременно (до 300 префиксов за один запрос).
Получить префикс	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` Получает сведения о существующем префиксе.
Обновить префикс	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` Обновляет существующий префикс.
Удаление префикса	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` Удаляет существующий префикс.
Удаление всех префиксов	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes` Удаляет все существующие префиксы из аккаунта.

Операции с allowlist

Операция	Метод и конечная точка / Описание
Получить список разрешённых префиксов	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` Получает все префиксы из списка разрешений аккаунта.
Добавить префикс в allowlist	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` Добавляет префикс в allowlist.
Получить префикс из allowlist	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` Получает сведения о существующем префиксе в списке разрешений.
Обновить префикс из белого списка	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` Обновляет существующий префикс в белом списке.
Удаление префикса из списка разрешенных	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` Удаляет существующий префикс из списка разрешенных.
Удаление всех префиксов из списка разрешенных	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` Удаляет все существующие префиксы из списка разрешенных.

Операции SYN Flood Protection

Правила

Операция	Метод и конечная точка / Описание
Получить список правил SYN flood	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` Получает все правила SYN-флуда в аккаунте.
Добавить правило SYN-флуда	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` Добавляет в аккаунт правило SYN flood.
Получить правило SYN-флуда	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` Получает сведения о существующем правиле SYN-флуда в аккаунте.
Обновить правило SYN flood	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` Обновляет существующее правило SYN flood в аккаунте.
Удаление правила SYN-флуда	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` Удаляет существующее правило SYN-флуда из аккаунта.
Удаление всех правил SYN-флуда	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` Удаляет все существующие правила SYN-флуда из аккаунта.

Фильтры

Операция	Метод и конечная точка / Описание
Получить список фильтров SYN flood	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` Получает все фильтры SYN-флуда в аккаунте.
Добавить фильтр SYN-флуда	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` Добавляет в аккаунт фильтр SYN flood.
Получить фильтр SYN-флуда	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` Получает сведения о существующем фильтре SYN-флуда в аккаунте.
Обновить фильтр SYN flood	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` Обновляет существующий фильтр SYN flood в аккаунте.
Удаление фильтра SYN-флуда	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` Удаляет существующий фильтр SYN-флуда из аккаунта.
Удаление всех фильтров SYN-флуда	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` Удаляет все существующие фильтры SYN-флуда из аккаунта.

Операции Out-of-state TCP Protection

Правила

Операция	Метод и конечная точка / Описание
Получить список правил out-of-state TCP	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` Получает все правила TCP вне состояния соединения в аккаунте.
Добавить правило out-of-state TCP	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` Добавляет в аккаунт правило out-of-state TCP.
Получить правило out-of-state TCP	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` Получает сведения о существующем правиле TCP вне состояния соединения в аккаунте.
Обновить правило out-of-state TCP	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` Обновляет существующее правило out-of-state TCP в аккаунте.
Удаление правила для TCP вне состояния соединения	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` Удаляет существующее правило для TCP вне состояния соединения из аккаунта.
Удаление всех правил для TCP вне состояния соединения	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` Удаляет все существующие правила для TCP вне состояния соединения из аккаунта.

Фильтры

Операция	Метод и конечная точка / Описание
Получить список фильтров out-of-state TCP	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` Получает все фильтры TCP вне состояния соединения в аккаунте.
Добавить фильтр out-of-state TCP	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` Добавляет в аккаунт фильтр out-of-state TCP.
Получить фильтр out-of-state TCP	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` Получает сведения о существующем фильтре TCP вне состояния соединения в аккаунте.
Обновить фильтр out-of-state TCP	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` Обновляет существующий фильтр out-of-state TCP в аккаунте.
Удаление фильтра для TCP вне состояния соединения	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` Удаляет существующий фильтр для TCP вне состояния соединения из аккаунта.
Удаление всех фильтров для TCP вне состояния соединения	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` Удаляет все существующие фильтры для TCP вне состояния соединения из аккаунта.

Пагинация

Операции API, возвращающие список элементов, используют постраничную навигацию. Подробнее о доступных параметрах запроса для постраничной навигации см. в Пагинация.