configuration.import

Beschreibung

boolean configuration.import(object parameters)

Diese Methode ermöglicht den Import von Konfigurationsdaten aus einer serialisierten Zeichenkette.

Diese Methode steht Nutzern jeder Art zur Verfügung. Die Berechtigung zum Aufruf der Methode kann in den Benutzerrolleneinstellungen widerrufen werden. Prüfen Sie Benutzerrollen für mehr Informationen.

Parameter

(object) Parameter, die die zu importierenden Daten und Regeln enthalten, wie die Daten verarbeitet werden sollen.

Parameter Type Beschreibung
format string Format der serialisierten Zeichenfolge.

Mögliche Werte:
yaml - YAML;
xml - XML;
json - JSON.

Parameter behavior:
- required
source string Serialisierte Zeichenfolge, die die Konfigurationsdaten enthält.

Parameter behavior:
- required
rules object Regeln dafür, wie neue und vorhandene Objekte importiert werden sollen.

Benutzer vom Typ Admin dürfen nur Objekte importieren, für die sie über eine read-write Berechtigung verfügen, sowie Karten. Beispielsweise kann ein Host und seine Entitäten (Datenpunkte, Auslöser, Diagramme usw.) nur importiert werden, wenn die Benutzergruppe des Benutzers über Berechtigungen für die Hostgruppe verfügt, zu der der importierte Host gehören wird. Bilder und Medientypen können von Benutzern vom Typ Admin nicht importiert werden.

Der Parameter rules wird in der folgenden Tabelle ausführlich beschrieben.

Parameter behavior:
- required

Wenn keine Regeln angegeben werden, wird die Konfiguration nicht aktualisiert.

Das Objekt rules unterstützt die folgenden Parameter.

Parameter Type Beschreibung
discoveryRules object Regeln für den Import von LLD-Regeln.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue LLD-Regeln erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene LLD-Regeln aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden LLD-Regeln, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
graphs object Regeln für den Import von Diagrammen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Diagramme erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Diagramme aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Diagramme, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
host_groups object Regeln für den Import von Hostgruppen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Hostgruppen erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Hostgruppen aktualisiert; Standardwert: false.
template_groups object Regeln für den Import von Vorlagengruppen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Vorlagengruppen erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Vorlagengruppen aktualisiert; Standardwert: false.
hosts object Regeln für den Import von Hosts.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Hosts erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Hosts aktualisiert; Standardwert: false.
httptests object Regeln für den Import von Web-Szenarien.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Web-Szenarien erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Web-Szenarien aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Web-Szenarien, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
images object Regeln für den Import von Bildern.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Bilder erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Bilder aktualisiert; Standardwert: false.
items object Regeln für den Import von Datenpunkten.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Datenpunkte erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Datenpunkte aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Datenpunkte, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
maps object Regeln für den Import von Karten.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Karten erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Karten aktualisiert; Standardwert: false.
mediaTypes object Regeln für den Import von Medientypen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Medientypen erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Medientypen aktualisiert; Standardwert: false.
templateLinkage object Regeln für den Import von Vorlagenverknüpfungen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden Vorlagen, die nicht mit dem importierten Host oder der importierten Vorlage verknüpft sind, aber in den importierten Daten vorhanden sind, verknüpft; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Vorlagen, die mit dem importierten Host oder der importierten Vorlage verknüpft sind, aber in den importierten Daten nicht vorhanden sind, ohne Entfernen der von den getrennten Vorlagen geerbten Entitäten (Datenpunkte, Auslöser usw.) getrennt; Standardwert: false.
templates object Regeln für den Import von Vorlagen.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Vorlagen erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Vorlagen aktualisiert; Standardwert: false.
templateDashboards object Regeln für den Import von Vorlagen-Dashboards.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Vorlagen-Dashboards erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Vorlagen-Dashboards aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Vorlagen-Dashboards, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
triggers object Regeln für den Import von Auslösern.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Auslöser erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Auslöser aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Auslöser, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.
valueMaps object Regeln für den Import von Wertzuordnungen für Host oder Vorlage.

Unterstützte Parameter:
createMissing - (boolean) wenn auf true gesetzt, werden neue Wertzuordnungen erstellt; Standardwert: false;
updateExisting - (boolean) wenn auf true gesetzt, werden vorhandene Wertzuordnungen aktualisiert; Standardwert: false;
deleteMissing - (boolean) wenn auf true gesetzt, werden Wertzuordnungen, die in den importierten Daten nicht vorhanden sind, aus der Datenbank gelöscht; Standardwert: false.

Rückgabewerte

(boolean) gibt true zurück, wenn der Importvorgang erfolgreich war.

Beispiele

Importieren einer Vorlage

Importieren Sie die in der XML-Zeichenfolge enthaltene Vorlagenkonfiguration. Wenn in der XML-Zeichenfolge irgendwelche Datenpunkte oder Auslöser fehlen, werden sie aus der Datenbank gelöscht, und alles andere bleibt unverändert.

Request:

{
    "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>7.4</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</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>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;\/dt&gt;</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 load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on {HOST.HOST} for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n"
    },
    "id": 1
}

Response:

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

Quelle

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