Перейти к основному содержимому

Сервис управления сущностями ролей.

/services/identityadminapi/api/Roles/GetAll

Возвращает список всех ролей.

Тип HTTP запроса: post

Отсылаемый запрос

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResult[]Данные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetOne

Возвращает информацию о роли по идентификатору.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Уникальный идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetOneByName

Возвращает информацию о роли по имени.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Имя роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
namestringИмя записи.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Create

Добавляет новую роль.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Информация о новой роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
namestringНазвание роли.да
descriptionstringОписание.нет
providerNamestringИмя провайдера аутентификации, с которым необходимо связать новую роль.
Доступные значения:
"[provider_name]" - создаётся связь с указанным провайдером;
"" - связь не создаётся;
null - значение берётся из ASE.MD.Platform.Infrastructure.Identity.Core.Configurations.RolesSynchronization.
нет
ldapDomainIdinteger (int32)Идентификатор домена LDAP.нет
readOnlybooleanФлаг, указывающий, что объект доступен только для чтения.нет

Возвращаемые результаты

Код HTTP ответа: 201

MIME-тип HTTP ответа: application/json

Created

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 400

MIME-тип HTTP ответа: application/json

Bad Request

Название поляТип поляОписаниеОбязательноеВозможные значения
typestringнет
titlestringнет
statusinteger (int32)нет
detailstringнет
instancestringнет

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Update

Обновляет существующую роль.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Информация о роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор роли.да
namestringНазвание роли.нет
descriptionstringОписание.нет
readOnlybooleanФлаг, указывающий, что объект доступен только для чтения.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Delete

Удаляет существующую роль.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Уникальный идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GroupDelete

Удаление списка ролей (до 10 штук за раз).

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Список идентификаторов ролей.

Название поляТип поляОписаниеОбязательноеВозможные значения
idParamsGuidIdApiParam[]Список идентификаторов.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetUsers

Возвращает список пользователей роли.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Уникальный идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleUsersResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetUsersAmount

Возвращает количество пользователей для роли.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Уникальный идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetRoleChildren

Возвращает все роли в виде дерева.

Тип HTTP запроса: post

Отсылаемый запрос

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleChildrenResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetRoleParents

Возвращает список родительских ролей.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Уникальный идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResult[]Данные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/AddChild

Добавляет подгруппу в группу.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

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

Название поляТип поляОписаниеОбязательноеВозможные значения
parentIdstring (uuid)Идентификатор родительской роли.да
childIdstring (uuid)Идентификатор дочерней роли.да

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/RemoveChild

Удаляет подгруппу из группы.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

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

Название поляТип поляОписаниеОбязательноеВозможные значения
parentIdstring (uuid)Идентификатор родительской роли.да
childIdstring (uuid)Идентификатор дочерней роли.да

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/SetUsers

Добавляет пользователей в группу.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Идентификатор группы и список идентификаторов пользователей.

Название поляТип поляОписаниеОбязательноеВозможные значения
userIdsstring(uuid)[]Уникальный идентификатор пользователя.да
roleIdstring (uuid)Уникальный идентификатор роли.да

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/GetOneRoleChildren

Возвращает список всех дочерних ролей.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Идентификатор роли.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleInfoResult[]Данные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Claims/Create

Добавляет Claim для сущности.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Параметр добавления Claim.

Название поляТип поляОписаниеОбязательноеВозможные значения
claimOwnerIdstring (uuid)Идентификатор сущности, для которой добавляется Claim.да
typestringТип сущности.да
valuestringЗначение сущности.да

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleClaimResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Claims/GetAll

Возвращает список Claims для указанной сущности.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Идентификатор сущности.

Название поляТип поляОписаниеОбязательноеВозможные значения
idstring (uuid)Уникальный идентификатор.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultRoleClaimsResultда
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Claims/Update

Обновляет данные Claim для указанной сущности.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Параметры обновления Claim.

Название поляТип поляОписаниеОбязательноеВозможные значения
idinteger (int32)Уникальный идентификатор сущности.да
claimOwnerIdstring (uuid)Идентификатор сущности, для которой обновляется Claim.да
typestringТип сущности.нет
valuestringЗначение сущности.нет

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden

/services/identityadminapi/api/Roles/Claims/Delete

Удаляет Claim для указанной сущности.

Тип HTTP запроса: post

Отсылаемый запрос

MIME-тип HTTP запроса: application/json

Параметры удаления Claim.

Название поляТип поляОписаниеОбязательноеВозможные значения
idinteger (int32)Уникальный идентификатор сущности.да
claimOwnerIdstring (uuid)Идентификатор пользователя для Claim.да

Возвращаемые результаты

Код HTTP ответа: 200

MIME-тип HTTP ответа: application/json

Success

Название поляТип поляОписаниеОбязательноеВозможные значения
resultstringДанные результата метода API.да
errorInfoда
typeInfoTypeInfo

Код HTTP ответа: 401

MIME-тип HTTP ответа: text/plain

Unauthorized

Код HTTP ответа: 403

MIME-тип HTTP ответа: text/plain

Forbidden