[comment]: # ({1359fe15-1359fe15})
# configuration.import

[comment]: # ({/1359fe15-1359fe15})

[comment]: # ({347dffb3-fe885a4a})
### Apraksts

`boolean configuration.import(object parameters)`

Šī metode ļauj importēt konfigurācijas datus no serializētas virknes.

::: noteclassic
Šī 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](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/347dffb3-fe885a4a})

[comment]: # ({2870849b-147fd272})
### Parametri

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

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|format|string|Serializētās virknes formāts.<br><br>Iespējamās vērtības:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.<br><br>[Parametra uzvedība](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|source|string|Serializēta virkne, kas satur konfigurācijas datus.<br><br>[Parametra uzvedība](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|rules|object|Noteikumi, kā importēt jaunus un esošus objektus.<br><br>Tipa *Admin* lietotāji var importēt tikai tos objektus, kuriem viņiem ir *read-write* [atļauja](/manual/api/reference/usergroup/object#permission), 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 tai host grupai, kurai piederēs importētais hosts. Attēlus un mediju tipus tipa *Admin* lietotāji nevar importēt.<br><br>Parametrs `rules` ir detalizēti aprakstīts tabulā zemāk.<br><br>[Parametra uzvedība](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|

::: noteimportant
Ja noteikumi nav norādīti, konfigurācija netiks atjaunināta.
:::

Objekts `rules` atbalsta šādus parametrus.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discoveryRules|object|Noteikumi, kā importēt LLD noteikumus.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni LLD noteikumi; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie LLD noteikumi tiks atjaunināti; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni grafiki; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie grafiki tiks atjaunināti; noklusējums: `false`;<br>`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 host grupas.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas host grupas; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās host grupas tiks atjauninātas; noklusējums: `false`.|
|template_groups|object|Noteikumi, kā importēt veidņu grupas.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas veidņu grupas; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās veidņu grupas tiks atjauninātas; noklusējums: `false`.|
|hosts|object|Noteikumi, kā importēt hosts.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni hosts; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie hosts tiks atjaunināti; noklusējums: `false`.|
|httptests|object|Noteikumi, kā importēt tīmekļa scenārijus.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni tīmekļa scenāriji; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie tīmekļa scenāriji tiks atjaunināti; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni attēli; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie attēli tiks atjaunināti; noklusējums: `false`.|
|items|object|Noteikumi, kā importēt vienumus.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni vienumi; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie vienumi tiks atjaunināti; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas kartes; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās kartes tiks atjauninātas; noklusējums: `false`.|
|mediaTypes|object|Noteikumi, kā importēt mediju tipus.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni mediju tipi; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, veidnes, kas nav saistītas ar importējamo hostu vai veidni, bet ir iekļautas importētajos datos, tiks saistītas; noklusējums: `false`;<br>`deleteMissing` - `(boolean)` ja iestatīts uz `true`, veidnes, kas ir saistītas ar importējamo hostu vai veidni, bet nav iekļautas importētajos datos, tiks atsaistītas, nenoņemot no atsaistītajām veidnēm mantotās entītijas (vienumus, trigerus utt.); noklusējums: `false`.|
|templates|object|Noteikumi, kā importēt veidnes.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas veidnes; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni veidņu paneļi; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie veidņu paneļi tiks atjaunināti; noklusējums: `false`;<br>`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.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidoti jauni trigeri; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošie trigeri tiks atjaunināti; noklusējums: `false`;<br>`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 host vai veidnes vērtību kartes.<br><br>Atbalstītie parametri:<br>`createMissing` - `(boolean)` ja iestatīts uz `true`, tiks izveidotas jaunas vērtību kartes; noklusējums: `false`;<br>`updateExisting` - `(boolean)` ja iestatīts uz `true`, esošās vērtību kartes tiks atjauninātas; noklusējums: `false`;<br>`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`.|

[comment]: # ({/2870849b-147fd272})

[comment]: # ({08d02880-08d02880})
### Atgrieztās vērtības

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

[comment]: # ({/08d02880-08d02880})

[comment]: # ({b41637d2-b41637d2})
### Piemēri

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({c692ed15-0801380e})
#### Veidnes importēšana

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

[Pieprasījums](/manual/api#performing-requests):

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

Atbilde:

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

[comment]: # ({/c692ed15-0801380e})

[comment]: # ({b6dce61f-c5744b74})
### Avots

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

[comment]: # ({/b6dce61f-c5744b74})