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.