Тип ресурса agentIdentity

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

Представляет удостоверение агента в Microsoft Entra ID. Удостоверение агента — это учетная запись, используемая агентами ИИ для проверки подлинности в экосистеме Microsoft Entra ID.

Наследует от servicePrincipal.

Этот ресурс имеет открытый тип, который допускает дополнительные свойства, помимо описанных здесь.

Методы

Метод	Тип возвращаемых данных	Описание
Список	Коллекция AgentIdentity	Получите список объектов agentidentity и их свойств.
Создание	AgentIdentity	Создание нового объекта agentidentity.
Получение	agentIdentity	Чтение свойств и связей объекта agentIdentity .
Обновление	agentIdentity	Обновление свойств объекта agentIdentity.
Delete	Нет	Удаление объекта agentIdentity.
Назначение ролей приложений
List appRoleAssignedTo	Коллекция appRoleAssignment	Получите удостоверения пользователей, групп и агентов, которым назначены роли приложений для этого удостоверения агента.
Перечисление appRoleAssignments	Коллекция appRoleAssignment	Получите роли приложений, назначенные этому удостоверению агента.
Создание объекта appRoleAssignment	appRoleAssignment	Создание нового объекта appRoleAssignment.
Удаление объекта AppRoleAssignment	appRoleAssignment	Удаление существующего объекта appRoleAssignment.
Предоставление делегированных разрешений
Перечисление oauth2PermissionGrants	Коллекция oAuth2PermissionGrant	Получите делегированные разрешения, разрешающие этому удостоверению агента доступ к API от имени вошедшего в систему пользователя.
Удаленные элементы
List	Коллекция directoryObject	Получите список недавно удаленных удостоверений агентов.
Получение	directoryObject	Получите свойства недавно удаленного удостоверения агента.
Восстановление	directoryObject	Восстановите недавно удаленное удостоверение агента.
Удалить без возможности восстановления	Нет	Окончательное удаление удостоверения агента.
Объекты каталога
Список ownedObjects	Коллекция directoryObject	Получите объекты каталога, принадлежащие этому удостоверению агента.
Членство
Указание прямых статусов	Коллекция directoryObject	Получите группы, непосредственным участником которых является удостоверение агента.
Вывод списка транзитивных членств	Коллекция directoryObject	Получите группы, участником которых является удостоверение агента. Эта операция транзитивна и включает группы, участником которых является удостоверение агента.
Владельцы
Список владельцев	Коллекция directoryObject	Получите владельцев удостоверения агента.
Добавление владельцев	directoryObject	Добавьте владельцев, выполнив публикацию в коллекции владельцев.
Удаление владельцев	Нет	Удаление объекта directoryObject .
Спонсоры
Список спонсоров	Коллекция directoryObject	Найдите спонсоров для этого удостоверения агента.
Добавление спонсоров	directoryObject	Добавление спонсоров путем публикации в коллекции спонсоров.
Удаление спонсоров	Нет	Удаление объекта directoryObject .

Свойства

Важно!

Хотя этот ресурс наследует от servicePrincipal, некоторые свойства неприменимы.

