11.发现服务 - 获取 - 《Zabbix 5.0 使用手册》

获取

获取

描述

integer/array dservice.get(object **parameters**)

这个方法允许根据给定的参数检索发现的服务。

参数

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

这个方法支持以下参数。

参数	类型	描述
dserviceids	字符串/数组	只返回拥有给定 ID 的被发现服务。
dhostids	字符串/数组	只返回被发现的服务，该服务属于给定的被发现主机。
dcheckids	字符串/数组	只返回由给定的发现检查检测到的已发现的服务。
druleids	字符串/数组	只返回被给定的发现规则检测到的服务。

selectDRules	查询	返回发现规则，该规则规定被发现服务在 `drules` 属性中以数组形式存在。
selectDHosts	查询	返回服务属于的已发现主机，该主机在 `dhosts` 属性中以数组形式存在。
selectHosts	查询	返回与 `hosts` 属性中的服务具有相同 IP 地址的主机。支持 `count`。

limitSelects	整数	限制子选择返回的记录数量。适用于下列子选择： `selectHosts` - 结果将按 `hostid` 排序。
sortfield	字符串/数组	根据给定的属性对结果进行排序。可能的值有： `dserviceid`， `dhostid` 和 `ip`。
countOutput	布尔值	在引用评论中详细描述了所有 `get` 方法的常见参数。
editable	布尔值
excludeSearch	布尔值
filter	对象
limit	整数
output	查询
preservekeys	布尔值
search	对象
searchByAny	布尔值
searchWildcardsEnabled	布尔值
sortorder	字符串/数组
startSearch	布尔值

返回值

(integer/array) 返回：

一个对象数组；
如果使用了 countOutput 参数，被检索的对象的数量。

示例

检索在主机上发现的服务

检索在被发现主机 “11” 上发现的所有被发现的服务。

请求：

{
    "jsonrpc": "2.0",
    "method": "dservice.get",
    "params": {
        "output": "extend",
        "dhostids": "11"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

响应：

{
    "jsonrpc": "2.0",
    "result": [
        {
            "dserviceid": "12",
            "dhostid": "11",
            "value": "",
            "port": "80",
            "status": "1",
            "lastup": "0",
            "lastdown": "1348650607",
            "dcheckid": "5",
            "ip": "192.168.1.134",
            "dns": "john.local"
        },
        {
            "dserviceid": "13",
            "dhostid": "11",
            "value": "",
            "port": "21",
            "status": "1",
            "lastup": "0",
            "lastdown": "1348650610",
            "dcheckid": "6",
            "ip": "192.168.1.134",
            "dns": "john.local"
        }
    ],
    "id": 1
}

参见

来源

CDService::get() in frontends/php/include/classes/api/services/CDService.php.