maintenance.create

Leírás

objektum karbantartás.create(objektum/tömb karbantartások)

Ez a módszer lehetővé teszi új karbantartások létrehozását.

Ez a módszer csak az Admin és a Kiemelt rendszergazda számára érhető el felhasználói típusok. A metódus meghívására vonatkozó engedélyek felhasználói szerepkörben visszavonhatók beállítások. Lásd: User roles további információért.

Paraméterek

(objektum/tömb) Létrehozandó karbantartások.

A normál karbantartáson kívül tulajdonságok, a metódus elfogadja a következőket paramétereket.

Paraméter	Típus	Leírás
groups	object/array	Host groups, amelyek karbantartáson esnek át. A gazdagépcsoportoknak meg kell adni a "groupid" tulajdonságot. < br>Legalább egy "groups" vagy "hosts" objektumot meg kell adni.
hosts	object/array	Hosts, amelyek karbantartáson esnek át. A gazdagépeken meg kell adni a "hostid" tulajdonságot. A "groups" vagy "hosts" legalább egy objektumát meg kell adni.
időperiódusok (kötelező)	object/array	Karbantartás időszakok.
tags	object/array	Problémacímkék. Határozza meg, milyen problémákat kell elnyomni. Ha nincs megadva címke, minden aktív karbantartási gazdagép problémák el lesznek távolítva.

Visszatérési értékek

(object) A létrehozott objektum azonosítóit tartalmazó objektumot ad vissza karbantartások a "maintenanceids" ingatlan alatt. A sorrend a A visszaküldött azonosítók megegyeznek az elvégzett karbantartások sorrendjével.

Példák

Creating a maintenance

Create a maintenance with data collection for host group with ID "2" and with problem tags service:mysqld and error. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour.

Request:

{
           "jsonrpc": "2.0",
           "method": "maintenance.create",
           "params": {
               "name": "Sunday maintenance",
               "active_since": 1358844540,
               "active_till": 1390466940,
               "tags_evaltype": 0,
               "groups": [
                   {"groupid": "2"}
               ],
               "timeperiods": [
                   {
                       "period": 3600,
                       "timeperiod_type": 3,
                       "start_time": 64800,
                       "every": 1,
                       "dayofweek": 64
                   }
               ],
               "tags": [
                   {
                       "tag": "service",
                       "operator": "0",
                       "value": "mysqld"
                   },
                   {
                       "tag": "error",
                       "operator": "2",
                       "value": ""
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

Lásd még

Időszak

Forrás

CMaintenance::create() in ui/include/classes/api/services/CMaintenance.php.

Documentation