Обновление unifiedRoleManagementPolicyRule

Пространство имен: microsoft.graph

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

Дополнительные сведения о правилах для ролей Microsoft Entra и примеры обновления правил см. в следующих статьях:

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Для PIM для Microsoft Entra ролей

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) RoleManagementPolicy.ReadWrite.Directory, RoleManagement.ReadWrite.Directory
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение RoleManagementPolicy.ReadWrite.Directory, RoleManagement.ReadWrite.Directory

В делегированных сценариях пользователю, выполнившему вход, также необходимо назначить по крайней мере одну из следующих Microsoft Entra ролей:

  • Для операций чтения: глобальный читатель, оператор безопасности, читатель безопасности, администратор безопасности или администратор привилегированных ролей.
  • Для операций записи: администратор привилегированных ролей

Для PIM для групп

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) RoleManagementPolicy.ReadWrite.AzureADGroup
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение RoleManagementPolicy.ReadWrite.AzureADGroup

HTTP-запрос

Чтобы обновить правило, определенное для политики, для Microsoft Entra ролей или групп в PIM:

PATCH /policies/roleManagementPolicies/{unifiedRoleManagementPolicyId}/rules/{unifiedRoleManagementPolicyRuleId}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

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

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
claimValue String Значение утверждения контекста проверки подлинности.

Можно обновить для типа правила unifiedRoleManagementPolicyAuthenticationContextRule .
enabledRules Коллекция строк Коллекция правил, включенных для этого правила политики. Например, MultiFactorAuthentication, Ticketingи Justification.

Можно обновить для типа правила unifiedRoleManagementPolicyEnablementRule .
isDefaultRecipientsEnabled Логический Указывает, будет ли получатель по умолчанию получать уведомление по электронной почте.

Можно обновить для типа правила unifiedRoleManagementPolicyNotificationRule .
isEnabled Boolean Включено ли это правило.

Можно обновить для типа правила unifiedRoleManagementPolicyAuthenticationContextRule .
isExpirationRequired Логический Указывает, требуется ли истечение срока действия или является ли это постоянно активным назначением или правомочности.

Можно обновить для типа правила unifiedRoleManagementPolicyExpirationRule .
maximumDuration Duration (Длительность) Максимальная продолжительность, допустимая для права на участие или назначение, которое не является постоянным. Требуется, если isExpirationRequired имеет значение true.

Можно обновить для типа правила unifiedRoleManagementPolicyExpirationRule .
notificationLevel String Уровень уведомления. Возможные значения: None, Critical, All.

Можно обновить для типа правила unifiedRoleManagementPolicyNotificationRule .
notificationRecipients Коллекция строк Список получателей Уведомления по электронной почте.

Можно обновить для типа правила unifiedRoleManagementPolicyNotificationRule .
notificationType String Тип уведомления. Поддерживается только Email .

Можно обновить для типа правила unifiedRoleManagementPolicyNotificationRule .
recipientType String Тип получателя уведомления. Возможные значения: Requestor, Approver, Admin.
Можно обновить для типа правила unifiedRoleManagementPolicyNotificationRule .
setting ApprovalSettings Параметры утверждения назначения роли.

Можно обновить для типа правила unifiedRoleManagementPolicyApprovalRule .
target unifiedRoleManagementPolicyRuleTarget Определяет сведения о область, предназначенных для правила политики управления ролями. Сведения могут включать тип субъекта, тип назначения роли и действия, влияющие на роль.

Можно обновить для всех типов правил.

Примечание: Свойство @odata.type со значением определенного типа правила должно быть включено в текст. Например, "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyApprovalRule".

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и объект unifiedRoleManagementPolicyRule в теле отклика.

Примеры

Пример 1. Обновление правила, определенного для политики в PIM, для Microsoft Entra ролей

Запрос

В следующем примере обновляется правило политики управления ролями типа unifiedRoleManagementPolicyExpirationRule с идентификатором Expiration_EndUser_Assignment.

PATCH https://graph.microsoft.com/v1.0/policies/roleManagementPolicies/DirectoryRole_84841066-274d-4ec0-a5c1-276be684bdd3_200ec19a-09e7-4e7a-9515-cf1ee64b96f9/rules/Expiration_EndUser_Assignment
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
    "id": "Expiration_EndUser_Assignment",
    "isExpirationRequired": true,
    "maximumDuration": "PT1H45M",
    "target": {
        "@odata.type": "microsoft.graph.unifiedRoleManagementPolicyRuleTarget",
        "caller": "EndUser",
        "operations": [
            "All"
        ],
        "level": "Assignment",
        "inheritableSettings": [],
        "enforcedSettings": []
    }
}

Отклик

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/roleManagementPolicies('DirectoryRole_84841066-274d-4ec0-a5c1-276be684bdd3_200ec19a-09e7-4e7a-9515-cf1ee64b96f9')/rules/$entity",
    "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
    "id": "Expiration_EndUser_Assignment",
    "isExpirationRequired": true,
    "maximumDuration": "PT1H45M",
    "target": {
        "caller": "EndUser",
        "operations": [
            "All"
        ],
        "level": "Assignment",
        "inheritableSettings": [],
        "enforcedSettings": []
    }
}

Пример 2. Обновление правила, определенного для политики в PIM для групп

Запрос

В следующем примере правило политики управления ролями обновляется с идентификатором Expiration_EndUser_Assignment.

PATCH https://graph.microsoft.com/v1.0/policies/roleManagementPolicies/Group_60bba733-f09d-49b7-8445-32369aa066b3_f21b26d9-9ff9-4af1-b1d4-bddf28591369/rules/Expiration_EndUser_Assignment
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
    "id": "Expiration_EndUser_Assignment",
    "isExpirationRequired": true,
    "maximumDuration": "PT1H45M",
    "target": {
        "caller": "EndUser",
        "operations": [
            "All"
        ],
        "level": "Assignment",
        "inheritableSettings": [],
        "enforcedSettings": []
    }
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/roleManagementPolicies('Group_60bba733-f09d-49b7-8445-32369aa066b3_f21b26d9-9ff9-4af1-b1d4-bddf28591369')/rules/$entity",
    "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
    "id": "Expiration_EndUser_Assignment",
    "isExpirationRequired": true,
    "maximumDuration": "PT1H45M",
    "target": {
        "caller": "EndUser",
        "operations": [
            "All"
        ],
        "level": "Assignment",
        "inheritableSettings": [],
        "enforcedSettings": []
    }
}