template.massupdate

Opis

object template.massupdate(object parameters)

Ta metoda umożliwia jednoczesne zastępowanie lub usuwanie powiązanych obiektów oraz aktualizowanie właściwości wielu szablonów.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania metody można cofnąć w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object) Parametry zawierające identyfikatory szablonów do aktualizacji oraz obiekty, które mają zostać zastąpione dla szablonów.

Metoda przyjmuje następujące parametry.

Parameter Type Description
templates object/array Szablony do zaktualizowania.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.

Zachowanie parametru:
- required
groups object/array Grupy szablonów do zastąpienia bieżących grup szablonów, do których należą szablony.

Grupy szablonów muszą mieć zdefiniowaną wyłącznie właściwość groupid.
macros object/array Makra użytkownika do zastąpienia wszystkich bieżących makr użytkownika w podanych szablonach.
templates_clear object/array Szablony do odłączenia i wyczyszczenia z podanych szablonów.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.
templates_link object/array Szablony do zastąpienia aktualnie podłączonych szablonów.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych szablonów w właściwości templateids.

Przykłady

Odłączanie szablonu

Odłącz i wyczyść szablon "10091" od podanych szablonów.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zastępowanie makr użytkownika

Zastąp wszystkie makra użytkownika podanym makrem użytkownika w wielu szablonach.

Request:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10074"
            },
            {
                "templateid": "10075"
            },
            {
                "templateid": "10076"
            },
            {
                "templateid": "10077"
            }
        ],
        "macros": [
            {
                "macro": "{$AGENT.TIMEOUT}",
                "value": "5m",
                "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."
            }
        ]
    },
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

Zobacz także

Źródło

CTemplate::massUpdate() w ui/include/classes/api/services/CTemplate.php.