veidne.update

Apraksts

object template.update(object/array templates)

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

Šī 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.

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 metode pieņem šādus parametrus.

Parametrs Tips Apraksts
groups object/array Veidņu grupas, ar kurām aizstāt pašreizējās veidņu grupas, kurām veidnes pieder.

Veidņu grupām jābūt definētai tikai groupid īpašībai.
tags object/array Veidņu birkas, ar kurām aizstāt pašreizējās veidņu birkas.
macros object/array Lietotāja makrosi, ar kuriem aizstāt pašreizējos lietotāja makrosus norādītajās veidnēs.
templates object/array Veidnes, ar kurām aizstāt pašlaik piesaistītās veidnes. Veidnes, kas netiek nodotas, tiks tikai atsaistītas.

Veidnēm jābūt definētai tikai templateid īpašībai.
templates_clear object/array Veidnes, ko atsaistīt un notīrīt no norādītajām veidnēm.

Veidnēm jābūt definētai tikai templateid īpašībai.

Atgrieztās vērtības

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

Piemēri

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:

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

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

Veidņu grupu atjaunināšana

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

Pieprasījums:

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

Atbilde:

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

Veidnes birku atjaunināšana

Aizstājiet visas veidnes birkas ar citu.

Pieprasījums:

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

Atbilde:

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

Veidnes makrosu atjaunināšana

Aizstājiet visus veidnes makrosus ar citu.

Pieprasījums:

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

Atbilde:

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

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:

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

Atbilde:

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

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:

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

Atbilde:

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

Avots

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