hostprototype.create

Apraksts

object hostprototype.create(object/array hostPrototypes)

Šī metode ļauj izveidot jaunus hostu prototipus.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

(object/array) Izveidojamie hostu prototipi.

Papildus standarta hosta prototipa īpašībām metode pieņem šādus parametrus.

Parametrs Tips Apraksts
groupLinks array Grupu saites, kas tiks izveidotas hosta prototipam.

Parametra darbība:
- obligāts
ruleid ID LLD kārtulas ID, kurai pieder hosta prototips.

Parametra darbība:
- obligāts
groupPrototypes array Grupu prototipi, kas tiks izveidoti hosta prototipam.
macros object/array Lietotāja makrosi, kas tiks izveidoti hosta prototipam.
tags object/array Hosta prototipa birkas.
interfaces object/array Hosta prototipa pielāgotās saskarnes.
templates object/array Veidnes, kas tiks piesaistītas hosta prototipam.

Veidnēm jābūt definētai tikai templateid īpašībai.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur izveidoto hostu prototipu ID īpašībā hostids. Atgriezto ID secība atbilst nodoto hostu prototipu secībai.

Piemēri

Hosts prototipa izveide

Izveidojiet hosts prototipu "{#VM.NAME}" LLD kārtulai "23542" ar grupas prototipu "{#HV.NAME}", birkas pāri "datacenter": "{#DATACENTER.NAME}" un pielāgotu SNMPv2 saskarni 127.0.0.1:161 ar kopienu {$SNMP_COMMUNITY}. Saistiet to ar hostu grupu "2".

Pieprasījums:

{
    "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}"
                }
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Skatīt arī

Avots

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