usergroup.create

Beschrijving

object gebruikersgroep.create(object/array gebruikersgroepen)

Met deze methode kunnen nieuwe gebruikersgroepen worden aangemaakt.

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) Gebruikersgroepen om aan te maken.

Naast de standaard eigenschappen van de gebruikersgroep, de methode accepteert de volgende parameters.

Parameter	Type	Beschrijving
rights	object/array	Permissies om aan de groep toe te wijzen
tag_filters	array	Op tags gebaseerde machtigingen om aan de groep toe te wijzen
users	object/array	Users om toe te voegen aan de gebruikersgroep. De gebruiker moet de eigenschap `userid` hebben gedefinieerd.

Retourwaarden

(object) Retourneert een object dat de ID's van de aangemaakte gebruiker bevat groepen onder de eigenschap usrgrpids. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven gebruikersgroepen.

Voorbeelden

Een gebruikersgroep maken

Maak een gebruikersgroep die toegang tot hostgroep "2" weigert, en voeg a . toe gebruiker ernaartoe.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "usergroup.create",
           "params": {
               "name": "Operation managers",
               "rights": {
                   "permission": 0,
                   "id": "2"
               },
               "users": [
                   {"userid": "12"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "usrgrpids": [
                   "20"
               ]
           },
           "id": 1
       }

Zie ook

Toestemming

Bron

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

Documentation