hostgroup.propagate

Beschreibung

object hostgroup.propagate(object parameters)

Mit dieser Methode können Berechtigungen und Tag-Filter auf alle Untergruppen einer Host-Gruppe angewendet werden.

Diese Methode ist nur für Benutzertypen vom Typ Super admin verfügbar.

Die Berechtigung zum Aufrufen dieser Methode kann in den Einstellungen der Benutzerrolle entzogen werden.

Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
groups object/array Zu propagierende Host-Gruppen.

Für die Host-Gruppen muss die Eigenschaft groupid definiert sein.

Parameterverhalten:
- erforderlich
permissions boolean Auf „true“ setzen, um Berechtigungen zu propagieren.

Parameterverhalten:
- erforderlich, wenn tag_filters nicht gesetzt ist
tag_filters boolean Auf „true“ setzen, um Tag-Filter zu propagieren.

Parameterverhalten:
- erforderlich, wenn permissions nicht gesetzt ist

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der propagierten Host-Gruppen unter der Eigenschaft groupids enthält.

Beispiele

Berechtigungen und Tag-Filter einer Hostgruppe an ihre Untergruppen weitergeben.

Geben Sie Berechtigungen und Tag-Filter einer Hostgruppe an ihre Untergruppen weiter.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.propagate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "permissions": true,
        "tag_filters": true
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "6",
        ]
    },
    "id": 1
}

Siehe auch

Quelle

CHostGroup::propagate() in ui/include/classes/api/services/CHostGroup.php.