prototipodehost.crear

Descripción

object hostprototype.create(object/array hostPrototypes)

Este método permite crear nuevos prototipos de host.

Este método solo está disponible para los tipos de usuarios Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en ajustes de rol de usuario. Ver User roles para más información.

Parámetros

(object/array) Prototipos de host que serán creados.

Además del standard host prototype properties, el método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
groupLinks (obligatorio)	matriz	Grupo links que se creará para el prototipo de host.
ruleid (obligatorio)	cadena	ID de la regla LLD a la que pertenece el prototipo de host.
groupPrototypes	matriz	Grupo prototypes que se creará para el prototipo de host.
macros	objeto/matriz	User macros que se crearán para el prototipo de host.
etiquetas	objeto/matriz	Prototipo de host [tags.
interfaces	objeto/matriz	Prototipo de host custom interfaces.
templates	objeto/matriz	Templates que se vincularán al prototipo del host. Las templates deben tener definida la propiedad `templateid`.

Valores devueltos

(object) Devuelve un objeto que contiene los ID de prototipos de host creados bajo la propiedad hostids. El orden de las identificaciones devueltas coincide con el orden de los prototipos de host aprobados.

Ejemplos

Creando un prototipo de host

Crear un prototipo de host "{#VM.NAME}" en LLD regla "23542" con el prototipo de grupo "{#HV.NAME}", par de etiqueta "Datacenter": "{#DATACENTER.NAME}" y personalizar SNMPv2 interface 127.0.0.1:161 con comunidad {$SNMP_COMMUNITY}. Conéctelo al grupo de host "2".

Solicitud:

{
       "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
       }

Respuesta:

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

Ver también

Fuente

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

Documentation