[comment]: # ({36f834f7-36f834f7})
# veidne.update

[comment]: # ({/36f834f7-36f834f7})

[comment]: # ({c65d8691-f8425904})
### Apraksts

`object template.update(object/array templates)`

Šī metode ļauj atjaunināt esošās veidnes.

::: noteclassic
Šī metode ir pieejama tikai *Admin* un *Super admin*
lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas
iestatījumos. Plašāku informāciju skatiet [Lietotāju
lomas](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/c65d8691-f8425904})

[comment]: # ({80d66659-5d06cf34})
### Parametri

`(object/array)` Atjaunināmās veidnes īpašības.

Katram veidnei ir jābūt definētai `templateid` īpašībai, visas pārējās
īpašības ir neobligātas. Tiks atjauninātas tikai norādītās īpašības, visas
pārējās paliks nemainītas.

Papildus [standarta veidnes īpašībām](object#template) metode
pieņem šādus parametrus.

|Parametrs|[Tips](/manual/api/reference_commentary#data-types)|Apraksts|
|--|--|------|
|groups|object/array|[Veidņu grupas](/manual/api/reference/templategroup/object), ar kurām aizstāt pašreizējās veidņu grupas, kurām veidnes pieder.<br><br>Veidņu grupām jābūt definētai tikai `groupid` īpašībai.|
|tags|object/array|[Veidņu birkas](/manual/api/reference/template/object#template-tag), ar kurām aizstāt pašreizējās veidņu birkas.|
|macros|object/array|[Lietotāja makrosi](/manual/api/reference/usermacro/object), ar kuriem aizstāt pašreizējos lietotāja makrosus norādītajās veidnēs.|
|templates|object/array|[Veidnes](/manual/api/reference/template/object), ar kurām aizstāt pašlaik piesaistītās veidnes. Veidnes, kas netiek nodotas, tiks tikai atsaistītas.<br><br>Veidnēm jābūt definētai tikai `templateid` īpašībai.|
|templates\_clear|object/array|[Veidnes](/manual/api/reference/template/object), ko atsaistīt un notīrīt no norādītajām veidnēm.<br><br>Veidnēm jābūt definētai tikai `templateid` īpašībai.|

[comment]: # ({/80d66659-5d06cf34})

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

`(object)` Atgriež objektu, kas satur atjaunināto veidņu ID
īpašībā `templateids`.

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

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

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

[comment]: # ({7ee813bd-cc534212})
#### Veidnes standarta īpašību mainīšana

Mainiet veidnes tehnisko nosaukumu uz "Linux by Zabbix agent Custom", redzamo nosaukumu uz "My template" un atjauniniet veidnes aprakstu.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "host": "Linux by Zabbix agent Custom",
        "name": "My template",
        "description": "This is a custom Linux template."
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7ee813bd-cc534212})

[comment]: # ({2b5d5c60-9dbdf129})
#### Veidņu grupu atjaunināšana

Aizstājiet visas dotās veidnes grupas ar citu grupu.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "groups": [
            {
                "groupid": "24"
            } 
        ]
    },
    "id": 1
}
```


Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/2b5d5c60-9dbdf129})

[comment]: # ({b5383db9-e7972b69})
#### Veidnes birku atjaunināšana

Aizstājiet visas veidnes birkas ar citu.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "tags": [
            {
                "tag": "host-name",
                "value": "{HOST.NAME}"
            }
        ]
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/b5383db9-e7972b69})

[comment]: # ({e808d272-bfacef5d})
#### Veidnes makrosu atjaunināšana

Aizstājiet visus veidnes makrosus ar citu.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "macros": [
            {
                "macro": "{$MY_MACRO}",
                "value": "new_value"
            }
        ]
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/e808d272-bfacef5d})

[comment]: # ({c0bea3a1-0c7e70df})
#### Veidnes saistīto veidņu atjaunināšana

Atvieno (neiztīrot) visas veidnes no norādītās veidnes un piesaista tai citu veidni.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/c0bea3a1-0c7e70df})

[comment]: # ({69f01ba0-3a06a003})
#### Veidnes saistīto veidņu notīrīšana

Atsaistiet un notīriet norādīto veidni no konkrētas saistītās veidnes.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates_clear": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/69f01ba0-3a06a003})

[comment]: # ({eb72cc1c-eb72cc1c})
### Avots

CTemplate::update() failā *ui/include/classes/api/services/CTemplate.php*.

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