proxy.update

Descripción

object proxy.update(object/array proxies)

Este método le permite actualizar proxies existentes.

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

Parámetros

(object/array) Propiedades del proxy que se actualizarán.

La propiedad proxyid debe definirse para cada proxy; todas las demás propiedades son opcionales. Solo se actualizarán las propiedades proporcionadas; las demás permanecerán sin cambios.

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

Parameter Type Description
hosts array Hosts que serán supervisados por el proxy.
Si un host ya está siendo supervisado por otro proxy, se reasignará al proxy actual.

Los hosts solo deben tener definida la propiedad hostid.
apm object Configuración de supervisión del rendimiento de las aplicaciones (APM) del proxy.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los proxies actualizados bajo la propiedad proxyids.

Ejemplos

Cambiar los equipos monitorizados por un proxy

Actualice el proxy para monitorizar los dos equipos indicados.

Petición:

{
    "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 el estado del proxy

Cambiar el proxy a un proxy activo y renombrarlo a "Active proxy".

Solicitud:

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

Respuesta:

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

Añadir un proxy a un grupo de proxies

Actualizar el proxy con ID "5" y añadirlo al grupo de proxies 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

Origen

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