task.create

Opis

object task.create(object/array tasks)

Ta metoda umożliwia tworzenie zadań.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w User roles.

Parametry

(object/array) Zadanie do utworzenia.

Metoda akceptuje zadania ze standardowymi właściwościami zadania.

Należy pamiętać, że zadania „Wykonaj teraz” można tworzyć tylko dla następujących typów pozycji/reguł wykrywania:

  • agent Zabbix (pasywny)
  • Proste sprawdzenie
  • agent SNMP (v1/v2/v3)
  • Wewnętrzny Zabbix
  • Sprawdzenie zewnętrzne
  • Monitor bazy danych
  • agent HTTP
  • agent IPMI
  • agent SSH
  • agent TELNET
  • agent JMX
  • Obliczana
  • Zależna pozycja
  • Skrypt
  • Przeglądarka

Jeśli pozycja/reguła wykrywania jest typu „Zależna pozycja”, to jej pozycja nadrzędna również musi być jednym z powyższych typów.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych zadań we właściwości taskids. Jedno zadanie jest tworzone dla każdej pozycji i reguły wykrywania niskiego poziomu. Kolejność zwróconych identyfikatorów odpowiada kolejności przekazanych itemids.

Przykłady

Tworzenie zadania

Utwórz zadanie „Wykonaj teraz” dla pozycji i reguły wykrywania niskiego poziomu.

Żądanie:

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

Odpowiedź:

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

Utwórz zadanie „Odśwież konfigurację proxy” dla dwóch proxy.

Żądanie:

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

Odpowiedź:

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

Utwórz zadanie „Informacje diagnostyczne”.

Żądanie:

{
    "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
}

Odpowiedź:

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

Zobacz także

Źródło

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