[comment]: # translation:outdated

[comment]: # ({9464a98f-9464a98f})
## event.get

[comment]: # ({/9464a98f-9464a98f})

[comment]: # ({a2311b6e-a2311b6e})
### Descrição

`integer/array event.get(object parameters)`

O método permite recuperar eventos de acordo com os parâmetros fornecidos.

::: não importante
Este método pode retornar eventos de uma entidade excluída
se esses eventos não foram removidos pela governanta
ainda.
:::

::: noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/a2311b6e-a2311b6e})

[comment]: # ({99511e47-99511e47})
### Parâmetros

`(object)` Parâmetros que definem a saída desejada.

O método oferece suporte aos parâmetros a seguir.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|eventids|string/array|Retorna apenas eventos com os IDs fornecidos.|
|groupids|string/array|Retorna apenas eventos criados por objetos que pertencem aos grupos de hosts especificados.|
|hostids|string/array|Retorna apenas eventos criados por objetos que pertencem aos hosts fornecidos.|
|objectids|string/array|Retorna apenas eventos criados pelos objetos fornecidos.|
|source|integer|Retorna apenas eventos com o tipo fornecido.<br><br>Consulte a [página do objeto do evento](object#event) para obter uma lista de tipos de eventos suportados.<br><br>Padrão: 0 - acionar eventos.|
|objeto|inteiro|Retorna apenas eventos criados por objetos de um determinado tipo.<br><br>Consulte a [página do objeto do evento](objeto#evento) para obter uma lista de tipos de objetos compatíveis.<br><br>Padrão : 0 - gatilho.|
|acknowledged|boolean|Se definido como `true` retorna apenas eventos reconhecidos.|
|suppressed|boolean|`true` - retorna somente eventos suprimidos;<br>`false` - retorna eventos no estado normal.|
|severities|integer/array|Retorna apenas eventos com as severidades de eventos especificadas. Aplica-se apenas se o objeto for acionador.|
|evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) E/Ou;<br>2 - Ou.|
|tags|array de objetos|Retorna apenas eventos com as tags fornecidas. Correspondência exata por tag e pesquisa sem distinção entre maiúsculas e minúsculas por valor e operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`.<br>Um array vazio retorna todos os eventos.<br><br>Possíveis tipos de operadores:<br>0 - (padrão) Like;<br>1 - Igual;<br>2 - Não gosta;<br>3 - Não é igual<br>4 - Existe;<br>5 - Não existe.|
|eventid\_from|string|Retorna apenas eventos com IDs maiores ou iguais ao ID fornecido.|
|eventid\_till|string|Retorna apenas eventos com IDs menores ou iguais ao ID fornecido.|
|time\_from|timestamp|Retorna apenas eventos que foram criados após ou no momento determinado.|
|time\_till|timestamp|Retorna apenas eventos que foram criados antes ou no momento determinado.|
|problem\_time\_from|timestamp|Retorna apenas eventos que estavam no estado de problema começando com `problem_time_from`. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se `problem_time_till` for especificado.|
|problem\_time\_till|timestamp|Retorna apenas eventos que estavam no estado de problema até `problem_time_till`. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se `problem_time_from` for especificado.|
|valor|inteiro/array|Retorna apenas eventos com os valores fornecidos.|
|selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com hosts contendo o objeto que criou o evento. Com suporte apenas para eventos gerados por gatilhos, itens ou regras LLD.|
|selectRelatedObject|query|Retorna uma propriedade `relatedObject` com o objeto que criou o evento. O tipo de objeto retornado depende do tipo de evento.|
|select\_alerts|query|Retorna uma propriedade [alerts](/manual/api/reference/alert/object) com alertas gerados pelo evento. Os alertas são classificados em ordem cronológica inversa.|
|select\_acknowledges|query|Retorna uma propriedade `acknowledges` com atualizações de eventos. As atualizações de eventos são classificadas em ordem cronológica inversa.<br><br>O objeto de atualização de evento tem as seguintes propriedades:<br>`acknowledgeid` - ID da confirmação de `(string)`;<br>`userid` - `(string) ` ID do usuário que atualizou o evento;<br>`eventid` - `(string)` ID do evento atualizado;<br>`clock` - `(timestamp)` hora em que o evento foi atualizado;<br> `message` - texto `(string)` da mensagem;<br>`action` - `(integer)` ação de atualização que foi executada veja [event.acknowledge](/manual/api/reference/event/acknowledge); <br>`old_severity` - gravidade do evento `(integer)` antes desta ação de atualização;<br>`new_severity` - gravidade do evento `(integer)` após esta ação de atualização;<br>`username` - `(string)` nome de usuário do usuário que atualizou o evento;<br>`name` - `(string)` nome do usuário que atualizou o evento;<br>`surname` - `(string)` sobrenome do usuário que atualizou o evento .<br><br>Suporta `contagem`.|
|selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/event/object#Event_tag) com tags de evento.|
|selectSuppressionData|query|Retorna uma propriedade `suppression_data` com a lista de manutenções:<br>`maintenanceid` - `(string)` ID da manutenção;<br>`suppress_until` - `(integer)` tempo até o evento é suprimido.|
|sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `eventid`, `objectid` e `clock`.|
|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](/manual/api/reference_commentary#common_get_method_parameters).|
|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|^|

[comment]: # ({/99511e47-99511e47})

[comment]: # ({7223bab1-7223bab1})
### Valores de retorno

`(integer/array)` Retorna:

- uma matriz de objetos;
- a contagem de objetos recuperados, se o parâmetro `countOutput` tiver
    sido usado.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({7bd1e923-7bd1e923})
#### Recuperando eventos de gatilho

Recupere os eventos mais recentes do gatilho "13926".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "evento.get",
    "parâmetros": {
        "saída": "estender",
        "select_acknowledges": "estender",
        "selectTags": "estender",
        "selectSuppressionData": "estender",
        "objectids": "13926",
        "sortfield": ["relógio", "id do evento"],
        "ordem de classificação": "DESC"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "eventid": "9695",
            "fonte": "0",
            "objeto": "0",
            "objeto": "13926",
            "relógio": "1347970410",
            "valor": "1",
            "reconhecido": "1",
            "ns": "413316245",
            "name": "MySQL está inativo",
            "gravidade": "5",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "opdata": "",
            "reconhece": [
                {
                    "reconhecimento": "1",
                    "userid": "1",
                    "eventid": "9695",
                    "relógio": "1350640590",
                    "message": "Problema resolvido.\n\r----[BULK ACKNOWLEDGE]----",
                    "ação": "6",
                    "old_severity": "0",
                    "new_severity": "0",
                    "username": "Admin",
                    "nome": "Zabbix",
                    "sobrenome": "Administrador"
                }
            ],
            "suppression_data": [
                {
                    "manutenção": "15",
                    "suppress_until": "1472511600"
                }
            ],
            "suprimido": "1",
            "Tag": [
                {
                    "tag": "serviço",
                    "valor": "mysqld"
                },
                {
                    "tag": "erro",
                    "valor": ""
                }
            ]
        },
        {
            "evento": "9671",
            "fonte": "0",
            "objeto": "0",
            "objeto": "13926",
            "relógio": "1347970347",
            "valor": "0",
            "reconhecido": "0",
            "ns": "0",
            "name": "Indisponível por ping ICMP",
            "gravidade": "4",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "opdata": "",
            "reconhece": [],
            "suppression_data": [],
            "suprimido": "0",
            "Tag": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/7bd1e923-7bd1e923})

[comment]: # ({adbe5436-adbe5436})
#### Recuperando eventos por período de tempo

Recupere todos os eventos que foram criados entre 9 e 10 de outubro,
2012, em ordem cronológica inversa.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "evento.get",
    "parâmetros": {
        "saída": "estender",
        "time_from": "1349797228",
        "time_till": "1350661228",
        "sortfield": ["relógio", "id do evento"],
        "sortorder": "desc"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "eventid": "20616",
            "fonte": "0",
            "objeto": "0",
            "objeto": "14282",
            "relógio": "1350477814",
            "valor": "1",
            "reconhecido": "0",
            "ns": "0",
            "name": "Menos de 25% livre no cache do histórico",
            "gravidade": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "opdata": "",
            "suprimido": "0"
        },
        {
            "eventid": "20617",
            "fonte": "0",
            "objeto": "0",
            "objeto": "14283",
            "relógio": "1350477814",
            "valor": "0",
            "reconhecido": "0",
            "ns": "0",
            "name": "O Zabbix Trapper processa mais de 75% ocupado",
            "gravidade": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "opdata": "",
            "suprimido": "0"
        },
        {
            "eventid": "20618",
            "fonte": "0",
            "objeto": "0",
            "objeto": "14284",
            "relógio": "1350477815",
            "valor": "1",
            "reconhecido": "0",
            "ns": "0",
            "name": "Alta perda de ping ICMP",
            "gravidade": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "opdata": "",
            "suprimido": "0"
        }
    ],
    "id": 1
}
```

[comment]: # ({/adbe5436-adbe5436})

[comment]: # ({c6eb3ba0-c6eb3ba0})
### Veja também

- [Alerta](/manual/api/reference/alert/object)
- [Item](/manual/api/reference/item/object)
- [Host](/manual/api/reference/host/object)
- [Regra LLD](/manual/api/reference/discoveryrule/object#lld_rule)
- [Trigger](/manual/api/reference/trigger/object)

[comment]: # ({/c6eb3ba0-c6eb3ba0})

[comment]: # ({f85dc7ca-f85dc7ca})
### Fonte

CEvent::get() em *ui/include/classes/api/services/CEvent.php*.

[comment]: # ({/f85dc7ca-f85dc7ca})