Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object) Parametri, kas satur importējamos datus un noteikumus, kā šie dati jāapstrādā.

Parametrs	Tips	Apraksts
format	string	Serializētās virknes formāts. Iespējamās vērtības: `yaml` - YAML; `xml` - XML; `json` - JSON. Parametra darbība: - required
source	string	Serializēta virkne, kas satur konfigurācijas datus. Parametra darbība: - required
rules	object	Noteikumi, kā importēt jaunus un esošus objektus. Admin tipa lietotāji drīkst importēt tikai tos objektus, kuriem viņiem ir read-write atļauja, kā arī kartes. Piemēram, hosts un tā entītijas (vienumi, trigeri, grafiki utt.) var tikt importēti tikai tad, ja lietotāja lietotāju grupai ir atļauja uz hostu grupu, kurai importētais hosts piederēs. Attēlus un mediju tipus Admin tipa lietotāji importēt nevar. Parametrs `rules` ir detalizēti aprakstīts zemāk esošajā tabulā. Parametra darbība: - required

Ja nav norādīti nekādi noteikumi, konfigurācija netiks atjaunināta.

Objekts rules atbalsta šādus parametrus.

Parametrs	Tips	Apraksts
discoveryRules	object	Noteikumi, kā importēt LLD noteikumus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni LLD noteikumi; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie LLD noteikumi tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, LLD noteikumi, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
graphs	object	Noteikumi, kā importēt grafikus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni grafiki; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie grafiki tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, grafiki, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
host_groups	object	Noteikumi, kā importēt hostu grupas. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas hostu grupas; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās hostu grupas tiks atjauninātas; noklusējums: `false`.
template_groups	object	Noteikumi, kā importēt veidņu grupas. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas veidņu grupas; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās veidņu grupas tiks atjauninātas; noklusējums: `false`.
hosts	object	Noteikumi, kā importēt hostus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni hosti; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie hosti tiks atjaunināti; noklusējums: `false`.
httptests	object	Noteikumi, kā importēt tīmekļa scenārijus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni tīmekļa scenāriji; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie tīmekļa scenāriji tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, tīmekļa scenāriji, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
images	object	Noteikumi, kā importēt attēlus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni attēli; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie attēli tiks atjaunināti; noklusējums: `false`.
items	object	Noteikumi, kā importēt vienumus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni vienumi; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie vienumi tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, vienumi, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
maps	object	Noteikumi, kā importēt kartes. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas kartes; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās kartes tiks atjauninātas; noklusējums: `false`.
mediaTypes	object	Noteikumi, kā importēt mediju tipus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni mediju tipi; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie mediju tipi tiks atjaunināti; noklusējums: `false`.
templateLinkage	object	Noteikumi, kā importēt veidņu saites. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, veidnes, kas nav piesaistītas importējamajam hostam vai veidnei, bet ir iekļautas importētajos datos, tiks piesaistītas; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, veidnes, kas ir piesaistītas importējamajam hostam vai veidnei, bet nav iekļautas importētajos datos, tiks atsaistītas, nenoņemot entītijas (vienumus, trigerus utt.), kas mantotas no atsaistītajām veidnēm; noklusējums: `false`.
templates	object	Noteikumi, kā importēt veidnes. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas veidnes; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās veidnes tiks atjauninātas; noklusējums: `false`.
templateDashboards	object	Noteikumi, kā importēt veidņu paneļus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni veidņu paneļi; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie veidņu paneļi tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, veidņu paneļi, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
triggers	object	Noteikumi, kā importēt trigerus. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni trigeri; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie trigeri tiks atjaunināti; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, trigeri, kas nav iekļauti importētajos datos, tiks dzēsti no datubāzes; noklusējums: `false`.
valueMaps	object	Noteikumi, kā importēt hosta vai veidnes vērtību kartes. Atbalstītie parametri: `createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas vērtību kartes; noklusējums: `false`; `updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās vērtību kartes tiks atjauninātas; noklusējums: `false`; `deleteMissing` - `(boolean)` ja iestatīts uz `true`, vērtību kartes, kas nav iekļautas importētajos datos, tiks dzēstas no datubāzes; noklusējums: `false`.

Atgrieztās vērtības

(boolean) Atgriež true, ja importēšana ir bijusi veiksmīga.

Piemēri

Veidnes importēšana

Importējiet veidnes konfigurāciju, kas ietverta XML virknē. Ja XML virknē trūkst kādu vienumu vai trigeru, tie tiks dzēsti no datubāzes, bet viss pārējais paliks nemainīts.

Pieprasījums:

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

Atbilde:

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

Avots

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

What’s next?

configuration.importcompare

Docs

configuration.import

Apraksts

Parametri

Atgrieztās vērtības

Piemēri

Veidnes importēšana

Avots

What’s next?

Suggest edit

Suggest an example

Thank you!