- tocdepth
2
Просмотр и обновление параметров пользователя
Можно посмотреть параметры пользователя, выполнив поиск нужной записи по ID или email.
Найти пользователя по ID
Чтобы найти пользователя организации по идентификатору и посмотреть его параметры, выполните запрос:
curl --location 'https://iam.api.cloud.ru/v1/customers/<customerId>/users/<userId>' \
--header 'accept: application/json' \
--header 'Authorization: Bearer <аутентификационный токен>'
Где:
customerId
— идентификатор организации;userId
— идентификатор пользователя.
Пример ответа
{ "user": { "user_id": "exxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "username": "ivanovivan@gmail.com", "email": "ivanovivan@gmail.com", "account_type": "USER_ACCOUNT_TYPE_LOCAL" } }
Найти пользователя по email
Выполните запрос:
curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users/find?email=<ivanovivan@gmail.com>&type=USER_ACCOUNT_TYPE_UNDEFINED' \
--header 'accept: application/json' \
--header 'Authorization: Bearer ey***A'
Где:
customerId
— Идентификатор организации.email
— Электронная почта пользователя.type
— Тип пользователя:USER_ACCOUNT_TYPE_LOCAL
— Будут найдены только локальные пользователи.USER_ACCOUNT_TYPE_FEDERATED
— Будут найдены только федеративные пользователи.USER_ACCOUNT_TYPE_UNDEFINED
— Будут найдены и локальные, и федеративные пользователи.
Пример ответа
{ "user": { "user_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "username": "ivanovivan@gmail.com", "email": "ivanovivan@gmail.com", "first_name": "Иван", "last_name": "Иванов", "middle_name": "Иванович", "enabled": true, "account_type": "USER_ACCOUNT_TYPE_FEDERATED" } }
Коды ошибок
404 Not Found
Задан не тот параметр в
type
и по введенным параметрам пользователь не был найден.Пример:
{ "code": 5, "message": "user not found by email and namespace_id", "details": [] }400 Bad Request
В запросе не задан email, в результате чего найден больше, чем один пользователь. Нужно сузить критерии поиска.
Пример:
{ "code": 3, "message": "duplicated users found by email and namespace_id: specify account type to narrow down search", "details": [] }
для Dev & Test