Áú»¢¶Ä²©

hostprototype.create

Opis

object hostprototype.create(object/array hostPrototypes)

Ta metoda pozwala tworzy? nowe prototypy host¨®w.

Ta metoda jest dost?pna tylko dla u?ytkownik¨®w typu Admin i Super admin. Uprawnienia do wywo?ania tej metody mo?na cofn?? w ustawieniach r¨®l u?ytkownika. Zobacz Role u?ytkownika po wi?cej informacji.

Parametry

(object/array) Prototypy host¨®w do utworzenia.

Dodatkowo do standardowych w?a?ciwo?ci prototypu hosta, metoda akceptuje nast?puj?ce parametry.

Parametr Typ Opis
groupLinks
(wymagane)
array Powi?zania grupy do utworzenia dla prototypu hosta.
ruleid
(wymagane)
string ID regu?y LLD, do kt¨®rej nale?y prototyp hosta.
groupPrototypes array Prototypy grupy do utworzenia dla prototypu hosta.
macros object/array Makra u?ytkownika do utworzenia dla prototypu hosta.
tags object/array Znaczniki prototypu hosta .
interfaces object/array Indywidualne interfejsy prototypy hosta .
templates object/array Szablony do po??czenia z prototypem hosta.

Szablony musz? mie? zdefiniowan? w?a?ciwo?? templateid.

Zwracane warto?ci

(object) Zwraca obiekt zawieraj?cy identyfikatory utworzonych prototyp¨®w host¨®w we w?a?ciwo?ci hostids. Kolejno?? zwr¨®conych identyfikator¨®w odpowiada kolejno?ci przekazanych prototyp¨®w host¨®w.

Przyk?ady

Tworzenie prototypu hosta

Utw¨®rz prototyp hosta "{#VM.NAME}" na regule LLD "23542" z prototypem grupy "{#HV.NAME}", par? znacznik¨®w "Datacenter": "{#DATACENTER.NAME}" oraz niestandardowym interfejsem SNMPv2 127.0.0.1:161 z has?em {$SNMP_COMMUNITY}. Po??cz go z grup? host¨®w "2".

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "hostprototype.create",
           "params": {
               "host": "{#VM.NAME}",
               "ruleid": "23542",
               "custom_interfaces": "1",
               "groupLinks": [
                   {
                       "groupid": "2"
                   }
               ],
               "groupPrototypes": [
                   {
                       "name": "{#HV.NAME}"
                   }
               ],
               "tags": [
                   {
                       "tag": "Datacenter",
                       "value": "{#DATACENTER.NAME}"
                   }
               ],
               "interfaces": [
                   {
                       "main": "1",
                       "type": "2",
                       "useip": "1",
                       "ip": "127.0.0.1",
                       "dns": "",
                       "port": "161",
                       "details": {
                           "version": "2",
                           "bulk": "1",
                           "community": "{$SNMP_COMMUNITY}"
                       }
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10103"
               ]
           },
           "id": 1
       }

Zobacz tak?e

?°ù¨®»å?´Ç

CHostPrototype::create() w ui/include/classes/api/services/CHostPrototype.php.