Свойство	Тип	Описание
odata.type	String	#microsoft.graph.agentIdentity. Выделяет этот объект как идентификатор агента. Можно использовать для идентификации этого объекта как удостоверение агента вместо другого типа субъекта-службы.
accountEnabled	Логический	true Если включена учетная запись удостоверения агента; в противном случае, false. Если установлено значение false, то пользователи не смогут войти в это приложение, даже если им оно назначено. Наследуется от servicePrincipal.
agentIdentityBlueprintId	String	AppId схемы удостоверений агента, которая определяет конфигурацию для этого удостоверения агента.
customSecurityAttributes	customSecurityAttributeValue	Открытый сложный тип, который содержит значение настраиваемого атрибута безопасности, назначенного объекту каталога. Допускается значение null. Требуется $select получение. Наследуется от servicePrincipal.
createdByAppId	String	AppId приложения, создавшего удостоверение агента. Внутренняя настройка с помощью Microsoft Entra ID. Только для чтения. Наследуется от servicePrincipal.
createdDateTime	DateTimeOffset	Дата и время создания удостоверения агента. Только для чтения. Наследуется от servicePrincipal.
disabledByMicrosoftStatus	Строка	Указывает, отключила ли корпорация Майкрософт схему удостоверений зарегистрированного агента. Возможные значения: null (значение по умолчанию), NotDisabledи DisabledDueToViolationOfServicesAgreement (причины могут включать подозрительные, оскорбительные или злонамеренные действия или нарушение соглашения об использовании служб Майкрософт). Наследуется от servicePrincipal.
displayName	String	Отображаемое имя для удостоверения агента. Наследуется от servicePrincipal.
id	String	Уникальный идентификатор для удостоверения агента. Наследуется от directoryObject. Ключ. Значение null не допускается. Только для чтения. Наследуется от сущности.
managerApplications	Коллекция объектов Guid	Коллекция идентификаторов приложений, назначенных в качестве менеджеров резервного агента удостоверения агентаIdentityBlueprint. Только для чтения; Значение управляется сервером и отражает Manager Applications резервного агента IdentityBlueprint. Чтобы сменить менеджеров, владелец или администратор должен обновить свойство managerApplications на резервном agentIdentityBlueprint в клиенте, где оно зарегистрировано. Для схем удостоверений многотенантных агентов администраторы в клиенте, где схема только используется, не могут внести это изменение — они должны попросить владельца или администратора в домашнем клиенте схемы. Значение null не допускается. Возвращается только с помощью оператора $select.
servicePrincipalType	Строка	Установите ServiceIdentity для всех удостоверений агента. Наследуется от servicePrincipal.
tags	Коллекция String	Пользовательские строки, которые можно использовать для классификации и идентификации удостоверения агента. Значение null не допускается. Значение представляет собой объединение строк, заданных здесь и в свойстве tags связанного объекта Agent Identity Blueprint. Наследуется от servicePrincipal.

Связи

Связь	Тип	Описание
appRoleAssignedTo	Коллекция appRoleAssignment	Назначения ролей приложения для этого приложения или службы, предоставленные пользователям, группам и другим удостоверениям агентов. Поддерживает $expand. Наследник от microsoft.graph.servicePrincipal
appRoleAssignments	Коллекция appRoleAssignment	Назначение роли приложения для другого приложения или службы, предоставленное этому удостоверению агента. Поддерживает $expand. Наследник от microsoft.graph.servicePrincipal
createdObjects	Коллекция directoryObject	Объекты каталога, созданные этим удостоверением агента. Только для чтения. Допускается значение null. Наследник от microsoft.graph.servicePrincipal
memberOf	Коллекция directoryObject	Роли, участником которых является удостоверение агента. Методы HTTP: GET. Только для чтения. Допускается значение null. Поддерживает $expand. Наследник от microsoft.graph.servicePrincipal
oauth2PermissionGrants	Коллекция oAuth2PermissionGrant	Делегированные разрешения предоставляют, разрешая этому удостоверению агента доступ к API от имени вошедшего пользователя. Только для чтения. Допускается значение null. Наследник от microsoft.graph.servicePrincipal
ownedObjects	Коллекция directoryObject	Объекты каталога, принадлежащие этому удостоверению агента. Только для чтения. Допускается значение null. Поддерживает $expand и $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1). Наследник от microsoft.graph.servicePrincipal
owners	Коллекция directoryObject	Объекты каталога, которые являются владельцами этого удостоверения агента. Владельцы — это набор пользователей без прав администратора или удостоверений агента, которым разрешено изменять этот объект. Поддерживает $expand и $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1). Наследник от microsoft.graph.servicePrincipal
спонсоры	Коллекция directoryObject	Спонсоры этого удостоверения агента.

Представление JSON

В следующем представлении JSON показан тип ресурса. По умолчанию возвращается только подмножество всех свойств. Все остальные свойства можно получить только с помощью $select.

{
  "@odata.type": "#microsoft.graph.agentIdentity",
  "id": "String (identifier)",
  "accountEnabled": "Boolean",
  "agentIdentityBlueprintId": "String",
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "disabledByMicrosoftStatus": "String",
  "displayName": "String",
  "managerApplications": [
    "Guid"
  ],
  "servicePrincipalType": "String",
  "tags": [
    "String"
  ]
}