tocdepth

2

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

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

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

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

curl --location 'https://iam.api.cloud.ru/api/v1/customers/<customerId>/users?email=<email>&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 — Имя пользователя. Поиск может выполняться по части имени пользователя.

    Подсказка

    Пользователей можно искать по 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=<email>&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 — Имя пользователя. Поиск может выполняться по части имени пользователя.

    Подсказка

    Пользователей можно искать по email, по username или по обоим параметрам.

  • 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": ""
  }
}
Запустили Evolution free tier
для Dev & Test
Получить