IP-адреса
Маршруты раздела «IP-адреса» для интеграции Cloud API.
Список IP-адресов
Включает назначенные и сохранённые адреса. attachment=unattached выбирает сохранённые адреса с vm_id=null. Своя цена продления и автопродление есть только у отдельно оплачиваемых IPv4; у включённых основных IPv4 и IPv6 поля оплаты могут быть null. Цены фиксированные, без наценки.
Расчёт аренды IPv4 без VPS
Один IPv4 в выбранной локации, без VPS и выбора кластера. Срок 1/3/6/12/24/36 календарных месяцев (по умолчанию 1). Цена — фиксированная месячная ставка из GET /plans × months, без наценки и скидки. Адрес принадлежит api_user_id. auto_renew=false по умолчанию; при включении продление на последний оплаченный срок по актуальной цене.
Аренда IPv4 без VPS
Один IPv4 в выбранной локации, без VPS и выбора кластера. Срок 1/3/6/12/24/36 календарных месяцев (по умолчанию 1). Цена — фиксированная месячная ставка из GET /plans × months, без наценки и скидки. Адрес принадлежит api_user_id. auto_renew=false по умолчанию; при включении продление на последний оплаченный срок по актуальной цене.
Рассчитать покупку IPv4
Покупает один дополнительный IPv4 на months=1/3/6/12/24/36 календарных месяцев (по умолчанию 1) и назначает его VPS. Цена — фиксированная месячная ставка × months, без наценки интеграции и скидки за срок. Оплата и автопродление адреса независимы от VPS. Не более 10 IPv4 на VPS, включая основной.
Купить IPv4
Покупает один дополнительный IPv4 на months=1/3/6/12/24/36 календарных месяцев (по умолчанию 1) и назначает его VPS. Цена — фиксированная месячная ставка × months, без наценки интеграции и скидки за срок. Оплата и автопродление адреса независимы от VPS. Не более 10 IPv4 на VPS, включая основной.
Назначить сохранённый IPv4
Назначает свободный оплаченный сохранённый IPv4 совместимому VPS без новой покупки и изменения срока. api_key_id передаётся в query, JSON-тела нет. Проверяйте guest_configuration_required: может потребоваться обновить сеть внутри гостевой ОС.
Снять IPv4
Снимает дополнительный IPv4; основной снять нельзя. keep_ip обязателен в query: true сохраняет адрес с отдельной оплатой, false освобождает. Проверяйте guest_configuration_required и при необходимости меняйте сеть внутри ОС. Неиспользованный срок не возвращается.
Продлить IPv4
Продлевает отдельно оплачиваемый IPv4 на months=1/3/6/12/24/36 календарных месяцев от max(текущее время, paid_until). Если months не передан, используется последний оплаченный срок. Цена — актуальная месячная ставка × срок, без наценки и скидки. Выбранный срок используется и следующим автопродлением. Основной IPv4 и IPv6 отдельно не продлеваются. Возвращает HTTP 200, завершённый заказ и paid_until. Повторяйте тот же Idempotency-Key и параметры при потере ответа.
Автопродление IPv4
Меняет настройку автопродления без списания баланса и изменения оплаченного срока. По умолчанию false. Сроки попыток, длительность и цены описаны в разделе жизненного цикла.
Освободить сохранённый IPv4
Безвозвратно освобождает сохранённый IPv4 без привязки к VPS. Списание или возврат не создаётся. Результат содержит operation_id; HTTP 200 подтверждает освобождение.