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 des rôles utilisateur. Consultez User roles pour plus d'informations.

Paramètres

(object) Paramètres contenant les données à importer et les règles de traitement de ces données.

Parameter	Type	Description
format	string	Format de la chaîne sérialisée. Valeurs possibles : `yaml` - YAML; `xml` - XML; `json` - JSON. Comportement du paramètre : - required
source	string	Chaîne sérialisée contenant les données de configuration. Comportement du paramètre : - required
rules	object	Règles de traitement des nouveaux objets et des objets existants lors de l'import. Les utilisateurs de type Admin peuvent importer uniquement les objets pour lesquels ils disposent d'une permission read-write, ainsi que les cartes. Par exemple, un hôte et ses entités (éléments, déclencheurs, graphiques, etc.) ne peuvent être importés que si le groupe d'utilisateurs de l'utilisateur dispose d'une permission sur le groupe d'hôtes auquel l'hôte importé appartiendra. Les images et les types de média ne peuvent pas être importés par les utilisateurs de type Admin. Le paramètre `rules` est décrit en détail dans le tableau ci-dessous. Comportement du paramètre : - required
returnMissingObjects	boolean	Règles indiquant si l'objet de réponse doit contenir des informations sur les objets manquants ; valeur par défaut : `false`.

Si aucune règle n'est fournie, la configuration ne sera pas mise à jour.

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

Parameter	Type	Description
dashboards	object	Règles d'import des tableaux de bord. Paramètres pris en charge : `createMissing` - `(boolean)` si défini sur `true`, de nouveaux tableaux de bord seront créés ; valeur par défaut : `false`; `updateExisting` - `(boolean)` si défini sur `true` et qu'un tableau de bord importable particulier est présent dans le système, il sera entièrement mis à jour. Les pages et les widgets seront entièrement remplacés par les nouveaux ; valeur par défaut : `false`.
discoveryRules	object	Règles d'import des 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`.
global_regexes	object	Règles d'import des expressions régulières globales. Paramètres pris en charge : `createMissing` - `(boolean)` si défini sur `true`, de nouvelles expressions régulières globales seront créées ; valeur par défaut : `false`; `updateExisting` - `(boolean)` si défini sur `true`, les expressions régulières globales existantes seront mises à jour, avec leurs sous-expressions entièrement remplacées ; valeur par défaut : `false`.
graphs	object	Règles d'import des 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 d'import des 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`.
hosts	object	Règles d'import des 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`.
httptests	object	Règles d'import des 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 d'import des 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`.
items	object	Règles d'import des é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 d'import des 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`.
mediaTypes	object	Règles d'import des 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`.
templateDashboards	object	Règles d'import des tableaux de bord de modèle. Paramètres pris en charge : `createMissing` - `(boolean)` si défini sur `true`, de nouveaux tableaux de bord de modèle seront créés ; valeur par défaut : `false`; `updateExisting` - `(boolean)` si défini sur `true`, les tableaux de bord de modèle existants seront mis à jour ; valeur par défaut : `false`; `deleteMissing` - `(boolean)` si défini sur `true`, les tableaux de bord de modèle absents des données importées seront supprimés de la base de données ; valeur par défaut : `false`.
template_groups	object	Règles d'import des 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`.
templateLinkage	object	Règles d'import des 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 importé, 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 importé, 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 d'import des 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`.
triggers	object	Règles d'import des 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 d'import des mappages de valeurs d'hôte ou de 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`.

Valeurs retournées

(boolean) Retourne true si l'import est réussi.

Exemples

Importation d’un modèle

Importez la configuration du modèle contenue dans la chaîne XML. Si des éléments ou des déclencheurs dans la chaîne XML sont manquants, ils seront supprimés de la base de données, et tout le reste restera inchangé.

Requête:

{
    "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>8.0</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
}

Réponse :

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

Source

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

What’s next?

configuration.importcompare

Docs

configuration.import

Description

Paramètres

Valeurs retournées

Exemples

Importation d’un modèle

Source

What’s next?

Suggest edit

Suggest an example

Thank you!