Documentation
Table of Contents
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.