hostprototype.create

Leírás

object hostprototype.create(object/array hostPrototypes)

Ez a módszer lehetővé teszi új gazdagép prototípusok létrehozását.

Ez a módszer csak az Admin és a Kiemelt rendszergazda számára érhető el felhasználói típusok. A metódus meghívására vonatkozó engedélyek felhasználói szerepkörben visszavonhatók beállítások. Lásd: User roles további információért.

Paraméterek

(object/array) Host prototípusok létrehozása.

A standard host prototype property, a metódus a következőket fogadja el paramétereket.

Paraméter Típus Leírás
groupLinks
(kötelező)		 array A gazdagép prototípusához létrehozandó [linkek] (/manual/api/reference/hostprototype/object#group_link) csoport.
ruleid
(kötelező)		 string Az LLD-szabály azonosítója, amelyhez a gazdagép prototípusa tartozik.
groupPrototypes array A gazdagép prototípusához létrehozandó [prototípusok] csoport (/manual/api/reference/hostprototype/object#group_prototype).
makrók object/array Felhasználói makrók létrehozandó a gazdagép prototípusához.
címkék object/array Host prototípus címkék.
interfészek objektum/tömb Gazdagép prototípusa egyéni interfészek.
templates object/array Sablonok a gazdagép prototípusához kapcsolandó.

A sablonoknak meg kell adni a templateid tulajdonságot.

Visszatérési értékek

(object) Egy objektumot ad vissza, amely tartalmazza a létrehozott gazdagép azonosítóit prototípusok a "hostids" tulajdonság alatt. A visszaküldött azonosítók sorrendje megegyezik az átadott gazdagép prototípusok sorrendjével.

Példák

Gazda prototípus létrehozása

Hozzon létre egy „{#VM.NAME}” gazdagép prototípust a „23542” LLD-szabályra egy csoporttal prototípus "{#HV.NAME}", címkepár "Datacenter": "{#DATACENTER.NAME}" és egyéni SNMPv2 interfész 127.0.0.1:161 közösséggel {$SNMP_COMMUNITY}. Kapcsolja össze a "2" fogadócsoporttal.

Kérés:

{
 · "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}"
 · }
 · ],
 · "Interfészek": [
 · {
 · "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
}

Válasz:

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

Lásd még

  • [Group Link] (objektum#Group_Link)
  • [Group Prototype] (Object#Group_prototype)
  • [Host prototípus címke] (objektum#host_prototype_tag)
  • [Egyéni interfész] (objektum#custom_interface)
  • [Felhasználó makró] (/kézi/api/referencia/usermacro/objektum#hostTemplate_level_macro)

Forrás

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