Documentation
Table of Contents
hanode.get
Descrição
integer/array hanode.get(object parameters)
O método permite recuperar uma lista de nós de cluster de alta disponibilidade de acordo com os parâmetros fornecidos.
Este método está disponível apenas para os tipos de usuário Super admin. Veja Usuário funções Para maiores informações.
Parâmetros
(object) Parâmetros que definem a saída desejada.
O método oferece suporte aos seguintes parâmetros.
|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |ha_nodeids|string/array|Retorna apenas nós com os IDs de nó fornecidos.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.
Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são um único valor ou uma matriz de valores para correspondência.
Permite filtrar pelas propriedades do nó: name, address, status.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.
Os valores possíveis são: name, lastaccess, status.| |countOutput|flag|Esses parâmetros sendo comuns para todos os métodos get são descritos em detalhes no comentário de referência.| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |ordem de classificação|cadeia/matriz|^|
Valores de retorno
(integer/array) Retorna:
- uma matriz de objetos;
- a contagem de objetos recuperados, se o parâmetro
countOutputtiver sido usado.
Exemplos
Obtenha uma lista de nós ordenados por status
Solicitação:
{
"jsonrpc": "2.0",
"método": "hanode.get",
"parâmetros": {
"preservekeys": verdadeiro,
"sortfield": "status",
"ordem de classificação": "DESC"
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": {
"ckuo7i1nw000h0sajj3l3hh8u": {
"ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u",
"name": "nó ativo",
"endereço": "192.168.1.13",
"porta": "10051",
"lastaccess": "1635335704",
"estado": "3"
},
"ckuo7i1nw000e0sajwfttc1mp": {
"ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp",
"nome": "nó6",
"endereço": "192.168.1.10",
"porta": "10053",
"lastaccess": "1635332902",
"estado": "2"
},
"ckuo7i1nv000c0sajz85xcrtt": {
"ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt",
"nome": "nó4",
"endereço": "192.168.1.8",
"porta": "10052",
"lastaccess": "1635334214",
"estado": "1"
},
"ckuo7i1nv000a0saj1fcdkeu4": {
"ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4",
"nome": "nó2",
"endereço": "192.168.1.6",
"porta": "10051",
"lastaccess": "1635335705",
"estado": "0"
}
},
"id": 1
}Obtenha uma lista de nós específicos por seus IDs
Solicitação:
{
"jsonrpc": "2.0",
"método": "hanode.get",
"parâmetros": {
"ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"]
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt",
"nome": "nó4",
"endereço": "192.168.1.8",
"porta": "10052",
"lastaccess": "1635334214",
"estado": "1"
},
{
"ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp",
"nome": "nó6",
"endereço": "192.168.1.10",
"porta": "10053",
"lastaccess": "1635332902",
"estado": "2"
}
],
"id": 1
}Obter uma lista de nós parados
Solicitação:
{
"jsonrpc": "2.0",
"método": "hanode.get",
"parâmetros": {
"output": ["ha_nodeid", "endereço", "porta"],
"filtro": {
"estado": 1
}
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3",
"endereço": "192.168.1.12",
"porta": "10051"
},
{
"ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt",
"endereço": "192.168.1.8",
"porta": "10052"
},
{
"ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x",
"endereço": "192.168.1.9",
"porta": "10053"
}
],
"id": 1
}Obtenha uma contagem de nós em espera
Solicitação:
{
"jsonrpc": "2.0",
"método": "hanode.get",
"parâmetros": {
"countOutput": verdadeiro,
"filtro": {
"estado": 0
}
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
Verifique o status dos nós em endereços IP específicos
Solicitação:
{
"jsonrpc": "2.0",
"método": "hanode.get",
"parâmetros": {
"saída": ["nome", "status"],
"filtro": {
"endereço": ["192.168.1.7", "192.168.1.13"]
}
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"nome": "nó3",
"estado": "0"
},
{
"name": "nó ativo",
"estado": "3"
}
],
"id": 1
}Fonte
CHaNode::get() em ui/include/classes/api/services/CHaNode.php.