Privileged Identity Management — ресурсы Azure
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Эта версия API Privileged Identity Management (PIM) для ресурсов Azure скоро перестанет поддерживаться. Используйте новый REST API PIM Azure для ролей ресурсов Azure.
Вы можете использовать Microsoft Entra управление привилегированными пользователями (PIM) для ресурсов Azure, чтобы настроить рабочий процесс JIT-доступа для ролей инфраструктуры Azure на уровне группы управления, подписки, группы ресурсов и ресурсов. Это относится как ко встроенным ролям, таким как "Владелец" и "Участник", так и к настраиваемым ролям RBAC.
Основные варианты использования службы PIM и ресурсов Azure с помощью REST API.
| Вариант использования | Ресурс | См. также |
|---|---|---|
| Подключение ресурса (подписок, группы ресурсов, ресурса и т. п.) для управления PIM, создание списка всех управляемых ресурсов, доступных для инициатора запроса, получение отношений управляемого ресурса. | governanceResource | Обнаружение ролей и управление ими |
| Список всех ролей ресурса или получение сведений об определенной роли указанного ресурса. | governanceRoleDefinition | |
| Получение всех параметров роли для ресурса или обновление параметра роли. | governanceRoleSetting | Изменение параметров роли |
| Отображение списка и экспорт всех назначений ролей для ресурса. | governanceRoleAssignment | Экспорт назначений ролей |
| Создание или удаление допустимого или активного назначения роли, активация и деактивация допустимого назначения, просмотр списка ожидающих запросов, утверждение или отказ ожидающего запроса, отмена вашего собственного ожидающего запроса. | governanceRoleAssignmentRequest |
Назначение ролей Активация ролей Утверждение запросов |
Миграция в API-интерфейсы PIM Azure Resource Manager для ролей ресурсов Azure
API итерации 3 PIM для управления ресурсами Azure теперь доступен через ИНТЕРФЕЙСы REST API Azure Resource Manager. Используйте это руководство для переноса существующих API в новые API Resource Manager Azure.
В следующей таблице описано, как API Resource Manager PIM Azure сопоставляется с существующими API Microsoft Graph.
| Operation | Microsoft API Graph (итерация 2) | API Resource Manager Azure (итерация 3) |
|---|---|---|
| Регистрация ресурса | Регистрация | Resource Manager не требует явной регистрации или подключения ресурсов для управления. Вы можете выполнять операции напрямую с помощью области ресурсов. |
| Перечисление определений ролей | Перечисление определений ролей | Определения ролей — список |
| Создание запросов на назначение ролей | Создание governanceRoleAssignmentRequest | Используйте запросы на планирование допустимости ролей — создание для создания допустимых назначений ролей Используйте запросы на планирование назначений ролей — создание для создания активных назначений ролей |
| Список назначений ролей | Перечисление governanceRoleAssignments | Используйте экземпляры планирования допустимости ролей — перечисление для получения допустимых назначений ролей Используйте экземпляры планирования назначений ролей — перечисление для получения активных назначений ролей |
| Управление параметрами ролей |
Перечисление governanceRoleSettings Обновление governanceRoleSetting |
Управление политиками с помощью azure Resource Manager |