Table of Contents
获取
Description 描述
integer/array proxy.get(object parameters)
The method allows to retrieve proxies according to the given parameters. 该方法允许根据给定的参数查询代理。
Parameters 参数
(object) Parameters defining the desired output. (object)定义所需输出的参数。
The method supports the following parameters. 此方法支持一下参数
| Parameter | Type | Description |
|---|---|---|
| proxyids | string/array | Return only proxies with the given IDs. 仅返回所给IDs的代理 |
| selectHosts | query | Return hosts monitored by the proxy in the hosts property. 返回在hosts属性中代理监控的主机 |
| selectInterface | query | Return the proxy interface used by a passive proxy in the interface property.返回在interface属性中被动代理使用代理接口 |
| sortfield | string/array | Sort the result by the given properties. Possible values are: hostid, host and status. 根据所给的属性进行排序\\可能的值： hostid, host 和 status. |
| countOutput | boolean | These parameters being common for all get methods are described in detail in the reference commentary. 改参数适用于所有的get方法，详细描述是在reference commentary |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Return values 返回值
(integer/array) Returns either:
- an array of objects;
- the count of retrieved objects, if the
countOutputparameter has been used. - 一个对象数组
- 搜索到对象的数量，如果
countOutput对象被使用
Examples 示例如下
Retrieve all proxies 检索所有的代理
Retrieve all configured proxies and their interfaces. 检索所有配置的代理和他们的接口
Request:
{ "jsonrpc": "2.0", "method": "proxy.get", "params": { "output": "extend", "selectInterface": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Response:
{ "jsonrpc": "2.0", "result": [ { "interface": [], "host": "Active proxy", "status": "5", "lastaccess": "0", "proxyid": "30091", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "" }, { "interface": { "interfaceid": "30109", "hostid": "30092", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10051" ], "host": "Passive proxy", "status": "6", "lastaccess": "0", "proxyid": "30092", "description": "" } ], "id": 1 }See also
Source
CProxy::get() in frontends/php/include/classes/api/services/CProxy.php.