创建

描述

object hostprototype.create(object/array hostPrototypes)

此方法允许创建新的主机原型.

参数

(对象/数组) 要创建的主机原型.

标准主机原型属性之外,该方法接受以下参数.

参数 类描述
groupLinks
(必选)
数组 要主机原型创建的组链接.
ruleid
(必选)
字符串 主机型所属的LLD规则的ID.
groupPrototypes数组 将主机原型创建的组原型.
inventory对象 主原型资产属性.
templates对象/数组 连接到机原型的模板.

模板必须已定义templateid属性.

返回值

(object)hostids属性中返回已创建主机原型ID的对象,返回ID的顺序与传入主机原型的顺序一致.

示例

创建主机原型

使用组原型{#HV.NAME}为LLD规则23542,创建主机原型{#VM.NAME},连接到主机组2

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "hostprototype.create",
  4. "params": {
  5. "host": "{#VM.NAME}",
  6. "ruleid": "23542",
  7. "groupLinks": [
  8. {
  9. "groupid": "2"
  10. }
  11. ],
  12. "groupPrototypes": [
  13. {
  14. "name": "{#HV.NAME}"
  15. }
  16. ]
  17. },
  18. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  19. "id": 1
  20. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "hostids": [
  5. "10103"
  6. ]
  7. },
  8. "id": 1
  9. }

参考

来源

CHostPrototype::create() in frontends/php/include/classes/api/services/CHostPrototype.php.