Изменение учетной записи администратора

Параметры запроса

Параметр

Описание

Обязательный

add-group

Идентификатор группы, к которой получит доступ администратор.

Параметр может быть указан в запросе неограниченное количество раз для указания нескольких групп одновременно.

нет

delete-group

Идентификатор группы, к которой будет отменен доступ администратору.

Параметр может быть указан в запросе неограниченное количество раз для указания нескольких групп одновременно.

нет

description

Описание

нет

id

Идентификатор учетной записи администратора, параметры которой будут изменены

да

last-name

Фамилия

нет

login

Регистрационное имя учетной записи администратора

нет

may-create-admin

Наличие права на создание учетных записей администраторов, групп администраторов.

Допустимые значения: yes | no. По умолчанию: yes.

нет

middle-name

Отчество

нет

name

Имя

нет

password

Пароль

нет

readonly

Ограничение прав учетной записи администратора.

Допустимые значения: yes | no. По умолчанию: no.
Если задано значение yes, то администратор будет иметь право только на чтение (см. Приложение А2. Права администратора).

нет

Если одновременно заданы параметры readonly=yes и may-create-admin=yes, то параметр readonly является приоритетным. Т. е. администратор с правами только на чтение не может создавать или изменять настройки учетных записей других администраторов.

 

Администратор не может изменять параметры may-create-admin, readonly и group для своей учетной записи.

 

Пример запроса

https://192.168.1.1:9081/api/admins/change.ds?id=adm3&login=newadm3&password=root&name=name&last-name=last-name&middle-name=middle-name&description=description&add-group=1&readonly=yes&may-create-admin=no

Ниже представлены примеры ответов в формате XML и в формате JSON.

 

Ответ в формате XML

<drweb-es-api api_version="4.3.2" timestamp="1582030255" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <administrator id="adm3"/>
</drweb-es-api>

 

Описание параметров ответного XML

Элемент <administrator /> содержит идентификатор измененной учетной записи администратора.

Атрибут элемента <administrator />:

Атрибут

Описание

id

Идентификатор учетной записи

 

Ответ в формате JSON

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

    "timestamp": 1582030515,

    "api": {
      "version": 40302,
      "versionString": "4.3.2"},

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

      "version": "13.00.0.202005090",
      "uuid": "eae1a652-96d5-48fd-9169-4788a03688b8"}},

"data": {
    "id": "adm3"}}

 

Описание параметров ответного JSON

Блок data содержит идентификатор измененной учетной записи администратора.

Элемент блока data:

Название поля

Описание

id

Идентификатор учетной записи