[comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### Opis `array configuration.importcompare(object parameters)` Ta metoda umożliwia porównanie pliku importu z bieżącymi elementami systemu i pokazuje, co zostanie zmienione, jeśli ten plik importu zostanie zaimportowany. noteclassic Metoda ta jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania tej metody można cofnąć w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({fa5f4195-0ae26f0f}) ### Parametry `(object)` Parametry zawierające możliwe dane do zaimportowania oraz reguły określające sposób ich przetwarzania. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |format|string|Format serializowanego ciągu.

Możliwe wartości:
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *required*| |source|string|Serializowany ciąg zawierający dane konfiguracyjne.

[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *required*| |rules|object|Reguły określające sposób porównywania nowych i istniejących obiektów.

Użytkownicy typu *Admin* i *User* mogą porównywać nowe obiekty tylko z istniejącymi, dla których mają uprawnienia *read-only* lub *read-write* [permission](/manual/api/reference/usergroup/object#permission).

Parametr `rules` jest szczegółowo opisany w tabeli poniżej.

[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *required*| ::: noteimportant Jeśli nie zostaną podane żadne reguły, nie będzie nic do zaktualizowania, a wynik będzie pusty. ::: ::: notetip Porównanie będzie wykonywane tylko dla grup hostów i szablonów. Wyzwalacze i wykresy będą porównywane tylko dla importowanych szablonów, wszystkie pozostałe zostaną uznane za "new". ::: Obiekt `rules` obsługuje następujące parametry. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryRules|object|Reguły określające sposób importu reguł LLD.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe reguły LLD; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące reguły LLD zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, reguły LLD nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |graphs|object|Reguły określające sposób importu wykresów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe wykresy; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące wykresy zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, wykresy nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |host_groups|object|Reguły określające sposób importu grup hostów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe grupy hostów; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące grupy hostów zostaną zaktualizowane; domyślnie: `false`.| |template_groups|object|Reguły określające sposób importu grup szablonów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe grupy szablonów; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące grupy szablonów zostaną zaktualizowane; domyślnie: `false`.| |hosts|object|Reguły określające sposób importu hostów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe hosty; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące hosty zostaną zaktualizowane; domyślnie: `false`.

Ten parametr nie wpływa na wynik. Jest dozwolony wyłącznie ze względów spójności z `configuration.import`.| |httptests|object|Reguły określające sposób importu scenariuszy webowych.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe scenariusze webowe; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące scenariusze webowe zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, scenariusze webowe nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |images|object|Reguły określające sposób importu obrazów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe obrazy; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące obrazy zostaną zaktualizowane; domyślnie: `false`.

Ten parametr nie wpływa na wynik. Jest dozwolony wyłącznie ze względów spójności z `configuration.import`.| |items|object|Reguły określające sposób importu pozycji.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe pozycje; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące pozycje zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, pozycje nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |maps|object|Reguły określające sposób importu map.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe mapy; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące mapy zostaną zaktualizowane; domyślnie: `false`.

Ten parametr nie wpływa na wynik. Jest dozwolony wyłącznie ze względów spójności z `configuration.import`.| |mediaTypes|object|Reguły określające sposób importu typów mediów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe typy mediów; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące typy mediów zostaną zaktualizowane; domyślnie: `false`.

Ten parametr nie wpływa na wynik. Jest dozwolony wyłącznie ze względów spójności z `configuration.import`.| |templateLinkage|object|Reguły określające sposób importu powiązań szablonów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, szablony, które nie są powiązane z importowanym hostem lub szablonem, ale są obecne w importowanych danych, zostaną powiązane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, szablony, które są powiązane z importowanym hostem lub szablonem, ale nie są obecne w importowanych danych, zostaną odłączone bez usuwania encji (pozycji, wyzwalaczy itp.) odziedziczonych z odłączonych szablonów; domyślnie: `false`.| |templates|object|Reguły określające sposób importu szablonów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe szablony; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące szablony zostaną zaktualizowane; domyślnie: `false`.| |templateDashboards|object|Reguły określające sposób importu pulpitów szablonów.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe pulpity szablonów; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące pulpity szablonów zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, pulpity szablonów nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |triggers|object|Reguły określające sposób importu wyzwalaczy.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe wyzwalacze; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące wyzwalacze zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, wyzwalacze nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| |valueMaps|object|Reguły określające sposób importu map wartości hosta lub szablonu.

Obsługiwane parametry:
`createMissing` - `(boolean)` jeśli ustawione na `true`, zostaną utworzone nowe mapy wartości; domyślnie: `false`;
`updateExisting` - `(boolean)` jeśli ustawione na `true`, istniejące mapy wartości zostaną zaktualizowane; domyślnie: `false`;
`deleteMissing` - `(boolean)` jeśli ustawione na `true`, mapy wartości nieobecne w importowanych danych zostaną usunięte z bazy danych; domyślnie: `false`.| [comment]: # ({/fa5f4195-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### Zwracane wartości `(array)` Zwraca tablicę ze zmianamy w konfiguracji, które zostaną wprowadzone. [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### Przykłady [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({ee3ffa2c-d979e902}) #### Porównanie importu szablonu Porównaj szablon zawarty w ciągu XML z bieżącymi elementami systemu i pokaż, co zostanie zmienione, jeśli ten szablon zostanie zaimportowany. [Żądanie](/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": "\n7.47df96b18c230490a9a0a9e2307226338Templates\n" }, "id": 1 } ``` Odpowiedź: ```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]: # ({/ee3ffa2c-d979e902}) [comment]: # ({f4cf61e8-c9a0185c}) ### Źródło CConfiguration::importcompare() w *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})