create()

This method allows you to create a host as defined by the host data array.

Parameters

Parameter	Type	Optional	Description	Details
host data	array or object	No	Array of Host objects or a single object	hostid shouldn't be specified
groups	array	No	HostGroup Objects add Host to.
templates	array	No	Templates Objects link Host to.

Returns

Parameter	Description
result	Operation successful. Result will contain array of created Host IDs. hostid are assigned to each Host object
error	In case of any errors

Example

{
       "jsonrpc":"2.0",
       "method":"host.create",
       "params":{
             "host":"Linux001",
             "ip":"192.168.3.1",
             "port":10050,
             "useip":1,
             "groups":[
                {
                   "groupid":50
                }
             ],
             "templates":[
                {
                   "templateid":20045
                }
             ]
          },
       "auth":"038e1d7b1735c6a5436ee9eae095879e",
       "id":3
       }

Host added successfully:

{
       "jsonrpc":"2.0",
       "result":{
          "hostids": ["107819"]
       },
       "id":3
       }

Host already exists:

{
       "jsonrpc":"2.0",
       "error":{
             "code":-32602,
             "message":"Invalid params.",
             "data":"[ CHost::create ] Host [ Linux001 ] already exists"
       },
       "id":3
       }

Documentation

create()

Parameters

Returns

Example