This is a translation of the original English documentation page. Help us make it better.

Sidebar

actie.maken

Beschrijving

object action.create(object/array acties)

Deze methode maakt het mogelijk om nieuwe acties te creëren.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) Te maken acties.

Naast de standaard actie-eigenschappen, is de methode accepteert de volgende parameters.

Parameter Type Beschrijving
filter object Actie filter object voor de actie.
operations array Actie bewerkingen om voor de actie te maken.
recovery_operations array Actie herstelbewerkingen om voor de actie te maken.
update_operations array Actie update-bewerkingen die moet worden gemaakt voor de actie.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte acties bevat onder de eigenschap actionids. De volgorde van de geretourneerde ID's komt overeen de volgorde van de uitgevoerde acties.

Voorbeelden

Maak een triggeractie

Maak een actie die wordt uitgevoerd wanneer een trigger van host "10084" dat heeft het woord "geheugen" in zijn naam gaat in de probleemtoestand. De actie moet eerst een bericht sturen naar alle gebruikers in gebruikersgroep "7". Als het evenement niet binnen 4 minuten is opgelost, wordt script "3" uitgevoerd op alle hosts in groep "2". Bij triggerherstel zal het alle gebruikers op de hoogte stellen die er een hebben ontvangen berichten over het probleem eerder. Bij trigger-update, bericht met aangepast onderwerp en hoofdtekst worden verzonden naar iedereen die een bevestiging heeft achtergelaten en opmerkingen via alle mediatypes.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "action.create",
           "parameters": {
               "name": "Activeer actie",
               "eventsource": 0,
               "status": 0,
               "esc_period": "2m",
               "filter": {
                   "evaltype": 0,
                   "conditions": [
                       {
                           "conditiontype": 1,
                           "operator": 0,
                           "value": "10084"
                       },
                       {
                           "conditiontype": 3,
                           "operator": 2,
                           "value": "memory"
                       }
                   ]
               },
               "operations": [
                   {
                       "operationtype": 0,
                       "esc_period": "0s",
                       "esc_step_from": 1,
                       "esc_step_to": 2,
                       "evaltype": 0,
                       "opmessage_grp": [
                           {
                               "usrgrpid": "7"
                           }
                       ],
                       "opmessage": {
                           "default_msg": 1,
                           "mediatypeid": "1"
                       }
                   },
                   {
                       "operationtype": 1,
                       "esc_step_from": 3,
                       "esc_step_to": 4,
                       "evaltype": 0,
                       "opconditions": [
                           {
                               "conditiontype": 14,
                               "operator": 0,
                               "value": "0"
                           }
                       ],
                       "opcommand_grp": [
                           {
                               "groupname": "2"
                           }
                       ],
                       "opcommand": {
                           "scriptid": "3"
                       }
                   }
               ],
               "recovery_operations": [
                   {
                       "bewerkingstype": "11",
                       "opmessge": {
                           "default_msg": 1
                       }
                   }
               ],
               "update_operations": [
                   {
                       "operationtype": "12",
                       "opmessage": {
                           "default_msg": 0,
                           "message": "Berichttekst voor aangepaste updatebewerking",
                           "subject": "Onderwerp van bericht over aangepaste updatebewerking"
                       }
                   }
               ],
               "pause_suppressed": "0",
               "notify_if_canceled": "0"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "action-id's": [
                   "17"
               ]
           },
           "id": 1
       }

Maak een ontdekkingsactie

Maak een actie die ontdekte hosts koppelt aan sjabloon "10091".

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "action.create",
           "parameters": {
               "name": "Ontdekkingsactie",
               "evenementenbron": 1,
               "status": 0,
               "filteren": {
                   "evaltype": 0,
                   "conditie": [
                       {
                           "conditietype": 21,
                           "operator": 0,
                           "waarde": "1"
                       },
                       {
                           "conditietype": 10,
                           "operator": 0,
                           "waarde": "2"
                       }
                   ]
               },
               "activiteiten": [
                   {
                       "bewerkingstype": 6,
                       "optemplate": [
                           {
                               "templateid": "10091"
                           }
                       ]
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "action-id's": [
                   "18"
               ]
           },
           "id": 1
       }

Een aangepast expressiefilter gebruiken

Maak een triggeractie die een aangepaste filtervoorwaarde gebruikt. De actie moet een bericht verzenden voor elke trigger met een hogere ernst of gelijk aan "Waarschuwing" voor hosts "10084" en "10106". De formule-ID's "A", "B" en "C" zijn willekeurig gekozen.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "action.create",
           "parameters": {
               "name": "Activeer actie",
               "eventsource": 0,
               "status": 0,
               "esc_periode": "2m",
               "filter": {
                   "evaltype": 3,
                   "formula": "A en (B of C)",
                   "conditons": [
                       {
                           "conditontype": 4,
                           "operator": 5,
                           "value": "2",
                           "formulaid": "A"
                       },
                       {
                           "conditietype": 1,
                           "operator": 0,
                           "value": "10084",
                           "formulaid": "B"
                       },
                       {
                           "conditiontype": 1,
                           "operator": 0,
                           "value": "10106",
                           "formulaid": "C"
                       }
                   ]
               },
               "operations": [
                   {
                       "operationtype": 0,
                       "esc_period": "0s",
                       "esc_step_from": 1,
                       "esc_step_to": 2,
                       "evaltype": 0,
                       "opmessage_grp": [
                           {
                               "usrgrpid": "7"
                           }
                       ],
                       "opmessage": {
                           "default_msg": 1,
                           "mediatypeid": "1"
                       }
                   }
               ],
               "pause_suppressed": "0",
               "notify_if_canceled": "0"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "action-id's": [
                   "18"
               ]
           },
           "id": 1
       }

Regel voor automatische agentregistratie maken

Voeg een host toe aan de hostgroep "Linux-servers" wanneer de hostnaam "SRV" bevat of metadata bevat "CentOS".

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "action.create",
           "parameters": {
               "name": "Registreer Linux-servers",
               "eventsource": "2",
               "status": "0",
               "filter": {
                   "evaltype": "2",
                   "conditions": [
                       {
                           "conditiontype": "22",
                           "operator": "2",
                           "value": "SRV"
                       },
                       {
                           "conditiontype": "24",
                           "operator": "2",
                           "value": "CentOS"
                       }
                   ]
               },
               "operations": [
                   {
                       "operationtype": "4",
                       "opgroup": [
                           {
                               "groupid": "2"
                           }
                       ]
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "action-id's": [
                   19
               ]
           },
           "id": 1
       }

Zie ook

Bron

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