[comment]: # translation:outdated

[comment]: # ({55d00364-e4b5aac4})
# 更新动作

[comment]: # ({/55d00364-e4b5aac4})

[comment]: # ({4779c6fb-458c01d9})
### 说明

`object action.update(object/array actions)`

此方法允许更新现有的动作。

[comment]: # ({/4779c6fb-458c01d9})

[comment]: # ({54fa1dca-7311cf21})
### 参数

`(object/array)` 要更新的动作属性。

必须为每个动作定义 `actionid`
属性，所有其他属性都是可选的。只有通过的属性将被更新，所有其他属性将保持不变。

除此之外 [standard action properties](object#action),
该方法接受以下参数。

|参数                      类|说明|<|
|-------------------------------|------|-|
|filter|object|[动作](zh/manual/api/reference/action/object#action_filter)筛选器对象以替换当前筛选器。|
|operations|array|动作[操作](zh/manual/api/reference/action/object#action_operation)替换现有操作。|
|recovery\_operations|array|动作[恢复操作](zh/manual/api/reference/action/object#action_recovery_operation),以替换现有恢复操作。|
|acknowledge\_operations|array|动作[更新操作](zh/manual/api/reference/action/object#action_update_operation)，以替换现有的更新操作。|

[comment]: # ({/54fa1dca-7311cf21})

[comment]: # ({c8ae8c68-8cbaa103})
### 返回值

`(object)` 返回一个对象，该对象在 `actionids` 属性下包含要更新动作的
ID。

[comment]: # ({/c8ae8c68-8cbaa103})

[comment]: # ({392bbd85-b41637d2})
### 范例

[comment]: # ({/392bbd85-b41637d2})

[comment]: # ({fcb72abc-77b78ec5})
#### 禁用动作

禁用动作，也就是说，将其状态设置为 `1`。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "action.update",
    "params": {
        "actionid": "2",
        "status": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

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

[comment]: # ({/fcb72abc-77b78ec5})

[comment]: # ({f1d743c2-755496f7})
### 参见

-   [Action filter](object#action_filter)
-   [Action operation](object#action_operation)

[comment]: # ({/f1d743c2-755496f7})

[comment]: # ({272698f5-df9f1d35})
### 来源

CAction::update() in
*frontends/php/include/classes/api/services/CAction.php*.

[comment]: # ({/272698f5-df9f1d35})