Table of Contents
#alerta.obter
Descri??o
integer/array alert.get(object parameters)
O m¨¦todo permite recuperar alertas de acordo com os par?metros fornecidos.
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 ±«²õ³Ü¨¢°ù¾±´Ç fun??es Para maiores informa??es.
Par?metros
(object) Par?metros que definem a sa¨ªda desejada.
O m¨¦todo oferece suporte aos par?metros a seguir.
|Par?metro|Tipo|Descri??o| |---------|----------------------------------- ------------|-----------| |alertids|string/array|Retorna apenas alertas com os IDs fornecidos.| |actionids|string/array|Retorna apenas alertas gerados pelas a??es fornecidas.| |eventids|string/array|Retorna apenas os alertas gerados pelos eventos fornecidos.| |groupids|string/array|Retorna apenas alertas gerados por objetos dos grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas alertas gerados por objetos dos hosts fornecidos.| |mediatypeids|string/array|Retorna apenas alertas de mensagens que usaram os tipos de m¨ªdia fornecidos.| |objectids|string/array|Retorna apenas alertas gerados pelos objetos fornecidos| |userids|string/array|Retorna apenas alertas de mensagens que foram enviadas para os usu¨¢rios indicados.| |eventobject|integer|Retorna apenas alertas gerados por eventos relacionados a objetos de um determinado tipo.
Veja event "object" para obter uma lista de tipos de objetos suportados.
Padr?o: 0 - trigger.| |eventsource|integer|Retorna apenas alertas gerados por eventos de um determinado tipo.
Consulte event "source" para obter uma lista de tipos de eventos suportados .
Padr?o: 0 - acionar eventos.| |time_from|timestamp|Retorna apenas os alertas que foram gerados ap¨®s o tempo determinado.| |time_till|timestamp|Retorna apenas os alertas que foram gerados antes do tempo determinado.| |selectHosts|query|Retorne uma propriedade hosts com dados de hosts que acionaram a opera??o de a??o.| |selectMediatypes|query|Retorne uma propriedade mediatypes com uma matriz dos tipos de m¨ªdia que foram usados para o alerta de mensagem.| |selectUsers|query|Retorne uma propriedade users com um array dos usu¨¢rios aos quais a mensagem foi endere?ada.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.
Os valores poss¨ªveis s?o: alertid, clock, eventid, mediatypeid, sendto e status.| |countOutput|boolean|Esses par?metros sendo comuns para todos os m¨¦todos get s?o descritos no coment¨¢rio de refer¨ºncia.| |edit¨¢vel|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |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 alertas por ID de a??o
Recupera todos os alertas gerados pela a??o "3".
Requisi??o:
{
"jsonrpc": "2.0",
"method": "alert.get",
"params": {
"output": "extend",
"actionids": "3"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"alertid": "1",
"actionid": "3",
"eventid": "21243",
"userid": "1",
"clock": "1362128008",
"mediatypeid": "1",
"sendto": "[email protected]",
"subject": "PROBLEM: Áú»¢¶Ä²© agent on Linux server is unreachable for 5 minutes: ",
"message": "Trigger: Áú»¢¶Ä²© agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified",
"status": "0",
"retries": "3",
"error": "",
"esc_step": "1",
"alerttype": "0",
"p_eventid": "0",
"acknowledgeid": "0"
}
],
"id": 1
}Veja tamb¨¦m
Fonte
CAlert::get() em ui/include/classes/api/services/CAlert.php.