hostinterface.create

Descripción

object hostinterface.create(object/array hostInterfaces)

Este método permite crear nuevas interfaces 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.

Parámetros

(objeto/array) Interfaces de host para crear.

El método acepta interfaces de host con las [propiedades de interfaz de host estándar] (object#host_interface).

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID del interface del equipo creado bajo la propiedad interfaceids. El orden de los ID devueltos, coinciden con el orden de las interfaces de equipo pasadas.

Ejemplos

Crear una nueva interfaz

Crear una interfaz de agente IP secundaria en el equipo "30052."

Request:

{
           "jsonrpc": "2.0",
           "method": "hostinterface.create",
           "params": {
               "hostid": "30052",
               "main": "0",
               "type": "1",
               "useip": "1",
               "ip": "127.0.0.1",
               "dns": "",
               "port": "10050",
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "interfaceids": [
                   "30062"
               ]
           },
           "id": 1
       }

Crear una interfaz con detalles SNMP

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "hostinterface.create",
           "params": {
               "hostid": "10456",
               "main": "0",
               "type": "2",
               "useip": "1",
               "ip": "127.0.0.1",
               "dns": "",
               "port": "1601",
               "details": {
                   "version": "2",
                   "bulk": "1",
                   "community": "{$SNMP_COMMUNITY}"
               }
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "interfaceids": [
                   "30063"
               ]
           },
           "id": 1
       }

Ver también

-hostinterface.massadd -host.massadd

Fuente

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

Documentation