usergroup.create

Descrição

object usergroup.create(object/array userGroups)

Este método permite criar novos grupos de usuários.

Este método está disponível apenas para o tipo de usuário Super admin.
As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções do usuário para obter mais informações.

Parameters

(object/array) Grupos de usuários a serem criados.

Álem dos standard user group properties, o método aceito os seguinte parâmetros. ### Parâmetros

(object/array) Grupos de usuários a serem criados.

Além das propriedades do grupo de usuários padrão, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
rights	object/array	Permissões para atribuir ao grupo
tag_filters	array	Permissões baseadas em etiquetas para atribuir ao grupo
users	object/array	Usuários para adicionar ao grupo de usuários. O usuário deve ter a propriedade `userid` definida.
Parameter	Type	Description
--	--	------
rights	object/array	Permissions to assign to the group
tag_filters	array	Tag based permissions to assign to the group
users	object/array	Users to add to the user group. The user must have the `userid` property defined.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos grupos de usuários criados sob a propriedade usrgrpids. A ordem dos IDs retornados corresponde à ordem dos grupos de usuários passados.

Exemplos

Criando um grupo de usuários

Crie um grupo de usuários, que negue o acesso ao grupo de hosts "2", e adicione um usuário a ele.

Request:

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

Response:

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

Veja também

Permissão

Fonte

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

Documentation