task.create

Beschreibung

object task.create(object/array tasks)

Mit dieser Methode können Sie Aufgaben erstellen.

Parameter

(object/array) Eine zu erstellende Aufgabe.

Die Methode akzeptiert Aufgaben mit den Standard-Aufgabeneigenschaften.

Beachten Sie, dass Aufgaben vom Typ „Jetzt ausführen“ nur für die folgenden Typen von Datenpunkten/Discovery-Regeln erstellt werden können:

• Zabbix-Agent (passiv)
• Einfache Prüfung
• SNMP-Agent (v1/v2/v3)
• Zabbix-intern
• Externe Prüfung
• Datenbankmonitor
• HTTP-Agent
• IPMI-Agent
• SSH-Agent
• TELNET-Agent
• JMX-Agent
• Berechnet
• Abhängiger Datenpunkt
• Skript
• Browser

Wenn der Datenpunkt/die Discovery-Regel vom Typ „Abhängiger Datenpunkt“ ist, muss auch sein Master-Datenpunkt einer der oben genannten Typen sein.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Aufgaben unter der Eigenschaft taskids enthält. Für jeden Datenpunkt und jede Low-Level-Discovery-Regel wird eine Aufgabe erstellt. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen itemids.

Beispiele

Erstellen einer Aufgabe

Erstellen Sie eine Aufgabe vom Typ „Jetzt ausführen“ für einen Datenpunkt und eine Low-Level-Discovery-Regel.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 6,
            "request": {
                "itemid": "10092"
            }
        },
        {
            "type": 6,
            "request": {
                "itemid": "10093"
            }
        }
    ],
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "taskids": [
            "1",
            "2"
        ]
    },
    "id": 1
}

Erstellen Sie eine Aufgabe vom Typ „Proxy-Konfiguration aktualisieren“ für zwei Proxys.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 2,
            "request": {
                "proxyids": ["10459", "10460"]
            }
        }
    ],
    "id": 1
}

Antwort:

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

Erstellen Sie eine Aufgabe vom Typ „Diagnoseinformationen“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 1,
            "request": {
                "alerting": {
                    "stats": [
                        "alerts"
                    ],
                    "top": {
                        "media.alerts": 10
                    }
                },
                "lld": {
                    "stats": "extend",
                    "top": {
                        "values": 5
                    }
                }
            },
            "proxyid": 0
        }
    ],
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "taskids": [
            "3"
        ]
    },
    "id": 1
}

Siehe auch

• Aufgabe
• 'Jetzt ausführen'-Anfrageobjekt
• 'Proxy-Konfiguration aktualisieren'-Anfrageobjekt
• 'Diagnoseinformationen'-Anfrageobjekt

Quelle

CTask::create() in ui/include/classes/api/services/CTask.php.