hostinterface.update

Description

object hostinterface.update(object/array hostInterfaces)

Cette méthode permet de mettre à jour des interfaces d’hôte existantes.

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. Voir User roles pour plus d’informations.

Paramètres

(object/array) Propriétés de l'interface de l'hôte à mettre à jour.

La propriété interfaceid doit être définie pour chaque interface de l'hôte, toutes les autres propriétés sont facultatives. Seules les propriétés indiquées seront mises à jour, toutes les autres resteront inchangées.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des interfaces hôtes mises à jour sous la propriété interfaceids.

Exemples

Modification du port d'une interface d'hôte

Modifiez le port d'une interface d'hôte.

Requête:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.update",
    "params": {
        "interfaceid": "30048",
        "port": "10055"
    },
    "id": 1
}

Réponse :

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

Modification des ports de plusieurs interfaces d'hôte

Modifiez le port de plusieurs interfaces d'hôte.

Requête:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.update",
    "params": [
        {
            "interfaceid": "30049",
            "port": "10055"
        },
        {
            "interfaceid": "30050",
            "port": "10055"
        },
        {
            "interfaceid": "30051",
            "port": "10055"
        }
    ],
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30049",
            "30050",
            "30051"
        ]
    },
    "id": 1
}

Source

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