REST API v2.4.8

Добро пожаловать в документацию облачной платформы XSVALTEAM Cloud. REST API предназначен для автоматизации управления облачной инфраструктурой.

99.99%

Доступность сервисов

34 ms

Среднее время ответа API

RU-Central

Основной регион

v2.4.8

Текущая версия API

Быстрый старт

Все обращения к API выполняются исключительно по HTTPS. Базовый адрес:

https://api.xsvalteam.cloud/v2/

Пример проверки состояния API:

GET
GET /status

Ответ сервера

{
  "status":"ok",
  "version":"2.4.8",
  "uptime":"99.99%",
  "region":"ru-central"
}

Авторизация

Все запросы к API требуют использования персонального токена доступа. Токен передается в заголовке Authorization.

Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

curl -X GET \
https://api.xsvalteam.cloud/v2/projects \
-H "Authorization: Bearer YOUR_TOKEN"

Ответ

{
  "status":"success",
  "projects":[
    {
      "id":"prj-001",
      "name":"production"
    },
    {
      "id":"prj-002",
      "name":"development"
    }
  ]
}

Compute API

Раздел предназначен для управления виртуальными серверами, образами, снапшотами и сетевыми интерфейсами.

POST
POST /compute/instances
{
  "name":"backend-01",
  "region":"ru-central",
  "image":"ubuntu-24.04",
  "cpu":2,
  "ram":4096,
  "disk":40
}

Поддерживаемые действия

  • Создание VPS
  • Удаление сервера
  • Перезагрузка
  • Изменение тарифа
  • Снимки (Snapshots)
  • Консоль VNC
  • Переустановка ОС

DNS API

API позволяет автоматически управлять DNS-зонами, ресурсными записями и делегированием доменов.

PUT
PUT /dns/zones/example.ru/records
{
  "type":"A",
  "name":"api",
  "ttl":300,
  "value":"192.0.2.15"
}

Object Storage

S3-совместимое объектное хранилище поддерживает управление бакетами, политиками доступа и жизненным циклом объектов.

GET
GET /storage/buckets
{
  "count":2,
  "buckets":[
    "backup",
    "logs"
  ]
}

SSL API

Управление TLS-сертификатами и автоматическим продлением.

Метод Описание
GET Получение списка сертификатов
POST Выпуск нового сертификата
DELETE Удаление сертификата

IAM — Управление доступом

Система управления пользователями, сервисными аккаунтами и ролями доступа.

Пользователи

Создание и управление учетными записями.

Роли

Гибкая модель RBAC для проектов.

API Tokens

Создание и отзыв токенов доступа.

Billing API

Получение информации о балансе, расходах и выставленных счетах.

GET /billing/account
{
  "balance":8420.15,
  "currency":"RUB",
  "next_invoice":"2026-08-01"
}

Monitoring API

Мониторинг позволяет получать показатели производительности инфраструктуры в режиме реального времени.

  • CPU Usage
  • RAM Usage
  • Disk IO
  • Network Traffic
  • Availability
  • Response Time

Статус сервисов

Сервис Состояние Доступность
Compute API ● Работает 99.99%
DNS API ● Работает 99.99%
Storage API ● Работает 99.98%
IAM ● Работает 100%
Monitoring ● Работает 99.97%

История изменений

v2.4.8

Добавлена поддержка Object Storage Lifecycle API. Исправлены ошибки авторизации сервисных аккаунтов. Оптимизирована производительность DNS API.

v2.4.5

Улучшено логирование операций Compute API. Добавлены новые метрики Monitoring API.

v2.4.0

Первый стабильный релиз API версии 2.4.