Documentation

Table of Contents

hostinterface.create

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 da interface de host.

Valores de retorno

(object) Retorna um objeto contendo os IDs do host criado interfaces sob a propriedade interfaceids. A ordem do retorno Os IDs correspondem à ordem das interfaces de host passadas.

Exemplos

Criar uma nova interface

Crie uma interface de agent secundária de IP 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

Fonte

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