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
}

Vairāku veidņu grupu atjaunināšana

Aizstājiet visas veidņu grupas vairākām veidnēm ar citām.

Pieprasījums:

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

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086",
            "10087",
            "10088"
        ]
    },
    "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
}

Vairāku veidņu makrosu atjaunināšana

Aizstājiet visus lietotāja makrosus ar norādīto lietotāja makrosu vairākās veidnēs.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": [
            {
                "templateid": "10087",
                "macros": [
                    {
                        "macro": "{$AGENT.TIMEOUT}",
                        "value": "5m",
                        "description": "Noildze, pēc kuras aģents tiek uzskatīts par nepieejamu. Darbojas tikai aģentiem, kurus var sasniegt no Zabbix servera/starpniekservera (pasīvais režīms)."
                    }
                ]
            },
            {
                "templateid": "10088",
                "macros": [
                    {
                        "macro": "{$AGENT.TIMEOUT}",
                        "value": "5m",
                        "description": "Noildze, pēc kuras aģents tiek uzskatīts par nepieejamu. Darbojas tikai aģentiem, kurus var sasniegt no Zabbix servera/starpniekservera (pasīvais režīms)."
                    }
                ]
            }
        ],
    "id": 1
}

Atbilde:

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

Veidnei piesaistīto veidņu atjaunināšana

Atvienojiet (neveicot notīrīšanu) visas veidnes no dotās veidnes un piesaistiet tai citu veidni.

Pieprasījums:

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

Atbilde:

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

Vairāku veidnei piesaistīto veidņu notīrīšana

Atsaistiet un notīriet konkrētu piesaistīto veidni no dotajām veidnēm.

Pieprasījums:

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

Atbilde:

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

Avots

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