Documentation
Table of Contents
hostinterface.get
Descri??o
integer/array hostinterface.get(object parameters)
O m¨¦todo permite recuperar interfaces de host de acordo com o dado par?metros.
Este m¨¦todo est¨¢ dispon¨ªvel para usu¨¢rios de qualquer tipo. Permiss?es para chamar o m¨¦todo pode ser revogado nas configura??es de fun??o do usu¨¢rio. 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| |---------|----------------------------------- ------------|-----------| |hostids|string/array|Retorna apenas interfaces de host usadas pelos hosts fornecidos.| |interfaceids|string/array|Retorna apenas interfaces de host com os IDs fornecidos.| |itemids|string/array|Retorna apenas interfaces de host usadas pelos itens fornecidos.| |triggerids|string/array|Retorna apenas interfaces de host usadas por itens nos gatilhos fornecidos.| |selectItems|query|Retorne uma propriedade items com os itens que usam a interface.
Suporta count.| |selectHosts|query|Retorne uma propriedade hosts com uma matriz de hosts que usam a interface.| |limitSelects|integer|Limite o n¨²mero de registros retornados por subsele??es.
Aplica-se ¨¤s seguintes subsele??es:selectItems.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.
Os valores poss¨ªveis s?o: interfaceid, dns, ip.| |countOutput|boolean|Esses par?metros sendo comuns para todos os m¨¦todos get s?o descritos em detalhes na p¨¢gina coment¨¢rio de refer¨ºncia.| |edit¨¢vel|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |nodeids|string/array|^| |sa¨ªda|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classifica??o|cadeia/matriz|^| |startSearch|boolean|^|
Valores de retorno
(integer/array) Retorna:
- uma matriz de objetos;
- a contagem de objetos recuperados, se o par?metro
countOutputtiver sido usado.
Exemplos
Recuperar interfaces de host
Recupere todos os dados sobre as interfaces usadas pelo host "30057".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "hostinterface.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: "estender",
"hostids": "30057"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"interfaceid": "50039",
"hostid": "30057",
"principal": "1",
"tipo 1",
"useip": "1",
"ip": "::1",
"dns": "",
"porta": "10050",
&±ç³Ü´Ç³Ù;»å¾±²õ±è´Ç²Ô¨ª±¹±ð±ô&±ç³Ü´Ç³Ù;: "0",
"erro": "",
"errors_from": "0",
"disable_until": "0",
"detalhes": []
},
{
"interfaceid": "55082",
"hostid": "30057",
"principal": "0",
"tipo 1",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"porta": "10051",
&±ç³Ü´Ç³Ù;»å¾±²õ±è´Ç²Ô¨ª±¹±ð±ô&±ç³Ü´Ç³Ù;: "0",
"erro": "",
"errors_from": "0",
"disable_until": "0",
"detalhes": {
"vers?o 2",
"em massa": "0",
"community": "{$SNMP_COMMUNITY}"
}
}
],
"id": 1
}Veja tamb¨¦m
Fonte
CHostInterface::get() em ui/include/classes/api/services/CHostInterface.php.