[comment]: # ({1359fe15-1359fe15}) # configuration.import [comment]: # ({/1359fe15-1359fe15}) [comment]: # ({347dffb3-fe885a4a}) ### Описание `boolean configuration.import(параметры объекта)` Этот метод позволяет импортировать данные конфигурации из сериализованной строки. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/347dffb3-fe885a4a}) [comment]: # ({2870849b-147fd272}) ### Параметры `(object)` Параметры, содержащие данные для импорта, и правила обработки этих данных. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |format|string|Формат сериализованной строки.

Возможные значения:
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *required*| |source|string|Сериализованная строка, содержащая данные конфигурации.

[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *required*| |rules|object|Правила импорта новых и существующих объектов.

Пользователи типа *Admin* могут импортировать только те объекты, для которых у них есть [разрешение](/manual/api/reference/usergroup/object#permission) *read-write*, а также карты. Например, узел сети и его сущности (элементы данных, триггеры, графики и т. д.) могут быть импортированы только в том случае, если группа пользователей имеет разрешение на группу узлов сети, к которой будет принадлежать импортируемый узел сети. Изображения и типы оповещений не могут быть импортированы пользователями типа *Admin*.

Параметр `rules` подробно описан в таблице ниже.

[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *required*| ::: noteimportant Если правила не заданы, конфигурация не будет обновлена. ::: Объект `rules` поддерживает следующие параметры. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryRules|object|Правила импорта правил LLD.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые правила LLD; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие правила LLD будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, правила LLD, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |graphs|object|Правила импорта графиков.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые графики; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие графики будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, графики, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |host_groups|object|Правила импорта групп узлов сети.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые группы узлов сети; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие группы узлов сети будут обновлены; по умолчанию: `false`.| |template_groups|object|Правила импорта групп шаблонов.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые группы шаблонов; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие группы шаблонов будут обновлены; по умолчанию: `false`.| |hosts|object|Правила импорта узлов сети.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые узлы сети; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие узлы сети будут обновлены; по умолчанию: `false`.| |httptests|object|Правила импорта веб-сценариев.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые веб-сценарии; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие веб-сценарии будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, веб-сценарии, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |images|object|Правила импорта изображений.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые изображения; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие изображения будут обновлены; по умолчанию: `false`.| |items|object|Правила импорта элементов данных.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые элементы данных; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие элементы данных будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, элементы данных, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |maps|object|Правила импорта карт.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые карты; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие карты будут обновлены; по умолчанию: `false`.| |mediaTypes|object|Правила импорта типов оповещений.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые типы оповещений; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие типы оповещений будут обновлены; по умолчанию: `false`.| |templateLinkage|object|Правила импорта связей шаблонов.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, шаблоны, которые не связаны с импортируемым узлом сети или шаблоном, но присутствуют в импортируемых данных, будут связаны; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, шаблоны, которые связаны с импортируемым узлом сети или шаблоном, но отсутствуют в импортируемых данных, будут отвязаны без удаления сущностей (элементов данных, триггеров и т. д.), унаследованных от отвязанных шаблонов; по умолчанию: `false`.| |templates|object|Правила импорта шаблонов.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые шаблоны; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие шаблоны будут обновлены; по умолчанию: `false`.| |templateDashboards|object|Правила импорта дашбордов шаблонов.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые дашборды шаблонов; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие дашборды шаблонов будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, дашборды шаблонов, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |triggers|object|Правила импорта триггеров.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые триггеры; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие триггеры будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, триггеры, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| |valueMaps|object|Правила импорта карт значений узла сети или шаблона.

Поддерживаемые параметры:
`createMissing` - `(boolean)` если установлено значение `true`, будут созданы новые карты значений; по умолчанию: `false`;
`updateExisting` - `(boolean)` если установлено значение `true`, существующие карты значений будут обновлены; по умолчанию: `false`;
`deleteMissing` - `(boolean)` если установлено значение `true`, карты значений, отсутствующие в импортируемых данных, будут удалены из базы данных; по умолчанию: `false`.| [comment]: # ({/2870849b-147fd272}) [comment]: # ({08d02880-08d02880}) ### Возвращаемые значения `(логическое)` Возвращает `true` при успешном импорте. [comment]: # ({/08d02880-08d02880}) [comment]: # ({b41637d2-b41637d2}) ### Примеры [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({c692ed15-0801380e}) #### Импорт шаблона Импортируйте конфигурацию шаблона, содержащуюся в XML-строке. Если какие-либо элементы данных или триггеры в XML-строке отсутствуют, они будут удалены из базы данных, а все остальное останется без изменений. [Запрос](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "\n7.47df96b18c230490a9a0a9e2307226338Templates\n" }, "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` [comment]: # ({/c692ed15-0801380e}) [comment]: # ({b6dce61f-c5744b74}) ### Источник CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/b6dce61f-c5744b74})