Documentation
Table of Contents
- host.create
- §°§á§Ú§ã
- §±§Ñ§â§Ñ§Þ§Ö§ä§â§Ú
- §±§à§Ó§â§Ñ§ä§ß§Ö §Ó§â§Ö§Õ§ß§à§ã§ä§Ú
- §±§â§Ú§Þ§Ö§â§Ú
- §¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ
- §¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §ã§Ñ SNMP §Ú§ß§ä§Ö§â§æ§Ö?§ã§à§Þ
- §¬§â§Ö§Ú§â§Ñ?§Ö §ç§à§ã§ä§Ñ §ã§Ñ PSK §Ö§ß§Ü§â§Ú§á§è§Ú?§à§Þ
- §¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ §á§â§à§Ü§Ú
- §¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ §á§â§à§Ü§ã§Ú §Ô§â§å§á§å
- §´§Ñ§Ü§à?§Ö §á§à§Ô§Ý§Ö§Õ§Ñ?§ä§Ö
- §ª§Ù§Ó§à§â
host.create
§°§á§Ú§ã
object host.create(object/array hosts)
§°§Ó§Ñ? §Þ§Ö§ä§à§Õ §à§Þ§à§Ô§å?§Ñ§Ó§Ñ §Ü§â§Ö§Ú§â§Ñ?§Ö §ß§à§Ó§Ú§ç §ç§à§ã§ä§à§Ó§Ñ.
§°§Ó§Ñ §Þ§Ö§ä§à§Õ§Ñ ?§Ö §Õ§à§ã§ä§å§á§ß§Ñ §ã§Ñ§Þ§à §ä§Ú§á§à§Ó§Ú§Þ§Ñ §¡§Õ§Þ§Ú§ß §Ú §³§å§á§Ö§â §Ñ§Õ§Þ§Ú§ß§Ü§à§â§Ú§ã§ß§Ú§Ü§Ñ. §¥§à§Ù§Ó§à§Ý§Ö §Ù§Ñ §á§à§Ù§Ú§Ó§Ñ?§Ö §Þ§Ö§ä§à§Õ§Ö §Þ§à§Ô§å §ã§Ö §à§á§à§Ù§Ó§Ñ§ä§Ú §å §á§à§Õ§Ö§ê§Ñ§Ó§Ñ?§Ú§Þ§Ñ §å§Ý§à§Ô§Ñ §Ü§à§â§Ú§ã§ß§Ú§Ü§Ñ. §±§à§Ô§Ý§Ö§Õ§Ñ?§ä§Ö Userroles §Ù§Ñ §Ó§Ú§ê§Ö §Ú§ß§æ§à§â§Þ§Ñ§è§Ú?§Ñ.
§±§Ñ§â§Ñ§Þ§Ö§ä§â§Ú
(object/array) §¥§à§Þ§Ñ?§Ú§ß§Ú §Ù§Ñ §Ü§â§Ö§Ú§â§Ñ?§Ö.
§±§à§â§Ö§Õ §ä§à§Ô§Ñ standard host properties, §Þ§Ö§ä§à§Õ §á§â§Ú§ç§Ó§Ñ§ä§Ñ §ã§Ý§Ö§Õ§Ö?§Ö §á§Ñ§â§Ñ§Þ§Ö§ä§â§Ö.
| Parameter | Type | §°§á§Ú§ã |
|---|---|---|
| groups | object/array | Host groups ) §Ù§Ñ §Õ§à§Õ§Ñ§Ó§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ. §¥§à§Þ§Ñ?§Ú§ß§Ú §Ô§â§å§á§Ö §Þ§à§â§Ñ?§å §Ú§Þ§Ñ§ä§Ú §ã§Ñ§Þ§à §Õ§Ö§æ§Ú§ß§Ú§ã§Ñ§ß§à §ã§Ó§à?§ã§ä§Ó§à groupid.Parameter behavior: - §à§Ò§Ñ§Ó§Ö§Ù§ß§à |
| interfaces | object/array | Interfaces §Ü§à?§Ú ?§Ö §Ò§Ú§ä§Ú §Ü§â§Ö§Ú§â§Ñ§ß§Ú §Ù§Ñ §Õ§à§Þ§Ñ?§Ú§ß§Ñ. |
| tags | object/array | Host tags. |
| templates | object/array | Templates §Ü§à?§Ú ?§Ö §Ò§Ú§ä§Ú §á§à§Ó§Ö§Ù§Ñ§ß§Ú §ã§Ñ §Õ§à§Þ§Ñ?§Ú§ß§à§Þ. §º§Ñ§Ò§Ý§à§ß§Ú §Þ§à§â§Ñ?§å §Ú§Þ§Ñ§ä§Ú §ã§Ñ§Þ§à §Õ§Ö§æ§Ú§ß§Ú§ã§Ñ§ß§à §ã§Ó§à?§ã§ä§Ó§à templateid. |
| macros | object/array | User macros §Ü§à?§Ú ?§Ö §ã§Ö §Ü§â§Ö§Ú§â§Ñ§ä§Ú §Ù§Ñ §Õ§à§Þ§Ñ?§Ú§ß§Ñ. |
| inventory | object | Host inventory §ã§Ó§à?§ã§ä§Ó§Ñ. |
§±§à§Ó§â§Ñ§ä§ß§Ö §Ó§â§Ö§Õ§ß§à§ã§ä§Ú
(object) §£§â§Ñ?§Ñ §à§Ò?§Ö§Ü§Ñ§ä §Ü§à?§Ú §ã§Ñ§Õ§â§Ø§Ú ID-§Ú?§Ö§Ó§Ö §Ü§â§Ö§Ú§â§Ñ§ß§Ú§ç §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ú§ã§á§à§Õ §ã§Ó§à?§ã§ä§Ó§Ñ hostidsIDs. §²§Ö§Õ§à§ã§Ý§Ö§Õ §Ó§â§Ñ?§Ö§ß§Ú§ç ID-§Ú?§Ö§Ó§Ñ §à§Õ§Ô§à§Ó§Ñ§â§Ñ §â§Ö§Õ§à§ã§Ý§Ö§Õ§å §á§â§à§ã§Ý§Ö?§Ö§ß§Ú§ç §Õ§à§Þ§Ñ?§Ú§ß§Ñ.
§±§â§Ú§Þ§Ö§â§Ú
§¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ
§¯§Ñ§á§â§Ñ§Ó§Ú§ä§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §á§à§Õ §ß§Ñ§Ù§Ú§Ó§à§Þ "Linux server" §ã§Ñ IP §Ú§ß§ä§Ö§â§æ§Ö?§ã§à§Þ §Ú §à§Ù§ß§Ñ§Ü§Ñ§Þ§Ñ, §Õ§à§Õ§Ñ?§ä§Ö §Ô§Ñ §å §Ô§â§å§á§å, §á§à§Ó§Ö§Ø§Ú§ä§Ö §ê§Ñ§Ò§Ý§à§ß §ã§Ñ ?§Ú§Þ §Ú §á§à§ã§ä§Ñ§Ó§Ú§ä§Ö MAC §Ñ§Õ§â§Ö§ã§Ö §å §Ú§ß§Ó§Ö§ß§ä§Ñ§â§å §Õ§à§Þ§Ñ?§Ú§ß§Ñ.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Linux server",
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": "192.168.3.1",
"dns": "",
"port": "10050"
}
],
"groups": [
{
"groupid": "50"
}
],
"tags": [
{
"tag": "host-name",
"value": "linux-server"
}
],
"templates": [
{
"templateid": "20045"
}
],
"macros": [
{
"macro": "{$USER_ID}",
"value": "123321"
},
{
"macro": "{$USER_LOCATION}",
"value": "0:0:0",
"description": "latitude, longitude and altitude coordinates"
}
],
"inventory_mode": 0,
"inventory": {
"macaddress_a": "01234",
"macaddress_b": "56768"
}
},
"id": 1
}§°§Õ§Ô§à§Ó§à§â:
§¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §ã§Ñ SNMP §Ú§ß§ä§Ö§â§æ§Ö?§ã§à§Þ
§¬§â§Ö§Ú§â§Ñ?§ä§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §á§à§Õ §ß§Ñ§Ù§Ú§Ó§à§Þ "SNMP hostSNMPv3" §ã§Ñ SNMP host §Ú§ß§ä§Ö§â§æ§Ö?§ã§à§Þ §ã§Ñ §Õ§Ö§ä§Ñ?§Ú§Þ§Ñ.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "SNMP host",
"interfaces": [
{
"type": 2,
"main": 1,
"useip": 1,
"ip": "127.0.0.1",
"dns": "",
"port": "161",
"details": {
"version": 3,
"bulk": 0,
"securityname": "mysecurityname",
"contextname": "","securitylevel": 1
}
}
],
"groups": [
{
"groupid": "4"
}
]
},
"id": 1
}§°§Õ§Ô§à§Ó§à§â:
§¬§â§Ö§Ú§â§Ñ?§Ö §ç§à§ã§ä§Ñ §ã§Ñ PSK §Ö§ß§Ü§â§Ú§á§è§Ú?§à§Þ
§¯§Ñ§á§â§Ñ§Ó§Ú§ä§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §á§à§Õ §ß§Ñ§Ù§Ú§Ó§à§Þ ?PSK host"¡° §ã§Ñ §Ü§à§ß§æ§Ú§Ô§å§â§Ú§ã§Ñ§ß§Ú§Þ PSK §ê§Ú§æ§â§à§Ó§Ñ?§Ö§Þ. §ª§Þ§Ñ?§ä§Ö §ß§Ñ §å§Þ§å §Õ§Ñ §Õ§à§Þ§Ñ?§Ú§ß §Þ§à§â§Ñ §Ò§Ú§ä§Ú pre-configured to use PSK.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "PSK host",
"interfaces": [
{
"type": 1,
"ip": "192.168.3.1",
"dns": "",
"port": "10050",
"useip": 1,
"main": 1
}
],
"groups": [
{
"groupid": "2"
}
],
"tls_accept": 2,
"tls_connect": 2,
"tls_psk_identity": "PSK 001",
"tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"
},
"id": 1
}§°§Õ§Ô§à§Ó§à§â:
§¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ §á§â§à§Ü§Ú
§¯§Ñ§á§â§Ñ§Ó§Ú§ä§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú ?§Ö §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ§ä§Ú §á§â§à§Ü§ã§Ú §ã§Ñ ID-§Ú?§Ö§Þ"1".
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Host monitored by proxy",
"groups": [
{
"groupid": "2"
}
],
"monitored_by": 1,
"proxyid": 1
},
"id": 1
}§°§Õ§Ô§à§Ó§à§â:
§¬§â§Ö§Ú§â§Ñ?§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ §á§â§à§Ü§ã§Ú §Ô§â§å§á§å
§¯§Ñ§á§â§Ñ§Ó§Ú§ä§Ö §Õ§à§Þ§Ñ?§Ú§ß§Ñ §Ü§à?§Ú ?§Ö §ß§Ñ§Õ§Ô§Ý§Ö§Õ§Ñ§ä§Ú §á§â§à§Ü§ã§Ú §Ô§â§å§á§Ñ §ã§Ñ ID-§Ú?§Ö§Þ "1".
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Host monitored by proxy group",
"groups": [
{
"groupid": "2"
}
],
"monitored_by": 2,
"proxy_groupid": 1
},
"id": 1
}§°§Õ§Ô§à§Ó§à§â:
§´§Ñ§Ü§à?§Ö §á§à§Ô§Ý§Ö§Õ§Ñ?§ä§Ö
-Host group -Template -User macro -Host interface -Host inventory -Host tag-Proxy -Proxy group
§ª§Ù§Ó§à§â
CHost::create() in ui/include/classes/api/services/CHost.php.