ação.criar
Descrição
object action.create(object/array actions)
Este método permite criar novas ações.
Este método está disponível apenas para Admin e Superadministrador tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário definições. Veja Usuário funções Para maiores informações.
Parâmetros
(objeto/array) Ações para criar.
Além das propriedades de ação padrão, o O método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| filter | objeto | Ação filtro objeto para a ação. |
| operações | array | Ação operações para criar para a ação. |
| recovery_operations | array | Ação operações de recuperação para criar para a ação. |
| update_operations | array | Ação update operations para criar para a ação. |
Valores de retorno
(object) Retorna um objeto contendo os IDs das ações criadas
sob a propriedade actionids. A ordem dos IDs retornados corresponde
a ordem das ações passadas.
Exemplos
Crie uma ação de gatilho
Crie uma ação que será executada quando um gatilho do host "10084" que tem a palavra "memória" em seu nome entra em estado de problema. A acção deve primeiro enviar uma mensagem a todos os usuários do grupo de usuários "7". Se o evento não for resolvido em 4 minutos, ele executará o script "3" em todos os hosts em grupo "2". Na recuperação do acionador, ele notificará todos os usuários que receberam qualquer mensagens sobre o problema anterior. Na atualização do gatilho, mensagem com assunto e corpo personalizados serão enviados a todos que deixaram agradecimentos e comentários através de todos os tipos de mídia.
Solicitação:
{
"jsonrpc": "2.0",
"método": "ação.criar",
"parâmetros": {
"name": "Ação do gatilho",
"origem do evento": 0,
"estado": 0,
"esc_period": "2m",
"filtro": {
"evaltype": 0,
"condições": [
{
"tipo de condição": 1,
"operador": 0,
"valor": "10084"
},
{
"tipo de condição": 3,
"operador": 2,
"valor": "memória"
}
]
},
"operações": [
{
"tipo de operação": 0,
"esc_period": "0s",
"esc_step_from": 1,
"esc_step_to": 2,
"evaltype": 0,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"mensagem de mensagem": {
"default_msg": 1,
"mediatypeid": "1"
}
},
{
"tipo de operação": 1,
"esc_step_from": 3,
"esc_step_to": 4,
"evaltype": 0,
"opcondições": [
{
"tipo de condição": 14,
"operador": 0,
"valor": "0"
}
],
"opcommand_grp": [
{
"groupid": "2"
}
],
"opcommand": {
"scriptid": "3"
}
}
],
"recovery_operations": [
{
"tipo de operação": "11",
"mensagem de mensagem": {
"default_msg": 1
}
}
],
"update_operations": [
{
"tipo de operação": "12",
"mensagem de mensagem": {
"default_msg": 0,
"message": "Corpo da mensagem de operação de atualização personalizada",
"subject": "Assunto da mensagem da operação de atualização personalizada"
}
}
],
"pause_suppressed": "0",
"notify_if_canceled": "0"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": {
"actionids": [
"17"
]
},
"id": 1
}Crie uma ação de descoberta
Crie uma ação de descoberta que vincule hosts descobertos ao template "10001".
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Discovery action",
"eventsource": 1,
"filter": {
"evaltype": 0,
"conditions": [
{
"conditiontype": 21,
"operator": 0,
"value": "1"
},
{
"conditiontype": 10,
"operator": 0,
"value": "2"
}
]
},
"operations": [
{
"operationtype": 6,
"optemplate": [
{
"templateid": "10001"
}
]
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"18"
]
},
"id": 1
}Usando um filtro de expressão personalizado
Crie uma ação de gatilho que usará uma condição de filtro personalizada. O ação deve enviar uma mensagem para cada gatilho com gravidade maior ou igual a "Aviso" para hosts "10084" e "10106". Os IDs de fórmula "A", "B" e "C" foram escolhidos arbitrariamente.
Solicitação:
{
"jsonrpc": "2.0",
"método": "ação.criar",
"parâmetros": {
"name": "Ação do gatilho",
"origem do evento": 0,
"estado": 0,
"esc_period": "2m",
"filtro": {
"evaltype": 3,
"fórmula": "A e (B ou C)",
"condições": [
{
"tipo de condição": 4,
"operador": 5,
"valor": "2",
"formulaid": "A"
},
{
"tipo de condição": 1,
"operador": 0,
"valor": "10084",
"formulaid": "B"
},
{
"tipo de condição": 1,
"operador": 0,
"valor": "10106",
"formulaid": "C"
}
]
},
"operações": [
{
"tipo de operação": 0,
"esc_period": "0s",
"esc_step_from": 1,
"esc_step_to": 2,
"evaltype": 0,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"mensagem de mensagem": {
"default_msg": 1,
"mediatypeid": "1"
}
}
],
"pause_suppressed": "0",
"notify_if_canceled": "0"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": {
"actionids": [
"18"
]
},
"id": 1
}Criar regra de registro automático do agente
Adicione um host ao grupo de hosts "Servidores Linux" quando o nome do host contiver "SRV" ou metadados contém "AlmaLinux".
Solicitação:
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Register Linux servers",
"eventsource": "2",
"status": "0",
"filter": {
"evaltype": "2",
"conditions": [
{
"conditiontype": "22",
"operator": "2",
"value": "SRV"
},
{
"conditiontype": "24",
"operator": "2",
"value": "AlmaLinux"
}
]
},
"operations": [
{
"operationtype": "4",
"opgroup": [
{
"groupid": "2"
}
]
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
19
]
},
"id": 1
}Veja também
Fonte
CAction::create() in ui/include/classes/api/services/CAction.php.