boolean configuration.import(object parameters)
このメソッドは、シリアル化された文字列から設定データをインポートすることができます。
このメソッドは、あらゆるタイプのユーザーが利用できます。 メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。 詳細は、ユーザーの役割を参照してください。
(object)
インポートするデータと、そのデータをどのように処理するかのルールを含むパラメータ
パラメータ | Type | 説明 |
---|---|---|
format (required) |
string | Format of the serialized string. Possible values: yaml - YAML;xml - XML;json - JSON. |
source (required) |
string | Serialized string containing the configuration data. |
rules (required) |
object | Rules on how new and existing objects should be imported. The rules parameter is described in detail in the table below. |
ルールが与えられない場合、設定は更新されない。
rules
オブジェクトは以下のパラメータをサポートしています。
パラメータ | Type | 説明 |
---|---|---|
discoveryRules | object | Rules on how to import LLD rules. Supported parameters: createMissing - (boolean) if set to true , new LLD rules will be created; default: false ;updateExisting - (boolean) if set to true , existing LLD rules will be updated; default: false ;deleteMissing - (boolean) if set to true , LLD rules not present in the imported data will be deleted from the database; default: false . |
graphs | object | Rules on how to import graphs. Supported parameters: createMissing - (boolean) if set to true , new graphs will be created; default: false ;updateExisting - (boolean) if set to true , existing graphs will be updated; default: false ;deleteMissing - (boolean) if set to true , graphs not present in the imported data will be deleted from the database; default: false . |
groups | object | Rules on how to import host groups. Supported parameters: createMissing - (boolean) if set to true , new host groups will be created; default: false ;updateExisting - (boolean) if set to true , existing host groups will be updated; default: false . |
hosts | object | Rules on how to import hosts. Supported parameters: createMissing - (boolean) if set to true , new hosts will be created; default: false ;updateExisting - (boolean) if set to true , existing hosts will be updated; default: false . |
httptests | object | Rules on how to import web scenarios. Supported parameters: createMissing - (boolean) if set to true , new web scenarios will be created; default: false ;updateExisting - (boolean) if set to true , existing web scenarios will be updated; default: false ;deleteMissing - (boolean) if set to true , web scenarios not present in the imported data will be deleted from the database; default: false . |
images | object | Rules on how to import images. Supported parameters: createMissing - (boolean) if set to true , new images will be created; default: false ;updateExisting - (boolean) if set to true , existing images will be updated; default: false . |
items | object | Rules on how to import items. Supported parameters: createMissing - (boolean) if set to true , new items will be created; default: false ;updateExisting - (boolean) if set to true , existing items will be updated; default: false ;deleteMissing - (boolean) if set to true , items not present in the imported data will be deleted from the database; default: false . |
maps | object | Rules on how to import maps. Supported parameters: createMissing - (boolean) if set to true , new maps will be created; default: false ;updateExisting - (boolean) if set to true , existing maps will be updated; default: false . |
mediaTypes | object | Rules on how to import media types. Supported parameters: createMissing - (boolean) if set to true , new media types will be created; default: false ;updateExisting - (boolean) if set to true , existing media types will be updated; default: false . |
templateLinkage | object | Rules on how to import template links. Supported parameters: createMissing - (boolean) if set to true , new links between templates and host will be created; default: false ;deleteMissing - (boolean) if set to true , template links not present in the imported data will be deleted from the database; default: false . |
templates | object | Rules on how to import templates. Supported parameters: createMissing - (boolean) if set to true , new templates will be created; default: false ;updateExisting - (boolean) if set to true , existing templates will be updated; default: false . |
templateDashboards | object | Rules on how to import template dashboards. Supported parameters: createMissing - (boolean) if set to true , new template dashboards will be created; default: false ;updateExisting - (boolean) if set to true , existing template dashboards will be updated; default: false ;deleteMissing - (boolean) if set to true , template dashboards not present in the imported data will be deleted from the database; default: false . |
triggers | object | Rules on how to import triggers. Supported parameters: createMissing - (boolean) if set to true , new triggers will be created; default: false ;updateExisting - (boolean) if set to true , existing triggers will be updated; default: false ;deleteMissing - (boolean) if set to true , triggers not present in the imported data will be deleted from the database; default: false . |
valueMaps | object | Rules on how to import host or template value maps. Supported parameters: createMissing - (boolean) if set to true , new value maps will be created; default: false ;updateExisting - (boolean) if set to true , existing value maps will be updated; default: false ;deleteMissing - (boolean) if set to true , value maps not present in the imported data will be deleted from the database; default: false . |
(boolean)
インポートに成功した場合は true
を返します。
XML 文字列に含まれるホストと item をインポートします。XML に含まれる item が欠落している場合、その item は
データベースから削除され、それ以外は変更されずに残ります。
Request:
{
"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
}
Response:
CConfiguration::import() は ui/include/classes/api/services/CConfiguration.php にあります。