action.update

描述

object action.update(object/array actions)

此方法用于 update 现有的动作。

此方法仅适用于 Admin 和 Super admin 用户类型。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。

参数

(object/array) 要更新的 action 属性。

必须为每个 action 定义 actionid 属性，其他所有属性均为可选。只有传入的属性会被更新，其余属性将保持不变。

除了标准 action 属性之外，该方法还接受以下参数。

Parameter Type Description
filter object 用于替换当前筛选条件的Action filter对象。
operations array 用于替换现有操作的Action operations。
recovery_operations array 用于替换现有恢复操作的Action recovery operations。

Parameter behavior:
- supported if eventsource of Action object is set to "event created by a trigger", "internal event", or "event created on service status update"
update_operations array 用于替换现有更新操作的Action update operations。

Parameter behavior:
- supported if eventsource of Action object is set to "event created by a trigger" or "event created on service status update"

返回值

(object) 返回一个 object，其中包含更新后的操作 ID， 位于 actionids 属性下。

示例

禁用动作

禁用某个动作，即将其状态设置为 "1"。

执行请求:

{
    "jsonrpc": "2.0",
    "method": "action.update",
    "params": {
        "actionid": "2",
        "status": "1"
    },
    "id": 1
}

响应：

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

另请参见

来源

CAction::update() 在 ui/include/classes/api/services/CAction.php 中。