graphitem.get

Опис

integer/array graphitem.get(object parameters)

Метод дозволяє отримувати елементи графа за заданими параметрами.

Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object) Параметри, що визначають бажаний результат.

Метод підтримує такі параметри.

Параметр	Тип	Опис
graphids	string/array	Повертає лише елементи графа, які належать до заданих графів.
itemids	рядок/масив	Повертає лише елементи графіка з заданими ідентифікаторами елементів.
type	integer	Повертати лише елементи графіка з указаним типом. Зверніться до сторінки об’єкта елемента графіка, щоб отримати список підтримуваних типів елементів графіка.
selectGraphs	запит	Повертає властивість graphs із масивом графіків, до яких належить елемент.
sortfield	рядок/масив	Сортувати результат за заданими властивостями. Можливі значення: `gitemid`.
countOutput	boolean	Ці параметри, які є спільними для всіх методів `get`, детально описано на сторінці довідковий коментар.
редагований	логічний
ліміт	ціле
вивід	запит
preservekeys	boolean
порядок сортування	рядок/масив

Повернуті значення

(integer/array) Повертає або:

масив об'єктів;
кількість отриманих об'єктів, якщо використовувався параметр countOutput.

Приклади

Отримання елементів графіка з графіка

Отримати всі елементи графіка, що використовуються в графіку, з додатковою інформацією про елемент і хост.

Запит:

{
           "jsonrpc": "2.0",
           "method": "graphitem.get",
           "params": {
               "output": "extend",
               "graphids": "387"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "gitemid": "1242",
                   "graphid": "387",
                   "itemid": "22665",
                   "drawtype": "1",
                   "sortorder": "1",
                   "color": "FF5555",
                   "yaxisside": "0",
                   "calc_fnc": "2",
                   "type": "0",
                   "key_": "system.cpu.util[,steal]",
                   "hostid": "10001",
                   "flags": "0",
                   "host": "Linux"
               },
               {
                   "gitemid": "1243",
                   "graphid": "387",
                   "itemid": "22668",
                   "drawtype": "1",
                   "sortorder": "2",
                   "color": "55FF55",
                   "yaxisside": "0",
                   "calc_fnc": "2",
                   "type": "0",
                   "key_": "system.cpu.util[,softirq]",
                   "hostid": "10001",
                   "flags": "0",
                   "host": "Linux"
               },
               {
                   "gitemid": "1244",
                   "graphid": "387",
                   "itemid": "22671",
                   "drawtype": "1",
                   "sortorder": "3",
                   "color": "009999",
                   "yaxisside": "0",
                   "calc_fnc": "2",
                   "type": "0",
                   "key_": "system.cpu.util[,interrupt]",
                   "hostid": "10001",
                   "flags": "0",
                   "host": "Linux"
               }
           ],
           "id": 1
       }

Дивись також

Графік

Джерело

CGraphItem::get() у ui/include/classes/api/services/CGraphItem.php.

Documentation