Настройки и администрирование

Поиск, просмотр и изменение параметров пользователей

Через API можно найти, просмотреть и изменить параметры пользователя, даже если он еще не принял приглашение в организацию.

Найти пользователя по ID

Чтобы найти пользователя организации по идентификатору и посмотреть его параметры, выполните запрос:

curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users/<userId>' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer j8eAMouA15uA0VHPZeicNWa7SL'

Где:

customerId — идентификатор организации;
userId — идентификатор пользователя.

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

Найти пользователя по email

Выполните запрос:

curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users/find?email=<mail@example.com>&type=USER_ACCOUNT_TYPE_UNDEFINED' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer j8eAMouA15uA0VHPZeicNWa7SL'

Где:

customerId — идентификатор организации;
email — email пользователя;
type — тип пользователя:
- USER_ACCOUNT_TYPE_LOCAL — будут найдены только локальные пользователи;
- USER_ACCOUNT_TYPE_FEDERATED — будут найдены только федеративные пользователи;
- USER_ACCOUNT_TYPE_UNDEFINED — будут найдены и локальные, и федеративные пользователи.

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

Коды ошибок

Изменить параметры федеративного пользователя

Чтобы изменить параметры, выполните запрос:

curl -X PUT --location 'https://iam.api.cloud.ru/api/v1/customers/<customersId>/users/<userId>' \
     --header 'accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer j8eAMouA15uA0VHPZeicNWa7SL' \
     --data '{
       "firstName": "Ольга",
       "lastName": "Иванова",
       "middleName": "Ивановна",
       "enabled": false
     }'

Где:

customerId — идентификатор организации;
userId — идентификатор пользователя;
firstName — имя пользователя, можно изменить;
lastName — фамилия пользователя, можно изменить;
middleName — отчество, можно изменить;
enabled:
- true — пользователь разблокирован и может выполнять операции в организации;
- false — пользователь заблокирован и не может выполнять операции в организации.

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

Примечание

Из-за того, что локальный пользователь может быть приглашенным физическим лицом и состоять в нескольких организациях, его параметры нельзя изменять.

См.также

Где найти ID организации?

Предыдущая статья

Изменение прав пользователей

Следующая статья

Отзыв прав пользователя

Была ли эта статья полезна?

Поддержка Юридические документы

Evolution

Advanced

Облако VMware