更新

更新

描述

host.update(主机对象/数组)对象

该方法允许更新现有主机。

这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考用户角色

参数

(对象/数组) 待更新的主机属性。

hostid 属性必须为每台主机定义，其他属性都是可选的。只有给定的属性将被更新，其他所有属性将保持不变。

但是，请注意，更新主机技术名称也将根据主机的技术名称值更新主机的可见名称(如果没有给出或为空)。

除了标准主机属性以外，此方法接受如下参数:

参数	类	描述
groups	对象/数组	更换主机所属的主机组。主机组必须已定义 `groupid` 属性。所有未在请求中列出的主机组将被解除链接。
interfaces	对象/数组	主机接口用于替换当前主机接口。所有未在请求中列出的接口将被删除。
tags	对象/数组	主机标签替换当前主机标签。所有未在请求中列出的标签将被删除。
inventory	object	主机清单属性。
macros	对象/数组	用户宏替换当前用户宏。所有未在请求中列出的宏将被删除。
templates	对象/数组	模板替换当前链接的模板。所有未在请求中列出的模板只会被解除链接。模板必须定义了 `templateid` 属性。
templates_clear	对象/数组	模板取消与主机的链接并清除。模板必须定义了 `templateid` 属性。

与Zabbix前端不同，当 name (可见主机名)与 host (技术主机名)相同时，通过API更新 host 不会自动更新 name 。这两个属性都需要显式更新。

返回值

(object) 返回一个对象，该对象包含 hostids 属性下更新的主机的id。

示例

开启主机监控

启用主机监控，即设置主机监控状态为0。

请求:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

删除模板

从主机上取消链接并清除两个模板。

请求:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "templates_clear": [
                   {
                       "templateid": "10124"
                   },
                   {
                       "templateid": "10125"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

更新用户宏

用两个新的宏替换所有主机宏。

请求:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "macros": [
                   {
                       "macro": "{$PASS}",
                       "value": "password"
                   },
                   {
                       "macro": "{$DISC}",
                       "value": "sda",
                       "description": "Updated description"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

更新主机资产

改变主机资产模式和添加位置。

请求:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "inventory_mode": 0,
               "inventory": {
                   "location": "Latvia, Riga"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 1
       }

更新主机标记

用一个新的主机标记替换所有的主机标记。

请求:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "tags": {
                   "tag": "OS",
                   "value": "CentOS 7"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 1
       }

另请参阅

源代码

CHost::update() in ui/include/classes/api/services/CHost.php.