hostinterface.create

Description

object hostinterface.create(object/array hostInterfaces)

Cette méthode permet de créer de nouvelles interfaces d'hôte.

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez Rôles utilisateur pour plus d'informations.

Paramètres

(object/array) Interfaces d’hôte à créer.

La méthode accepte des interfaces d’hôte avec les propriétés standard des interfaces d’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éer une nouvelle interface

Créez 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"
    },
    "id": 1
}

Réponse :

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

Créer une interface avec les 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}"
        }
    },
    "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.