Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

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

Fonte

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