Cluster — действия с кластерами серверов 1С:Предприятия

Дата последней модификации страницы: 01.12.2024

Методы группы cluster внешнего программного интерфейса менеджера сервиса предназначены для выполнения различных действий с кластерами серверов 1С:Предприятия, используемых облачным сервисом Фреш.

Сводка по методам

МетодНазначение
cluster/listСписок используемых в сервисе кластеров сервера 1С:Предприятия
cluster/updateИзменить информацию о кластере сервера 1С:Предприятия
cluster/infoИнформация о кластере сервера 1С:Предприятия

cluster/list

Список используемых в сервисе кластеров сервера 1С:Предприятия

ПараметрТипОписаниеПример
Запрос
host_name *Строка переменная (255)Адрес центрального сервера кластераServerName
main_port *Число (+5.0)Номер основного IP-порта менеджера кластера1541
Ответ: list (1..*)
idСтрока переменная (9)Код кластера000000001
nameСтрока переменная (25)Наименование кластераКластер
deletion_markБулевоПометка удаленияfalse
platform *Строка переменная (18)Версия платформы 1С:Предприятие, используемая кластером8.3.13.1809
host_nameСтрока переменная (255)Адрес центрального сервера кластераServerName
main_portЧисло (+5.0)Номер основного IP-порта менеджера кластера1541
Пример запроса  Развернуть 
POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/cluster/list
Authorization: Basic base64_encode(user:password) или Bearer access_token
Пример ответа  Развернуть 
{
  "list": [
    {
      "id": "000000001",
      "name": "Кластер",
      "deletion_mark": false,
      "platform": "8.3.13.1809",
      "host_name": "ServerName",
      "main_port": 1541
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

cluster/update

Изменить информацию о кластере сервера 1С:Предприятия

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код кластера000000001
name *Строка переменная (25)Наименование кластераКластер 1
platform *Строка переменная (18)Версия платформы 1С:Предприятие, используемая кластером8.3.13.1809
Ответ
idСтрока переменная (9)Код кластера000000001
updated *БулевоЭлемент измененtrue
created *БулевоСоздан новый элементfalse
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, СтруктураУстановленное значениеКластер 1
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, СтруктураПрежнее значениеКластер
Пример запроса  Развернуть 
POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/cluster/update
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": "000000001",
  "name": "Кластер 1",
  "platform": "8.3.13.1809"
}
Пример ответа  Развернуть 
{
  "id": "000000001",
  "updated": true,
  "created": false,
  "change_list": [
    {
      "name": "name",
      "value": "Кластер 1",
      "old_value": "Кластер"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

cluster/info

Информация о кластере сервера 1С:Предприятия

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код кластера000000001
Ответ
id *Строка переменная (9)Код кластера000000001
name *Строка переменная (25)Наименование кластераКластер
deletion_mark *БулевоПометка удаленияfalse
platform *Строка переменная (18)Версия платформы 1С:Предприятие, используемая кластером8.3.13.1809
host_name *Строка переменная (255)Адрес центрального сервера кластераServerName
main_port *Число (+5.0)Номер основного IP-порта менеджера кластера1541
Пример запроса  Развернуть 
POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/cluster/info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": "000000001"
}
Пример ответа  Развернуть 
{
  "id": "000000001",
  "name": "Кластер",
  "deletion_mark": false,
  "platform": "8.3.13.1809",
  "host_name": "ServerName",
  "main_port": 1541,
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх