Áú»¢¶Ä²©

This is the documentation page for an unsupported version of Áú»¢¶Ä²©.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

configuration.import

Description

boolean configuration.import(object parametres)

Cette m¨¦thode permet d'importer des donn¨¦es de configuration ¨¤ partir d'une cha?ne s¨¦rialis¨¦e.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ

(object) ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ contenant les donn¨¦es ¨¤ importer et les r¨¨gles de traitement des donn¨¦es.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð Type Description
format
(requis)
string Format de la cha?ne s¨¦rialis¨¦e.

Valeurs possibles:
json - JSON;
xml - XML.
source
(requis)
string Cha?ne s¨¦rialis¨¦e contenant les donn¨¦es de configuration.
rules
(requis)
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, la configuration ne sera pas mise ¨¤ jour.

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

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð Type Description
applications object R¨¨gles sur la fa?on d'importer des applications.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouvelles applications seront cr¨¦¨¦es; par d¨¦faut: false;
deleteMissing - (boolean) Si initialis¨¦ ¨¤ true, les applications non pr¨¦sentes dans les donn¨¦es import¨¦es seront supprim¨¦es de la base de donn¨¦es; par d¨¦faut: false.
discoveryRules object R¨¨gles sur la fa?on d'importer les r¨¨gles LLD.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouveau groupes d'h?tes seront cr¨¦¨¦s; par d¨¦faut: false.
hosts object R¨¨gles sur la fa?on d'importer des h?tes.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.
images object R¨¨gles sur la fa?on d'importer des images.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.
items object R¨¨gles sur la fa?on d'importer des ¨¦l¨¦ments.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.
screens object R¨¨gles sur la fa?on d'importer des ¨¦crans.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouveaux ¨¦crans seront cr¨¦¨¦s; par d¨¦faut: false;
updateExisting - (boolean) Si initialis¨¦ ¨¤ true, les ¨¦crans existants seront mis ¨¤ jour; par d¨¦faut: false.
templateLinkage object R¨¨gles sur la fa?on d'importer des liens de mod¨¨les.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouveaux liens entre mod¨¨les et h?tes seront cr¨¦¨¦s; par d¨¦faut: false.
templates object R¨¨gles sur la fa?on d'importer des mod¨¨les.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouveaux mod¨¨les seront cr¨¦¨¦s; par d¨¦faut: false;
updateExisting - (boolean) Si initialis¨¦ ¨¤ true, mes mod¨¨les existants seront mis ¨¤ jour; par d¨¦faut: false.
templateScreens object R¨¨gles sur la fa?on d'importer des ¨¦crans de mod¨¨le.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ pris en charge:
createMissing - (boolean) Si initialis¨¦ ¨¤ true, les nouveaux ¨¦crans de mod¨¨le seront cr¨¦¨¦s; par d¨¦faut: false;
updateExisting - (boolean) Si initialis¨¦ ¨¤ true, les ¨¦crans de mod¨¨le existants seront mis ¨¤ jour; par d¨¦faut: false;
deleteMissing - (boolean) Si initialis¨¦ ¨¤ true, les ¨¦crans de mod¨¨le 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

Valeurs de retour

(boolean) Renvoie true si l'importation a r¨¦ussi.

Exemples

Importer des h?tes et des ¨¦l¨¦ments

Importez l'h?te et les ¨¦l¨¦ments contenus dans la cha?ne XML. Si des ¨¦l¨¦ments de la cha?ne XML sont manquants, ils seront supprim¨¦s de la base de donn¨¦es et tout le reste ne sera pas modifi¨¦.

¸é±ð±ç³Ü¨º³Ù±ð:

