什么是API:
API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。简单的说,API就是对外的接口,利用API可以直接到达软件硬件内部来进行操作….
zabbix中API的作用:
Zabbix API为批量操作、第三方软件集成以及其他作用提供可编程接口。
API的大致工作流如下:
(1)API 采用JSON-RPC实现。这意味着调用任何函数,都需要发送POST请求,输入输出数据都是以JSON格式
(2)准备JSON对象,它描述了你想要做什么(创建主机,获取图像,更新监控项等)。
(3)获取JSON格式响应。
1.查看zabbix监控系统的api接口:
vim zabbix-api.sh
curl -s -X POST -H 'Content-Type:application/json' -d '
# 利用curl命令模拟json格式的post请求
{
"jsonrpc": "2.0", # 这是标准的JSON RPC参数以标示协议版本。所有的请求都会保持不变
"method": "user.login", # 利用用户登陆的方式获取API
"params": {
"user": "Admin",
"password": "jay" # zabbix监控系统的用户名和密码
},
"id": 1, # 这个字段用于绑定JSON请求和响应。响应会跟请求有相同的"id"。在一次性发送多个请求时很有用,这些也不需要唯一或者连续
"auth": null
}' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool
# 采用POST方法向http://example.com/zabbix/api_jsonrpc.php发送此JSON对象. http://example.com/zabbix/是Zabbix前端地址。
# api_jsonrpc.php是调用API的PHP脚本。可在安装可视化前端的目录下找到。
给脚本以执行权限:chmod +x zabbix-api.sh
2.查看zabbix主机和被监控主机信息
curl -X POST -H 'Content-Type:application/json' -d '
{
"jsonrpc": "2.0",
"method": "host.get", # host.get方法
"params": {
"output": ["host"]
},
"auth": "8491f6ca509122f6eee354c541f925b4", # zabbix监控的API
"id": 1
}' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool
curl -s -X POST -H 'Content-Type:application/json' -d '
{
"jsonrpc": "2.0",
"method": "host.delete", # 调用host.delete方法
"params": [
"10256" # 上一步返回的被监控主机host号
],
"auth": "8491f6ca509122f6eee354c541f925b4",
"id": 1
}' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool
curl -X POST -H 'Content-Type:application/json' -d '
{
"jsonrpc": "2.0",
"method": "host.create", # 调用host.create方法
"params": {
"host": "server4.example.com", # 被监控的主机名
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": "172.25.1.4", # 被监控主机的ip
"dns": "",
"port": "10050" # zabbix-agent的端口号
}
],
"groups": [
{
"groupid": "2" # 建立的主机加入的群组
# 怎样获知groupid和templateid呢?我们可以在zabbix的web界面中打开某个群组和模版,即可在上边的地址栏中得到......
}
],
"templates": [
{
"templateid": "10001" # 建立的主机使用的模版
}
]
},
"auth": "8491f6ca509122f6eee354c541f925b4",
"id": 1
}' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool