datenpunktprototyp.update

Beschreibung

object itemprototype.update(object/array itemPrototypes)

Mit dieser Methode können vorhandene Datenpunkt-Prototypen aktualisiert werden.

Parameter

(object/array) Zu aktualisierende Eigenschaften des Datenpunktprototyps.

Die Eigenschaft itemid muss für jeden Datenpunktprototyp definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den Standard-Eigenschaften des Datenpunktprototyps akzeptiert die Methode die folgenden Parameter.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Item-Prototypen unter der Eigenschaft itemids enthält.

Beispiele

Ändern der Schnittstelle eines Datenpunktprototyps

Ändern Sie die Host-Schnittstelle, die von erkannten Datenpunkten verwendet wird.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "27428",
        "interfaceid": "132"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "27428"
        ]
    },
    "id": 1
}

Abhängigen Datenpunkt-Prototyp aktualisieren

Aktualisieren Sie den abhängigen Datenpunkt-Prototyp mit einer neuen ID des Master-Datenpunkt-Prototyps. Es sind nur Abhängigkeiten auf demselben Host (Vorlage/Discovery-Regel) zulässig, daher sollten Master- und abhängiger Datenpunkt dieselbe hostid und ruleid haben.

Request:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "master_itemid": "25570",
        "itemid": "189030"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "189030"
        ]
    },
    "id": 1
}

HTTP-Agent-Datenpunktprototyp aktualisieren

Abfragefelder ändern und alle benutzerdefinierten Header entfernen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid":"28305",
        "query_fields": [
            {
                "name": "random",
                "value": "qwertyuiopasdfghjklzxcvbnm"
            }
        ],
        "headers": []
    }
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "28305"
        ]
    },
    "id": 1
}

Aktualisieren der Vorverarbeitungsoptionen eines Datenpunkts

Aktualisieren Sie einen Datenpunkt-Prototyp mit der Vorverarbeitungsregel „Benutzerdefinierter Multiplikator“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "44211",
        "preprocessing": [
            {
                "type": 1,
                "params": "4",
                "error_handler": 2,
                "error_handler_params": "5"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "44211"
        ]
    },
    "id": 1
}

Aktualisieren eines Skript-Datenpunktprototyps

Aktualisieren Sie einen Skript-Datenpunktprototyp mit einem anderen Skript und entfernen Sie unnötige Parameter, die vom vorherigen Skript verwendet wurden.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "23865",
        "parameters": [],
        "script": "Zabbix.log(3, 'Log test');\nreturn 1;"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23865"
        ]
    },
    "id": 1
}

Quelle

CItemPrototype::update() in ui/include/classes/api/services/CItemPrototype.php.