Хостинг

Список контейнеров

URL: /api/v1/hosting/containers/
Метод: GET
Результат: JSON

Опциональные параметры запроса:

  • offset(int) - Индекс первой строки выборки, начиная с 0
  • limit(int) - Количество элементов в выборке

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение:

  • count (int) - Количество элементов
  • entities - Список контейнеров
    • id(int) - Идентификатор контейнера
    • login(str) - Логин контейнера, например, c234
    • name(str) - Имя контейнера
    • service_address(str) - Имя сервера
    • service_ip(str) - IP-адрес сервера
    • memory_limit(int) - Объем оперативной памяти (МБ)
    • quota(int) - Объем дискового пространства (МБ)
    • state(int) - Статус:
      • ENABLED - активен
      • DISABLED_BY_SERVICE - Отключен за неуплату
      • DISABLED_BY_ADMIN - Отключен администратором
      • DISABLED_BY_QUOTA - Отключен за превышение ограничения дискового пространства
    • created(datetime) - Дата создания
    • updated(datetime) - Дата изменения
    • environment(int) - Версия окружения:
      • 0 - Облачный хостинг (современное окружение)
      • 1 - Виртуальный хостинг (старое окружение)
    • virtualhosts(Список virtualhosts) - Список сайтов в контейнере
    • memcache(Memcache) - Настройки memcache
    • redis(Redis) - Настройки redis
    • is_in_transfer(bool) - Нахождение контейнера в процессе передачи на другой аккаунт

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/hosting/containers/?limit=10' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Создание контейнера

URL: /api/v1/hosting/containers/
Метод: POST
Результат: JSON

Обязательные параметры запроса:

  • name(str) - Название контейнера
  • memory_limit(int) - Ограничение оперативной памяти (МБ)
  • quota(int) - Ограничение дискового пространства (МБ)
  • environment(int) - Версия окружения:
    • 0 - Облачный хостинг (современное окружение)
    • 1 - Виртуальный хостинг (старое окружение)

Опциональные параметры запроса:

  • password(str) - Пароль для доступа по SSH
  • redis(int) - Объем оперативной памяти для Redis (МБ)
  • memcache(int) - Объем оперативной памяти для Memcache (МБ)
  • create_packet(bool) - Создавать пакет?

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Контейнер

  • id(int) - Идентификатор контейнера
  • login(str) - Логин контейнера, например, c234
  • name(str) - Имя контейнера
  • service_address(str) - Имя сервера
  • service_ip(str) - IP-адрес сервера
  • memory_limit(int) - Объем оперативной памяти (МБ)
  • quota(int) - Объем дискового пространства (МБ)
  • state(int) - Статус:
    • ENABLED - активен
    • DISABLED_BY_SERVICE - Отключен за неуплату
    • DISABLED_BY_ADMIN - Отключен администратором
    • DISABLED_BY_QUOTA - Отключен за превышение ограничения дискового пространства
  • created(datetime) - Дата создания
  • updated(datetime) - Дата изменения
  • environment(int) - Версия окружения:
    • 0 - Облачный хостинг (современное окружение)
    • 1 - Виртуальный хостинг (старое окружение)
  • virtualhosts(Список virtualhosts) - Список сайтов в контейнере
  • memcache(Memcache) - Настройки memcache
  • redis(Redis) - Настройки redis
  • is_in_transfer(bool) - Нахождение контейнера в процессе передачи на другой аккаунт

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

curl --request POST 'https://api-ms.netangels.ru/api/v1/hosting/containers/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "Мои сайты", 
          "memory_limit": 512, 
          "quota": 5120, 
          "redis": 512, 
          "memcache": 512 
    }'

Информация о контейнере

URL: /api/v1/hosting/containers/{id}/
Метод: GET
Результат: JSON

  • id - ID контейнера

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение:

Контейнер

  • id(int) - Идентификатор контейнера
  • login(str) - Логин контейнера, например, c234
  • name(str) - Имя контейнера
  • service_address(str) - Имя сервера
  • service_ip(str) - IP-адрес сервера
  • memory_limit(int) - Объем оперативной памяти (МБ)
  • quota(int) - Объем дискового пространства (МБ)
  • state(int) - Статус:
    • ENABLED - активен
    • DISABLED_BY_SERVICE - Отключен за неуплату
    • DISABLED_BY_ADMIN - Отключен администратором
    • DISABLED_BY_QUOTA - Отключен за превышение ограничения дискового пространства
  • created(datetime) - Дата создания
  • updated(datetime) - Дата изменения
  • environment(int) - Версия окружения:
    • 0 - Облачный хостинг (современное окружение)
    • 1 - Виртуальный хостинг (старое окружение)
  • virtualhosts(Список virtualhosts) - Список сайтов в контейнере
  • memcache(Memcache) - Настройки memcache
  • redis(Redis) - Настройки redis
  • is_in_transfer(bool) - Нахождение контейнера в процессе передачи на другой аккаунт

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/hosting/containers/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Обновление контейнера

URL: /api/v1/hosting/containers/{id}/
Метод: PUT
Результат: JSON

  • id - ID контейнера

Опциональные параметры запроса:

  • name(str) - Название контейнера
  • memory_limit(int) - Ограничение оперативной памяти (МБ)
  • quota(int) - Ограничение дискового пространства (МБ)
  • password(str) - Пароль для доступа по SSH

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Контейнер

  • id(int) - Идентификатор контейнера
  • login(str) - Логин контейнера, например, c234
  • name(str) - Имя контейнера
  • service_address(str) - Имя сервера
  • service_ip(str) - IP-адрес сервера
  • memory_limit(int) - Объем оперативной памяти (МБ)
  • quota(int) - Объем дискового пространства (МБ)
  • state(int) - Статус:
    • ENABLED - активен
    • DISABLED_BY_SERVICE - Отключен за неуплату
    • DISABLED_BY_ADMIN - Отключен администратором
    • DISABLED_BY_QUOTA - Отключен за превышение ограничения дискового пространства
  • created(datetime) - Дата создания
  • updated(datetime) - Дата изменения
  • environment(int) - Версия окружения:
    • 0 - Облачный хостинг (современное окружение)
    • 1 - Виртуальный хостинг (старое окружение)
  • virtualhosts(Список virtualhosts) - Список сайтов в контейнере
  • memcache(Memcache) - Настройки memcache
  • redis(Redis) - Настройки redis
  • is_in_transfer(bool) - Нахождение контейнера в процессе передачи на другой аккаунт

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/hosting/containers/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "Мои сайты", 
          "memory_limit": 512, 
          "quota": 5120 
    }'

Удаление контейнера

URL: /api/v1/hosting/containers/{id}/
Метод: DELETE

  • id - ID контейнера

Коды ответов

Код Описание
200 Успешный запрос
400 Удаление запрещено

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

curl --request DELETE 'https://api-ms.netangels.ru/api/v1/hosting/containers/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"