Documentation
Table of Contents
service.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
object service.update(object/array services)
Este m¨¦todo permite actualizar los servicios existentes.
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 obtener m¨¢s informaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
Propiedades del servicio (objeto/matriz) que se actualizar¨¢n.
La propiedad serviceid debe definirse para cada servicio, todos los dem¨¢s Las propiedades son opcionales. S¨®lo se actualizar¨¢n las propiedades pasadas, todas otros permanecer¨¢n sin cambios.
Adem¨¢s de las propiedades de servicio est¨¢ndar, el El m¨¦todo acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| children | array | [servicios] secundarios(/manual/api/reference/service/object#service) para reemplazar los servicios secundarios actuales. Los servicios secundarios deben tener solo la propiedad serviceid definida. |
| parents | array | [servicios] principales(/manual/api/reference/service/object#service) para reemplazar los servicios principales actuales. Los servicios principales deben tener solo la propiedad serviceid definida. |
| tags | array | Etiquetas de servicio para reemplazar las etiquetas de servicio actuales. |
| problem_tags | array | Etiquetas de problema para reemplazar las etiquetas de problema actuales. |
| status_rules | array | Reglas de estado para reemplazar las reglas de estado actuales. |
Valores de retorno
(objeto) Devuelve un objeto que contiene los ID de los servicios actualizados bajo la propiedad serviceids.
Ejemplos
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô del servicio principal para un servicio
Haga que el servicio con ID "3" sea el servicio principal del servicio con ID "5".
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"serviceid": "5",
"parents": [
{
"serviceid": "3"
}
]
},
"id": 1
}Respuesta:
Agregar un tiempo de inactividad programado
Agregue un tiempo de inactividad para el servicio con ID "4" programado semanalmente a partir del lunes 22:00 hasta el martes 10:00.
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"serviceid": "4",
"times": [
{
"type": "1",
"ts_from": "165600",
"ts_to": "201600"
}
]
},
"id": 1
}Respuesta:
Fuente
CService::update() en ui/include/classes/api/services/CService.php.