nat.php¶

Модуль управления статическим NAT: добавление и удаление правил проброса IP-адресов через MikroTik.

Методы API¶

Метод	Действие	Описание
`add_static_nat`	добавление статического NAT	Добавляет статический NAT passthrough для указанного сервера. Принимает ID сервера и ACL для IPMI.
`remove_static_nat`	удаление статического NAT	Удаляет статический NAT passthrough для указанного сервера или белого IP.

nat/add_static_nat¶

Добавляет статический NAT passthrough для указанного сервера. Принимает ID сервера и ACL для IPMI.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `add_static_nat`
token	✅	string	Токен авторизации
id	✅	int	ID сервера (внутри `params[]` или на верхнем уровне)
ip_acl	✅	string	ACL для IPMI в формате IP/CIDR (например, 192.168.1.1/24)
ttl	❌	int	Время жизни правила в часах (по умолчанию 2, макс 24)

Пример запроса

curl -s "https://invapi.hostkey.ru/nat" -X POST \
--data "action=add_static_nat" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE" \
--data "ip_acl=VALUE"

Пример успешного ответа

{
  "result": "OK",
  "action": "add_static_nat",
  "callback": "7bc29eb23fb1b879b21fce509597f07c"
}

Примеры ошибок

{
  "code": -1,
  "message": "NAT/add_static_nat: invalid server id"
}

nat/remove_static_nat¶

Удаляет статический NAT passthrough для указанного сервера или белого IP.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `remove_static_nat`
token	✅	string	Токен авторизации
id	✅	int	ID сервера
white_ip	❌	string	Белый IP для удаления правила

Пример запроса

curl -s "https://invapi.hostkey.ru/nat" -X POST \
--data "action=remove_static_nat" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE"

Пример успешного ответа

{
  "result": "OK",
  "action": "remove_static_nat",
  "callback": "7bc29eb23fb1b879b21fce509597f07c"
}

Примеры ошибок

{
  "code": -1,
  "message": "NAT/remove_static_nat: invalid server id"
}