configuration.importcompare

Descrizione

array configuration.importcompare(parametri oggetto)

Questo metodo consente di confrontare il file di importazione con gli elementi del sistema corrente e mostra cosa verrà modificato se questo file di importazione verrà importato.

Questo metodo è disponibile per utenti di qualsiasi tipo. Permessi per chiamare il metodo può essere revocato nelle impostazioni del ruolo utente. Vedere Utente ruoli per maggiori informazioni.

Parametri

(object)Parametri contenenti i possibili dati da importare e regole di come devono essere gestiti i dati.

Parametri	Tipo	Descrizione
format (required)	string	Formato della stringa serializzata. Valori possibili: `yaml` - YAML; `xml` - XML; `json` - JSON.
source (required)	string	Stringa serializzata contenente i dati di configurazione.
rules (required)	object	Regole su come importare oggetti nuovi ed esistenti. Il parametro `regole` è descritto in dettaglio nella tabella seguente.

Se non vengono fornite regole, non ci sarà nulla da aggiornare e il risultato sarà vuoto.

Il confronto sarà essere fatto solo per gruppi host e modelli. Trigger e grafici saranno confrontato solo per i modelli importati, qualsiasi altro sarà considerato come "nuovo".

L'oggetto regole supporta i seguenti parametri.

Parametro	Tipo	Descrizione
discoveryRules	object	Regole su come importare le regole LLD. Parametri supportati `createMissing` - `(boolean)` se impostato su `true`, verranno create nuove regole LLD; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, le regole LLD esistenti verranno aggiornate; default: `false`; `deleteMissing` - `(boolean)`se impostato a `true`, le regole LLD non presenti nei dati importati verranno cancellate dal database; default: `false`.
graphs	object	Regole su come importare i grafici. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi grafici; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, i grafici esistenti verranno aggiornati; default: `false`; `deleteMissing` - `(boolean)`se impostato a `true`, i grafici non presenti nei dati importati verranno eliminati dal database; default: `false`.
groups	object	Regole su come importare i gruppi host. Parametri supportati: `createMissing` - `(boolean)`se impostato su `true`, verranno creati nuovi gruppi host; default: `false`; `updateExisting` - `(boolean)`se impostato su `true`, i gruppi host esistenti verranno aggiornati; default: `false`.
hosts	object	Regole su come importare host. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi host; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, gli host esistenti verranno aggiornati; default: `false`. Questo parametro non farà alcuna differenza per l'output. È consentito solo per coerenza con `configuration.import`.
httptests	object	Regole su come importare scenari web. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi scenari web; default: `false`; `updateExisting` - `(boolean)`se impostato su `true`, gli scenari web esistenti verranno aggiornati; default: `false`; `deleteMissing` - `(boolean)` if set to `true`, se impostato a `true`, gli scenari web non presenti nei dati importati verranno eliminati dal database; predefinito: `falso`.
images	object	Regole su come importare le immagini. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno create nuove immagini; default: `false`; `updateExisting` - `(boolean)`se impostato su `true`, le immagini esistenti verranno aggiornate; predefinito: `falso`. Questo parametro non farà alcuna differenza per l'output. È consentito solo per coerenza con `configuration.import`.
items	object	Regole su come importare elementi. Parametri supportati: `createMissing` - `(boolean)`se impostato su `true`, verranno creati nuovi elementi; default: `false`; `updateExisting` - `(boolean)`se impostato su `true`, gli elementi esistenti verranno aggiornati; default: `false`; `deleteMissing` - `(boolean)`se impostato a `true`, gli elementi non presenti nei dati importati verranno eliminati dal database; predefinito: `falso`.
maps	object	Regole su come importare le mappe. Parametri Supportati: `createMissing` - `(boolean)`se impostato su `true`, verranno create nuove mappe; predefinito: `falso`; `updateExisting` - `(boolean)`se impostato su `true`, le mappe esistenti verranno aggiornate; default: `false`. Questo parametro non farà alcuna differenza per l'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; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, i tipi di media esistenti verranno aggiornati; default: `false`. Questo parametro non farà alcuna differenza per l'output. È consentito solo per coerenza con `configuration.import`.
templateLinkage	object	Regole su come importare i link dei template. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi link tra i template e l'host ; default: `false`; `deleteMissing` - `(boolean)` se impostato a `true`, i link ai template non presenti nei dati importati verranno cancellati dal database; predefinito: `falso`.
templates	object	Regole su come importare modelli. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi modelli; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, i modelli esistenti verranno aggiornati; predefinito: `falso`.
templateDashboards	object	Regole su come importare i dashboard dei modelli. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi dashboard dei modelli; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, i dashboard dei modelli esistenti verranno aggiornati; default: `false`; `deleteMissing` - `(boolean)` se impostato a `true`, i dashboard dei modelli non presenti nei dati importati verranno eliminati dal database; predefinito: `falso`.
trigger	oggetto	Regole su come importare i trigger. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno creati nuovi trigger; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, i trigger esistenti verranno aggiornati; default: `false`; `deleteMissing` - `(boolean)` se impostato a `true`, i trigger non presenti nei dati importati verranno eliminati dal database; predefinito: `falso`.
valueMaps	object	Regole su come importare mappe di valori host o modelli. Parametri supportati: `createMissing` - `(boolean)` se impostato su `true`, verranno create nuove mappe di valori ; default: `false`; `updateExisting` - `(boolean)` se impostato su `true`, le mappe dei valori esistenti verranno aggiornate; default: `false`; `deleteMissing` - `(boolean)` se impostato a `true`, le mappe dei valori non presenti nei dati importati verranno cancellate dal database; predefinito: `falso`.

