Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

hostprototype.create

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

object hostprototype.create(object/array hostPrototypes)

Este m¨¦todo permite crear nuevos prototipos de equipo.

Este m¨¦todo solo est¨¢ disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al m¨¦todo se pueden revocar en la configuraci¨®n del rol de usuario. Ver Roles de usuario para m¨¢s informaci¨®n.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ

(objeto/matriz) Prototipos de host para crear.

Adem¨¢s del prototipo de host est¨¢ndar propiedades, el m¨¦todo acepta lo siguiente par¨¢metros.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Tipo ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
groupLinks array Enlaces de grupo que se crear¨¢n para el prototipo de host.

Comportamiento de par¨¢metros:
- obligatorio
ruleid ID ID de la regla LLD a la que pertenece el prototipo de host.

Comportamiento del par¨¢metro:
- requerido
groupPrototypes array Prototipos de grupo que se crear¨¢n para el prototipo de host.
macros objeto/matriz macros de usuario que se crear¨¢n para el prototipo de host.
etiquetas objeto/matriz Etiquetas de prototipo de host.
interfaces objeto/matriz Prototipo de host interfaces personalizadas.
plantillas objeto/matriz Plantillas que se vincular¨¢n al prototipo del host.

Las plantillas deben tener definida solo la propiedad templateid.

Valores devueltos

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

Ejemplos

Creaci¨®n de un prototipo de equipo

Cree un prototipo de equipo "{#VM.NAME}" en la regla LLD "23542" con un prototipo de grupo "{#HV.NAME}", par de etiquetas "datacenter": "{#DATACENTER.NAME}" y una interfaz SNMPv2 personalizada 127.0.0.1:161 con la comunidad {$SNMP_COMMUNITY}. Vinc¨²lelo al grupo de equipos "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}"
                       }
                   }
               ]
           },
           "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.