[comment]: # translation:outdated

[comment]: # ({48cd3524-48cd3524})
# problem.get

[comment]: # ({/48cd3524-48cd3524})

[comment]: # ({8a8d3f7b-a18b2713})
### Descrição

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

O método permite recuperar problemas de acordo com os parâmetros fornecidos.  
  
Este método é para recuperar problemas não resolvidos. Também é possível, se especificado, recuperar problemas resolvidos recentemente. O período que determina a idade "recentemente" é definido em *Administração* →  *[Geral](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*.  
Os problemas que foram resolvidos antes desse período não são mantidos na tabela de problemas. Para recuperar problemas que foram resolvidos no passado, use o método [event.get](/manual/api/reference/event/get).

::: noteimportant
Esse método pode retornar problemas de uma entidade excluída se esses problemas ainda não tiverem sido removidos pelo housekeeper .
:::

::: noteclassic
Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte [Funções de usuário](/manual/web_interface/frontend_sections/administration/user_roles) para obter mais informações.
:::

[comment]: # ({/8a8d3f7b-a18b2713})

[comment]: # ({8dc74f9e-98f39c6a})
### 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|Retornar apenas problemas com os IDs fornecidos.|
|groupids|string/array|Retorna apenas problemas criados por objetos que pertencem aos grupos de hosts fornecidos.|
|hostids|string/array|Retorna apenas problemas criados por objetos que pertencem aos hosts fornecidos.|
|objectids|string/array|Retorna apenas os problemas criados pelos objetos fornecidos.|
|source|integer|Retorna apenas problemas com o tipo fornecido.<br><br>Consulte a [página de objeto de evento de problema](object#problem) para obter uma lista de tipos de eventos compatíveis.<br><br>Padrão: 0 - problema criado por uma trigger.|
|object|integer|Retorne apenas os problemas criados por objetos de um determinado tipo.<br><br>Consulte a [página do objeto de evento do problema](object#problem) para obter uma lista de tipos de objetos compatíveis.<br><br>Padrão: 0 - trigger.|
|acknowledged|boolean|`true` - retornar somente problemas reconhecidos;<br>`false` - somente não reconhecidos.|
|suppressed|boolean|`true` - retorna apenas problemas suprimidos;<br>`false` - retorna problemas no estado normal.|
|severities|integer/array|Retorne apenas problemas com determinadas gravidades de eventos. Aplica-se apenas se o objeto for trigger.|
|evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) And/Or;<br>2 - Or.|
|tags|array of objects|Retorna apenas problemas 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 problemas.<br><br>Tipos de operadores possíveis:<br>0 - (padrão) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.|
|recent|boolean|`true` - Retorna PROBLEM e recentemente RESOLVED problemas (depende dos acionadores de exibição OK por N segundos)<br>Padrão: `false` - apenas problemas UNRESOLVED|
|eventid\_from|string|Retornar apenas problemas com IDs maiores ou iguais ao ID fornecido.|
|eventid\_till|string|Retornar apenas problemas com IDs menores ou iguais ao ID fornecido.|
|time\_from|timestamp|Retornar apenas os problemas que foram criados após ou no momento determinado.|
|time\_till|timestamp|Retornar apenas problemas que foram criados antes ou no momento determinado.|
|selectAcknowledges|query|Retorna uma propriedade `acknowledges` com as atualizações do problema. As atualizações de problemas são classificadas em ordem cronológica inversa.<br><br>O objeto de atualização do problema tem as seguintes propriedades:<br>`acknowledgeid` - `(string)` ID da atualização;<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` - `(string)` texto da mensagem;<br>`action` - `(integer)`tipo de ação de atualização (veja [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` gravidade do evento antes desta ação de atualização;<br>`new_severity` - `(integer)` gravidade do evento após esta ação de atualização;<br><br>Suporta `count`.|
|selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/problem/object#problem_tag) com as tags de problema. Formato de saída: `[{"tag": "<tag>", "value": "<value>"}, ...]`.|
|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é que o problema seja suprimido.|
|sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `eventid`.|
|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/commentário_referência#common_get_method_parameters) page.|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/8dc74f9e-98f39c6a})

[comment]: # ({7223bab1-7223bab1})
### Valores de retorno  
  
`(integer/array)` Retorna:  
  
- uma matriz de objetos;  
- a contagem de objetos recuperados, se o parâmetro `countOutput` foi usado.

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

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

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

[comment]: # ({1858d490-4d83529d})
#### Recuperando eventos de problema de trigger 
  
Recupere eventos recentes do trigger "15112".

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "selectAcknowledges": "extend",
        "selectTags": "extend",
        "selectSuppressionData": "extend",
        "objectids": "15112",
        "recent": "true",
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "auth": "67f45d3eb1173338e1b1647c4bdc1916",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1245463",
            "source": "0",
            "object": "0",
            "objectid": "15112",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "1",
            "name": "Zabbix agent on localhost is unreachable for 5 minutes",
            "acknowledged": "1",
            "severity": "3",
            "opdata": "",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "problem solved",
                    "action": "6",
                    "old_severity": "0",
                    "new_severity": "0"
                }
            ],
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600"
                }
            ],
            "suppressed": "1",
            "tags": [
                {
                    "tag": "test tag",
                    "value": "test value"
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/1858d490-4d83529d})

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

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

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

[comment]: # ({15f9267d-15f9267d})
### Fonte

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

[comment]: # ({/15f9267d-15f9267d})