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 /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 /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 /dns/zones/example.ru/records
{
"type":"A",
"name":"api",
"ttl":300,
"value":"192.0.2.15"
}
Object Storage
S3-совместимое объектное хранилище поддерживает управление бакетами, политиками доступа и жизненным циклом объектов.
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.