Configuration — действия с конфигурациями и версиями конфигураций

Методы группы Configuration внешнего программного интерфейса Менеджера сервиса предназначены для выполнения действий с конфигурациями и версиями конфигураций, размещенных в облачном сервисе Фреш.

Методы этой группы могут использоваться:

  • администраторами сервиса;
  • пользователями, которых администратор сервиса назначил ответственными за конфигурацию — по отношению к этой конфигурации и версиям этой конфигурации.

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

МетодНазначение
configuration/createЗарегистрировать новую конфигурацию
configuration/deleteПометить на удаление или снять пометку удаления конфигурации
configuration/infoИнформация об используемой в сервисе конфигурации
configuration/listСписок используемых в сервисе конфигураций
configuration/updateИзменить информацию об используемой в сервисе конфигурации
configuration/version/createЗарегистрировать новую версию конфигурации
configuration/version/deleteПометить на удаление или снять пометку удаления версии конфигурации
configuration/version/infoИнформация о версии конфигурации
configuration/version/listСписок версий конфигураций
configuration/version/updateИзменить информацию о версии конфигурации
configuration/version/file/createЗарегистрировать новый файл версии конфигурации
configuration/version/file/deleteУдалить файл версии конфигурации
configuration/version/file/listСписок файлов версии конфигурации
configuration/version/file_token/downloadПолучить талон на скачивание файла версии конфигурации
configuration/version/file_token/uploadПолучить талон на загрузку файла версии конфигурации
configuration/version/incident/list

Список инцидентов, выявленных при проверке версий и обновлений конфигураций

configuration/version/incident/update

Изменить принятое по инциденту решение

configuration/version/source/createЗарегистрировать новый элемент цепочки обновления с исходной на целевую версию конфигурации
configuration/version/source/deleteПометить на удаление или снять пометку удаления элемента цепочки обновления
configuration/version/source/infoИнформация об элементе цепочки обновления с исходной на целевую версию конфигурации
configuration/version/source/listСписок исходных версий для обновления на целевую версию конфигурации
configuration/version/source/agent_script/createЗарегистрировать новый сценарий агента сервиса по элементу цепочки обновления
configuration/version/source/agent_script/listСписок сценариев агента сервиса элемента цепочки обновления
configuration/version/source/file/createЗарегистрировать новый файл элемента цепочки обновления
configuration/version/source/file/deleteУдалить файл элемента цепочки обновления
configuration/version/source/file/listСписок файлов элемента цепочки обновления
configuration/version/source/file_token/downloadПолучить талон на скачивание файла элемента цепочки обновления
configuration/version/source/file_token/uploadПолучить талон на загрузку файла элемента цепочки обновления

configuration/create

