[comment]: # translation:outdated

[comment]: # ({3ab1bd41-c0df6427})
# 更新

[comment]: # ({/3ab1bd41-c0df6427})

[comment]: # ({34ec4811-89a9f4ab})
### 描述

`object hostprototype.update(object/array hostPrototypes)`

此方法允许更新已存在的主机原型。

[comment]: # ({/34ec4811-89a9f4ab})

[comment]: # ({0c8b825c-39f600d5})
### 参数

`(object/array)` 要更新的主机原型属性。

必须为每个主机原型定义`hostid`属性，所有其他属性都是可选的。只有过期的属性将被更新，所有其他属性将保持不变。
除[标准主机原型属性](object#host_prototype)外，该方法还接受以下参数：

|参数              [|型](/zh/manual/api/reference_commentary#data_types)   描述|<|
|---------------------|-------------------------------------------------------------|-|
|groupLinks|数组                                                     组|链接](/zh/manual/api/reference/hostprototype/object#group_link)来替换主机原型上的当前组链接。|
|groupPrototypes|数组                                                     组|原型](/zh/manual/api/reference/hostprototype/object#group_prototype)替换主机原型中已存在的组原型。|
|macros|对象/数组                                                [用户|](/manual/api/reference/usermacro/object)来替换当前的用户宏。<br><br>请求中未列出的所有宏都将被删除。|
|templates|对象/数组                                                [模板|(/zh/manual/api/reference/template/object)来替换当前已连接的模板。<br><br>模板必须已定义`templateid`属性。|

[comment]: # ({/0c8b825c-39f600d5})

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

`(object)` 在`hostids`属性中放回已更新主机原型ID的对象。

[comment]: # ({/fa2eca10-c97defa2})

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

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

[comment]: # ({116bf5f8-9e34a671})
#### 禁用主机原型

通过将status状态设置为1，可禁用主机原型。

请求：

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "hostprototype.update",
    "params": {
        "hostid": "10092",
        "status": 1
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应：

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10092"
        ]
    },
    "id": 1
}
```

[comment]: # ({/116bf5f8-9e34a671})

[comment]: # ({75b4c301-749ec170})
### 参考

-   [组链接](object#group_link)
-   [组原型](object#group_prototype)
-   [用户宏](/zh/manual/api/reference/usermacro/object#hosttemplate_level_macro)

[comment]: # ({/75b4c301-749ec170})

[comment]: # ({7a77c438-a380e3fb})
### 来源

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

[comment]: # ({/7a77c438-a380e3fb})