configuration.import

Опис

boolean configuration.import(object parameters)

Овај метод омогућава увоз података о конфигурацији из серијализованог стринга.

Овај метод је доступан корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте User roles за више информација.

Параметри

(object) Параметри који садрже податке за увоз и правила како би ти подаци требало да буду обрађени.

Parameter Type Description
format string Формат серијализованог низа.

Могуће вредности:
yaml - YAML;
xml - XML;
json - JSON.

Понашање параметра:
- обавезно
source string Серијализовани стринг који садржи конфигурационе податке.

Понашање параметра:
- обавезно
rules object Правила о томе како треба увозити нове и постојеће објекте.

Корисници типа Администратор могу увозити само оне објекте за које имају [дозволу] за читање-писање (/manual/api/reference/usergroup/object#permission), као и мапе. На пример, домаћин и његови ентитети (ставке, окидачи, графикони, итд.) могу се увозити само ако корисничка група корисника има дозволу за групу домаћина којој ће увезени домаћин припадати. Корисници типа Администратор не могу увозити слике и типове медија.

Параметар rules је детаљно описан у табели испод.

Понашање параметра:
- обавезно

Ако нису дата правила, конфигурација се неће ажурирати.

Објекат rules подржава следеће параметре.

Parameter Type 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) ако је постављено наn 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, постојећи типови медија ће бити ажурирани; подразумеванo: 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.

Повратне вредности

(boolean) Враћа true ако је увоз био успешан.

Примери

Увоз шаблона

Увезите конфигурацију шаблона садржану у XML стрингу. Ако неке ставке или окидачи у XML стрингу недостају, биће обрисани из базе података, а све остало ће остати непромењено.

Захтев:

{
          "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": "<?xml version=\"1.0\" кодирање=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Шаблони</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>Нови шаблон</template><name>Нови шаблон</name><groups><group><name>Шаблони</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix агент пинг</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Време рада Apache сервера</name><type>ЗАВИСНО</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>ТЕКСТ</value_type><препроцесирање><step><type>РЕГЕКС</type><parameters><parameter><dt>Време рада сервера: (.*)<\/dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>Оптерећење процесора</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)>2</expression><name>Оптерећење процесора је превисоко на {HOST.HOST} за 3 минута</name><priority>УПОЗОРЕЊЕ</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Статус Apache сервера</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>ТЕКСТ</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Пинг Zabbix агента</name><mappings><mapping><value>1</value><newvalue>Доступно</newvalue></mapping><mapping><value>0</value><newvalue>Није доступно</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n"
          },
          "id": 1
       }

Одговор:

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

Извор

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