[comment]: # aside: 1

[comment]: # ({195463c3-8bbba5df})
# Objeto trigger

Os seguintes objetos estão diretamente relacionados à API de `trigger`.

[comment]: # ({/195463c3-8bbba5df})

[comment]: # ({b0c56e99-db828bca})
### Trigger

O objeto trigger possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|triggerid|ID|ID do trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*<br>- *obrigatório* para operações de atualização|
|description|string|Nome do trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|expression|string|Expressão do trigger.<br><br>Itens com `value_type` definido como `5` (binário) não podem ser usados em expressões de trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|event\_name|string|Nome do evento gerado pelo trigger.|
|opdata|string|Dados operacionais.|
|comments|string|Descrição adicional do trigger.|
|error|string|Texto do erro caso tenha havido algum problema ao atualizar o estado do trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|flags|integer|Origem do trigger.<br><br>Valores possíveis:<br>0 - *(padrão)* um trigger simples;<br>4 - um trigger descoberto.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|lastchange|timestamp|Hora em que o trigger mudou de estado pela última vez.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|priority|integer|Severidade do trigger.<br><br>Valores possíveis:<br>0 - *(padrão)* não classificado;<br>1 - informação;<br>2 - aviso;<br>3 - média;<br>4 - alta;<br>5 - desastre.|
|state|integer|Estado do trigger.<br><br>Valores possíveis:<br>0 - *(padrão)* o estado do trigger está atualizado;<br>1 - o estado atual do trigger é desconhecido.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|status|integer|Se o trigger está habilitado ou desabilitado.<br><br>Valores possíveis:<br>0 - *(padrão)* habilitado;<br>1 - desabilitado.|
|templateid|ID|ID do trigger do template pai.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|type|integer|Se o trigger pode gerar múltiplos eventos de problema.<br><br>Valores possíveis:<br>0 - *(padrão)* não gerar múltiplos eventos;<br>1 - gerar múltiplos eventos.|
|url|string|URL associada ao trigger.|
|url_name|string|Rótulo para a URL associada ao trigger.|
|value|integer|Se o trigger está em estado OK ou de problema.<br><br>Valores possíveis:<br>0 - *(padrão)* OK;<br>1 - problema.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|recovery\_mode|integer|Modo de geração de evento OK.<br><br>Valores possíveis:<br>0 - *(padrão)* Expressão;<br>1 - Expressão de recuperação;<br>2 - Nenhum.|
|recovery\_expression|string|Expressão de recuperação do trigger.<br><br>Itens com `value_type` definido como `5` (binário) não podem ser usados em expressões de recuperação de trigger.|
|correlation\_mode|integer|Fechamento de eventos OK.<br><br>Valores possíveis:<br>0 - *(padrão)* Todos os problemas;<br>1 - Todos os problemas se os valores das tags coincidirem.|
|correlation\_tag|string|Tag para correspondência.|
|manual\_close|integer|Permitir fechamento manual.<br><br>Valores possíveis:<br>0 - *(padrão)* Não;<br>1 - Sim.|
|uuid|string|Identificador único universal, usado para vincular triggers importados aos já existentes. Gerado automaticamente, se não fornecido.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *suportado* se o trigger pertencer a um template|

[comment]: # ({/b0c56e99-db828bca})

[comment]: # ({5a130da9-0188f389})
### Tag de trigger

O objeto de tag de trigger possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|tag|string|Nome da tag de trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|value|string|Valor da tag de trigger.|

[comment]: # ({/5a130da9-0188f389})