Restituisce i valori

(array) Restituisce un array con modifiche nella configurazione, che sarà fatto.

Esempi

Importazione di host ed elementi

Importa il modello e gli elementi contenuti nella stringa YAML. Se ci sono oggetti mancanti in YAML, verranno mostrati come eliminati e tutto il resto rimarrà invariato.

Richiesta:

{  "jsonrpc": "2.0",  "metodo": "configuration.import",  "parametri": {  "formato": "xml",  "regole": {  "gruppi": {  "createMissing": vero,  "aggiornamento esistente": vero  },  "modelli": {  "createMissing": vero,  "aggiornamento esistente": vero  },  "Oggetti": {  "createMissing": vero,  "aggiornamento esistente": vero,  "deleteMissing": vero  },  "trigger": {  "createMissing": vero,  "aggiornamento esistente": vero,  "deleteMissing": vero  },  "DiscoveryRules": {  "createMissing": vero,  "aggiornamento esistente": vero,  "deleteMissing": vero  },  "valueMaps": {  "createMissing": vero,  "aggiornamento esistente": falso  }  },  "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>27-05-2021T07:12:07Z< /date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Server Zabbix</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template >Modello di esportazione</template><name>Modello di esportazione</name><groups><group><name>Server Zabbix</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83< /uuid><name>Elemento</name><key>item.key</key><delay>30s</delay><valuemap><name>Stato host</name></valuemap><triggers><trigger ><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></ items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Regola di rilevamento</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid> name>Prototipo oggetto</name><key>prototype.key</ key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Stato host</name><mappings><mapping><value> 0</value><newvalue>Su</newvalue></mapping><mapping><value>2</value><newvalue>Irraggiungibile</newvalue></mapping></mappings></valuemap></ valuemaps></template></templates></zabbix_export>"  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 }

Risposta:

{  "jsonrpc": "2.0",  "risultato":{  "modelli":{  "aggiornato":[  {  "prima":{  "uuid":"e1bde9bf2f0544f5929f45b82502e744",  "template": "Esporta modello",  "name": "Esporta modello"  },  "dopo":{  "uuid":"e1bde9bf2f0544f5929f45b82502e744",  "template": "Esporta modello",  "name": "Esporta modello"  },  "Oggetti":{  "aggiunto":[  {  "dopo":{  "uuid":"3237bc89226e42ed8207574022470e83",  "nome": "Articolo",  "chiave":"elemento.chiave",  "ritardo": "30 anni",  "mappa dei valori":{  "name":"Stato host"  }  },  "trigger":{  "aggiunto":[  {  "dopo":{  "uuid":"bd1ed0089e4b4f35b762c9d6c599c348",  "expression":"last(/Esporta modello/item.key)=0",  "nome": "Trigger"  }  }  ]  }  }  ],  "RIMOSSO":[  {  "prima":{  "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6",  "name": "Oggetto vecchio",  "key":"ite_old.key",  "ritardo": "30 anni",  "mappa dei valori":{  "name":"Stato host"  }  }  }  ]  },  "discovery_rules":{  "aggiornato":[  {  "prima":{  "uuid":"c91616bcf4a44f349539a1b40cb0979d",  "name": "Regola di rilevamento",  "chiave":"regola.chiave"  },  "dopo":{  "uuid":"c91616bcf4a44f349539a1b40cb0979d",  "name": "Regola di rilevamento",  "chiave":"regola.chiave"  },  "item_prototypes":{  "aggiornato":[  {  "prima":{  "uuid":"7e164881825744248b3039af3435cf4b",  "name": "Prototipo di vecchio oggetto",  "key":"prototype_old.key"  },  "dopo":{  "uuid":"7e164881825744248b3039af3435cf4b",  "name":"Prototipo dell'oggetto",  "chiave":"prototipo.chiave"  }  }  ]  }  }  ]  }  }  ]  }  },  "id": 1 }

Fonte

CConfiguration::importcompare() in ui/include/classes/api/services/CConfiguration.php.

Documentation