Метод работы с учётными записями администраторов

Для работы с учётными записями администраторов выполните запросы с помощью API-метода accounts (перед выполнением запроса определите токен администратора):

добавление учётной записи локального администратора:

curl -X POST -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/local/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>' -d '{
    "username": "<логин локального администратора>",
    "password": "<пароль локального администратора>",
    "confirmed_password": "<повторный пароль локального администратора>",
    "is_active": <признак активности локального администратора (true/false)>,
    "full_name": "<ФИО>",
    "email": "<e-mail>",
    "time_zone": "<временная зона>"
}'

В подстановке <временная зона> используйте одно из значений, содержащихся в раскрывающемся списке «Временная зона».

Пример ответа:

{
    "id": 2,
    "username": "new_admin",
    "is_active": true,
    "full_name": "FIO",
    "email": "user@example.com",
    "time_zone": "(UTC+03:00) Europe/Chisinau"
}

получение информации о конкретной учётной записи локального администратора:

curl -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/local/<идентификатор запрашиваемого администратора>/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>'

Пример ответа:

{
    "id": 3,
    "username": "admin",
    "is_active": true,
    "full_name": "admin admin admin",
    "email": "admin@example.com",
    "time_zone": "Europe/Moscow"
}

изменение учётной записи локального администратора:

curl -X PUT -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/local/<идентификатор запрашиваемого администратора>/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>' -d '{
    "username": "<логин локального администратора>",
    "is_active": <признак активности локального администратора (true/false)>,
    "full_name": "<ФИО>",
    "email": "<e-mail>",
    "time_zone": "<временная зона>"
}'

В подстановке <идентификатор запрашиваемого администратора> используйте значение параметра id, которое возвращается при получении списка всех учётных записей администраторов, а в подстановке <временная зона> используйте одно из значений, содержащихся в раскрывающемся списке «Временная зона».

Пример ответа:

{
    "id": 3,
    "username": "admin_3",
    "is_active": false,
    "full_name": "admin admin admin",
    "email": "admin@example.com",
    "time_zone": "Europe/Moscow"
}

сброс пароля учётной записи локального администратора:

curl -X POST -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/local/<идентификатор запрашиваемого администратора>/reset-password/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>' -d '{ "password": "<новый пароль>", "confirmed_password": "<повторно новый пароль>"}'

Пример ответа:

200

добавление учётной записи администратора из LDAP:

curl -X POST -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/ldap/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>' -d '{"time_zone": <временная зона>, "ldap_sid": <идентификатор SID администратора из LDAP>}'

Пример ответа:

{
    "id": 4,
    "is_active": true,
    "full_name": "testusers_3249",
    "email": "",
    "time_zone": "Europe/Moscow"
}

получение информации о конкретной учётной записи администратора из LDAP:

curl -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/ldap/<идентификатор запрашиваемого администратора>/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>'

Пример ответа:

{
    "id": 5,
    "is_active": true,
    "full_name": "testusers_3251",
    "email": "",
    "time_zone": "Europe/Moscow"
}

изменение учётной записи администратора из LDAP:

curl -X PUT -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/ldap/<идентификатор запрашиваемого администратора>/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>' -d '{"time_zone": <временная зона>, "ldap_sid" :<идентификатор SID администратора из LDAP>}'

Пример ответа:

{
    "id": 5,
    "is_active": true,
    "full_name": "testusers_3251",
    "email": "",
    "time_zone": "Europe/Chisinau"
}

получение списка всех учётных записей администраторов:

curl -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>'

Пример ответа:

{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 5,
            "username": "admin",
            "full_name": "",
            "is_active": true,
            "is_ldap": false,
            "is_superuser": false,
            "is_request_user": false,
            "time_zone": "Europe/Moscow"
        },
        {
            "id": 1,
            "username": "superuser",
            "full_name": "",
            "is_active": true,
            "is_ldap": false,
            "is_superuser": true,
            "is_request_user": true,
            "time_zone": "Europe/Moscow"
        }
    ]
}

удаление учётной записи администратора:

curl -X DELETE -v '<IP-адрес или DNS-имя сервера>/api/v2/accounts/staff/<идентификатор запрашиваемого администратора>/' --header 'Content-Type: application/json' -H 'Authorization: Bearer <токен администратора>'

Пример ответа:

204 No Content

См. также:

API сервера