proxy.update

Descripción

object proxy.update(object/array proxies)

Este método permite actualizar los servidores proxy existentes.

Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(objeto/array) Propiedades del proxy a actualizar.

La propiedad proxyid debe estar definida para cada proxy, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

Además de las propiedades estándar del proxy, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
hosts array Hosts que serán monitorizados por el proxy.
Si un host ya está monitorizado por un proxy diferente, será reasignado al proxy actual.

Los hosts deben tener definida sólo la propiedad hostid.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los servidores proxy actualizados bajo la propiedad proxyids.

Ejemplos

Cambiar equipos monitoreados por un proxy

Actualice el proxy para monitorear los dos equipos proporcionados.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "hosts": [
            {
                "hostid": "10294"
            },
            {
                "hostid": "10295"
            },
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "10293"
        ]
    },
    "id": 1
}

Cambiar estado de proxy

Cambie el proxy a un proxy activo y cámbiele el nombre a "Proxy activo".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "name": "Proxy activo",
        "operating_mode": "0"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "10293"
        ]
    },
    "id": 1
}

Agregar un proxy a un grupo de proxy

Actualice el proxy con ID "5" y agréguelo al grupo de proxy con ID "1".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "proxyid": "5",
        "proxy_groupid": "1",
        "local_address": "127.0.0.1"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "5"
        ]
    },
    "id": 1
}

Ver también

Fuente

CProxy::update() en ui/include/classes/api/services/CProxy.php.