usergroup.create

Apraksts

object usergroup.create(object/array userGroups)

Šī metode ļauj izveidot jaunas lietotāju grupas.

Šī metode ir pieejama tikai Super admin lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object/array) Izveidojamās lietotāju grupas.

Papildus standarta lietotāju grupas īpašībām metode pieņem šādus parametrus.

Parameter Type Description
hostgroup_rights object/array Hostu grupu atļaujas, ko piešķirt lietotāju grupai.
templategroup_rights object/array Veidņu grupu atļaujas, ko piešķirt lietotāju grupai.
tag_filters array Ar tagiem balstītas atļaujas, ko piešķirt lietotāju grupai.
users object/array Lietotāji, ko pievienot lietotāju grupai.

Lietotājam jābūt definētam tikai userid īpašumam.
rights
(deprecated)		 object/array Šis parametrs ir novecojis, lūdzu, tā vietā izmantojiet hostgroup_rights vai templategroup_rights.
Atļaujas, ko piešķirt lietotāju grupai.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur izveidoto lietotāju grupu ID īpašībā usrgrpids. Atgriezto ID secība atbilst nodoto lietotāju grupu secībai.

Piemēri

Lietotāju grupas izveide

Izveidojiet lietotāju grupu Operation managers ar liegtu piekļuvi hostu grupai "2" un pievienojiet tai lietotāju.

Pieprasījums:

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

Atbilde:

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

Skatiet arī

Avots

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