task.create

Beschreibung

object task.create(object/array tasks)

Diese Methode ermöglicht das Erstellen von Aufgaben.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

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

Quelle

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