Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

#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 que vinculará os hosts descobertos ao modelo "10091".

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "ação.criar",
           "parâmetros": {
               "name": "Ação de descoberta",
               "origem do evento": 1,
               "estado": 0,
               "filtro": {
                   "evaltype": 0,
                   "condições": [
                       {
                           "tipo de condição": 21,
                           "operador": 0,
                           "valor": "1"
                       },
                       {
                           "tipo de condição": 10,
                           "operador": 0,
                           "valor": "2"
                       }
                   ]
               },
               "operações": [
                   {
                       "tipo de operação": 6,
                       "otimizar": [
                           {
                               "templateid": "10091"
                           }
                       ]
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "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 "CentOS".

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "ação.criar",
           "parâmetros": {
               "name": "Registrar servidores Linux",
               "eventsource": "2",
               "estado": "0",
               "filtro": {
                   "evaltype": "2",
                   "condições": [
                       {
                           "conditiontype": "22",
                           "operador": "2",
                           "valor": "SRV"
                       },
                       {
                           "conditiontype": "24",
                           "operador": "2",
                           "valor": "CentOS"
                       }
                   ]
               },
               "operações": [
                   {
                       "tipo de operação": "4",
                       "opgroup": [
                           {
                               "groupid": "2"
                           }
                       ]
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "actionids": [
                   19
               ]
           },
           "id": 1
       }

Veja também

Fonte

CAction::create() in ui/include/classes/api/services/CAction.php.