[comment]: # ({cdc53a5f-cdc53a5f})
# graph.get

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

[comment]: # ({b80d99e9-d2f8406d})
### Описание

`integer/array graph.get(параметры объекта)`

Этот метод позволяет получать графики в соответствии с заданными
параметрами.

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

[comment]: # ({/b80d99e9-d2f8406d})

[comment]: # ({5711b41f-5b1c5b22})
### Параметры

`(object)` Параметры, определяющие требуемый результат.

Метод поддерживает следующие параметры.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|graphids|ID/array|Возвращать только графики с указанными ID.|
|groupids|ID/array|Возвращать только графики, которые принадлежат узлам сети или шаблонам в указанных группах узлов сети или группах шаблонов.|
|templateids|ID/array|Возвращать только графики, которые принадлежат указанным шаблонам.|
|hostids|ID/array|Возвращать только графики, которые принадлежат указанным узлам сети.|
|itemids|ID/array|Возвращать только графики, которые содержат указанные элементы данных.|
|templated|boolean|Если установлено в `true`, возвращать только графики, которые принадлежат шаблонам.|
|inherited|boolean|Если установлено в `true`, возвращать только графики, унаследованные от шаблона.|
|expandName|flag|Расширять макросы в имени графика.|
|selectDiscoveryData|query|Возвращать свойство `discoveryData` с данными объекта обнаружения графика. Объект обнаружения графика связывает обнаруженный график с прототипом графика, из которого он был обнаружен.<br><br>Он имеет следующие свойства:<br>`parent_graphid` - `(ID)` ID прототипа графика, из которого был создан график;<br>`status` - `(int)` статус обнаружения графика:<br>0 - *(по умолчанию)* график обнаружен,<br>1 - график больше не обнаружен;<br>`ts_delete` - `(timestamp)` время, когда будет удален график, который больше не обнаружен.|
|selectDiscoveryRule|query|Возвращать свойство [`discoveryRule`](/manual/api/reference/drule/object) с правилом низкоуровневого обнаружения, которое создало график.|
|selectHostGroups|query|Возвращать свойство [`hostgroups`](/manual/api/reference/hostgroup/object) с группами узлов сети, к которым принадлежит график.|
|selectTemplateGroups|query|Возвращать свойство [`templategroups`](/manual/api/reference/templategroup/object) с группами шаблонов, к которым принадлежит график.|
|selectTemplates|query|Возвращать свойство [`templates`](/manual/api/reference/template/object) с шаблонами, к которым принадлежит график.|
|selectHosts|query|Возвращать свойство [`hosts`](/manual/api/reference/host/object) с узлами сети, к которым принадлежит график.|
|selectItems|query|Возвращать свойство [`items`](/manual/api/reference/item/object) с элементами данных, используемыми в графике.|
|selectGraphItems|query|Возвращать свойство [`gitems`](/manual/api/reference/graphitem/object) с элементами данных, используемыми в графике.|
|filter|object|Возвращать только те результаты, которые точно соответствуют заданному фильтру.<br><br>Принимает объект, где ключи — это имена свойств, а значения — либо одно значение, либо массив значений, с которыми выполняется сравнение.<br><br>Не поддерживает свойства с [типом данных](/manual/api/reference_commentary#data-types) `text`.<br><br>Поддерживает дополнительные свойства:<br>`host` - техническое имя узла сети, к которому принадлежит график;<br>`hostid` - ID узла сети, к которому принадлежит график.|
|sortfield|string/array|Сортировать результат по указанным свойствам.<br><br>Возможные значения: `graphid`, `name`, `graphtype`.|
|countOutput|boolean|Эти параметры описаны в [комментарии к справочнику](/manual/api/reference_commentary#common-get-method-parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|
|selectGraphDiscovery|query|Возвращать свойство `graphDiscovery` с объектом обнаружения графика. Объекты обнаружения графика связывают график с прототипом графика, из которого он был создан.<br><br>Этот запрос **устарел**, вместо него используйте `selectDiscoveryData`.

[comment]: # ({/5711b41f-5b1c5b22})

[comment]: # ({7223bab1-7223bab1})
### Возвращаемые значения

`(целое число/массив)` Возвращает либо:

- · массив объектов;
- · количество извлеченных объектов, если использовался параметр `countOutput`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({d11e19d3-e7fae381})
#### Получение графиков с узлов сети

Получите все графики с узла сети "10107" и отсортируйте их по имени.

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "graph.get",
    "params": {
        "output": "extend",
        "hostids": 10107,
        "sortfield": "name"
    },
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "graphid": "612",
            "name": "CPU jumps",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "439",
            "show_work_period": "1",
            "show_triggers": "1",
            "graphtype": "0",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
        },
        {
            "graphid": "613",
            "name": "CPU load",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "433",
            "show_work_period": "1",
            "show_triggers": "1",
            "graphtype": "0",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "1",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
        },
        {
            "graphid": "614",
            "name": "CPU utilization",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "387",
            "show_work_period": "1",
            "show_triggers": "0",
            "graphtype": "1",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "1",
            "ymax_type": "1",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
        },
        {
            "graphid": "645",
            "name": "Disk space usage /",
            "width": "600",
            "height": "340",
            "yaxismin": "0",
            "yaxismax": "0",
            "templateid": "0",
            "show_work_period": "0",
            "show_triggers": "0",
            "graphtype": "2",
            "show_legend": "1",
            "show_3d": "1",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "4"
        }
    ],
    "id": 1
}
```

[comment]: # ({/d11e19d3-e7fae381})

[comment]: # ({7b8d40e8-e4f96e80})
### См. также

-   [Правило обнаружения](/manual/api/reference/discoveryrule/object#discovery-rule)
-   [Элемент графика](/manual/api/reference/graphitem/object#graph-item)
-   [Элемент данных](/manual/api/reference/item/object#item)
-   [Узел сети](/manual/api/reference/host/object#host)
-   [Группа узлов сети](/manual/api/reference/hostgroup/object#host-group)
-   [Шаблон](/manual/api/reference/template/object#template)
-   [Группа шаблонов](/manual/api/reference/templategroup/object#template-group)

[comment]: # ({/7b8d40e8-e4f96e80})

[comment]: # ({6f7b2d0a-6f7b2d0a})
### Источник

CGraph::get() в *ui/include/classes/api/services/CGraph.php*.

[comment]: # ({/6f7b2d0a-6f7b2d0a})