proxy.create

Description

object proxy.create(object/array proxies)

Cette méthode vous permet de créer de nouveaux proxy.

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

Paramètres

(object/array) Proxies à créer.

En plus des propriétés standard des proxies, 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 autre proxy, il sera réaffecté au proxy actuel.

Les hôtes doivent uniquement avoir la propriété hostid définie.
apm object Paramètres de surveillance des performances des applications (APM) du proxy.

Valeurs de retour

(object) Renvoie un objet contenant les ID des proxies créés dans la propriété proxyids. L’ordre des ID renvoyés correspond à l’ordre des proxies transmis.

Exemples

Créer un proxy actif

Créez un proxy d’action « Active proxy » et assignez-lui un hôte à surveiller.

Request:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10279"
            }
        ]
    },
    "id": 1
}

Réponse :

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

Créer un proxy passif

Créez un proxy passif « Passive proxy » et assignez-lui deux hôtes à surveiller.

Requête:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Passive proxy",
        "operating_mode": "1",
        "address": "127.0.0.1",
        "port": "10051",
        "hosts": [
            {
                "hostid": "10192"
            },
            {
                "hostid": "10139"
            }
        ]
    },
    "id": 1
}

Réponse :

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

Création d’un proxy et ajout à un groupe de proxys

Créez un proxy actif « Active proxy » et ajoutez-le au groupe de proxys avec l’ID « 1 ».

Requête:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "proxy_groupid": "1",
        "operating_mode": "0"
    },
    "id": 1
}

Réponse :

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

Création d'un proxy avec chiffrement basé sur un certificat

Créez un proxy actif avec un chiffrement basé sur un certificat encryption. Le proxy est configuré pour surveiller l'hôte "10785".

Requête :

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10785"
            }
        ],
        "tls_accept": "4",
        "tls_issuer": "CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com",
        "tls_subject": "CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com"
    },
    "id": 1
}

Réponse :

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

Création d’un proxy avec APM activé

Créez un proxy actif « Active proxy » avec APM activé. Le proxy accepte jusqu’à 1000 messages par seconde, ajoute l’attribut de ressource deployment.environment aux traces et ajoute l’attribut de ressource cloud.region aux métriques.

Requête :

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "apm": {
            "data_collection_status": "1",
            "max_messages_per_second": "1000",
            "additional_resource_attributes": [
                {
                    "key": "deployment.environment",
                    "value": "production",
                    "signal_type": "0"
                },
                {
                    "key": "cloud.region",
                    "value": "eu-central-1",
                    "signal_type": "1"
                }
            ]
        }
    },
    "id": 1
}

Réponse :

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

Voir aussi

Source

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