Sommaire
proxygroup.get
Description
integer/array proxygroup.get(object parameters)
La méthode permet de récupérer des groupes de proxys selon les paramètres fournis.
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 des rôles utilisateur. Voir User roles pour plus d’informations.
Paramètres
(object) Paramètres définissant la sortie souhaitée.
La méthode prend en charge les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| proxy_groupids | ID/array | Retourner uniquement les groupes de proxys avec les ID indiqués. |
| proxyids | ID/array | Retourner uniquement les groupes de proxys qui contiennent les proxys indiqués. |
| selectProxies | query | Retourner une propriété proxies avec les proxys appartenant au groupe de proxys.Prend en charge count. |
| sortfield | string/array | Trier le résultat selon les propriétés indiquées. Valeurs possibles : proxy_groupid, name. |
| 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
countOutputa été utilisé.
Exemples
Récupérer tous les groupes de proxys
Récupérez tous les groupes de proxys configurés avec leurs proxys.
{
"jsonrpc": "2.0",
"method": "proxygroup.get",
"params": {
"output": "extend",
"selectProxies": ["proxyid", "name"]
},
"id": 1
}
Réponse :
{
"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": "10m",
"min_online": "3",
"description": "",
"state": "3",
"proxies": [
{
"proxyid": "3",
"name": "proxy 3"
},
{
"proxyid": "4",
"name": "proxy 4"
},
{
"proxyid": "5",
"name": "proxy 5"
}
]
}
],
"id": 1
}
Voir aussi
Source
CProxyGroup::get() dans ui/include/classes/api/services/CProxyGroup.php.