This is a translation of the original English documentation page. Help us make it better.

configuration.import

Опис

boolean configuration.import(object parameters)

Цей метод дозволяє імпортувати конфігураційні дані з серіалізованого рядка.

Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object) Параметри, що містять дані для імпорту та правила обробки даних.

Параметр Тип Опис
формат
(обов’язково)
рядок Формат серіалізованого рядка.

Можливі значення:
yaml - YAML;
xml - XML;
>json - JSON.
джерело
(обов’язково)
рядок Серіалізований рядок, що містить дані конфігурації.
rules
(обов’язково)
object Правила імпорту нових і існуючих об’єктів.

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

Якщо правила не задано, конфігурацію не буде оновлено.

Об’єкт rules підтримує такі параметри.

Параметр Тип Опис
discoveryRules об'єкт Правила щодо імпорту правил 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, існуючі графіки будуть оновлені; default: false;
deleteMissing - (boolean) якщо встановлено значення true, графіки, яких немає в імпортованих даних, буде видалено з бази даних; за замовчуванням: false.
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, існуючі елементи буде оновлено; default: 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 об’єкт Правила імпорту посилань шаблонів.

Підтримувані параметри:
createMissing - (boolean), якщо встановлено значення true, створюватимуться нові посилання між шаблонами та хостом ; за замовчуванням: false;
deleteMissing - (boolean) якщо встановлено значення true, посилання на шаблон, яких немає в імпортованих даних, буде видалено з бази даних; за замовчуванням: false.
шаблони об'єкт Правила імпорту шаблонів.

Підтримувані параметри:
createMissing - (логічний), якщо встановлено значення true, створюватимуться нові шаблони; за замовчуванням: false;
updateExisting - (boolean) якщо встановлено значення true, існуючі шаблони будуть оновлені; за замовчуванням: false.
templateDashboards об’єкт Правила імпорту панелей інструментів шаблонів.

Підтримувані параметри:
createMissing - (boolean), якщо встановлено значення true, будуть створені нові панелі інструментів шаблону; за замовчуванням: false;
updateExisting - (boolean) якщо встановлено значення true, існуючі інформаційні панелі шаблонів буде оновлено; за замовчуванням: false;
deleteMissing - (boolean) якщо встановлено значення true, інформаційні панелі шаблонів, яких немає в імпортованих даних, буде видалено з бази даних; за замовчуванням: false.
тригери об'єкт Правила імпорту тригерів.

Підтримувані параметри:
createMissing - (boolean), якщо встановлено значення true, створюватимуться нові тригери; за замовчуванням: false;
updateExisting - (boolean) якщо встановлено значення true, існуючі тригери будуть оновлені; default: false;
deleteMissing - (boolean) якщо встановлено значення true, тригери, яких немає в імпортованих даних, буде видалено з бази даних; за замовчуванням: false.
valueMaps об’єкт Правила імпорту карт значень хосту або шаблону.

Підтримувані параметри:
createMissing - (boolean), якщо встановлено значення true, створюватимуться нові карти значень ; за замовчуванням: false;
updateExisting - (boolean) якщо встановлено значення true, існуючі карти значень буде оновлено; default: false;
deleteMissing - (boolean) якщо встановлено значення true, карти значень, яких немає в імпортованих даних, буде видалено з бази даних; за замовчуванням: false.

Повернуті значення

(boolean) Повертає true, якщо імпортування було успішним.

Приклади

Імпорт хостів і елементів

Імпортуйте хост і елементи, що містяться в рядку XML. Якщо якісь елементи в XML відсутні, їх буде видалено з бази даних, а все інше залишиться без змін.

Запит:

{
           "jsonrpc": "2.0",
           "method": "configuration.import",
           "params": {
               "format": "xml",
               "rules": {
                   "valueMaps": {
                       "createMissing": true,
                       "updateExisting": false
                   },
                   "hosts": {
                       "createMissing": true,
                       "updateExisting": true
                   },
                   "items": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   }
               },
               "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

{
           "jsonrpc": "2.0",
           "result": true,
           "id": 1
       }

Джерело

CConfiguration::import() в ui/include/classes/api/services/CConfiguration.php.