Documentation
Table of Contents
task.create
Description
object task.create(object/array tasks)
Cette m¨¦thode permet de cr¨¦er une nouvelle t?che (comme collecter des donn¨¦es de diagnostic ou v¨¦rifier des ¨¦l¨¦ments ou des r¨¨gles de d¨¦couverte de bas niveau sans recharger la configuration).
Cette m¨¦thode est seulement disponible pour les utilisateurs du type Super admin. Les autorisations d'appeler la m¨¦thode peuvent ¨ºtre r¨¦voqu¨¦es dans les param¨¨tres de r?le d'utilisateur. Voir R?les utilisateur pour plus d'informations.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object/array) Une t?che ¨¤ cr¨¦er.
La m¨¦thode accepte les param¨¨tres suivants.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| type (obligatoire) |
integer | Type de t?che. Valeurs possibles?: 1 - Informations de diagnostic?; 6 - V¨¦rifier maintenant. |
| request (obligatoire) |
object | Objet de demande de t?che selon le type de t?che. Le format correct de l'objet de requ¨ºte est d¨¦crit dans la section Objet de t?che. |
| proxy_hostid | integer | Proxy pour lequel la t?che d'informations de diagnostic collectera des donn¨¦es. Ignor¨¦ pour les t?ches 'V¨¦rifier maintenant'. |
Notez que les t?ches 'V¨¦rifier maintenant' ne peuvent ¨ºtre cr¨¦¨¦es que pour les types d'objets/r¨¨gles de d¨¦couverte?suivants :
- Agent Áú»¢¶Ä²©
- Agent SNMPv1/v2/v3
- V¨¦rification simple
- Contr?le interne
- Contr?le externe
- Moniteur de base de donn¨¦es
- Agent HTTP
- Agent IPMI
- Agent SSH
- Agent TELNET
- V¨¦rification calcul¨¦e
- Agent JMX
Valeurs retourn¨¦es
(object) Retourne un objet contenant les identifiants des t?ches cr¨¦¨¦s sous la propri¨¦t¨¦ taskids. L'ordre des ID retourn¨¦s correspond ¨¤ l'ordre des t?ches transmises.
Exemples
Cr¨¦ation d'une t?che
Cr¨¦ez une t?che "v¨¦rifier maintenant" pour deux ¨¦l¨¦ments. L'un est un ¨¦l¨¦ment, l'autre est une r¨¨gle de d¨¦couverte de bas niveau.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 6,
"request": {
"itemid": "10092"
}
},
{
"type": "6",
"request": {
"itemid": "10093"
}
}
],
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Cr¨¦ez une t?che "informations de diagnostic".
Requ¨ºte :
{
"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
}R¨¦ponse :
Voir ¨¦galement
- T?che
- Objet de requ¨ºte 'Ex¨¦cuter maintenant'
- Objet de requ¨ºte 'information de diagnostic'
- Objet de requ¨ºte statistique
Source
CTask::create() dans ui/include/classes/api/services/CTask.php.