tocdepth: 2

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

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

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

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

curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users?email=<username>&limit=50&accountType=USER_ACCOUNT_TYPE_UNDEFINED' \

     --header 'accept: application/json' \
     --header 'Authorization: Bearer <аутентификационный токен>'

Где:

customerId — Идентификатор организации. Параметр можно найти в URL вашего проекта https://console.cloud.ru/projects/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/spa/svp?customerId=5а5bаbа5-a55b-55a5-ab55-ab5aab55ab55.
email — Электронная почта пользователя. Поиск может выполняться по частичному совпадению.
username — Имя пользователя. Поиск может выполняться по части имени пользователя.
limit — Количество записей в ответе.
before — Получение предыдущей страницы пользователей.
after — Получение следующей страницы пользователей.
accountType — Тип аккаунта пользователя (необязательный):
- USER_ACCOUNT_TYPE_UNDEFINED — В ответе будут выведены и локальные, и федеративные пользователи.
- USER_ACCOUNT_TYPE_LOCAL — Выводятся только локальные пользователи.

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

{
{
  "users": [
      {
          "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_LOCAL"
      }
  ],
  "limit": 50,
  "cursor": {
      "before": "",
      "after": ""
  }
}

Посмотреть список федеративных пользователей

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

curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users?email=<useremail>&limit=50&accountType=USER_ACCOUNT_TYPE_UNDEFINED' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <аутентификационный токен>'

Где:

customerId — Идентификатор организации. Можно найти в URL вашего проекта https://console.cloud.ru/projects/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/spa/svp?customerId=5а5bаbа5-a55b-55a5-ab55-ab5aab55ab55.
useremail — Электронная почта пользователя. Поиск может выполняться по частичному соответствию.
limit — Количество записей на странице.
before — Получение предыдущей страницы пользователей.
after — Получение следующей страницы пользователей.
accountType — Тип аккаунта пользователя (необязательный):
- USER_ACCOUNT_TYPE_UNDEFINED — В ответе будут выведены и локальные, и федеративные пользователи.
- USER_ACCOUNT_TYPE_FEDERATED — Выводятся только федеративные пользователи.

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

{
{
  "users": [
      {
          "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"
      }
  ],
  "limit": 50,
  "cursor": {
      "before": "",
      "after": ""
  }
}

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