Update agentIdentityBlueprintPrincipal

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

Обновление свойств объекта agentIdentityBlueprintPrincipal .

Важно!

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

Разрешения

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

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

Важно!

  • Субъект, создающий схему удостоверения агента или субъект схемы, автоматически назначается в качестве владельца.
  • Владельцы могут создавать и изменять удостоверения агента, связанные с схемой, которой они владеют, без назначения роли идентификатора агента.
  • Чтобы пользователи, не являющиеся владельцем, вызывали этот API в делегированных сценариях с использованием рабочих или учебных учетных записей, администратору должна быть назначена поддерживаемая роль Microsoft Entra. Эта операция поддерживает следующую встроенную роль с наименьшими привилегиями:

Разрешения для определенных сценариев

  • Чтобы обновить свойство customSecurityAttributes , выполните следующие действия:
    • В делегированных сценариях администратору должна быть назначена роль администратора назначения атрибутов , а приложению — делегированное разрешение CustomSecAttributeAssignment.ReadWrite.All .
    • В сценариях только для приложений, использующих разрешения Microsoft Graph, приложению должно быть предоставлено разрешение CustomSecAttributeAssignment.ReadWrite.All .

HTTP-запрос

PATCH /servicePrincipals/{id}/microsoft.graph.agentIdentityBlueprintPrincipal

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

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

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

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

Укажите обновленные значения свойств для субъекта схемы удостоверения агента.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Сведения об ошибках, возвращаемых API-интерфейсами удостоверений агента, см. в разделе Коды ошибок удостоверений агента.

Пример

Запрос

В следующем примере показан запрос на обновление субъекта схемы удостоверения агента.

PATCH https://graph.microsoft.com/v1.0/servicePrincipals/{id}/microsoft.graph.agentIdentityBlueprintPrincipal
Content-type: application/json

{
  "appRoleAssignmentRequired": true
}

Отклик

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

HTTP/1.1 204 No Content
  • Last updated on