This is a translation of the original English documentation page. Help us make it better.

Sidebar

Become a monitoring expert!
Sign up for Zabbix training

configuration.importcompare

Description

array configuration.importcompare(object parameters)

Cette méthode permet de comparer le fichier d'importation avec les éléments actuels du système et montre ce qui sera changé si ce fichier d'importation est importé.¶

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir les rôles utilisateur pour plus d'informations.

Paramètres

(object) Paramètres contenant les données possibles à importer et les règles de traitement des données.

Paramètre Type Description
format
(obligatoire)
string Format de la chaîne sérialisée.

Valeurs possibles :
yaml - YAML;
xml - XML;
json - JSON.
source
(obligatoire)
string Chaîne sérialisée contenant les données de configuration.
rules
(obligatoire)
object Règles sur la façon dont les objets nouveaux et existants doivent être importés.

Le paramètre rules est décrit en détail dans le tableau ci-dessous.

Si aucune règle n'est donnée, il n'y aura rien à mettre à jour et le résultat sera vide.

La comparaison sera effectuée uniquement pour les groupes d'hôtes et les modèles. Les déclencheurs et les graphiques seront comparés uniquement pour les modèles importés, tout autre sera considéré comme "nouveau".

L'objet rules prend en charge les paramètres suivants.

Paramètre Type Description
discoveryRules object Règles sur la façon d'importer les règles LLD.

Paramètres pris en charge :
createMissing - (boolean) Si initialisé à true, les nouvelles règles LLD seront créées ; par défaut: false ;
updateExisting - (boolean) Si initialisé à true, les règles LLD existantes seront mises à jour; par défaut: false ;
deleteMissing - (boolean) Si initialisé à true, Les règles LLD non présentes dans les données importées seront supprimées de la base de données ; par défaut: false.
graphs object Règles sur la façon d'importer des graphiques.

Paramètres pris en charge :
createMissing - (boolean) Si initialisé à true, les nouveaux graphiques seront créés ; par défaut: false ;
updateExisting - (boolean) Si initialisé à true, les graphiques existants seront mis à jour ; par défaut: false ;
deleteMissing - (boolean) Si initialisé à true, les graphiques non présents dans les données importées seront supprimés de la base de données ; par défaut: false.
groups object Règles sur l'importation des groupes d'hôtes.

Paramètres pris en charge :
createMissing - (boolean) Si initialisé à true, les nouveaux groupes d'hôtes seront créés ; par défaut : false ;
updateExisting - (boolean) Si initialisé à true, les groupes d'hôtes existants seront mis à jour ; par défaut: false.
hosts object Règles sur la façon d'importer des hôtes.

Paramètres pris en charge :
createMissing - (boolean) Si initialisé à true, les nouveaux hôtes seront créés ; par défaut : false;
updateExisting - (boolean) Si initialisé à true, les hôtes existants seront mis à jour ; par défaut: false.

Ce paramètre ne fera aucune différence sur la sortie. Il est autorisé uniquement pour la cohérence avec configuration.import.
httptests object Règles sur la façon d'importer des scénarios Web.

Paramètres pris en charge :
createMissing` - `(boolean)` Si initialisé à `true`, les nouveaux scenarios web seront créés ; par défaut: `false` ;
`updateExisting` - `(boolean)` Si initialisé à `true`, les scenarios web existants seront mis à jour ; par défaut: `false` ;
`deleteMissing` - `(boolean)` Si initialisé à `true`, les scenarios web non présents dans les données importées seront supprimés de la base de données ; par défaut: `false`.| |images|object|Règles sur la façon d'importer des images.

Paramètres pris en charge :
`createMissing` - `(boolean)` Si initialisé à `true`, les nouvelles images seront créées ; par défaut : `false`;
`updateExisting` - `(boolean)` Si initialisé à `true`, les images existantes seront mises à jour ; par défaut: `false`.

Ce paramètre ne fera aucune différence sur la sortie. Il est autorisé uniquement pour la cohérence avec `configuration.import`.| |items|object|Règles sur la façon d'importer des éléments.

Paramètres pris en charge :
createMissing-(boolean)Si initialisé àtrue, les nouveaux éléments seront créés ; par défaut:false;
updateExisting-(boolean)Si initialisé àtrue, les éléments existants seront mis à jour ; par défaut:false;
deleteMissing-(boolean)Si initialisé àtrue, les éléments non présents dans les données importées seront supprimés de la base de données ; par défaut:false.| |maps|object|Règles sur la façon d'importer des cartes.

Paramètres pris en charge :
createMissing-(boolean)Si initialisé àtrue, les nouvelles cartes seront créées ; par défaut :false;
updateExisting-(boolean)Si initialisé àtrue, les cartes existantes seront mises à jour ; par défaut:false.

Ce paramètre ne fera aucune différence sur la sortie. Il est autorisé uniquement pour la cohérence avec
configuration.import.| |mediaTypes|object|Règles sur la façon d'importer des types de médias.

Paramètres pris en charge :
createMissing-(boolean)Si initialisé àtrue, les nouveaux types de médias seront créés ; par défaut :false;
updateExisting-(boolean)Si initialisé àtrue, les types de médias existants seront mis à jour ; par défaut:false.

Ce paramètre ne fera aucune différence sur la sortie. Il est autorisé uniquement pour la cohérence avec
configuration.import.| |templateLinkage|object|Règles sur la façon d'importer les liens de modèles.

Paramètres pris en charge :
``createMissing
- (boolean) Si initialisé à true, les nouveaux liens entre modèles et hôtes seront créés ; par défaut: false ;
deleteMissing - (boolean) Si initialisé à true, les liens non présents dans les données importées seront supprimés de la base de données ; par défaut: false.
templates object Règles sur l'importation des modèles.

Paramètres pris en charge :
createMissing - (boolean) Si initialisé à true, les nouveaux modèles seront créés ; par défaut : false ;
updateExisting - (boolean) Si initialisé à true, les modèles existants seront mis à jour ; par défaut: false.
templateDashboards object Règles sur la façon d'importer des tableaux de bord des modèles.

Paramètres pris en charge :
createMissing` - `(boolean)` Si initialisé à `true`, les nouveaux tableaux de bord seront créés ; par défaut: `false` ;
`updateExisting` - `(boolean)` Si initialisé à `true`, les tableaux de bord existants seront mis à jour ; par défaut: `false` ;
`deleteMissing` - `(boolean)` Si initialisé à `true`, les tableaux de bord non présents dans les données importées seront supprimés de la base de données ; par défaut: `false`.| |triggers|object|Règles sur la façon d'importer des déclencheurs.

