object proxy.create(object/array proxies)
Cette méthode permet de créer de nouveaux proxys.
(object/array) Proxys à créer.
En plus des propriétés de l'objet proxy standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| hosts | array | Les hôtes à surveiller par le proxy. Si un hôte est déjà surveillé par un autre proxy, il sera réaffecté au proxy actuel. Les hôtes doivent avoir la propriété hostid définie. |
| interface | object | Interface hôte à créer pour le proxy passif. Obligatoire pour les proxies passifs. |
(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.
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é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 }
CProxy::create() dans frontends/php/include/classes/api/services/CProxy.php.