proxy.get

Description

integer/array proxy.get(object parameters)

Cette méthode permet de récupérer des proxys selon les paramètres indiqués.

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Consultez la page Rôles utilisateur pour plus d'informations.
Seuls les proxys autorisés par la Liste d'accès aux proxys des groupes d'utilisateurs de l'utilisateur sont renvoyés.

Paramètres

(object) Paramètres définissant le résultat souhaité.

La méthode prend en charge les paramètres suivants.

Paramètre Type Description
proxyids ID/array Ne retourner que les proxy correspondant aux ID indiqués.
proxy_groupids ID/array Ne retourner que les proxy appartenant aux groupes de proxy indiqués.
selectApm query Retourner une propriété apm contenant les paramètres de surveillance des performances des applications (APM) du proxy.
selectAssignedHosts query Retourner une propriété assignedHosts contenant les hôtes affectés au proxy.

Prend en charge count.
selectHosts query Retourner une propriété hosts contenant les hôtes surveillés par le proxy.

Prend en charge count.
selectProxyGroup query Retourner une propriété proxyGroup contenant l’objet du groupe de proxy.
sortfield string/array Trier le résultat selon les propriétés indiquées.

Valeurs possibles : proxyid, name, operating_mode.
countOutput boolean Ces paramètres sont décrits dans le commentaire de référence.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valeurs de retour

(integer/array) Renvoie soit :

  • un tableau d’objets ;
  • le nombre d’objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupérer tous les proxys

Récupérez tous les proxys configurés et leurs interfaces.

Requête :

{
    "jsonrpc": "2.0",
    "method": "proxy.get",
    "params": {
        "output": "extend"
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": [
        {
            "proxyid": "11",
            "name": "Active proxy",
            "proxy_groupid": "0",
            "local_address": "",
            "local_port": "10051",
            "operating_mode": "0",
            "description": "",
            "allowed_addresses": "",
            "address": "127.0.0.1",
            "port": "10051",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "custom_timeouts": "0",
            "timeout_zabbix_agent": "",
            "timeout_simple_check": "",
            "timeout_snmp_agent": "",
            "timeout_external_check": "",
            "timeout_db_monitor": "",
            "timeout_http_agent": "",
            "timeout_ssh_agent": "",
            "timeout_telnet_agent": "",
            "timeout_script": "",
            "last_access": "1693391880",
            "version": "70000",
            "compatibility": "1",
            "state": "1"
        },
        {
            "proxyid": "12",
            "name": "Passive proxy",
            "proxy_groupid": "1",
            "local_address": "127.0.0.1",
            "local_port": "10051",
            "operating_mode": "1",
            "description": "",
            "allowed_addresses": "",
            "address": "127.0.0.1",
            "port": "10051",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "custom_timeouts": "1",
            "timeout_zabbix_agent": "5s",
            "timeout_simple_check": "5s",
            "timeout_snmp_agent": "5s",
            "timeout_external_check": "5s",
            "timeout_db_monitor": "5s",
            "timeout_http_agent": "5s",
            "timeout_ssh_agent": "5s",
            "timeout_telnet_agent": "5s",
            "timeout_script": "5s",
            "lastaccess": "1693391875",
            "version": "60400",
            "compatibility": "2",
            "state": "2"
        }
    ],
    "id": 1
}

Voir aussi

Source

CProxy::get() dans ui/include/classes/api/services/CProxy.php.