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 countOutput tiver 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:

{
    "jsonrpc": "2.0",
    "resultado": "3",
    "id": 1
}

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.