maintenance.get

Apraksts

integer/array maintenance.get(object parameters)

Šī metode ļauj izgūt uzturēšanas darbus atbilstoši norādītajiem parametriem.

Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāja lomas.

Parametri

(object) Parametri, kas nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
groupids ID/array Atgriezt tikai uzturēšanas periodus, kas piešķirti norādītajām hostu grupām.
hostids ID/array Atgriezt tikai uzturēšanas periodus, kas piešķirti norādītajiem hostiem.
triggerids ID/array Atgriezt tikai uzturēšanas periodus, kas piešķirti norādītajiem trigeriem.
maintenanceids ID/array Atgriezt tikai uzturēšanas periodus ar norādītajiem ID.
selectHostGroups query Atgriezt hostgroups rekvizītu ar uzturēšanas periodam piešķirtajām hostu grupām.
selectHosts query Atgriezt hosts rekvizītu ar uzturēšanas periodam piešķirtajiem hostiem.
selectTriggers query Atgriezt triggers rekvizītu ar uzturēšanas periodam piešķirtajiem trigeriem.
selectEventNames query Atgriezt event_names rekvizītu ar uzturēšanas periodam piešķirtajiem notikumu nosaukumiem.
selectTags query Atgriezt tags rekvizītu ar uzturēšanas perioda problēmu tagiem.
selectTimeperiods query Atgriezt timeperiods rekvizītu ar uzturēšanas perioda laika periodiem.
sortfield string/array Kārtot rezultātu pēc norādītajiem rekvizītiem.

Iespējamās vērtības: maintenanceid, name, maintenance_type, active_since, active_till.
countOutput boolean Šie parametri ir aprakstīti atsauces komentārā.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

(integer/array) Atgriež vai nu:

  • objektu masīvu;
  • izgūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Uzturēšanas periodu izgūšana

Izgūstiet visus konfigurētos uzturēšanas periodus, datus par piešķirto uzturēšanas tvērumu (hostu grupa, hosts, trigeris, notikuma nosaukums, birkas) un definētajiem laika periodiem.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "maintenance.get",
    "params": {
        "output": "extend",
        "selectHostGroups": "extend",
        "selectHosts": "extend",
        "selectTriggers": "extend",
        "selectEventNames": "extend",
        "selectTags": "extend",
        "selectTimeperiods": "extend"
    },
    "id": 1
}

Atbilde:


{
  "jsonrpc": "2.0",
  "result": [
    {
      "maintenanceid": "1",
      "name": "Regulāra DB uzturēšana",
      "maintenance_type": "0",
      "description": "",
      "active_since": "1791936000",
      "active_till": "2107555200",
      "tags_evaltype": "0",
      "hostgroups": [
        {
          "groupid": "20",
          "name": "Datubāzes",
          "flags": "0",
          "uuid": "748ad4d098d447d492bb935c907f652f"
        }
      ],
      "triggers": [],
      "event_names": [],
      "hosts": [],
      "tags": [],
      "timeperiods": [
        {
          "timeperiod_type": "4",
          "every": "1",
          "month": "4095",
          "dayofweek": "0",
          "day": "1",
          "start_time": "64800",
          "period": "3600",
          "start_date": "0"
        }
      ]
    },
    {
      "maintenanceid": "2",
      "name": "Ad hoc: Printer: tinte BEIGUSIES",
      "maintenance_type": "0",
      "description": "",
      "active_since": "1792057740",
      "active_till": "1792061340",
      "tags_evaltype": "0",
      "hostgroups": [
        {
          "groupid": "4",
          "name": "Zabbix serveri",
          "flags": "0",
          "uuid": "6f6799aa69e844b4b3918f779f2abf08"
        }
      ],
      "triggers": [],
      "event_names": [
        {
          "operator": "2",
          "value": "Printer: tinte BEIGUSIES"
        }
      ],
      "hosts": [],
      "tags": [],
      "timeperiods": [
        {
          "timeperiod_type": "0",
          "every": "1",
          "month": "0",
          "dayofweek": "0",
          "day": "0",
          "start_time": "0",
          "period": "3600",
          "start_date": "1792057740"
        }
      ]
    }
  ],
  "id": 1
}```

[comment]: # ({/ec7146e4-0b1cb387})

[comment]: # ({0c4dce96-dbcf678a})
### Skatiet arī

-   [Hosts](/manual/api/reference/host/object#host)
-   [Hostu grupa](/manual/api/reference/hostgroup/object#host-group)
-   [Trigeris](/manual/api/reference/trigger/object#trigger)
-   [Notikuma nosaukums](object#event-name)
-   [Problēmas tags](object#problem-tag)
-   [Laika periods](object#time-period)

[comment]: # ({/0c4dce96-dbcf678a})

[comment]: # ({f0ec3c40-50ed5be3})
### Avots

CMaintenance::get() failā *ui/include/classes/api/services/CMaintenance.php*.

[comment]: # ({/f0ec3c40-50ed5be3})