proxy.create

Description

object proxy.create(object/array proxies)

Cette méthode permet de créer de nouveaux proxys.

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

Paramètres

(object/array) Proxys à créer.

En plus des propriétés standard du proxy, la méthode accepte les paramètres suivants.

Paramètre Type Description
hosts array Hôtes à surveiller par le proxy. Si un hôte est déjà surveillé par un proxy différent, il sera réaffecté au proxy actuel.

Les hôtes doivent avoir la propriété hostid définie.
interface object Interface d'hôte à créer pour le proxy passif.

Obligatoire pour les proxys passifs.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des déclencheurs créés sous la propriété proxyids. L'ordre des ID retournés correspond à l'ordre des proxys transmis.

Exemples

Création d'un proxy actif

Créez un proxy actif "Active proxy" et lui assigner un hôte à surveiller.

Requête :

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Active proxy",
               "status": "5",
               "hosts": [
                   {
                       "hostid": "10279"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10280"
               ]
           },
           "id": 1
       }

Création d'un proxy passif

Créez un proxy actif "Passive proxy" et lui assigner deux hôtes à surveiller.

Requête :

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Passive proxy",
               "status": "6",
               "interface": {
                   "ip": "127.0.0.1",
                   "dns": "",
                   "useip": "1",
                   "port": "10051"
               },
               "hosts": [
                   {
                       "hostid": "10192"
                   },
                   {
                       "hostid": "10139"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10284"
               ]
           },
           "id": 1
       }

Voir également

Source

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