role.create

Description

object role.create(object/array roles)

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

Cette méthode est seulement disponible pour les utilisateurs du type Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir Rôles utilisateur 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 avec le type "Utilisateur" et refusez l'accès à 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"
                }
            ]
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "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.