task.create
Descripció
object task.create(object/array tasks)
Aquest mètode permet crear tasques.
Aquest mètode és disponible per a qualsevol tipus d'usuaris (usuaris del tipus Admin i Usuari des de Zabbix 7.0.19). Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu els Rols d'usuari per obtindre més informació.
Paràmetres
(object/array) Crear una tasca.
El mètode admet tasques amb les propietats estàndard.
Tingueu en compte que les tasques 'Comprovar ara' només es poden crear per als tipus d'objectes/regles de descoberta següents:
- Agent Zabbix (passiu)
- Comprovacions simples
- Agent SNMPv1/v2/v3
- Comprovació interna
- Comprovació externa
- Monitor de base de dades
- Agent HTTP
- Agent IPMI
- Agent SSH
- Agent TELNET
- Agent JMX
- Verificació calculada
- Element dependent
- Script
- Navegador
Si l'element/regla de descoberta és del tipus "Element dependent", el seu element mestre també ha de ser d'un dels tipus anteriors.
Valors retornats
(object) Retorna un objecte que conté els ID de les tasques creades sota la propietat taskids. L'ordre dels ID retornats correspon a l'ordre de les tasques transmeses.
Exemples
Creació d'una tasca
Creeu una tasca 'Executar ara' per a dos elements. Un és un element, l'altre és una regla de descoberta de baix nivell.
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 6,
"request": {
"itemid": "10092"
}
},
{
"type": 6,
"request": {
"itemid": "10093"
}
}
],
"id": 1
}
Response:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"1",
"2"
]
},
"id": 1
}
Create a task Refresh proxy configuration for two proxies.
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 2,
"request": {
"proxyids": ["10459", "10460"]
}
}
],
"id": 1
}
Response:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"1"
]
},
"id": 1
}
Create a task diagnostic information.
{
"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
}
Resposta:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"3"
]
},
"id": 1
}
Veieu també
- Tasca
- Objecte de consulta 'Verificar ara'
- Objecte de consulta 'Actualitzar la configuració del proxy'
- Objecte de consulta 'Informació de diagnòstic'
Font
CTask::create() in ui/include/classes/api/services/CTask.php.