Zabbix SDK and CLI Tools use Zabbix API. At present this API provides:

• Zabbix Python SDK
• Zabbix CommandLine Tools Based on this SDK

Developed and mantained by Junqi Lee(paperplane). Please feel free to report bugs and your suggestions.

##API Usage##

First, refer to API document. Use host.get as an example.

API:
integer/array host.get(object parameters)

Request Method:
POST

Request Parameters:
{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": "extend",
        "filter": {
            "host": [
                "Zabbix server",
                "Linux server"
            ]
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Then,we will call this api in the way api.host.get(). but how to call this api:

• Initilize the api client

  api = APIClient(domain='http://monitor.example.com',username='api',password='api')

• Login to get authid

  api.login()

• Call the api

  api.host.get(output=['hostid','status'],filter={"host": ["Zabbix server","Linux server"]})

Notice: Json Format Request Params translate to key=value parameters.

##Command Line Tools Usage##

Currently support cli:

create user
create host
create itme
get    user
get    host
get    item
delete user
delete host
delete item

Every method has an example to show how to use. For detailed information,use --help/-h.

Before We use these tools, try to set correct server,user and password in the client script or set these as cli arguments.

zabbix get host --output hostid --output status --filter '{"host": ["Zabbix server","Linux server"]}'

zabbix delete host --hostid '23' --hostid '12'

zabbix create host --params '{"host": "Linux server","interfaces": [{"type": 1,"main": 1,"useip": 1,"ip": "192.168.3.1","dns": "","port": "10050"}],"groups": [{"groupid": "50" }],"templates": [{"templateid": "20045"}],"inventory": {"macaddress_a": "01234","macaddress_b": "56768"}}'

##Example Usage##

Add example. You Can Use this example in your projects. this example allows you add groups, hosts, items, graphs, screens simple, automatic and batch.