Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

hostinterface.create

Description

object hostinterface.create(object/array hostInterfaces)

Cette méthode permet de créer de nouvelles interfaces hôtes.

Cette méthode est disponible uniquement pour tous les utilisateurs de type Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object/array) Interfaces hôtes à créer. La méthode accepte les interfaces hôtes ayant les propriétés standard de l'objet interface hôte.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des interfaces hôtes créées sous la propriété interfaceids. L'ordre des ID retournés correspond à l'ordre des interfaces hôtes transmises.

Exemples

Création d'une interface

Créer une interface d'agent IP secondaire sur l'hôte "30052".

Requête :

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

Réponse :

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

Créer une interface avec des détails SNMP

Requête :

{
           "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}"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

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

Voir également

Source

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