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.
{
"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.
{
"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”.
{
"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
- Task
- Obiekt żądania „Wykonaj teraz”
- Obiekt żądania „Odśwież konfigurację proxy”
- Obiekt żądania „Informacje diagnostyczne”
Źródło
CTask::create() w ui/include/classes/api/services/CTask.php.