hostinterface.create

Descrição

object hostinterface.create(object/array hostInterfaces)

Este método permite criar novas interfaces de host.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Veja Funções de usuário para mais informações.

Parâmetros

(object/array) Interfaces de host a serem criadas.

O método aceita interfaces de host com as propriedades padrão de interface de host.

Valores de retorno

(object) Retorna um objeto contendo os IDs das interfaces de host criadas na propriedade interfaceids. A ordem dos IDs retornados corresponde à ordem das interfaces de host passadas.

Exemplos

Criar uma nova interface

Crie uma interface de agent secundária no host "30052".

Requisição:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.create",
    "params": {
        "hostid": "30052",
        "main": "0",
        "type": "1",
        "useip": "1",
        "ip": "127.0.0.1",
        "dns": "",
        "port": "10050"
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30062"
        ]
    },
    "id": 1
}

Criar uma interface com detalhes SNMP

Requisição:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.create",
    "params": {
        "hostid": "10456",
        "main": "0",
        "type": "2",
        "useip": "1",
        "ip": "127.0.0.1",
        "dns": "",
        "port": "1601",
        "details": {
            "version": "2",
            "bulk": "1",
            "community": "{$SNMP_COMMUNITY}"
        }
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30063"
        ]
    },
    "id": 1
}

Veja também

Origem

CHostInterface::create() em ui/include/classes/api/services/CHostInterface.php.