[comment]: # ({0bfa3a60-0bfa3a60})
# hostinterface.create

[comment]: # ({/0bfa3a60-0bfa3a60})

[comment]: # ({e87d74af-e87d74af})
### Descripción

`object hostinterface.create(object/array hostInterfaces)`

Este método permite crear nuevas interfaces de host.

::: noteclassic
Este método solo está disponible para 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](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

[comment]: # ({/e87d74af-e87d74af})

[comment]: # ({e81b8e01-e81b8e01})
### Parámetros

`(object/array)` Interfaces de host a ser creadas. El método acepta interfaces 
de host con el [standard host interface  
properties](object#interfaz_de_host).

[comment]: # ({/e81b8e01-e81b8e01})

[comment]: # ({4b59ae6b-4b59ae6b})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de las interfaces de host creadas
bajo la propiedad `interfaceids`. El orden de los IDs devueltos coinciden con el orden de las interfaces de host pasadas.

[comment]: # ({/4b59ae6b-4b59ae6b})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({ee4a91b7-150295f4})
#### Cree una interfaz nueva 

Cree una interfaz  secundaria de agente IP en el host "30052."

Solicitud:

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

Respuesta:

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

[comment]: # ({/ee4a91b7-150295f4})

[comment]: # ({1ce3a12e-c22176c4})
#### Cree una interfaz con detalles SNMP 

Solicitud:

```json
{
"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}"
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```

Respuesta:

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

[comment]: # ({/1ce3a12e-c22176c4})

[comment]: # ({9afed0b0-9afed0b0})
### Ver también

-[hostinterface.massadd](massadd)
-[host.massadd](/manual/api/reference/host/massadd)

[comment]: # ({/9afed0b0-9afed0b0})

[comment]: # ({5b41f219-5b41f219})
### Fuente

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

[comment]: # ({/5b41f219-5b41f219})