[comment]: # ({4a6b3375-4a6b3375})
# host.massupdate

[comment]: # ({/4a6b3375-4a6b3375})

[comment]: # ({10cbc072-10cbc072})
### 描述

`object host.massupdate(object parameters)`

此方法允许同时替换或移除多个主机上的关联objects和update属性.

::: noteclassic
此方法仅适用于*Admin*和*Super admin*用户类型. 调用该方法的权限可在用户角色设置中撤销. 详见[User
roles](/manual/web_interface/frontend_sections/administration/user_roles)获取更多信息.

:::

[comment]: # ({/10cbc072-10cbc072})

[comment]: # ({37b8fe51-6d664071})
### 参数

`(object)` 参数包含需要update的主机ID及待更新的属性.

除[主机](object#主机)外，该方法还接受以下参数.

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **hosts**<br>(required) | object/array | 待更新的[Hosts](/manual/api/reference/host/object).<br><br>主机必须定义`hostid`属性. |
| groups | object/array | 用于替换当前主机所属主机组的主机[groups](/manual/api/reference/hostgroup/object).<br><br>主机组必须定义`groupid`属性. |
| interfaces | object/array | 用于替换指定主机上当前主机接口的主机[interfaces](/manual/api/reference/hostinterface/object). |
| inventory | object | 主机[主机资产清单](/manual/api/reference/host/object#主机资产清单)属性.<br><br>不能使用`inventory`参数更新主机库存模式，应改用`inventory_mode`. |
| macros | object/array | 用于替换指定主机上当前用户宏的[User macros](/manual/api/reference/usermacro/object). |
| templates | object/array | 用于替换指定主机上当前链接模板的[Templates](/manual/api/reference/template/object).<br><br>模板必须定义`templateid`属性. |
| templates\_clear | object/array | 用于从指定主机解绑并clear的[Templates](/manual/api/reference/template/object).<br><br>模板必须定义`templateid`属性. |

[comment]: # ({/37b8fe51-6d664071})

[comment]: # ({d166b99b-d166b99b})
### 返回值

`(object)` 返回一个包含已更新objectID的主机数组
其ID存储在`hostids`属性下。

[comment]: # ({/d166b99b-d166b99b})

[comment]: # ({b41637d2-b41637d2})
### 示例

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

[comment]: # ({b2f0a627-4a8d8b94})
#### 启用多台主机

启用对两个主机的监控，即将它们的状态设置为0.

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "host.massupdate",
    "params": {
        "hosts": [
            {
                "hostid": "69665"
            },
            {
                "hostid": "69666"
            }
        ],
        "status": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```
响应:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}
```

[comment]: # ({/b2f0a627-4a8d8b94})

[comment]: # ({4b09fb40-4b09fb40})
### 另请参阅

-   [host.update](update)
-   [host.massadd](massadd)
-   [host.massremove](massremove)
-   [主机组](/manual/api/reference/hostgroup/object#主机组)
-   [主机组](/manual/api/reference/template/object#主机组)
-   [用户宏-object](/manual/api/reference/usermacro/object#用户宏-object)
-   [主机接口](/manual/api/reference/hostinterface/object#主机接口)

[comment]: # ({/4b09fb40-4b09fb40})

[comment]: # ({ad74e98b-ad74e98b})
### 来源

CHost::massUpdate() 位于 *ui/include/classes/api/services/CHost.php* 文件中。

[comment]: # ({/ad74e98b-ad74e98b})