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",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "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": &±ç³Ü´Ç³Ù;²Ô¨®6&±ç³Ü´Ç³Ù;,
"endere?o": "192.168.1.10",
"porta": "10053",
"lastaccess": "1635332902",
"estado": "2"
},
"ckuo7i1nv000c0sajz85xcrtt": {
"ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt",
"nome": &±ç³Ü´Ç³Ù;²Ô¨®4&±ç³Ü´Ç³Ù;,
"endere?o": "192.168.1.8",
"porta": "10052",
"lastaccess": "1635334214",
"estado": "1"
},
"ckuo7i1nv000a0saj1fcdkeu4": {
"ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4",
"nome": &±ç³Ü´Ç³Ù;²Ô¨®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",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "hanode.get",
"par?metros": {
"ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"]
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt",
"nome": &±ç³Ü´Ç³Ù;²Ô¨®4&±ç³Ü´Ç³Ù;,
"endere?o": "192.168.1.8",
"porta": "10052",
"lastaccess": "1635334214",
"estado": "1"
},
{
"ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp",
"nome": &±ç³Ü´Ç³Ù;²Ô¨®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",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "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",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "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",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "hanode.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["nome", "status"],
"filtro": {
"endere?o": ["192.168.1.7", "192.168.1.13"]
}
},
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"nome": &±ç³Ü´Ç³Ù;²Ô¨®3&±ç³Ü´Ç³Ù;,
"estado": "0"
},
{
"name": "n¨® ativo",
"estado": "3"
}
],
"id": 1
}Fonte
CHaNode::get() em ui/include/classes/api/services/CHaNode.php.