role.create

Beschreibung

object role.create(object/array roles)

Diese Methode ermöglicht es Ihnen, neue Rollen zu erstellen.

Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen 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.