ZABBIX是一款广受欢迎的高效监控工具，它提供了一系列丰富的API接口，使得日常监控任务变得更加便捷。无论是查看信息、添加主机、应用监控模板，还是执行删除操作，ZABBIX API都能助您一臂之力，尤其在进行大规模监控部署时，其快速、准确的特点尤为突出。

01 准备工作：ZABBIX API调用

本文将展示如何使用Python语言，结合HTTP客户端库，通过发送HTTP请求来实现ZABBIX API的各种功能。

首先，要访问Zabbix的数据，您需要登录并获取一个身份认证token。这可以通过使用user.login方法来完成。以下是一个简单的脚本示例：

[root@zbx-server]# vim zbxapi-create-hostgroup.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x(IP)/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
  "jsonrpc": "2.0",
  "method": "user.login",
  "params": {
        "user": "Admin",
        "password": "zabbix",      
    },
  "id": 0,
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response content:", response.text)
执行脚本：
python3  zbxapi-create-hostgroup.py  {hostgroup-name}
返回结果如下：
Response content: {"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}

其中result的值就是id: 1对应的身份认证auth的值

02 常用API功能及使用方法

1、创建主机群组并获取ID

创建一个新的主机群组，并获取其ID是后续操作的关键步骤。以下是一个Python脚本示例，用于创建群组并打印返回的组ID：

# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
  "jsonrpc": "2.0",
    "method": "hostgroup.create",
    "params": {
              "name": sys.argv[1],  
      },
  "id": "1",
    "auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text)

执行脚本并传入群组名称作为参数，您将得到类似如下的响应：

{"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}

其中，result字段的值即为新创建的主机群组ID。

在zabbix web页面可以看到也是成功创建的主机群组并且groupid也都为21

获取主机群组ID这一步是比较关键的，因为后续的创建模板，创建主机等，都需要用到groupid(主机群组ID)，当新创建时可以通过API创建获取，个人也是比较喜欢，因为它可以创建的同时一并将ID也返回，如果是查询之前的，则web页面会方便一些，只需要鼠标放在对应位置即可，各有优势。

2、创建监控模板

创建模板是配置监控项和触发器的前提。以下是一个创建模板的脚本示例：

[root@zbx-server]# vim zbxapi-create-template.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
  "jsonrpc": "2.0",
  "method": "template.create",
  "params": {
  "host": sys.argv[1],
        "groups": {
            "groupid": sys.argv[2]
        },
},
  "id": "1",
  "auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text)
执行脚本：
python3  zbxapi-create-template.py  {template-name}   {groupid}

执行脚本并传入模板名称和所属群组ID，您将能在Zabbix的Web界面中看到新创建的模板。

3、创建监控主机并加入指定组

创建主机并将其加入到指定的监控群组中，是实现监控的最终步骤。以下是一个创建主机的脚本示例：

vim  zbx-host-create.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
"jsonrpc": "2.0",
"method": "host.create",
"params": {
  "host": sys.argv[1],
            "interfaces": [
            {
                "type": 1,
                    "main": 1,
                "useip": 1,
                "ip": sys.argv[2],
                "dns": "",
                    "port": "10050"
            }
            ],
            "groups": [
                {
                "groupid": sys.argv[3],  
                }
            ],
            "templates": [
                {
                    "templateid": sys.argv[4],
                }
            ],
            "inventory_mode": 0,
        "inventory": {
            "macaddress_a": "01234",
            "macaddress_b": "56768"
        }
    },
  "id": 1,
  "auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers,   data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text) 


执行脚本：python3  zbx-host-create.py  {hostname}  {ip}  {groupid}  {templateid}

执行脚本并传入主机名、IP地址、群组ID和模板ID，您将成功创建一个新的监控主机，并将其绑定到指定的群组和模板。

03 总 结

通过ZABBIX API，我们可以高效地完成主机创建等日常监控任务。在面对大量服务器需要监控时，与传统的Web界面操作相比，API提供了一种更加快速和自动化的解决方案。

此外，ZABBIX API还支持删除操作、添加标签、设置主机宏、创建监控大屏等众多功能，极大地提升了我们使用ZABBIX的效率和深度。

对于更详细的操作和功能，您可以参考ZABBIX官方API文档：

ZABBIX API Documentation

如有相关问题，请在文章后面给小编留言，小编安排作者第一时间和您联系，为您答疑解惑。

更多操作功能参考ZABBIX 官方API链接地址：

https://www.zabbix.com/documentation/current/zh/manual/api