hostinterface.create

Beschrijving

object hostinterface.create(object/array hostInterfaces)

Deze methode maakt het mogelijk om nieuwe host-interfaces te maken.

Deze methode is alleen beschikbaar voor gebruikers met het type Admin en Superadmin. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Hostinterfaces om te maken.

De methode accepteert hostinterfaces met de standaard hostinterface-eigenschappen.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte host bevat interfaces onder de eigenschap interfaceids. De volgorde van de geretourneerde ID's komen overeen met de volgorde van de doorgegeven hostinterfaces.

Voorbeelden

Een nieuwe interface creëren

Creëer een secundaire IP-agentinterface op host "30052."

Verzoek:

{
           "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
       }

Reactie:

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

Een interface creëren met SNMP-details

Verzoek:

{
           "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
       }

Reactie:

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

Zie ook

Bron

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