Documentation
Table of Contents
service.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
integer/array service.get(object parameters)
El m¨¨tode permet recuperar serveis segons els par¨¤metres prove?ts.
Aquest m¨¨tode ¨¦s disponible per a usuaris de qualsevol mena. Els permisos per cridar al m¨¨tode es poden revocar a les configuracions de rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(objecte) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que defineixen la sortida esperada.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| serviceids | ID/array | Retorna nom¨¦s serveis amb els ID donats. |
| parentids | ID/array | Retorna nom¨¦s els serveis que s¨®n enlla?ats als serveis pare donats. |
| deep_parentids | flag | Retorna tots els serveis secundaris directes i indirectes. S'empra juntament amb parentids. |
| childids | ID/array | Retorna nom¨¦s els serveis que s¨®n enlla?ats als serveis secundaris donats. |
| evaltype | enter | Regles per a la cerca d'etiquetes. Valors possibles: 0 - (per defecte) I/O; 2 - O. |
| tags | objecte/matriu d'objectes | Retorn nom¨¦s serveis amb etiquetes donades. Concordan?a exacta per etiqueta i cerca que distingeix entre maj¨²scules i maj¨²scules o min¨²scules per valor de l'etiqueta en funci¨® del valor de l'operador. Format: [{"tag": "<etiqueta>", "value": "<valor>", " operator": "<operador>"}, ...].Una matriu buida retorna tots els serveis. Possibles valors d'operador: 0 - (per defecte) °ä´Ç²Ô³Ù¨¦; 1 - ?s igual; 2 - No cont¨¦; 3 - No ¨¦s igual; 4 - Existeix; 5 - No existeix. |
| problem_tags | objecte/matriu d'objectes | Retorn nom¨¦s serveis amb etiquetes de problema donades. Concordan?a exacta per etiqueta i cerca que distingeix entre maj¨²scules i maj¨²scules o min¨²scules per valor de l'etiqueta en funci¨® del valor de l'operador. Format: [{"tag": "<etiqueta>", "valor": "<valor>", " operator": "<operador>"}, ...].Una matriu buida retorna tots els serveis. Possibles valors d'operador: 0 - (per defecte) °ä´Ç²Ô³Ù¨¦;<br >1 - ?s igual; 2 - No cont¨¦; 3 - No ¨¦s igual; 4 - Existeix; 5 - No existeix. |
| without_problem_tags | bandera | Retorn nom¨¦s serveis sense etiquetes de problema. |
| slaids | ID/array | Retorna nom¨¦s els serveis que s¨®n enlla?ats amb els SLA espec¨ªfics. |
| selectChildren | query | Retorna una propietat fills amb els serveis secundaris.Admet count. |
| selectParents | query | Retorna una propietat parents amb els serveis parentals.Admet count. |
| selectTags | query | Retorna una propietat tags amb etiquetes de servei.Admet count. |
| selectProblemEvents | query | Retorna una propietat problem_events amb una matriu d'objectes d'esdeveniment problema.L'objecte d'esdeveniment problema t¨¦ les propietats seg¨¹ents: eventid - (cadena) Identificador d'esdeveniment;< br>gravetat - (cadena) Gravetat de l'esdeveniment actual;nom - (cadena) Nom de l'esdeveniment resolt.Admet count. |
| selectProblemTags | query | Retorna una propietat problem_tags amb etiquetes de problema.Admet count. |
| selectStatusRules | query | Retorna una propietat status_rules amb regles d'estat.Admet count. |
| selectStatusTimeline | objecte/matriu d'objectes | Retorna una propietat status_timeline que cont¨¦ canvis d'estat del servei per a per¨ªodes determinats.Format [{"period_from": "<period_from>", "period_to": "<period_to >"}, ...] - period_from ¨¦s una data d'inici (inclosa; marca de temps entera) i period_to ¨¦s una data de finalitzaci¨® (exclusiu; marca de temps enter) per al per¨ªode que t'interessa.< br>Retorna una matriu d'entrades que contenen una propietat start_value i una matriu alarmes per als canvis d'estat dins dels per¨ªodes especificats. |
| sortfield | string/array | Ordena el resultat per les propietats donades. Valors possibles: serviceid, name, status, sortorder, created_at. |
| countOutput | boolean | Aquests par¨¤metres es descriuen en detall al comentari de refer¨¨ncia. |
| editable | ²ú´Ç´Ç±ô±ð¨¤ | |
| excludeSearch | ²ú´Ç´Ç±ô±ð¨¤ | |
| filter | objecte | |
| limit | enter | |
| output | consulta | |
| preservekeys | boolean | |
| search | objecte | |
| searchByAny | ²ú´Ç´Ç±ô±ð¨¤ | |
| searchWildcardsEnabled | ²ú´Ç´Ç±ô±ð¨¤ | |
| sortorder | cadena/matriu | |
| startSearch | ²ú´Ç´Ç±ô±ð¨¤ |
Valors de retorn
(integer/array) Retorna un d'entre:
- una taula d'objectes;
- el recompte d'objectes recuperats, si s'empra el par¨¤metre
countOutput.
Exemples
Recuperar tots els serveis
Recupera tota la informaci¨® de tots els serveis i les seves depend¨¨ncies.
{
"jsonrpc": "2.0",
"method": "service.get",
"params": {
"output": "extend",
"selectChildren": "extend",
"selectParents": "extend"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"serviceid": "1",
"name": "El meu servei - 0001",
"status": "-1",
"algorithm": "2",
"sortorder": "0",
"weight": "0",
"propagation_rule": "0",
"propagation_value": "0",
"description": "¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® del meu servei 0001.",
"uuid": "dfa4daeaea754e3a95c04d6029182681",
"created_at": "946684800",
"readonly": false,
"parents": [],
"children": []
},
{
"serviceid": "2",
"name": "El meu servei - 0002",
"status": "-1",
"algorithm": "2",
"sortorder": "0",
"weight": "0",
"propagation_rule": "0",
"propagation_value": "0",
"description": "¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® del meu servei 0002.",
"uuid": "20ea0d85212841219130abeaca28c065",
"created_at": "946684800",
"readonly": false,
"parents": [],
"children": []
}
],
"id": 1
}Font
CService::get() in ui/include/classes/api/services/CService.php.