Методы группы 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 * | Строка неограниченной длины | Подсистемы конфигурации, в состав которых входит объект | Налоги.Документы; ОбъектыЗарплата; Отчетность.НДФЛ; УниверсальныйЖурнал.НДФЛ |
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 | Строка неограниченной длины | Решение по инциденту | ЯвляетсяОшибкой |
Ответ | |||
Нет параметров |
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 Мбайт) следует учитывать, что файл может быть доступен для использования лишь через некоторое время после его закачки и получения его идентификатора. Рекомендуется перед использованием файла проверить его фактическую регистрацию в данных менеджера сервиса.