Zabbix Documentation 1.8

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

api:host:delete

Table of Contents

delete()

Available since version: 1.8
This function allows you to delete information about one or several hosts. All host-related information will be removed including items, graphs, macros, application, historical data, etc.

Parameters

Array of Host IDs

Returns

ParameterDescription
resultOperation successful. Result will contain array of deleted Host IDs.
errorIn case of any errors

Example

Delete hosts by Host ID

{
"jsonrpc":"2.0",
"method":"host.delete",
"params":[
      {
         "hostid":"107824"
      },
      {
         "hostid":"107825"
      }
],
"auth":"3a57200802b24cda67c4e4010b50c065",
"id":2
}

Hosts deleted successfully:

{
"jsonrpc":"2.0",
"result":{
   "hostids": ["107824", "107825"]
},
"id":2
}
Host does not exist:

{
"jsonrpc":"2.0",
"error":{
      "code":-32500,
      "message":"Application error.",
      "data":"[ CHost::delete ] Host does not exist"
},
"id":2
}