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.

Documentation