service.update

Beschrijving

object service.update(object/array-services)

Met deze methode kunnen bestaande services worden bijgewerkt.

Parameters

'(object/array)'-service-eigenschappen moeten worden bijgewerkt.

De eigenschap serviceid moet worden gedefinieerd voor elke service, alle andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.

Naast de standaard service-eigenschappen, is de methode accepteert de volgende parameters.

|---------------|--------------------------------- --------------------|----------------------------- -------------------------------------------------- ------------------------------------------| | kinderen | reeks | Kinderservices om de huidige servicekinderen te vervangen.

Voor de kinderen moet de eigenschap 'serviceid' zijn gedefinieerd. | | ouders | reeks | Ouderservices ter vervanging van de huidige serviceouders.

Voor de ouders moet de eigenschap serviceid zijn gedefinieerd. | | labels | reeks | Service tags om de huidige servicetags te vervangen. | | probleem_tags | reeks | Probleemtags om de huidige probleemtags te vervangen. | | status_regels | reeks | Statusregels om de huidige statusregels te vervangen. |

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte services bevat onder de eigenschap serviceids.

Voorbeelden

De ouder instellen voor een dienst

Maak service met ID "3" als ouder voor service met ID "5".

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "serviceid": "5",
               "parents": [
                   {
                       "serviceid": "3"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "serviceids": [
                   "5"
               ]
           },
           "id": 1
       }

Een geplande uitvaltijd toevoegen

Voeg een downtime toe voor service met ID "4" wekelijks gepland vanaf maandag 22:00 t/m dinsdag 10:00.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "serviceid": "4",
               "times": [
                   {
                       "type": "1",
                       "ts_from": "165600",
                       "ts_to": "201600"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "serviceids": [
                   "4"
               ]
           },
           "id": 1
       }

Bron

CService::update() in ui/include/classes/api/services/CService.php.