[comment]: # translation:outdated

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

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

[comment]: # ({fe0d9976-fe22ea70})
### 描述

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

该方法允许根据给定的参数来检索图表监控项。

::: noteclassic
这种方法对任何类型的用户都适用。调用该方法的权限可以在用户角色设置中撤销。前往[用户角色](/manual/web_interface/frontend_sections/administration/user_roles)以获取更多信息。
:::

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

[comment]: # ({11d25a81-d30698ba})

### 参数

`(object)` 定义所需输出的参数。

该方法支持以下参数。

|参数|[类型](/manual/api/reference_commentary#数据类型)|描述|
|---------|---------------------------------------------------|-----------|
|graphids|string/array|只返回属于给定图表的图表监控项。|
|itemids|string/array|只返回具有给定监控项ID的图表监控项。|
|type|integer|只返回具有给定类型的图表监控项。<br><br>请参考[图表监控项对象页](object#图表监控项)，了解支持的图表监控项类型列表。|
|selectGraphs|query|返回一个[图表](/manual/api/reference/graph/object)属性，其中包含该监控项所属的图表的数组。|
|sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值： `gitemid`。|
|countOutput|boolean|这些参数是所有 "get "方法的共同参数，在[参考说明](/manual/api/reference_commentary#通用get方法参数)页面中有详细描述。|
|editable|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|sortorder|string/array|^|

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

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

### 返回值

返回值是 `(integer/array)` 其中之一：

-   一个对象的数组；
-   如果使用了`countOutput`参数，则为检索到的对象的数量。

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

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

### 示例

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

[comment]: # ({8a9e60a9-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]: # ({/8a9e60a9-37da5f20})

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

### 另见

-   [图表](/manual/api/reference/graph/object#图表)

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

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

### 来源

*ui/include/classes/api/services/CGraphItem.php* 中的 CGraphItem::get()。

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