role.create

Beschreibung

object role.create(object/array roles)

Mit dieser Methode können neue Rollen erstellt werden.

Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu erstellende Rollen.

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

Parameter Type Beschreibung
rules array Für die Rolle zu erstellende Rollenregeln.

Rückgabewerte

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

Beispiele

Erstellen einer Rolle

Erstellen Sie eine Rolle vom Typ „Benutzer“ mit verweigertem Zugriff auf zwei UI-Elemente.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "role.create",
    "params": {
        "name": "Operator",
        "type": "1",
        "rules": {
            "ui": [
                {
                    "name": "monitoring.hosts",
                    "status": "0"
                },
                {
                    "name": "monitoring.maps",
                    "status": "0"
                }
            ]
        }
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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