[comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### 説明 `array configuration.importcompare(object parameters)` このメソッドは、インポートファイルを現在のシステム要素と比較し、このインポートファイルがインポートされる場合に何が変更されるかを表示することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/users/user_roles)を参照してください。 ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({dee760dc-0ae26f0f}) ### パラメーター `(object)` インポートするデータを含むパラメーターと、データの処理方法を規定します。 |パラメーター|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |format|string|シリアル化された文字列のフォーマット。

利用可能な値:
`yaml` - YAML
`xml` - XML
`json` - JSON

[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *必須*| |source|string|設定データを含むシリアル化された文字列。

[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *必須*| |rules|object|新しいオブジェクトと既存のオブジェクトを比較する方法に関するルール。

`rules`パラメーターについては、以下の表で詳しく説明します。

[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *必須*| ::: notetip ルールが指定されていない場合、設定は更新されず、結果は空になります。 ::: ::: notetip 比較はホストグループとテンプレートに対してのみ行われます。 トリガーとグラフはインポートされたテンプレートについてのみ比較され、その他は"新規"とみなされます。 ::: `rules`オブジェクトは次のパラメーターをサポートします。 |パラメーター|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |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`

このパラメーターは出力に影響を与えません。これは`configuration.import`との一貫性を保つためにのみ許可されます。| |httptests|object|Webシナリオのインポート方法に関するルール。

サポートするパラメーター:
`createMissing` - `(boolean)` `true`に設定すると、新しいWebシナリオが作成されます。デフォルト: `false`
`updateExisting` - `(boolean)` `true`に設定すると、既存のWebシナリオが更新されます。デフォルト: `false`
`deleteMissing` - `(boolean)` `true`に設定すると、インポートされたデータに存在しないWebシナリオはデータベースから削除されます。デフォルト: `false`| |images|object|画像のインポート方法に関するルール。

サポートするパラメーター:
`createMissing` - `(boolean)` `true`に設定すると、新しい画像が作成されます。デフォルト: `false`
`updateExisting` - `(boolean)` `true`に設定すると、既存の画像は更新されます。デフォルト: `false`

このパラメーターは出力に影響を与えません。これは`configuration.import`との一貫性を保つためにのみ許可されます。| |items|object|アイテムのインポート方法に関するルール。

サポートするパラメーター:
`createMissing` - `(boolean)` `true`に設定すると、新しいアイテムが作成されます。デフォルト: `false`
`updateExisting` - `(boolean)` `true`に設定すると、既存のアイテムは更新されます。デフォルト: `false`
`deleteMissing` - `(boolean)` `true`に設定すると、インポートされたデータに存在しないアイテムはデータベースから削除されます。デフォルト: `false`| |maps|object|マップのインポート方法に関するルール。

サポートするパラメーター:
`createMissing` - `(boolean)` `true`に設定すると、新しいマップが作成されます。デフォルト: `false`
`updateExisting` - `(boolean)` `true`に設定すると、既存のマップは更新されます。デフォルト: `false`

このパラメーターは出力に影響を与えません。これは`configuration.import`との一貫性を保つためにのみ許可されます。| |mediaTypes|object|メディアタイプのインポート方法に関するルール。

サポートするパラメーター:
`createMissing` - `(boolean)` `true`に設定すると、新しいメディアタイプが作成されます。デフォルト: `false`
`updateExisting` - `(boolean)` `true`に設定すると、既存のメディアタイプは更新されます。デフォルト: `false`

このパラメーターは出力に影響を与えません。これは`configuration.import`との一貫性を保つためにのみ許可されます。| |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]: # ({/dee760dc-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### 戻り値 `(array)` 行われる設定の変更を含む配列を返します。 [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### 例 [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({429abad0-d979e902}) #### テンプレートのインポートの比較 XML文字列に含まれるテンプレートを現在のシステム要素と比較し、このテンプレートがインポートされた場合に何が変更されるかを示します。 [リクエスト](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "host_groups": { "createMissing": true, "updateExisting": true }, "template_groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "\n6.47df96b18c230490a9a0a9e2307226338Templates\n" }, "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` [comment]: # ({/429abad0-d979e902}) [comment]: # ({f4cf61e8-c9a0185c}) ### ソース CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})