Áú»¢¶Ä²©

service.update

Description

object service.update(object/array services)

Cette m¨¦thode permet de mettre ¨¤ jour les services existants.

Cette m¨¦thode est disponible ¨¤ tous les types d'utilisateurs. Les autorisations d'appeler la m¨¦thode peuvent ¨ºtre r¨¦voqu¨¦es dans les param¨¨tres du le r?le d'utilisateur. Voir R?les Utilisateur pour plus d'informations.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ

Les propri¨¦t¨¦s du service (object/array) doivent ¨ºtre mises ¨¤ jour.

La propri¨¦t¨¦ serviceid doit ¨ºtre d¨¦finie pour chaque service, toutes les autres les propri¨¦t¨¦s sont facultatives. Seules les propri¨¦t¨¦s pass¨¦es seront mises ¨¤ jour, toutes les autres resteront inchang¨¦es.

En plus des propri¨¦t¨¦s de service standard, la m¨¦thode accepte les param¨¨tres suivants.

Param¨¨tre | Type | Descriptif |

|---------------|--------------------------------------------- --------------------|-------------------------------------- -------------------------------------------------- ------------------------------------------| | enfants | array | Services enfants pour remplacer les enfants de service actuels.

Les enfants doivent avoir la propri¨¦t¨¦ serviceid d¨¦finie. | | parents | array | Services parents pour remplacer les services parents actuels.

Les parents doivent avoir la propri¨¦t¨¦ serviceid d¨¦finie. | | balises | array | Tags de service en rempalcement des tags de service actuels. | | probl¨¨me_tags | array | Tags de probl¨¨me en remplacement des tags de probl¨¨me actuelles. | | statut_r¨¨gles | array | R¨¨gles de statut en remplacement des r¨¨gles de statut actuelles. |

Valeurs retourn¨¦es

(object) Retourne un objet contenant les identifiants des services mis ¨¤ jour sous la propri¨¦t¨¦ serviceids.

Exemples

D¨¦finition du parent d'un service

Faites en sorte que le service avec l'ID "3" soit le parent du service avec l'ID "5".

Requ¨ºte :

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

R¨¦ponse :

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

Ajout d'un temps d'arr¨ºt planifi¨¦

Ajoutez un temps d'arr¨ºt pour le service avec l'ID "4" programm¨¦ chaque semaine du lundi 22h00 au mardi 10h00.

Requ¨ºte :

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

R¨¦ponse :

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

Source

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