Зарегистрировать новую конфигурацию

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код конфигурацииsm
nameСтрока переменная (64)Наименование конфигурацииМенеджер сервиса, редакция 1.0
sysnameСтрока переменная (255)Имя конфигурации, как оно задано в конфигуратореМенеджерСервиса
typeСтрока неограниченной длиныТип конфигурацииУправляющая
owner_id *Число (+12.0)Код абонента, являющегося владельцем конфигурации123
description *Строка неограниченной длиныОписание конфигурацииЭто пример описания конфигурации
icon *Двоичные данные размером до 10240 байт в строке Base64Пиктограмма, размер до 10 Кб89 50 4E 47 0D 0A 1A 0A 00 00 00 0D 49 48 44 52 00 00 00 20 00 00 00 20 08 06 00 00 00 73 7A 7A F4 0...
mobile_key *Строка переменная (32)Подпись мобильного клиента00012345678901234567890123456789
Ответ
idСтрока переменная (9)Код конфигурацииsm
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значениеМенеджер сервиса, редакция 1.0
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значениеПример прежнего наименования конфигурации
Пример запроса
{
"id": "sm",
"name": "Менеджер сервиса, редакция 1.0",
"sysname": "МенеджерСервиса",
"type": "Управляющая",
"owner_id": 123,
"description": "Это пример описания конфигурации",
"icon": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAGXRFWHRTb2Z0d2Fy\r\nZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAArJJREFUeNqsV91KW0EQ7llONaapMRIt\r\nKm20WlT8uSjohQ/QG5/Hl7Cv0Ut9Bou2etNeiCgo1bT+YoigVdNqlPiNzMp2e447\r\ne44HPpaQnZlv529ng0aj8Uz6lT9mC1heAi+AFiADBMA1cAVcAmd9M7WqVGfgIgCj\r\nzVi6gXYgZIMayvqtcQsQiTLI/ElMAMZ7sPTEGHGR0NgBiR9eBPjU79jVQUoChHPg\r\ne5Q3/iMA41ksw8BzgWKK+z7wF+h0eOsGWAGJs1gCfPIxjrXrZBTnZSi8MeSJeK+D\r\nxAJkalpGWR4Z5JMrw71xODGN8/fTIUMHnDIFlMH+NZacJfAYidaInCo6CBAKsDXy\r\nDwF2/RuBsIk85Hqt3HkrlB3Dfkrw+1jTV3LEPO6/ESgawkrZnfeoCsI4JaUSuu6x\r\nUDQBbcK9Jkr3VbAz20LGR5+o3n33L1AICh7Kqe73qAKAOldMNzetJCS6Qr5cJASo\r\niZxEZH6Vk7gvAYEiEcgKCbznzD1nMjWDxC+gP4EX8ooJSBJH94g2DtvDBzKVhAnc\r\nGlqbpAlWt+6PpoRlHIScWFlPEpdWHrwSyEb9fxHyTZbzSByaeGwCXULy9p4LxUnl\r\n04IrEZVQ8tShUVVc08qjk1Ws+Of4YpIYtHUfKLjziO92EQns30t5eq27TqOavguO\r\nUri/6NH/TWyb88CGsH6PIwjkExgn3csPBDir1wUkmiMIXHvegsqcDZXRzdaoxByC\r\nQxEEvgLfGIeSzIetL3Ez4WceHOO8kEHWj1ttmMp4lcs54zBOHXTeNZbTC2ia3R3X\r\nRKh0y7yHxvEO45kW18woVJ9A+FjyMKEr+oOR4WkHEqqeORg/9X2aTWCZSEliCYYX\r\n0zxOqctNAgPscgkJcvcWGz9N9Tq2yPTz+N7Jc4GehH8zyNW7MLop1XknwABKrNn9\r\n1daFowAAAABJRU5ErkJggg==",
"mobile_key": "00012345678901234567890123456789",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/create",
"debug": true
}
}
Пример ответа
{
"id": "sm",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "Менеджер сервиса, редакция 1.0",
"old_value": "Пример прежнего наименования конфигурации"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/delete

Пометить на удаление или снять пометку удаления конфигурации

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код конфигурацииsm
deletion_markБулевоПометка удаленияНет
Ответ
idСтрока переменная (9)Код конфигурацииsm
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значениеМенеджер сервиса, редакция 1.0
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значениеПример прежнего наименования конфигурации
Пример запроса
{
"id": "sm",
"deletion_mark": false,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/delete",
"debug": true
}
}
Пример ответа
{
"id": "sm",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "Менеджер сервиса, редакция 1.0",
"old_value": "Пример прежнего наименования конфигурации"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/info

Информация об используемой в сервисе конфигурации

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код конфигурацииsm
Ответ
id *Строка переменная (9)Код конфигурацииsm
name *Строка переменная (64)Наименование конфигурацииМенеджер сервиса, редакция 1.0
deletion_mark *БулевоПометка удаленияНет
owner_id *Число (+12.0)Код абонента, являющегося владельцем конфигурации123
sysname *Строка переменная (255)Имя конфигурации, как оно задано в конфигуратореМенеджерСервиса
type *Строка неограниченной длиныТип конфигурацииУправляющая
description *Строка неограниченной длиныОписание конфигурацииЭто пример описания конфигурации
icon *Двоичные данные размером до 10240 байт в строке Base64Пиктограмма, размер до 10 Кб89 50 4E 47 0D 0A 1A 0A 00 00 00 0D 49 48 44 52 00 00 00 20 00 00 00 20 08 06 00 00 00 73 7A 7A F4 0...
mobile_key *Строка переменная (32)Подпись мобильного клиента00012345678901234567890123456789
create_theme *БулевоСоздавать тему в конференцииНет
Пример запроса
{
"id": "sm",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/info",
"debug": true
}
}
Пример ответа
{
"id": "sm",
"name": "Менеджер сервиса, редакция 1.0",
"deletion_mark": false,
"owner_id": 123,
"sysname": "МенеджерСервиса",
"type": "Управляющая",
"description": "Это пример описания конфигурации",
"icon": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAGXRFWHRTb2Z0d2Fy\r\nZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAArJJREFUeNqsV91KW0EQ7llONaapMRIt\r\nKm20WlT8uSjohQ/QG5/Hl7Cv0Ut9Bou2etNeiCgo1bT+YoigVdNqlPiNzMp2e447\r\ne44HPpaQnZlv529ng0aj8Uz6lT9mC1heAi+AFiADBMA1cAVcAmd9M7WqVGfgIgCj\r\nzVi6gXYgZIMayvqtcQsQiTLI/ElMAMZ7sPTEGHGR0NgBiR9eBPjU79jVQUoChHPg\r\ne5Q3/iMA41ksw8BzgWKK+z7wF+h0eOsGWAGJs1gCfPIxjrXrZBTnZSi8MeSJeK+D\r\nxAJkalpGWR4Z5JMrw71xODGN8/fTIUMHnDIFlMH+NZacJfAYidaInCo6CBAKsDXy\r\nDwF2/RuBsIk85Hqt3HkrlB3Dfkrw+1jTV3LEPO6/ESgawkrZnfeoCsI4JaUSuu6x\r\nUDQBbcK9Jkr3VbAz20LGR5+o3n33L1AICh7Kqe73qAKAOldMNzetJCS6Qr5cJASo\r\niZxEZH6Vk7gvAYEiEcgKCbznzD1nMjWDxC+gP4EX8ooJSBJH94g2DtvDBzKVhAnc\r\nGlqbpAlWt+6PpoRlHIScWFlPEpdWHrwSyEb9fxHyTZbzSByaeGwCXULy9p4LxUnl\r\n04IrEZVQ8tShUVVc08qjk1Ws+Of4YpIYtHUfKLjziO92EQns30t5eq27TqOavguO\r\nUri/6NH/TWyb88CGsH6PIwjkExgn3csPBDir1wUkmiMIXHvegsqcDZXRzdaoxByC\r\nQxEEvgLfGIeSzIetL3Ez4WceHOO8kEHWj1ttmMp4lcs54zBOHXTeNZbTC2ia3R3X\r\nRKh0y7yHxvEO45kW18woVJ9A+FjyMKEr+oOR4WkHEqqeORg/9X2aTWCZSEliCYYX\r\n0zxOqctNAgPscgkJcvcWGz9N9Tq2yPTz+N7Jc4GehH8zyNW7MLop1XknwABKrNn9\r\n1daFowAAAABJRU5ErkJggg==",
"mobile_key": "00012345678901234567890123456789",
"create_theme": false,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/list

Список используемых в сервисе конфигураций

ПараметрТипОписаниеПример
Запрос
id *Строка переменная (9)Код конфигурацииsm
sysname *Строка переменная (255)Имя конфигурации, как оно задано в конфигуратореМенеджерСервиса
Ответ
listСписок (1..*)Список сведений по каждой конфигурации
  - idСтрока переменная (9)Код конфигурацииsm
  - nameСтрока переменная (64)Наименование конфигурацииМенеджер сервиса, редакция 1.0
  - deletion_markБулевоПометка удаленияНет
  - owner_idЧисло (+12.0)Код абонента, являющегося владельцем конфигурации123
  - sysnameСтрока переменная (255)Имя конфигурации, как оно задано в конфигуратореМенеджерСервиса
  - typeСтрока неограниченной длиныТип конфигурацииУправляющая
Пример запроса
{
"general": {
"version": 6,
"type": "srv",
"method": "configuration/list",
"debug": true
}
}
Пример ответа
{
"list": [
{
"id": "sm",
"name": "Менеджер сервиса, редакция 1.0",
"deletion_mark": false,
"owner_id": 123,
"sysname": "МенеджерСервиса",
"type": "Управляющая"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/update

Изменить информацию об используемой в сервисе конфигурации

ПараметрТипОписаниеПример
Запрос
idСтрока переменная (9)Код конфигурацииsm
name *Строка переменная (64)Наименование конфигурацииМенеджер сервиса, редакция 1.0
sysname *Строка переменная (255)Имя конфигурации, как оно задано в конфигуратореМенеджерСервиса
type *Строка неограниченной длиныТип конфигурацииУправляющая
description *Строка неограниченной длиныОписание конфигурацииЭто пример описания конфигурации
icon *Двоичные данные размером до 10240 байт в строке Base64Пиктограмма, размер до 10 Кб89 50 4E 47 0D 0A 1A 0A 00 00 00 0D 49 48 44 52 00 00 00 20 00 00 00 20 08 06 00 00 00 73 7A 7A F4 0...
mobile_key *Строка переменная (32)Подпись мобильного клиента00012345678901234567890123456789
Ответ
idСтрока переменная (9)Код конфигурацииsm
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значениеМенеджер сервиса, редакция 1.0
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значениеПример прежнего наименования конфигурации
Пример запроса
{
"id": "sm",
"name": "Менеджер сервиса, редакция 1.0",
"sysname": "МенеджерСервиса",
"type": "Управляющая",
"description": "Это пример описания конфигурации",
"icon": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAGXRFWHRTb2Z0d2Fy\r\nZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAArJJREFUeNqsV91KW0EQ7llONaapMRIt\r\nKm20WlT8uSjohQ/QG5/Hl7Cv0Ut9Bou2etNeiCgo1bT+YoigVdNqlPiNzMp2e447\r\ne44HPpaQnZlv529ng0aj8Uz6lT9mC1heAi+AFiADBMA1cAVcAmd9M7WqVGfgIgCj\r\nzVi6gXYgZIMayvqtcQsQiTLI/ElMAMZ7sPTEGHGR0NgBiR9eBPjU79jVQUoChHPg\r\ne5Q3/iMA41ksw8BzgWKK+z7wF+h0eOsGWAGJs1gCfPIxjrXrZBTnZSi8MeSJeK+D\r\nxAJkalpGWR4Z5JMrw71xODGN8/fTIUMHnDIFlMH+NZacJfAYidaInCo6CBAKsDXy\r\nDwF2/RuBsIk85Hqt3HkrlB3Dfkrw+1jTV3LEPO6/ESgawkrZnfeoCsI4JaUSuu6x\r\nUDQBbcK9Jkr3VbAz20LGR5+o3n33L1AICh7Kqe73qAKAOldMNzetJCS6Qr5cJASo\r\niZxEZH6Vk7gvAYEiEcgKCbznzD1nMjWDxC+gP4EX8ooJSBJH94g2DtvDBzKVhAnc\r\nGlqbpAlWt+6PpoRlHIScWFlPEpdWHrwSyEb9fxHyTZbzSByaeGwCXULy9p4LxUnl\r\n04IrEZVQ8tShUVVc08qjk1Ws+Of4YpIYtHUfKLjziO92EQns30t5eq27TqOavguO\r\nUri/6NH/TWyb88CGsH6PIwjkExgn3csPBDir1wUkmiMIXHvegsqcDZXRzdaoxByC\r\nQxEEvgLfGIeSzIetL3Ez4WceHOO8kEHWj1ttmMp4lcs54zBOHXTeNZbTC2ia3R3X\r\nRKh0y7yHxvEO45kW18woVJ9A+FjyMKEr+oOR4WkHEqqeORg/9X2aTWCZSEliCYYX\r\n0zxOqctNAgPscgkJcvcWGz9N9Tq2yPTz+N7Jc4GehH8zyNW7MLop1XknwABKrNn9\r\n1daFowAAAABJRU5ErkJggg==",
"mobile_key": "00012345678901234567890123456789",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/update",
"debug": true
}
}
Пример ответа
{
"id": "sm",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "Менеджер сервиса, редакция 1.0",
"old_value": "Пример прежнего наименования конфигурации"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/version/create

Зарегистрировать новую версию конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
vendorСтрока переменная (256)ПоставщикФирма "1С"
typeСтрока неограниченной длиныТип версииРелиз
platformСтрока переменная (18)Минимальный номер версии платформы 1С:Предприятие8.3.13.1690
description *Строка неограниченной длиныОписание версииПример описания версии
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значение1.0.82.31
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значение0.0.0.0
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"vendor": "Фирма \"1С\"",
"type": "Релиз",
"platform": "8.3.13.1690",
"description": "Пример описания версии",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/create",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "1.0.82.31",
"old_value": "0.0.0.0"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/version/delete

Пометить на удаление или снять пометку удаления версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
deletion_markБулевоПометка удаленияНет
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значение1.0.82.31
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значение0.0.0.0
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"deletion_mark": false,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/delete",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "1.0.82.31",
"old_value": "0.0.0.0"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

  Вверх

configuration/version/info

Информация о версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
Ответ
conf_id *Строка переменная (9)Код конфигурацииsm
version *Строка переменная (18)Номер версии1.0.82.31
deletion_mark *БулевоПометка удаленияНет
type *Строка неограниченной длиныТип версииРелиз
description *Строка неограниченной длиныОписание версииПример описания версии
platform *Строка переменная (18)Минимальный номер версии платформы 1С:Предприятие8.3.13.1690
vendor *Строка переменная (256)ПоставщикФирма "1С"
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/info",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"deletion_mark": false,
"type": "Релиз",
"description": "Пример описания версии",
"platform": "8.3.13.1690",
"vendor": "Фирма \"1С\"",
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/list

Список версий конфигураций

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
version *Строка переменная (18)Номер версии1.0.82.31
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
listСписок (0..*)Список сведений по версиям конфигурации
  - versionСтрока переменная (18)Номер версии1.0.82.31
  - deletion_markБулевоПометка удаленияНет
  - typeСтрока неограниченной длиныТип версииРелиз
  - platformСтрока переменная (18)Минимальный номер версии платформы 1С:Предприятие8.3.13.1690
  - vendorСтрока переменная (256)ПоставщикФирма "1С"
Пример запроса
{
"conf_id": "sm",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/list",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"list": [
{
"version": "1.0.82.31",
"deletion_mark": false,
"type": "Релиз",
"platform": "8.3.13.1690",
"vendor": "Фирма \"1С\"",
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/update

Изменить информацию о версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
vendorСтрока переменная (256)ПоставщикФирма "1С"
typeСтрока неограниченной длиныТип версииРелиз
platformСтрока переменная (18)Минимальный номер версии платформы 1С:Предприятие8.3.13.1690
description *Строка неограниченной длиныОписание версииПример описания версии
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поляname
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значение1.0.82.31
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значение0.0.0.0
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"vendor": "Фирма \"1С\"",
"type": "Релиз",
"platform": "8.3.13.1690",
"description": "Пример описания версии",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/update",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"updated": true,
"created": false,
"change_list": [
{
"name": "name",
"value": "1.0.82.31",
"old_value": "0.0.0.0"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх


configuration/version/file/create

Зарегистрировать новый файл версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
file_idУникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_type *Строка переменная (50)Назначение файлаConfigurationDistribution
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
created *БулевоЗарегистрирован новый файлДа
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/file/create",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"created": true,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/file/delete

Удалить файл версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
deletedБулевоФайл удаленДа
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/file/delete",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"deleted": true,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/file/list

Список файлов версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_type *Строка переменная (50)Назначение файлаConfigurationDistribution
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
listСписок (0..*)Список сведений по файлам версии конфигурации
  - file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
  - file_idУникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
  - size *Число (+15.0)Размер файла (байт)52 428 800
  - name *Строка переменная (255)Имя файла1cv8.cf
  - date *Дата и время в строке формата ISOДата файла
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/file/list",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"list": [
{
"file_type": "ConfigurationDistribution",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"size": 52428800,
"name": "1cv8.cf",
"date": "2019-02-26T11:52:08"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/file_token/download

Получить талон на скачивание файла версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
directionСтрока переменная (8)Направление передачи данныхdownload
token *Строка переменная (64)Талон на загрузку или скачивание файла хранилищаbacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/file_token/download",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"direction": "download",
"token": "bacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb",
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/file_token/upload

Получить талон на загрузку файла версии конфигурации

ПараметрТипОписаниеПример
Запрос
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
nameСтрока переменная (255)Имя файла1cv8.cf
sizeЧисло (+15.0)Размер файла (байт)52 428 800
advancedcheck *БулевоДополнительно проверить и обработать двоичные данные файла поставки (*.cf)Да
Ответ
conf_idСтрока переменная (9)Код конфигурацииsm
versionСтрока переменная (18)Номер версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationDistribution
directionСтрока переменная (8)Направление передачи данныхupload
token *Строка переменная (64)Талон на загрузку или скачивание файла хранилищаbacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb
Пример запроса
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"name": "1cv8.cf",
"size": 52428800,
"advancedcheck": true,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/file_token/upload",
"debug": true
}
}
Пример ответа
{
"conf_id": "sm",
"version": "1.0.82.31",
"file_type": "ConfigurationDistribution",
"direction": "upload",
"token": "bacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb",
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

Важная особенность

При загрузке больших файлов (более 500 Мбайт) следует учитывать, что файл может быть доступен для использования лишь через некоторое время после его закачки и получения его идентификатора. Рекомендуется перед использованием файла проверить его фактическую регистрацию в данных менеджера сервиса.

 Вверх

configuration/version/incident/list

Список инцидентов, выявленных при проверке версий и обновлений конфигураций

ПараметрТипОписаниеПример
Запрос
target
Целевая (проверяемая) версия
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.11
source *
Исходная версия (при проверке обновления на целевую)mt
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.10
test_kind *Строка переменная (50)Код вида проверки, в рамках которой зарегистрирован инцидентDataLosses
Ответ: list (1..*)
target
Целевая (проверяемая) версия
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.11
source *
Исходная версия (при проверке обновления на целевую)mt
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.10
id *Число (+10.0)Код инцидента, рассчитанный как хеш CRC32 его ключевых свойств86 033 667
decision *Строка неограниченной длиныРешение по инцидентуЯвляетсяОшибкой
test_kind *Строка переменная (50)Код вида проверки, в рамках которой зарегистрирован инцидентDataLosses
description *Строка неограниченной длиныОписание инцидентаУдален в Зарплата 5.0.33.4
correction *Строка переменная (256)Изменение, выявленное проверкой обновленияДанные удалены
purpose *Строка переменная (80)Назначение объекта, уточняющее его свойстваРеквизит табличной части
object_name *Строка переменная (256)Имя объекта, в котором выявлено изменениеДокумент.НДФЛ2.ТабличнаяЧасть.ТаблицаДокумента.Реквизит.Отметка
subsystems *Строка неограниченной длиныПодсистемы конфигурации, в состав которых входит объектНалоги.Документы; ОбъектыЗарплата; Отчетность.НДФЛ; УниверсальныйЖурнал.НДФЛ
Пример запроса  Развернуть
{
  "target": {
    "conf_id": "mt",
    "version": "1.1.3.11"
  },
  "source": {
    "conf_id": "mt",
    "version": "1.1.3.10"
  },
  "test_kind": "DataLosses",
  "general": {
    "version": 25,
    "type": "srv",
    "method": "configuration/version/incident/list",
    "debug": true
  }
}
Пример ответа  Развернуть
{
  "list": [
    {
      "target": {
        "conf_id": "mt",
        "version": "1.1.3.11"
      },
      "source": {
        "conf_id": "mt",
        "version": "1.1.3.10"
      },
      "id": 86033667,
      "decision": "ЯвляетсяОшибкой",
      "test_kind": "DataLosses",
      "description": "Удален в Зарплата 5.0.33.4",
      "correction": "Данные удалены",
      "purpose": "Реквизит табличной части",
      "object_name": "Документ.НДФЛ2.ТабличнаяЧасть.ТаблицаДокумента.Реквизит.Отметка",
      "subsystems": "Налоги.Документы; ОбъектыЗарплата; Отчетность.НДФЛ; УниверсальныйЖурнал.НДФЛ"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 25,
    "sm_version": "1.1.27.10",
    "sm_timezone": "Europe/Moscow"
  }
}

  Вверх

configuration/version/incident/update

Изменить принятое по инциденту решение

ПараметрТипОписаниеПример
Запрос
idЧисло (+10.0)Код инцидента, рассчитанный как хеш CRC32 его ключевых свойств86 033 667
target
Целевая (проверяемая) версия
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.11
source *
Исходная версия (при проверке обновления на целевую)mt
  - conf_idСтрока переменная (22)Код конфигурацииmt
  - versionСтрока переменная (18)Номер версии1.1.3.10
decisionСтрока неограниченной длиныРешение по инцидентуЯвляетсяОшибкой
Ответ
Нет параметров
Пример запроса  Развернуть
{
  "id": 86033667,
  "target": {
    "conf_id": "mt",
    "version": "1.1.3.11"
  },
  "source": {
    "conf_id": "mt",
    "version": "1.1.3.10"
  },
  "decision": "ЯвляетсяОшибкой",
  "general": {
    "version": 11,
    "type": "srv",
    "method": "configuration/version/incident/update",
    "debug": true
  }
}
Пример ответа  Развернуть
{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 11,
    "sm_version": "1.0.97.2",
    "sm_timezone": "Europe/Moscow"
  }
}

  Вверх

configuration/version/source/create

Зарегистрировать новый элемент цепочки обновления с исходной на целевую версию конфигурации

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поля
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значение
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значение
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/create",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"updated": true,
"created": false,
"change_list": [
{
"name": "Строковое значение (пример)",
"value": "Строковое значение (пример)",
"old_value": "Строковое значение (пример)"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/delete

Пометить на удаление или снять пометку удаления элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
deletion_markБулевоПометка удаленияНет
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
updated *БулевоЭлемент измененДа
created *БулевоСоздан новый элементНет
change_listСписок (0..*)Список изменений
  - nameСтрока переменная (255)Имя поля
  - value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Установленное значение
  - old_value *Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64Прежнее значение
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"deletion_mark": false,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/delete",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"updated": true,
"created": false,
"change_list": [
{
"name": "Строковое значение (пример)",
"value": "Строковое значение (пример)",
"old_value": "Строковое значение (пример)"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/info

Информация об элементе цепочки обновления с исходной на целевую версию конфигурации

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
Ответ
target_conf_id *Строка переменная (9)Код целевой конфигурацииsm
target_version *Строка переменная (18)Номер целевой версии1.0.82.32
source_conf_id *Строка переменная (9)Код исходной конфигурацииsm
source_version *Строка переменная (18)Номер исходной версии1.0.82.31
deletion_mark *БулевоПометка удаленияНет
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/info",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"deletion_mark": false,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/list

Список исходных версий для обновления на целевую версию конфигурации

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
listСписок (0..*)Список исходных версий для обновления на целевую версию конфигурации
  - source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
  - source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
  - deletion_markБулевоПометка удаленияНет
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/list",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"list": [
{
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"deletion_mark": false
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/agent_script/create

Зарегистрировать новый сценарий агента сервиса по элементу цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
templateСтрока переменная (50)Код вида сценария агентаCheckVersionUpdates
force *БулевоВыполнить даже при наличии предупрежденийНет
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
force *БулевоВыполнить даже при наличии предупрежденийНет
template *Строка переменная (50)Код вида сценария агентаCheckVersionUpdates
notify *БулевоОповещать о проблемах (используется в CheckCompatibilityConfigurationExtensions)Нет
created *БулевоЗарегистрирован новый сценарийДа
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"template": "CheckVersionUpdates",
"force": false,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/agent_script/create",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"force": false,
"template": "CheckVersionUpdates",
"notify": false,
"created": true,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/agent_script/list

Список сценариев агента сервиса элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
template *Строка переменная (50)Код вида сценария агентаCheckVersionUpdates
done *БулевоЗадание сценария агента завершеноДа
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
listСписок (0..*)Список сведений о сценариях агента сервиса
  - templateСтрока переменная (50)Код вида сценария агентаCheckVersionUpdates
  - agent *Строка переменная (25)Наименование агента сервисаАгент 1
  - description *Строка неограниченной длиныОписание сценарияПример описания сценария
  - start *Дата и время в строке формата ISOМомент планирования заданий сценария26.02.2019 0:00:00
  - finish *Дата и время в строке формата ISOМомент завершения обработки выполненного задания сценария26.02.2019 11:38:05
  - done *БулевоЗадание сценария агента завершеноДа
  - success *БулевоУспешное завершение задания сценария агентаДа
  - message *Строка неограниченной длиныСообщение агента сервиса по результатам выполнения заданий сценарияЭто пример сообщения от агента
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/agent_script/list",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"list": [
{
"template": "CheckVersionUpdates",
"agent": "Агент 1",
"description": "Пример описания сценария",
"start": "2019-02-26T00:00:00",
"finish": "2019-02-26T11:38:05",
"done": true,
"success": true,
"message": "Это пример сообщения от агента"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/file/create

Зарегистрировать новый файл элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
file_idУникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_type *Строка переменная (50)Назначение файлаConfigurationUpdate
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
created *БулевоЗарегистрирован новый файлДа
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/file/create",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"created": true,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/file/delete

Удалить файл элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
deletedБулевоФайл удаленДа
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/file/delete",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"deleted": true,
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/file/list

Список файлов элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_type *Строка переменная (50)Назначение файлаConfigurationUpdate
file_id *Уникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
listСписок (0..*)Список сведений по файлам элемента цепочки обновления версии конфигурации
  - file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
  - file_idУникальный идентификаторИдентификатор файлаa741f8ef-2bfa-4a4c-b8e3-17ae36f39035
  - size *Число (+15.0)Размер файла (байт)52 428 800
  - name *Строка переменная (255)Имя файла1cv8.cf
  - date *Дата и время в строке формата ISOДата файла
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/file/list",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"list": [
{
"file_type": "ConfigurationUpdate",
"file_id": "a741f8ef-2bfa-4a4c-b8e3-17ae36f39035",
"size": 52428800,
"name": "1cv8.cf",
"date": "2019-02-26T11:52:08"
}
],
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/file_token/download

Получить талон на скачивание файла элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
directionСтрока переменная (8)Направление передачи данныхdownload
token *Строка переменная (64)Талон на загрузку или скачивание файла хранилищаbacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/file_token/download",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"direction": "download",
"token": "bacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb",
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

 Вверх

configuration/version/source/file_token/upload

Получить талон на загрузку файла элемента цепочки обновления

ПараметрТипОписаниеПример
Запрос
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
nameСтрока переменная (255)Имя файла1cv8.cfu
sizeЧисло (+15.0)Размер файла (байт)52 428 800
advancedcheck *БулевоДополнительно проверить и обработать двоичные данные файла обновления (*.cfu)Да
Ответ
target_conf_idСтрока переменная (9)Код целевой конфигурацииsm
target_versionСтрока переменная (18)Номер целевой версии1.0.82.32
source_conf_idСтрока переменная (9)Код исходной конфигурацииsm
source_versionСтрока переменная (18)Номер исходной версии1.0.82.31
file_typeСтрока переменная (50)Назначение файлаConfigurationUpdate
directionСтрока переменная (8)Направление передачи данныхupload
token *Строка переменная (64)Талон на загрузку или скачивание файла хранилищаbacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb
Пример запроса
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"name": "1cv8.cfu",
"size": 52428800,
"advancedcheck": true,
"general": {
"version": 6,
"type": "srv",
"method": "configuration/version/source/file_token/upload",
"debug": true
}
}
Пример ответа
{
"target_conf_id": "sm",
"target_version": "1.0.82.32",
"source_conf_id": "sm",
"source_version": "1.0.82.31",
"file_type": "ConfigurationUpdate",
"direction": "upload",
"token": "bacff7f85e0fec5a0aba0b7a2e705a7c09b352dc196b45cab40897aae42a59eb",
"general": {
"response": 10200,
"error": false,
"message": "",
"version": 6,
"sm_version": "1.0.82.31",
"sm_timezone": "Europe/Moscow"
}
}

Важная особенность

При загрузке больших файлов (более 500 Мбайт) следует учитывать, что файл может быть доступен для использования лишь через некоторое время после его закачки и получения его идентификатора. Рекомендуется перед использованием файла проверить его фактическую регистрацию в данных менеджера сервиса.

 Вверх