API SCIM

Важно!

Эта функция предоставляется в режиме общедоступной предварительной версии.

Azure Databricks поддерживает использование SCIM (System for Cross-domain Identity Management) — открытого стандарта для автоматической подготовки пользователей с помощью REST API и JSON. API SCIM в Azure Databricks соответствует версии 2.0 протокола SCIM.

Требования

У учетной записи Azure Databricks должен быть план Azure Databricks уровня "Премиум".

API SCIM

Администратор рабочей области Azure Databricks может вызывать все конечные точки API SCIM:

Пользователи, не являющиеся администраторами, а также субъекты-службы могут вызывать конечную точку получения собственных данных, конечную точку получения данных о пользователях для отображения имен и идентификаторов пользователей, а также конечную точку получения данных о группах для показа отображаемых имен и идентификаторов групп.

Вызов API SCIM рабочей области

Для рабочих областей API SCIM в примерах измените на <databricks-instance> URL-адрес рабочей области своего развертывания Azure Databricks.

https://<databricks-instance>/api/2.0/preview/scim/v2/<api-endpoint>

Параметры заголовка

Параметр Type Описание
Authorization (обязательно) STRING Задайте значение Bearer <access-token>.

Сведения о создании маркеров см. в статьях Аутентификация с помощью личных маркеров доступа Azure Databricks, Аутентификация с помощью маркеров Azure Active Directory и API маркеров.

Важно! Администратор Azure Databricks, который создает этот токен, не должен управляться поставщиком удостоверений (IdP). Подготовку администратора Azure Databricks, который управляется IdP, можно отменить с помощью IdP, что приведет к отключению интеграции подготовки SCIM.
Content-Type (обязательно для операций записи) STRING Задайте значение application/scim+json.
Accept (обязательно для операций чтения) STRING Задайте значение application/scim+json.

Фильтрация результатов

Используйте фильтры для выделения набора пользователей или групп. Поля userName для пользователя и displayName для группы поддерживаются для всех пользователей. Администраторы могут отфильтровать список пользователей по атрибуту active.

Оператор Описание Поведение
eq equals (равно) Значения атрибута и оператора должны быть одинаковыми.
ne не равно Значения атрибута и оператора не являются одинаковыми.
co contains Значение оператора должно быть подстрокой значения атрибута.
sw начинается с Атрибут должен начинаться со значения оператора и включать его.
и логическое И Соответствие, если все выражения имеют значение true.
или диспетчер конфигурации служб логическое ИЛИ Соответствие, если какое-либо из выражений имеет значение true.

Сортировка результатов

Отсортируйте результаты с помощью параметров запроса sortBy и sortOrder. По умолчанию выбрана сортировка по идентификатору.

Список всех API SCIM