hostinterface.replacehostinterfaces

Descripción

object hostinterface.replacehostinterfaces(object parameters)

Este método permite reemplazar todas las interfaces de equipo en un equipo determinado.

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

(object) Parámetros que contienen el ID del host a actualizar y las nuevas interfaces de host.

Parámetro Tipo Descripción
interfaces object/array Interfaces de host para reemplazar las interfaces de host actuales.

Comportamiento del parámetro:
- requerido
hostid ID ID del host a actualizar.

Comportamiento del parámetro:
- requerido

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID del las interfaces de equipo creadas bajo la propiedad interfaceids.

Ejemplos

Reemplazo de interfaces de equipo

Reemplace todas las interfaces de equipo con una única interfaz de agente.

Solicitud:

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

Respuesta:

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

Ver también

Fuente

CHostInterface::replaceHostInterfaces() en ui/include/classes/api/services/CHostInterface.php.