Paramètres pris en charge :
createMissing-(boolean)Si initialisé àtrue, les nouveaux déclencheurs seront créés ; par défaut:false;
updateExisting-(boolean)Si initialisé àtrue, les déclencheurs existants seront mis à jour ; par défaut:false;
deleteMissing-(boolean)Si initialisé àtrue, les déclencheurs non présents dans les données importées seront supprimés de la base de données ; par défaut:false.| |valueMaps|object|Règles sur la façon d'importer des tables de correspondance.

Paramètres pris en charge :
``createMissing
- (boolean) Si initialisé à true, les nouvelles tables de correspondance seront créées ; par défaut: false ;
updateExisting - (boolean) Si initialisé à true, les tables de correspondance existantes seront mises à jour ; par défaut: false ;
deleteMissing - (boolean) Si initialisé à true, les tables de correspondance non présentes dans les données importées seront supprimées de la base de données ; par défaut: false.

Valeurs retournées

(array) Renvoie un tableau avec les changements de configuration qui seront effectués.

Exemples

Import d'hôtes et d'éléments

Importez le modèle et les éléments contenus dans la chaîne YAML. S'il manque des éléments dans le YAML, ils seront affichés comme supprimés et tout le reste restera inchangé.

Requête :

{
           "jsonrpc": "2.0",
           "method": "configuration.import",
           "params": {
               "format": "xml",
               "rules": {
                   "groups": {
                       "createMissing": true,
                       "updateExisting": true
                   },
                   "templates": {
                       "createMissing": true,
                       "updateExisting": true
                   },
                   "items": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   },
                   "triggers": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   },
                   "discoveryRules": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   },
                   "valueMaps": {
                       "createMissing": true,
                       "updateExisting": false
                   }
               },
               "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</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>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
          "jsonrpc":"2.0",
          "result":{
             "templates":{
                "updated":[
                   {
                      "before":{
                         "uuid":"e1bde9bf2f0544f5929f45b82502e744",
                         "template":"Export template",
                         "name":"Export template"
                      },
                      "after":{
                         "uuid":"e1bde9bf2f0544f5929f45b82502e744",
                         "template":"Export template",
                         "name":"Export template"
                      },
                      "items":{
                         "added":[
                            {
                               "after":{
                                  "uuid":"3237bc89226e42ed8207574022470e83",
                                  "name":"Item",
                                  "key":"item.key",
                                  "delay":"30s",
                                  "valuemap":{
                                     "name":"Host status"
                                  }
                               },
                               "triggers":{
                                  "added":[
                                     {
                                        "after":{
                                           "uuid":"bd1ed0089e4b4f35b762c9d6c599c348",
                                           "expression":"last(/Export template/item.key)=0",
                                           "name":"Trigger"
                                        }
                                     }
                                  ]
                               }
                            }
                         ],
                         "removed":[
                            {
                               "before":{
                                  "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6",
                                  "name":"Old Item",
                                  "key":"ite_old.key",
                                  "delay":"30s",
                                  "valuemap":{
                                     "name":"Host status"
                                  }
                               }
                            }
                         ]
                      },
                      "discovery_rules":{
                         "updated":[
                            {
                               "before":{
                                  "uuid":"c91616bcf4a44f349539a1b40cb0979d",
                                  "name":"Discovery rule",
                                  "key":"rule.key"
                               },
                               "after":{
                                  "uuid":"c91616bcf4a44f349539a1b40cb0979d",
                                  "name":"Discovery rule",
                                  "key":"rule.key"
                               },
                               "item_prototypes":{
                                  "updated":[
                                     {
                                        "before":{
                                           "uuid":"7e164881825744248b3039af3435cf4b",
                                           "name":"Old item prototype",
                                           "key":"prototype_old.key"
                                        },
                                        "after":{
                                           "uuid":"7e164881825744248b3039af3435cf4b",
                                           "name":"Item prototype",
                                           "key":"prototype.key"
                                        }
                                     }
                                  ]
                               }
                            }
                         ]
                      }
                   }
                ]
             }
          },
          "id":1
       }

Source

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