[comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### Descrizione `array configuration.importcompare(object parameters)` Questo metodo consente di confrontare il file di importazione con gli elementi di sistema correnti e mostra cosa verrebbe modificato se questo file di importazione venisse importato. ::: noteclassic Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni dei ruoli utente. Consultare [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles) per ulteriori informazioni. ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({fa5f4195-0ae26f0f}) ### Parametri `(object)` Parametri contenenti i possibili dati da importare e le regole su come i dati devono essere gestiti. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |format|string|Formato della stringa serializzata.

Valori possibili:
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required*| |source|string|Stringa serializzata contenente i dati di configurazione.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required*| |rules|object|Regole su come gli oggetti nuovi ed esistenti devono essere confrontati.

Gli utenti di tipo *Admin* e *User* possono confrontare i nuovi oggetti solo con quelli esistenti per i quali hanno permesso *read-only* o *read-write* [permission](/manual/api/reference/usergroup/object#permission).

Il parametro `rules` è descritto in dettaglio nella tabella seguente.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required*| ::: noteimportant Se non vengono fornite regole, non ci sarà nulla da aggiornare e il risultato sarà vuoto. ::: ::: notetip Il confronto verrà eseguito solo per host group e template. I trigger e i graph saranno confrontati solo per i template importati; qualsiasi altro sarà considerato come "nuovo". ::: L'oggetto `rules` supporta i seguenti parametri. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryRules|object|Regole su come importare le regole LLD.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno create nuove regole LLD; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, le regole LLD esistenti verranno aggiornate; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, le regole LLD non presenti nei dati importati verranno eliminate dal database; predefinito: `false`.| |graphs|object|Regole su come importare i graph.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi graph; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i graph esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, i graph non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| |host_groups|object|Regole su come importare i gruppi host.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi gruppi host; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i gruppi host esistenti verranno aggiornati; predefinito: `false`.| |template_groups|object|Regole su come importare i gruppi template.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi gruppi template; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i gruppi template esistenti verranno aggiornati; predefinito: `false`.| |hosts|object|Regole su come importare gli host.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi host; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, gli host esistenti verranno aggiornati; predefinito: `false`.

Questo parametro non farà alcuna differenza nell'output. È consentito solo per coerenza con `configuration.import`.| |httptests|object|Regole su come importare gli scenari web.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi scenari web; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, gli scenari web esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, gli scenari web non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| |images|object|Regole su come importare le immagini.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno create nuove immagini; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, le immagini esistenti verranno aggiornate; predefinito: `false`.

Questo parametro non farà alcuna differenza nell'output. È consentito solo per coerenza con `configuration.import`.| |items|object|Regole su come importare gli item.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi item; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, gli item esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, gli item non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| |maps|object|Regole su come importare le mappe.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno create nuove mappe; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, le mappe esistenti verranno aggiornate; predefinito: `false`.

Questo parametro non farà alcuna differenza nell'output. È consentito solo per coerenza con `configuration.import`.| |mediaTypes|object|Regole su come importare i tipi di media.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi tipi di media; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i tipi di media esistenti verranno aggiornati; predefinito: `false`.

Questo parametro non farà alcuna differenza nell'output. È consentito solo per coerenza con `configuration.import`.| |templateLinkage|object|Regole su come importare i collegamenti dei template.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, i template non collegati all'host o al template in fase di importazione, ma presenti nei dati importati, verranno collegati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, i template collegati all'host o al template in fase di importazione, ma non presenti nei dati importati, verranno scollegati senza rimuovere le entità (item, trigger, ecc.) ereditate dai template scollegati; predefinito: `false`.| |templates|object|Regole su come importare i template.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi template; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i template esistenti verranno aggiornati; predefinito: `false`.| |templateDashboards|object|Regole su come importare i dashboard dei template.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi dashboard dei template; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i dashboard dei template esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, i dashboard dei template non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| |triggers|object|Regole su come importare i trigger.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi trigger; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i trigger esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, i trigger non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| |valueMaps|object|Regole su come importare i value map di host o template.

Parametri supportati:
`createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi value map; predefinito: `false`;
`updateExisting` - `(boolean)` se impostato su `true`, i value map esistenti verranno aggiornati; predefinito: `false`;
`deleteMissing` - `(boolean)` se impostato su `true`, i value map non presenti nei dati importati verranno eliminati dal database; predefinito: `false`.| [comment]: # ({/fa5f4195-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### Valori restituiti `(array)` Restituisce un array con le modifiche nella configurazione che verranno apportate. [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### Esempi [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({ee3ffa2c-d979e902}) #### Confronto dell'importazione di un template Confronta il template contenuto nella stringa XML con gli elementi correnti del sistema e mostra cosa verrà modificato se questo template verrà importato. [Request](/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 } ``` Response: ```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}) ### Sorgente CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})