此方法允许根据指定的参数获取主机.

    参数

    (object) 定义期望输出的参数.

    该方法支持以下参数.

    (integer/array) 返回其中之一:

    • 一组对象;

    • 如果使用了countOutput参数，则返回获取的对象数量.

    示例

    通过名称获取数据

    响应:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "maintenances": [],
    6.             "hostid": "10160",
    7.             "proxy_hostid": "0",
    8.             "host": "Zabbix server",
    9.             "status": "0",
    10.             "disable_until": "0",
    12.             "available": "0",
    13.             "errors_from": "0",
    14.             "lastaccess": "0",
    15.             "ipmi_authtype": "-1",
    16.             "ipmi_privilege": "2",
    17.             "ipmi_username": "",
    18.             "ipmi_password": "",
    19.             "ipmi_disable_until": "0",
    20.             "ipmi_available": "0",
    21.             "snmp_disable_until": "0",
    22.             "snmp_available": "0",
    23.             "maintenanceid": "0",
    24.             "maintenance_status": "0",
    25.             "maintenance_type": "0",
    26.             "maintenance_from": "0",
    27.             "ipmi_errors_from": "0",
    28.             "snmp_errors_from": "0",
    29.             "ipmi_error": "",
    30.             "snmp_error": "",
    31.             "jmx_disable_until": "0",
    32.             "jmx_available": "0",
    33.             "jmx_errors_from": "0",
    34.             "jmx_error": "",
    35.             "name": "Zabbix server",
    36.             "description": "The Zabbix monitoring server.",
    37.             "tls_connect": "1",
    38.             "tls_accept": "1",
    39.             "tls_issuer": "",
    40.             "tls_subject": "",
    41.             "tls_psk_identity": "",
    42.             "tls_psk": ""
    43.         {
    44.             "maintenances": [],
    45.             "hostid": "10167",
    46.             "proxy_hostid": "0",
    47.             "host": "Linux server",
    48.             "status": "0",
    49.             "disable_until": "0",
    50.             "error": "",
    51.             "available": "0",
    52.             "errors_from": "0",
    53.             "lastaccess": "0",
    54.             "ipmi_authtype": "-1",
    55.             "ipmi_privilege": "2",
    56.             "ipmi_username": "",
    57.             "ipmi_password": "",
    58.             "ipmi_disable_until": "0",
    59.             "ipmi_available": "0",
    60.             "snmp_disable_until": "0",
    61.             "snmp_available": "0",
    62.             "maintenanceid": "0",
    63.             "maintenance_status": "0",
    64.             "maintenance_type": "0",
    65.             "maintenance_from": "0",
    66.             "ipmi_errors_from": "0",
    67.             "snmp_errors_from": "0",
    68.             "ipmi_error": "",
    69.             "snmp_error": "",
    70.             "jmx_disable_until": "0",
    71.             "jmx_available": "0",
    72.             "jmx_errors_from": "0",
    73.             "jmx_error": "",
    74.             "name": "Linux server",
    75.             "description": "",
    76.             "tls_connect": "1",
    77.             "tls_accept": "1",
    78.             "tls_issuer": "",
    80.             "tls_psk_identity": "",
    81.             "tls_psk": ""
    82.         }
    83.     ],
    84.     "id": 1
    85. }

    获取主机组

    获取主机“Zabbix server”所属的主机组，并不检索主机本身的详细信息

    请求:

    响应:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "hostid": "10085",
    6.             "groups": [
    7.                 {
    8.                     "groupid": "2",
    9.                     "name": "Linux servers",
    10.                     "internal": "0",
    11.                     "flags": "0"
    12.                 {
    13.                     "groupid": "4",
    14.                     "name": "Zabbix servers",
    15.                     "internal": "0",
    16.                     "flags": "0"
    17.                 }
    18.             ]
    19.         }
    20.     ],
    21.     "id": 2
    22. }

    获取关联的模板

    获取主机“10084”关联的模板的ID和名称 请求:

    响应:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "hostid": "10084",
    6.             "parentTemplates": [
    7.                 {
    8.                     "name": "Template OS Linux",
    9.                     "templateid": "10001"
    10.                 },
    11.                 {
    12.                     "name": "Template App Zabbix Server",
    13.                     "templateid": "10047"
    14.                 }
    15.             ]
    16.         }
    17.     ],
    18.     "id": 1
    19. }

    根据主机资产清单数据进行检索

    响应:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "hostid": "10084",
    6.             "host": "Zabbix server",
    7.             "inventory": {
    8.                 "os": "Linux Ubuntu"
    9.             }
    10.         },
    11.         {
    12.             "hostid": "10107",
    13.             "host": "Linux server",
    14.             "inventory": {
    15.                 "os": "Linux Mint"
    16.             }
    17.         }
    18.     ],
    19.     "id": 1
    20. }

    来源

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