proxy.create

Beschreibung

object proxy.create(object/array proxies)

Mit dieser Methode können neue Proxys erstellt werden.

Parameter

(object/array) Zu erstellende Proxys.

Zusätzlich zu den Standard-Proxy-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Proxys unter der Eigenschaft proxyids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Proxys.

Beispiele

Einen aktiven Proxy erstellen

Erstellen Sie einen aktiven Proxy „Active proxy“ und weisen Sie ihm einen Host zur Überwachung zu.

Anfrage:

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

Antwort:

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

Einen passiven Proxy erstellen

Erstellen Sie einen passiven Proxy „Passive proxy“ und weisen Sie ihm zwei Hosts zur Überwachung zu.

Anfrage:

{
    "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
}

Antwort:

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

Erstellen eines Proxy und Hinzufügen zu einer Proxy-Gruppe

Erstellen Sie einen aktiven Proxy „Active proxy“ und fügen Sie ihn der Proxy-Gruppe mit der ID „1“ hinzu.

Anfrage:

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

Antwort:

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

Creating a proxy with certificate-based encryption

Create an active proxy with certificate-based encryption. The proxy is configured to monitor host "10785".

Request:

{
    "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
}

Response:

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

Siehe auch

• Host
• Proxy-Gruppe

Quelle

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