获取
描述
integer/array proxygroup.get(object parameters)
该方法允许根据给定的参数检索Proxy组。
此方法适用于任何类型的用户。调用该方法的权限可以在用户角色设置中撤销。有关更多信息，请参阅 用户角色。
参数
(object) 定义所需输出的参数。
该方法支持以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| proxy_groupids | ID/数组 | 仅返回具有给定ID的proxy组。 |
| proxyids | ID/数组 | 仅返回包含给定proxies的proxy组。 |
| selectProxies | 查询 | 返回一个proxies属性，其中包含属于proxy组的proxies。支持 count。 |
| sortfield | 字符串/数组 | 根据给定属性对结果进行排序。 可能的值： proxy_groupid，name。 |
| countOutput | 布尔值 | 这些参数在参考说明中进行了描述。 |
| editable | 布尔值 | |
| excludeSearch | 布尔值 | |
| filter | 对象 | |
| limit | 整数 | |
| output | 查询 | |
| preservekeys | 布尔值 | |
| search | 对象 | |
| searchByAny | 布尔值 | |
| searchWildcardsEnabled | 布尔值 | |
| sortorder | 字符串/数组 | |
| startSearch | 布尔值 |
返回值
(integer/array) 返回以下任一值：
- 包含对象的数组；
- 如果已使用
countOutput参数，则返回检索到的对象的数量。
示例
检索所有Proxy组
检索所有已配置的Proxy组（含Proxy）。
请求:
{
"jsonrpc": "2.0",
"method": "proxygroup.get",
"params": {
"output": "extend",
"selectProxies": ["proxyid", "name"]
},
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": [{
"proxy_groupid": "1",
"name": "Proxy Group 1",
"failover_delay": "1m",
"min_online": "3",
"description": "",
"state": "1",
"proxies": [{
"proxyid": "1",
"name": "Proxy 1"
},
{
"proxyid": "2",
"name": "Proxy 2"
}
]
},
{“
proxy_groupid”：“ 2”，“ name”：“ Proxy Group 2”，“ failover_delay”：“ 10 m”，“ min_online”：“ 3”，“ description”：“”，“ state”：“ 3”，“ proxies”：[{“
proxyid”：“ 3”，“ name”：“ Proxy 3”
}, {“
proxyid”：“ 4”，“ name”：“ Proxy 4”
}, {“
proxyid”：“ 5”，“ name”：“ Proxy 5”
}]
}
],
“id”： 1
}另请参阅
来源
ui/include/classes/api/services/CProxyGroup.php 中的 CProxyGroup::get()。