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

Standarta veidnes īpašību maiņa

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

Request:

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

Response:

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

Veidņu grupu atjaunināšana

Aizstājiet visas norādītā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 makro mainīšana

Aizstājiet visas veidnes makro ar citu makro.

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

Atsaistīt un notīrīt 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.