Sidebar
Table of Contents
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:
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:
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:
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:
Zie ook
Bron
CAction::create() in ui/include/classes/api/services/CAction.php.