proxygroup.get

Descrição

integer/array proxygroup.get(object parameters)

O método permite recuperar grupos de proxy de acordo com os parâmetros fornecidos.

Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações da função de usuário. Consulte Funções de usuário para obter mais informações. Somente os grupos de proxy permitidos pela Lista de acesso de proxy dos grupos de usuários do usuário são retornados.

Parâmetros

(object) Parâmetros que definem a saída desejada.

O método suporta os seguintes parâmetros.

Parâmetro Tipo Descrição
proxy_groupids ID/array Retorna apenas grupos de proxy com os IDs fornecidos.
proxyids ID/array Retorna apenas grupos de proxy que contenham os proxies fornecidos.
selectProxies query Retorna uma propriedade proxies com os proxies que pertencem ao grupo de proxy.

Suporta count.
sortfield string/array Ordena o resultado pelas propriedades fornecidas.

Valores possíveis: proxy_groupid, name.
countOutput boolean Esses parâmetros são descritos no comentário de referência.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores de retorno

(integer/array) Retorna:

  • um array de objetos;
  • a contagem de objetos recuperados, se o parâmetro countOutput tiver sido usado.

Exemplos

Recuperar todos os grupos de proxy

Recupere todos os grupos de proxy configurados com proxies.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxygroup.get",
    "params": {
        "output": "extend",
        "selectProxies": ["proxyid", "name"]
    },
    "id": 1
}

Resposta:

{
    "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
}

Veja também

Fonte

CProxyGroup::get() em ui/include/classes/api/services/CProxyGroup.php.