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 atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā User roles.

Parametri

(object/array) Lietotāju grupas, kas jāizveido.

Papildus standarta lietotāju grupas rekvizītiem metode pieņem šādus parametrus.

Parameter Type Description
hostgroup_rights object/array Saimniekdatoru grupu atļaujas, kas jāpiešķir lietotāju grupai.
proxies object/array Starpniekserveri, kas jāsaista ar lietotāju grupu.
Starpniekserveriem drīkst būt definēts tikai rekvizīts proxyid.
proxy_groups object/array Starpniekserveru grupas, kas jāsaista ar lietotāju grupu.
Starpniekserveru grupām drīkst būt definēts tikai rekvizīts proxy_groupid.
templategroup_rights object/array Veidņu grupu atļaujas, kas jāpiešķir lietotāju grupai.
tag_filters array Uz tagiem balstītas atļaujas, kas jāpiešķir lietotāju grupai.
users object/array Lietotāji, kas jāpievieno lietotāju grupai.

Lietotājam drīkst būt definēts tikai rekvizīts userid.

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.