Create an Administrator Group

Request Parameters

Parameter

Description

Mandatory

description

Administrator group description

no

admin_group

Parent administrator group ID.

If this parameter is not specified in a request, a new group will be created inside the group of administrator who initiated the request.

no

name

Administrator group name

yes

 

Request Example

https://192.168.1.1:9081/api/admingroups/add.ds?name=new1&admin_group=fe76cc50-8d2b-11ea-6efc-502672a1498e

XML and JSON response structure examples are described below.

 

XML Response Structure

<drweb-es-api api_version="4.3.0" timestamp="1588503092" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <admin-group id="0d20c3f0-8d2c-11ea-6efe-502672a1498e"/>
</drweb-es-api>

 

Description of XML Response Parameters

The <admin-group /> element contains a newly created administrator group ID.

The <admin-group /> element attribute:

Attribute

Description

id

Group ID

 

JSON Response Structure

{ "head": {
    "status": true,

    "timestamp": 1588503165,

    "api": {
      "version": 40300,
      "versionString": 4.3.0},

    "server": {
      "name": "192.168.1.1",

      "version": "13.00.0.202005090",
      "uuid": "78b77680-8080-11ea-701a-44a527d9115c"}},

"data": {
    "id": "38542ee0-8d2c-11ea-6f00-502672a1498e"}}

 

Description of JSON Response Parameters

The data block contains a newly created administrator group ID.

The data block element:

Field name

Description

id

Group ID