role.create

Beschrijving

objectrol.create(object/array-rollen)

Deze methode maakt het mogelijk om nieuwe rollen aan te maken.

Deze methode is alleen beschikbaar voor het gebruikerstype Superbeheerder. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zien Gebruiker rollen voor meer informatie.

Parameters

(object/array) Rollen om aan te maken.

Naast de standaard roleigenschappen, is de methode accepteert de volgende parameters.

Parameter Type Beschrijving
rules array Rol regels die voor de rol moeten worden gemaakt.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte rollen bevat onder de eigenschap roleids. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven rollen.

Voorbeelden

Een rol maken

Maak een rol met het type "Gebruiker" en krijg geen toegang tot twee UI-elementen.

Verzoek:

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

Antwoord:

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

Zie ook

Bron

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