item.update

Beschreibung

object item.update(object/array items)

Mit dieser Methode können vorhandene Datenpunkte aktualisiert werden.

Web-Datenpunkte können nicht über die Zabbix-API aktualisiert werden.

Diese Methode ist nur für Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu aktualisierende Datenpunkt-Eigenschaften.

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

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

Parameter Type Beschreibung
preprocessing array Optionen für die Datenpunkt-Vorverarbeitung, die die aktuellen Vorverarbeitungsoptionen ersetzen.

Parameterverhalten:
- schreibgeschützt für geerbte Objekte oder entdeckte Objekte
tags array Datenpunkt-Tags.

Parameterverhalten:
- schreibgeschützt für entdeckte Objekte

Rückgabewerte

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

Beispiele

Einen Datenpunkt aktivieren

Aktivieren Sie einen Datenpunkt, d. h. setzen Sie seinen Status auf „0“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "id": 1
}

Antwort:

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

Abhängigen Datenpunkt aktualisieren

Aktualisieren Sie den Namen des abhängigen Datenpunkts und die ID des Master-Datenpunkts. Es sind nur Abhängigkeiten auf demselben Host zulässig, daher sollten Master- und abhängiger Datenpunkt dieselbe hostid haben.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "id": 1
}

Antwort:

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

HTTP-Agent-Datenpunkt aktualisieren

Aktivieren Sie das Trapping von Datenpunktwerten.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": 1
    },
    "id": 1
}

Antwort:

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

Aktualisieren eines Datenpunkts mit Vorverarbeitung

Aktualisieren Sie einen Datenpunkt mit der Datenpunkt-Vorverarbeitungsregel „Im Bereich“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "preprocessing": [
            {
                "type": 13,
                "params": "\n100",
                "error_handler": 1,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Antwort:

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

Aktualisieren eines Skript-Datenpunkts

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

Anfrage:

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

Antwort:

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

Quelle

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