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

configuratie.import

Beschrijving

boolean configuration.import(object parameters)

Deze methode maakt het mogelijk om configuratiegegevens te importeren vanuit een geserialiseerde string.

Deze methode is beschikbaar voor gebruikers van elk type. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruikersrollen voor meer informatie.

Parameters

(object) Parameters die de gegevens bevatten die geïmporteerd moeten worden en regels over hoe de gegevens behandeld moeten worden.

Parameter Type Beschrijving
format string Formaat van de geserialiseerde string.

Mogelijke waarden:
yaml - YAML;
xml - XML;
json - JSON.

Parametergedrag:
- verplicht
source string Geserialiseerde string die de configuratiegegevens bevat.

Parametergedrag:
- verplicht
rules object Regels over hoe nieuwe en bestaande objecten geïmporteerd moeten worden.

De rules-parameter wordt in detail beschreven in de onderstaande tabel.

Parametergedrag:
- verplicht

Als er geen regels worden opgegeven, zal de configuratie niet worden bijgewerkt.

Het rules-object ondersteunt de volgende parameters.

Parameter Type Beschrijving
discoveryRules object Regels over hoe LLD-regels geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe LLD-regels aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande LLD-regels bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden LLD-regels die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
graphs object Regels over hoe grafieken geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe grafieken aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande grafieken bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden grafieken die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
host_groups object Regels over hoe hostgroepen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe hostgroepen aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande hostgroepen bijgewerkt; standaard: false.
template_groups object Regels over hoe sjabloongroepen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe sjabloongroepen aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande sjabloongroepen bijgewerkt; standaard: false.
hosts object Regels over hoe hosts geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe hosts aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande hosts bijgewerkt; standaard: false.
httptests object Regels over hoe webscenario's geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe webscenario's aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande webscenario's bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden webscenario's die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
images object Regels over hoe afbeeldingen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe afbeeldingen aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande afbeeldingen bijgewerkt; standaard: false.
items object Regels over hoe items geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe items aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande items bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden items die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
maps object Regels over hoe kaarten geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe kaarten aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande kaarten bijgewerkt; standaard: false.
mediaTypes object Regels over hoe mediatypen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe mediatypen aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande mediatypen bijgewerkt; standaard: false.
templateLinkage object Regels over hoe sjoemelkoppelingen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden sjablonen die niet zijn gekoppeld aan de host of het sjabloon dat wordt geïmporteerd, maar wel aanwezig zijn in de geïmporteerde gegevens, gekoppeld; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden sjablonen die zijn gekoppeld aan de host of het sjabloon dat wordt geïmporteerd, maar niet aanwezig zijn in de geïmporteerde gegevens, ontkoppeld zonder entiteiten te verwijderen (items, triggers, enz.) die zijn overgeërfd van de ontkoppelde sjablonen; standaard: false.
templates object Regels over hoe sjablonen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe sjablonen aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande sjablonen bijgewerkt; standaard: false.
templateDashboards object Regels over hoe sjabloon-dashboards geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe sjabloon-dashboards aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande sjabloon-dashboards bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden sjabloon-dashboards die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
triggers object Regels over hoe triggers geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe triggers aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande triggers bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden triggers die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.
valueMaps object Regels over hoe waardekaarten van hosts of sjablonen geïmporteerd moeten worden.

Ondersteunde parameters:
createMissing - (boolean) als dit is ingesteld op true, worden nieuwe waardekaarten aangemaakt; standaard: false;
updateExisting - (boolean) als dit is ingesteld op true, worden bestaande waardekaarten bijgewerkt; standaard: false;
deleteMissing - (boolean) als dit is ingesteld op true, worden waardekaarten die niet aanwezig zijn in de geïmporteerde gegevens, verwijderd uit de database; standaard: false.

Retourwaarden

(boolean) Retourneert true als het importeren is gelukt.

Voorbeelden

Een sjabloon importeren

Importeer de sjabloonconfiguratie die is opgenomen in de XML-string. Als er items of triggers ontbreken in de XML-string, worden deze uit de database verwijderd en blijft al het andere ongewijzigd.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "configuration.import",
           "params": {
               "format": "xml",
               "rules": {
                   "templates": {
                       "createMissing": true,
                       "updateExisting": true
                   },
                   "items": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   },
                   "triggers": {
                       "createMissing": true,
                       "updateExisting": true,
                       "deleteMissing": true
                   },
                   "valueMaps": {
                       "createMissing": true,
                       "updateExisting": false
                   }
               },
               "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.4</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Sjablonen</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>Nieuw sjabloon</template><name>Nieuw sjabloon</name><groups><group><name>Sjablonen</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>AFHANKELIJK</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEKST</value_type><preprocessing><step><type>REGEX</type><parameters><parameter><dt>Server uptime: (.*)</dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU-belasting</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/Nieuw sjabloon/system.cpu.load,3m)>2</expression><name>CPU-belasting te hoog op 'Nieuwe host' gedurende 3 minuten</name><priority>WAARSCHUWING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache serverstatus</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEKST</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Beschikbaar</newvalue></mapping><mapping><value>0</value><newvalue>Niet beschikbaar</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n"
           },
           "id": 1
       }

Reactie:

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

Bron

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