role.create

Description

object role.create(object/array roles)

Cette méthode vous permet de créer de nouveaux rôles.

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 User roles pour plus d'informations.

Paramètres

(object/array) Rôles à créer.

En plus des propriétés de rôle standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
rules array Règles de rôle à créer pour le rôle.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des rôles créés sous la propriété roleids. L'ordre des ID retournés correspond à l'ordre des rôles transmis.

Exemples

Création d’un rôle

Créez un rôle de type « Utilisateur » avec un accès refusé à deux éléments de l’interface utilisateur.

Requête :

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

Réponse :

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

Voir aussi

Source

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