[comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### Description `array configuration.importcompare(object parameters)` Cette méthode permet de comparer un fichier d’importation avec les éléments actuels du système et indique ce qui sera modifié si ce fichier d’importation est importé. ::: noteclassic 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 [User roles](/manual/web_interface/frontend_sections/users/user_roles) pour plus d’informations. ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({fa5f4195-0ae26f0f}) ### Paramètres `(object)` Paramètres contenant les données possibles à importer et les règles indiquant comment les données doivent être traitées. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |format|string|Format de la chaîne sérialisée.

Valeurs possibles :
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):
- *required*| |source|string|Chaîne sérialisée contenant les données de configuration.

[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):
- *required*| |rules|object|Règles indiquant comment les objets nouveaux et existants doivent être comparés.

Les utilisateurs de type *Admin* et *User* peuvent comparer les nouveaux objets uniquement avec les objets existants pour lesquels ils disposent d'une [permission](/manual/api/reference/usergroup/object#permission) en *lecture seule* ou en *lecture-écriture*.

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

[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):
- *required*| ::: noteimportant Si aucune règle n'est fournie, il n'y aura rien à mettre à jour et le résultat sera vide. ::: ::: notetip 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 élément sera considéré comme "new". ::: L'objet `rules` prend en charge les paramètres suivants. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryRules|object|Règles indiquant comment importer les règles de découverte LLD.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouvelles règles LLD seront créées ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les règles LLD existantes seront mises à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les règles LLD absentes des données importées seront supprimées de la base de données ; valeur par défaut : `false`.| |graphs|object|Règles indiquant comment importer les graphiques.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux graphiques seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les graphiques existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les graphiques absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| |host_groups|object|Règles indiquant comment importer les groupes d'hôtes.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux groupes d'hôtes seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les groupes d'hôtes existants seront mis à jour ; valeur par défaut : `false`.| |template_groups|object|Règles indiquant comment importer les groupes de modèles.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux groupes de modèles seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les groupes de modèles existants seront mis à jour ; valeur par défaut : `false`.| |hosts|object|Règles indiquant comment importer les hôtes.

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

Ce paramètre n'aura aucune incidence sur la sortie. Il est autorisé uniquement pour assurer la cohérence avec `configuration.import`.| |httptests|object|Règles indiquant comment importer les scénarios web.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux scénarios web seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les scénarios web existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les scénarios web absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| |images|object|Règles indiquant comment importer les images.

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

Ce paramètre n'aura aucune incidence sur la sortie. Il est autorisé uniquement pour assurer la cohérence avec `configuration.import`.| |items|object|Règles indiquant comment importer les éléments.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux éléments seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les éléments existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les éléments absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| |maps|object|Règles indiquant comment importer les cartes.

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

Ce paramètre n'aura aucune incidence sur la sortie. Il est autorisé uniquement pour assurer la cohérence avec `configuration.import`.| |mediaTypes|object|Règles indiquant comment importer les types de média.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux types de média seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les types de média existants seront mis à jour ; valeur par défaut : `false`.

Ce paramètre n'aura aucune incidence sur la sortie. Il est autorisé uniquement pour assurer la cohérence avec `configuration.import`.| |templateLinkage|object|Règles indiquant comment importer les liens de modèles.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, les modèles qui ne sont pas liés à l'hôte ou au modèle en cours d'importation, mais qui sont présents dans les données importées, seront liés ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les modèles liés à l'hôte ou au modèle en cours d'importation, mais absents des données importées, seront dissociés sans supprimer les entités (éléments, déclencheurs, etc.) héritées des modèles dissociés ; valeur par défaut : `false`.| |templates|object|Règles indiquant comment importer les modèles.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux modèles seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les modèles existants seront mis à jour ; valeur par défaut : `false`.| |templateDashboards|object|Règles indiquant comment importer les tableaux de bord de modèles.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux tableaux de bord de modèles seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les tableaux de bord de modèles existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les tableaux de bord de modèles absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| |triggers|object|Règles indiquant comment importer les déclencheurs.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux déclencheurs seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les déclencheurs existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les déclencheurs absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| |valueMaps|object|Règles indiquant comment importer les mappages de valeurs de l'hôte ou du modèle.

Paramètres pris en charge :
`createMissing` - `(boolean)` si défini sur `true`, de nouveaux mappages de valeurs seront créés ; valeur par défaut : `false` ;
`updateExisting` - `(boolean)` si défini sur `true`, les mappages de valeurs existants seront mis à jour ; valeur par défaut : `false` ;
`deleteMissing` - `(boolean)` si défini sur `true`, les mappages de valeurs absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.| [comment]: # ({/fa5f4195-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### Valeurs retournées `(array)` Renvoie un tableau avec les changements de configuration qui seront effectués. [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### Exemples [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({ee3ffa2c-d979e902}) #### Comparaison de l'import d'un modèle Compare le modèle contenu dans la chaîne XML avec les éléments actuels du système, et affiche ce qui sera modifié si ce modèle est importé. [Requête](/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 } ``` Réponse: ```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}) ### Source CConfiguration::importcompare() dans *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})