[comment]: # translation:outdated

[comment]: # ({43e64f56-43e64f56})
# graphitem.get

[comment]: # ({/43e64f56-43e64f56})

[comment]: # ({c5d254ae-fe22ea70})
### Опис

`integer/array graphitem.get(object parameters)`

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

::: noteclassic
Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації.
:::

[comment]: # ({/c5d254ae-fe22ea70})

[comment]: # ({e3b9b978-d30698ba})
### Параметри

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

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

|Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|graphids|string/array|Повертає лише елементи графа, які належать до заданих графів.|
|itemids|рядок/масив|Повертає лише елементи графіка з заданими ідентифікаторами елементів.|
|type|integer|Повертати лише елементи графіка з указаним типом.<br><br>Зверніться до [сторінки об’єкта елемента графіка](object#graph_item), щоб отримати список підтримуваних типів елементів графіка.|
|selectGraphs|запит|Повертає властивість [graphs](/manual/api/reference/graph/object) із масивом графіків, до яких належить елемент.|
|sortfield|рядок/масив|Сортувати результат за заданими властивостями.<br><br>Можливі значення: `gitemid`.|
|countOutput|boolean|Ці параметри, які є спільними для всіх методів `get`, детально описано на сторінці [довідковий коментар](/manual/api/reference_commentary#common_get_method_parameters).|
|редагований|логічний|^|
|ліміт|ціле|^|
|вивід|запит|^|
|preservekeys|boolean|^|
|порядок сортування|рядок/масив|^|

[comment]: # ({/e3b9b978-d30698ba})

[comment]: # ({7223bab1-7223bab1})
### Повернуті значення

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

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

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Приклади

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({1a131f00-37da5f20})
#### Отримання елементів графіка з графіка

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

Запит:

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

Відповідь:

```json
{
    "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
}
```

[comment]: # ({/1a131f00-37da5f20})

[comment]: # ({09a26e71-09a26e71})
### Дивись також

- [Графік](/manual/api/reference/graph/object#graph)

[comment]: # ({/09a26e71-09a26e71})

[comment]: # ({8d13cada-8d13cada})
### Джерело

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

[comment]: # ({/8d13cada-8d13cada})