task.create

Opis

object task.create(object/array tasks)

Ta metoda pozwala na utworzenie nowego zadania (takiego jak zbieranie danych diagnostycznych czy sprawdzanie pozycji lub reguł wykrywania niskopoziomowego bez ponownego wczytywania konfiguracji).

Ta metoda jest dostępna tylko dla typu użytkownika Super admin. Uprawnienia do wywołania metody można cofnąć w ustawieniach ról użytkownika. Zobacz Typy użytkowników aby uzyskać więcej informacji.

Parametry

(object/array) Zadanie do utworzenia.

Metoda akceptuje następujące parametry.

Parametr Typ Opis
type
(wymagane)
integer Typ zadania.

Dopuszczalne wartości:
1 - Informacje diagnostyczne;
6 - Sprawdź teraz.
request
(wymagane)
object Obiekt żądania zadania zgodny z typem zadania. Poprawny format obiektu żądania opisano w sekcji Obiektu zadania.
proxy_hostid integer ID proxy, dla którego zadanie zbierania informacji diagnostycznych będzie uruchomione.

Ignorowane dla zadań typu 'Sprawdź teraz'.

Uwaga Zadania typu 'Sprawdź teraz' mogą być tworzone tylko dla następujących typów pozycji/reguł odkrywania:

  • Zabbix agent
  • SNMPv1/v2/v3 agent
  • Proste sprawdzenie
  • Wewnętrzny Zabbix
  • Test zewnętrzny
  • Monitorowanie bazy danych
  • Agent HTTP
  • Agent IPMI
  • Agent SSH
  • Agent TELNET
  • Sprawdzenie obliczeniowe
  • Agent JMX

Zwracane wartości

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

Przykłady

Tworzenie zadania

Utwórz zadanie sprawdź teraz dla dwóch pozycji. Jedna z nich to pozycja, a druga to reguła wykrywania niskopoziomowego.

Zapytanie:

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

Odpowiedź:

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

Utwórz zadanie zbieranie danych diagnostycznych.

Zapytanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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