更新
描述
object action.update(object/array actions)
此方法允许更新现有动作。
此方法仅对 Admin 和 Super admin 用户类型可用。在用户角色设置中可以撤销调用此方法的权限。有关更多信息，请参阅用户角色。
参数
(object/array) 要更新的动作属性。
必须为每个动作定义 actionid 属性，其他所有属性均为可选。
只有传入的属性会被更新，其他所有属性将保持不变。
除标准动作属性外， 该方法还接受以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| filter | object | 用于替换当前过滤条件的动作过滤器对象。 |
| operations | array | 用于替换现有操作的动作操作。 |
| recovery_operations | array | 用于替换现有恢复操作的动作恢复操作。 参数行为： - 如果动作对象的 eventsource 设置为“由触发器创建的事件”、“内部事件”或“在服务状态更新时创建的事件”，则支持 |
| update_operations | array | 用于替换现有更新操作的动作更新操作。 参数行为： - 如果动作对象的 eventsource 设置为“由触发器创建的事件”或“在服务状态更新时创建的事件”，则支持 |
返回值
(object) 返回一个对象，其中包含 actionids 属性下已更新的动作的ID。
示例
禁用动作
禁用一个动作，即将其状态设置为"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 文件中。