{
           "jsonrpc": "2.0",
           "method": "configuration.import",
           "params": {
               "format": "xml",
               "rules": {
                   "applications": {
                       "createMissing": true,
                       "deleteMissing": false
                   },
                   "valueMaps": {
                       "createMissing": true,
                       "updateExisting": false
                   },
                   "hosts": {
                       "createMissing": true,
                       "updateExisting": true
                   },
                   "items": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   }
               },
               "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>4.0</version><date>2012-04-18T11:20:14Z</date><groups><group><name>Áú»¢¶Ä²© servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><description/><proxy/><status>0</status><ipmi_authtype>-1</ipmi_authtype><ipmi_privilege>2</ipmi_privilege><ipmi_username/><ipmi_password/><tls_connect>1</tls_connect><tls_accept>1</tls_accept><tls_issuer/><tls_subject/><tls_psk_identity/><tls_psk/><templates/><groups><group><name>Áú»¢¶Ä²© servers</name></group></groups><interfaces><interface><default>1</default><type>1</type><useip>1</useip><ip>127.0.0.1</ip><dns/><port>10050</port><bulk>1</bulk><interface_ref>if1</interface_ref></interface></interfaces><applications><application><name>Application</name></application></applications><items><item><name>Item</name><type>0</type><snmp_community/><snmp_oid/><key>item.key</key><delay>30s</delay><history>90d</history><trends>365d</trends><status>0</status><value_type>3</value_type><allowed_hosts/><units/><snmpv3_contextname/><snmpv3_securityname/><snmpv3_securitylevel>0</snmpv3_securitylevel><snmpv3_authprotocol>0</snmpv3_authprotocol><snmpv3_authpassphrase/><snmpv3_privprotocol>0</snmpv3_privprotocol><snmpv3_privpassphrase/><params/><ipmi_sensor/><authtype>0</authtype><username/><password/><publickey/><privatekey/><port/><description/><inventory_link>0</inventory_link><applications><application><name>Application</name></application></applications><valuemap><name>Host status</name></valuemap><logtimefmt/><preprocessing/><interface_ref>if1</interface_ref><jmx_endpoint/><timeout>3s</timeout><url/><query_fields/><posts/><status_codes>200</status_codes><follow_redirects>1</follow_redirects><post_type>0</post_type><http_proxy/><headers/><retrieve_mode>0</retrieve_mode><request_method>1</request_method><output_format>0</output_format><allow_traps>0</allow_traps><ssl_cert_file/><ssl_key_file/><ssl_key_password/><verify_peer>0</verify_peer><verify_host>0</verify_host><master_item/></item></items><discovery_rules/><macros/><inventory/></host></hosts><triggers><trigger><expression>{Export host:item.key.last()}=0</expression><name>Trigger</name><url/><status>0</status><priority>2</priority><description>Host trigger</description><type>0</type><recovery_mode>1</recovery_mode><recovery_expression>{Export host:item.key.last()}=2</recovery_expression><dependencies/><tags/><correlation_mode>1</correlation_mode><correlation_tag>Tag 01</correlation_tag><manual_close>0</manual_close></trigger></triggers><graphs><graph><name>Graph</name><width>900</width><height>200</height><yaxismin>0.0000</yaxismin><yaxismax>100.0000</yaxismax><show_work_period>1</show_work_period><show_triggers>1</show_triggers><type>0</type><show_legend>1</show_legend><show_3d>0</show_3d><percent_left>0.0000</percent_left><percent_right>0.0000</percent_right><ymin_type_1>0</ymin_type_1><ymax_type_1>0</ymax_type_1><ymin_item_1>0</ymin_item_1><ymax_item_1>0</ymax_item_1><graph_items><graph_item><sortorder>0</sortorder><drawtype>0</drawtype><color>C80000</color><yaxisside>0</yaxisside><calc_fnc>7</calc_fnc><type>0</type><item><host>Export host</host><key>item.key</key></item></graph_item></graph_items></graph></graphs><value_maps><value_map><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></value_map></value_maps></zabbix_export>"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

¸é¨¦±è´Ç²Ô²õ±ð:

{
           "jsonrpc": "2.0",
           "result": true,
           "id": 1
       }

Source

CConfiguration::import() dans frontends/php/include/classes/api/services/CConfiguration.php.