role.create

Description

object role.create(object/array roles)

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

Cette méthode est uniquement disponible 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. Voir 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 également

  • [Règles de rôle] (object#role_rules)
  • [Elément de l'interface utilisateur] (objet#ui_element)
  • Module
  • Action

Source

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