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.