hostprototype.create

Description 说明

object hostprototype.create(object/array hostPrototypes)

This method allows to create new host prototypes.这种方法允许创建新的主机原型。

Parameters 参数

(object/array) Host prototypes to create.主机原型创建。

Additionally to the standard host prototype properties, the method accepts the following parameters.除标准主机原型属性之外，该方法接受以下参数。

Return values 返回值

(object) Returns an object containing the IDs of the created host prototypes under the hostids property. The order of the returned IDs matches the order of the passed host prototypes.返回包含“hostid”属性下创建的主机原型的ID的对象。 返回的ID的顺序与传递的主机原型的顺序相匹配。

Examples 示例

Creating a host prototype 创建主机原型

Create a host prototype “{#VM.NAME}” on LLD rule “23542” with a group prototype “{#HV.NAME}”. Link it to host group “2”.使用组原型“{＃HV.NAME}”为LLD规则“23542”创建主机原型“{＃VM.NAME}”。 将其链接到主机组“2”。

Request:

{
    "jsonrpc": "2.0",
    "method": "hostprototype.create",
    "params": {
        "host": "{#VM.NAME}",
        "ruleid": "23542",
        "groupLinks": [
            {
                "groupid": "2"
            }
        ],
        "groupPrototypes": [
            {
                "name": "{#HV.NAME}"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

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

See also 参见

• Group link

• Group prototype

• Host prototype inventory

Source 来源

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