Áú»¢¶Ä²©

action.get

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

integer/array action.get(par¨¢metros de objeto)

El m¨¦todo permite recuperar acciones seg¨²n los par¨¢metros dados.

Este m¨¦todo est¨¢ disponible para usuarios de cualquier tipo. Los permisos para llamar al m¨¦todo se puede revocar en la configuraci¨®n de roles de usuario. Para m¨¢s informaci¨®n, ver Roles de usuario.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ

(object) ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ que definen la salida deseada.

El m¨¦todo admite los siguientes par¨¢metros.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Tipo ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
actionids string/array Devuelve solo las acciones con los IDs indicados.
groupids string/array Devuelve solo las acciones que incluyen en sus condiciones de acci¨®n los grupos de equipos indicados.
hostids string/array Devuelve solo las acciones que incluyen en sus condiciones de acci¨®n los equipos indicados.
triggerids string/array Devuelve solo las acciones que incluyen en sus condiciones de acci¨®n los iniciadores indicados.
mediatypeids string/array Devuelve solo las acciones que usan los tipos de medios indicados para enviar mensajes.
usrgrpids string/array Devuelve solo las acciones configuradas para enviar mensajes a los grupos de usuario indicados.
userids string/array Devuelve solo las acciones configuradas para enviar mensajes a los usuarios indicados.
scriptids string/array Devuelve solo las acciones configuradas para ejecutar los scripts indicados.
selectFilter query Devuelve una propiedad de filtro con el filtro de condici¨®n de acci¨®n.
selectOperations query Devuelve una propiedad de operations con operaciones de acci¨®n.
selectRecoveryOperations query Devuelve una propiedad de recovery_operations con operaciones de recuperaci¨®n.
selectUpdateOperations query Devuelve una propiedad de update_operations con operaciones de actualizaci¨®n.
sortfield string/array Ordena los resultados por las propiedades indicadas.

Los posibles valores son: actionid, name y status.
countOutput boolean Estos par¨¢metros son comunes para todos los m¨¦todos get descritos en el comentario de referencia.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores devueltos

(interger/array) devuelve:

  • un arreglo de objetos;
  • el contador de los objetos devueltos, si el par¨¢metro countOutput ha sido utilizado.

Ejemplos

Recuperar acciones de iniciador

Recuperar todas las acciones de iniciador configuradas junto con las condiciones de acci¨®n y operaciones.

Solicitud:

{
       "jsonrpc": "2.0",
       "method": "action.get",
       "params": {
       "output": "extend",
       "selectOperations": "extend",
       "selectRecoveryOperations": "extend",
       "selectUpdateOperations": "extend",
       "selectFilter": "extend",
       "filter": {
       "eventsource": 0
       }
       },
       "id": 1
       }

Respuesta:

{
       "jsonrpc": "2.0",
       "result": [
       {
       "actionid": "3",
       "name": "Report problems to Áú»¢¶Ä²© administrators",
       "eventsource": "0",
       "status": "1",
       "esc_period": "1h",
       "pause_suppressed": "1",
       "filter": {
       "evaltype": "0",
       "formula": "",
       "conditions": [],
       "eval_formula": ""
       },
       "operations": [
       {
       "operationid": "3",
       "actionid": "3",
       "operationtype": "0",
       "esc_period": "0",
       "esc_step_from": "1",
       "esc_step_to": "1",
       "evaltype": "0",
       "opconditions": [],
       "opmessage": [
       {
       "default_msg": "1",
       "subject": "",
       "message": "",
       "mediatypeid" => "0"
       }
       ],
       "opmessage_grp": [
       {
       "usrgrpid": "7"
       }
       ]
       }
       ],
       "recovery_operations": [
       {
       "operationid": "7",
       "actionid": "3",
       "operationtype": "11",
       "evaltype": "0",
       "opconditions": [],
       "opmessage": {
       "default_msg": "0",
       "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}",
       "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}",
       "mediatypeid": "0"
       }
       }
       ],
       "update_operations": [
       {
       "operationid": "31",
       "operationtype": "12",
       "evaltype": "0",
       "opmessage": {
       "default_msg": "1",
       "subject": "",
       "message": "",
       "mediatypeid": "0"
       }
       },
       {
       "operationid": "32",
       "operationtype": "0",
       "evaltype": "0",
       "opmessage": {
       "default_msg": "0",
       "subject": "Updated: {TRIGGER.NAME}",
       "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}",
       "mediatypeid": "1"
       },
       "opmessage_grp": [
       {
       "usrgrpid": "7"
       }
       ],
       "opmessage_usr": []
       },
       {
       "operationid": "33",
       "operationtype": "1",
       "evaltype": "0",
       "opcommand": {
       "scriptid": "3"
       },
       "opcommand_hst": [
       {
       "hostid": "10084"
       }
       ],
       "opcommand_grp": []
       }
       ]
       }
       ],
       "id": 1
       }

Recuperar acciones de descubrimiento

Recuperar todas las acciones de descubrimiento configuradas junto con las condiciones y operaciones de la acci¨®n. El filtro utiliza el tipo de evaluaci¨®n "y", por lo que la propiedad formula est¨¢ vac¨ªa y se genera eval_formula ²¹³Ü³Ù´Ç³¾¨¢³Ù¾±³¦²¹³¾±ð²Ô³Ù±ð.

Solicitud:

{
       "jsonrpc": "2.0",
       "method": "action.get",
       "params": {
       "output": "extend",
       "selectOperations": "extend",
       "selectFilter": "extend",
       "filter": {
       "eventsource": 1
       }
       },
       "id": 1
       }

Respuesta:

{
       "jsonrpc": "2.0",
       "result": [
       {
       "actionid": "2",
       "name": "Auto discovery. Linux servers.",
       "eventsource": "1",
       "status": "1",
       "esc_period": "0s",
       "pause_suppressed": "1",
       "filter": {
       "evaltype": "0",
       "formula": "",
       "conditions": [
       {
       "conditiontype": "10",
       "operator": "0",
       "value": "0",
       "value2": "",
       "formulaid": "B"
       },
       {
       "conditiontype": "8",
       "operator": "0",
       "value": "9",
       "value2": "",
       "formulaid": "C"
       },
       {
       "conditiontype": "12",
       "operator": "2",
       "value": "Linux",
       "value2": "",
       "formulaid": "A"
       }
       ],
       "eval_formula": "A and B and C"
       },
       "operations": [
       {
       "operationid": "1",
       "actionid": "2",
       "operationtype": "6",
       "esc_period": "0s",
       "esc_step_from": "1",
       "esc_step_to": "1",
       "evaltype": "0",
       "opconditions": [],
       "optemplate": [
       {
       "templateid": "10001"
       }
       ]
       },
       {
       "operationid": "2",
       "actionid": "2",
       "operationtype": "4",
       "esc_period": "0s",
       "esc_step_from": "1",
       "esc_step_to": "1",
       "evaltype": "0",
       "opconditions": [],
       "opgroup": [
       {
       "groupid": "2"
       }
       ]
       }
       ]
       }
       ],
       "id": 1
       }

Ver tambi¨¦n

Fuente

CAction::get() en ui/include/clases/api/services/CAction.php.