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.