Sidebar

fr:manual:api:reference:action:create

action.create

Description

object action.create(object/array actions)

Cette méthode permet de créer de nouvelles actions.

Paramètres

(object/array) Actions à créer.

En plus des propriétés de l'objet action standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
filter object Objet de filtre d'action pour l'action.
operations array Opérations d'action à créer pour l'action.
recovery_operations array Opérations de récupération d'action à créer pour l'action.
acknowledge_operations array Opérations d'acquittement d'action à créer pour l'action.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des actions créées sous la propriété actionids. L'ordre des ID retournés correspond à l'ordre des actions transmises.

Exemples

Créer une action de déclenchement

Créer une action à exécuter lorsqu'un déclencheur de l'hôte “30045” portant le mot “memory” dans son nom passe à l'état problématique. L'action doit d'abord envoyer un message à tous les utilisateurs du groupe d'utilisateurs “7”. Si l'événement n'est pas résolu dans les 4 minutes, le script “3” sera exécuté sur tous les hôtes du groupe “2”. Lors de la récupération par déclenchement, il avertira tous les utilisateurs ayant reçu des messages concernant le problème auparavant. Lors de l'acquittement du déclencheur, un message avec un sujet et un corps personnalisés sera envoyé à tous ceux qui ont laissé des accusés de réception et des commentaires via tous les types de support.

Requête :

{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Trigger action",
        "eventsource": 0,
        "status": 0,
        "esc_period": "2m",
        "def_shortdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}",
        "def_longdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}\r\nLast value: {ITEM.LASTVALUE}\r\n\r\n{TRIGGER.URL}",
        "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": [
                    {
                        "groupid": "2"
                    }
                ],
                "opcommand": {
                    "type": 4,
                    "scriptid": "3"
                }
            }
        ],
        "recovery_operations": [
            {
                "operationtype": "11",
                "opmessage": {
                    "default_msg": 1
                }
            }    
        ],
        "acknowledge_operations": [
            {
                "operationtype": "12",
                "opmessage": {
                    "message": "Custom acknowledge operation message body",
                    "subject": "Custom acknowledge operation message subject"
                }
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "17"
        ]
    },
    "id": 1
}

Création d'une action de découverte

Créer une action qui liera les hôtes découverts au modèle “30085”.

Requête :

{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Discovery action",
        "eventsource": 1,
        "status": 0,
        "esc_period": "0s",
        "filter": {
            "evaltype": 0,
            "conditions": [
                {
                    "conditiontype": 21,
                    "value": "1"
                },
                {
                    "conditiontype": 10,
                    "value": "2"
                }
            ]
        },
        "operations": [
            {
                "esc_step_from": 1,
                "esc_period": "0s",
                "optemplate": [
                    {
                        "templateid": "10091"
                    }
                ],
                "operationtype": 6,
                "esc_step_to": 1
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "18"
        ]
    },
    "id": 1
}

Utilisation d'un filtre d'expression personnalisé

Créer une action de déclenchement qui utilisera une condition de filtre personnalisée. L'action doit envoyer un message pour chaque déclencheur avec une gravité supérieure ou égale à “Avertissement” pour les hôtes “10084” et “10106”. Les identifiants de formules “A”, “B” et “C” ont été choisis arbitrairement.

Requête :

{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Trigger action",
        "eventsource": 0,
        "status": 0,
        "esc_period": "2m",
        "def_shortdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}",
        "def_longdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}\r\nLast value: {ITEM.LASTVALUE}\r\n\r\n{TRIGGER.URL}",
        "filter": {
            "evaltype": 3,
            "formula": "A and (B or C)",
            "conditions": [
                {
                    "conditiontype": 4,
                    "operator": 5,
                    "value": "2",
                    "formulaid": "A"
                },
                {
                    "conditiontype": 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"
                }
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "18"
        ]
    },
    "id": 1
}

Voir également

Source

CAction::create() dans frontends/php/include/classes/api/services/CAction.php.