Через API можно найти, просмотреть и изменить параметры пользователя, даже если он еще не принял приглашение в организацию.
Чтобы найти пользователя организации по идентификатору и посмотреть его параметры, выполните запрос:
curl -X GET --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users/<userId>' \--header 'accept: application/json' \--header 'Authorization: Bearer j8eAMouA15uA0VHPZeicNWa7SL'
Где:
customerId — идентификатор организации;
userId — идентификатор пользователя.
Выполните запрос:
curl -X GET --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users/find?email=<mail@example.com>&type=<USER_ACCOUNT_TYPE_LOCAL>' \--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/<customerId>/users/<userId>' \--header 'accept: application/json' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer j8eAMouA15uA0VHPZeicNWa7SL' \--data '{"firstName": "Ivan","lastName": "Ivanov","middleName": "Ivanovich","enabled": false}'
Где:
customerId — идентификатор организации;
userId — идентификатор пользователя;
firstName — имя пользователя, можно изменить;
lastName — фамилия пользователя, можно изменить;
middleName — отчество, можно изменить;
enabled:
true — пользователь разблокирован и может выполнять операции в организации;
false — пользователь заблокирован и не может выполнять операции в организации.
Локальный пользователь может быть приглашенным физическим лицом и входить в несколько организаций, поэтому его параметры менять нельзя.