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.
(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. |
(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 :
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 :
CProxy::create() dans ui/include/classes/api/services/CProxy.php.