[comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### Descripción `array configuration.importcompare(object parameters)` Este método permite comparar un archivo de importación con los elementos actuales del sistema y muestra qué se cambiará si se importa este archivo. ::: noteclassic Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para más información. ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({fa5f4195-0ae26f0f}) ### Parámetros `(object)` Parámetros que contienen los posibles datos a importar y las reglas sobre cómo se deben gestionar los datos. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |format|string|Formato de la cadena serializada.

Valores posibles:
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *required*| |source|string|Cadena serializada que contiene los datos de configuración.

[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *required*| |rules|object|Reglas sobre cómo se deben comparar los objetos nuevos y existentes.

Los usuarios de tipo *Admin* y *User* pueden comparar objetos nuevos solo con aquellos existentes para los que tienen permiso de [solo lectura](/manual/api/reference/usergroup/object#permission) o [lectura y escritura](/manual/api/reference/usergroup/object#permission).

El parámetro `rules` se describe en detalle en la tabla siguiente.

[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *required*| ::: noteimportant Si no se proporcionan reglas, no habrá nada que actualizar y el resultado estará vacío. ::: ::: notetip La comparación se realizará solo para grupos de host y templates. Los triggers y los gráficos se compararán solo para los templates importados; cualquier otro se considerará "nuevo". ::: El objeto `rules` admite los siguientes parámetros. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryRules|object|Reglas sobre cómo importar reglas LLD.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevas reglas LLD; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán las reglas LLD existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, las reglas LLD que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |graphs|object|Reglas sobre cómo importar gráficos.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos gráficos; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los gráficos existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los gráficos que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |host_groups|object|Reglas sobre cómo importar grupos de host.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos grupos de host; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los grupos de host existentes; valor predeterminado: `false`.| |template_groups|object|Reglas sobre cómo importar grupos de templates.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos grupos de templates; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los grupos de templates existentes; valor predeterminado: `false`.| |hosts|object|Reglas sobre cómo importar hosts.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos hosts; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los hosts existentes; valor predeterminado: `false`.

Este parámetro no hará ninguna diferencia en la salida. Solo se permite por coherencia con `configuration.import`.| |httptests|object|Reglas sobre cómo importar escenarios web.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos escenarios web; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los escenarios web existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los escenarios web que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |images|object|Reglas sobre cómo importar imágenes.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevas imágenes; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán las imágenes existentes; valor predeterminado: `false`.

Este parámetro no hará ninguna diferencia en la salida. Solo se permite por coherencia con `configuration.import`.| |items|object|Reglas sobre cómo importar items.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos items; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los items existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los items que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |maps|object|Reglas sobre cómo importar mapas.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos mapas; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los mapas existentes; valor predeterminado: `false`.

Este parámetro no hará ninguna diferencia en la salida. Solo se permite por coherencia con `configuration.import`.| |mediaTypes|object|Reglas sobre cómo importar tipos de medios.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos tipos de medios; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los tipos de medios existentes; valor predeterminado: `false`.

Este parámetro no hará ninguna diferencia en la salida. Solo se permite por coherencia con `configuration.import`.| |templateLinkage|object|Reglas sobre cómo importar enlaces de templates.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se enlazarán los templates que no estén vinculados al host o template que se está importando, pero que estén presentes en los datos importados; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, se desvincularán los templates que estén vinculados al host o template que se está importando, pero que no estén presentes en los datos importados, sin eliminar las entidades (items, triggers, etc.) heredadas de los templates desvinculados; valor predeterminado: `false`.| |templates|object|Reglas sobre cómo importar templates.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos templates; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los templates existentes; valor predeterminado: `false`.| |templateDashboards|object|Reglas sobre cómo importar paneles de templates.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos paneles de templates; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los paneles de templates existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los paneles de templates que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |triggers|object|Reglas sobre cómo importar triggers.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos triggers; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los triggers existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los triggers que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| |valueMaps|object|Reglas sobre cómo importar mapas de valores de host o template.

Parámetros admitidos:
`createMissing` - `(boolean)` si se establece en `true`, se crearán nuevos mapas de valores; valor predeterminado: `false`;
`updateExisting` - `(boolean)` si se establece en `true`, se actualizarán los mapas de valores existentes; valor predeterminado: `false`;
`deleteMissing` - `(boolean)` si se establece en `true`, los mapas de valores que no estén presentes en los datos importados se eliminarán de la base de datos; valor predeterminado: `false`.| [comment]: # ({/fa5f4195-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### Valores de retorno `(array)` Devuelve un array con los cambios en la configuración que se realizarán. [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### Ejemplos [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({e4aded1b-d979e902}) #### Comparando la importación de un template Compare el template contenido en la cadena XML con los elementos actuales del sistema, y muestre qué cambiará si se importa este template. [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.07df96b18c230490a9a0a9e2307226338Templates\n" }, "id": 1 } ``` Respuesta: ```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]: # ({/e4aded1b-d979e902}) [comment]: # ({f4cf61e8-c9a0185c}) ### Fuente CConfiguration::importcompare() en *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})