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 grupu īpašībām metode pieņem šādus parametrus.

Parametrs Tips Apraksts
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 Uz birkām 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ētai tikai userid īpašībai.

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.