Documentation
Table of Contents
maintenance.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
integer/array maintenance.get(object parameters)
El m¨¦todo permite recuperar mantenimientos de acuerdo con los par¨¢metros dados.
Este m¨¦todo est¨¢ disponible para usuarios de cualquier tipo. Los permisos para llamar al m¨¦todo se pueden revocar en la configuraci¨®n de roles de usuario. Ver Roles de usuario para m¨¢s informaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(objeto) ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ que definen la salida deseada.
El m¨¦todo admite los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| groupids | ID/matriz | Devuelve s¨®lo los mantenimientos que est¨¢n asignados a los grupos de equipos dados. |
| hostids | ID/matriz | Devuelve s¨®lo los mantenimientos que est¨¢n asignados a los equipos dados. |
| maintenanceids | ID/matriz | Devuelve s¨®lo los mantenimientos con los ID proporcionados. |
| selectHostGroups | query | Devuelve una propiedad hostgroups con grupos de equipos asignados al mantenimiento. |
| selectHosts | query | Devuelve una propiedad hosts con equipos asignados al mantenimiento. |
| selectTags | query | Devuelve una propiedad tags con etiquetas problem¨¢ticas del mantenimiento. |
| selectTimeperiods | query | Devuelve una propiedad timeperiods con los per¨ªodos de tiempo del mantenimiento. |
| sortfield | string/array | Ordena el resultado por las propiedades dadas. Valores posibles: maintenanceid, name, maintenance_type. |
| countOutput | booleano | Estos par¨¢metros, que son comunes para todos los m¨¦todos get, se describen en detalle en el comentario de referencia. |
| editable | booleano | |
| excludeSearch | booleano | |
| filter | objeto | |
| limit | entero | |
| output | consulta | |
| preservekeys | booleano | |
| search | objeto | |
| searchByAny | booleano | |
| searchWildcardsEnabled | booleano | |
| sortorder | cadena/matriz | |
| startSearch | booleano | |
| selectGroups (obsoleto) |
query | Este par¨¢metro est¨¢ obsoleto; utilice selectHostGroups en su lugar.Devuelve una propiedad groups con grupos de equipos asignados al mantenimiento. |
Valores de retorno
(entero/matriz) Devuelve:
- una matriz de objetos;
- el recuento de objetos recuperados, si el par¨¢metro
countOutputha sido usado.
Ejemplos
Recuperando mantenimientos
Recuperar todos los mantenimientos configurados y los datos sobre los grupos de equipos asignados, per¨ªodos de tiempo definidos y etiquetas de problemas.
{
"jsonrpc": "2.0",
"method": "maintenance.get",
"params": {
"output": "extend",
"selectHostGroups": "extend",
"selectTimeperiods": "extend",
"selectTags": "extend"
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": [
{
"maintenanceid": "3",
"name": "Sunday maintenance",
"maintenance_type": "0",
"description": "",
"active_since": "1358844540",
"active_till": "1390466940",
"tags_evaltype": "0",
"hostgroups": [
{
"groupid": "4",
"name": "Áú»¢¶Ä²© servers",
"flags": "0",
"uuid": "6f6799aa69e844b4b3918f779f2abf08"
}
],
"timeperiods": [
{
"timeperiod_type": "3",
"every": "1",
"month": "0",
"dayofweek": "1",
"day": "0",
"start_time": "64800",
"period": "3600",
"start_date": "2147483647"
}
],
"tags": [
{
"tag": "service",
"operator": "0",
"value": "mysqld",
},
{
"tag": "error",
"operator": "2",
"value": ""
}
]
}
],
"id": 1
}Ver tambi¨¦n
Fuente
CMaintenance::get() enui/include/classes/api/services/CMaintenance.php.