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 *	Строка переменная (150)	Вид проверки, в рамках которой зарегистрирован инцидент	Потери данных
Ответ: 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 *	Строка переменная (150)	Вид проверки, в рамках которой зарегистрирован инцидент	Потери данных
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": "Потери данных",
  "general": {
    "version": 11,
    "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": "Потери данных",
      "description": "Удален в Зарплата 5.0.33.4",
      "correction": "Данные удалены",
      "purpose": "Реквизит табличной части",
      "object_name": "Документ.НДФЛ2.ТабличнаяЧасть.ТаблицаДокумента.Реквизит.Отметка",
      "subsystems": "Налоги.Документы; ОбъектыЗарплата; Отчетность.НДФЛ; УниверсальныйЖурнал.НДФЛ"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 11,
    "sm_version": "1.0.97.2",
    "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 Мбайт) следует учитывать, что файл может быть доступен для использования лишь через некоторое время после его закачки и получения его идентификатора. Рекомендуется перед использованием файла проверить его фактическую регистрацию в данных менеджера сервиса.

Вверх