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
}
Одговор:
CConfiguration::import() у ui/include/classes/api/services/CConfiguration.php.