Тип ресурса riskyAgent

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет агенты Microsoft Entra, которые подвергаются риску, оцениваемые Microsoft Entra ID Protection на основе различных сигналов и машинного обучения. Этот API предоставляет программный доступ ко всем агентам с риском в клиенте Microsoft Entra. @odata.type указывает точный тип этого агента. Поддерживаемые типы: riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal и riskyAgentUser.

Наследует от сущности.

Методы

Метод Тип возвращаемых данных Описание
Список Коллекция riskyAgent Получите список объектов riskyAgent и их свойств.
Получение riskyAgent Чтение свойств и связей объекта riskyAgent .
Dismiss Нет Устраните риск, связанный с одним или несколькими объектами riskyAgent.
Подтвердить скомпрометированный Нет Убедитесь, что один или несколько объектов RiskyAgent скомпрометировались.
Подтверждение безопасности Нет Подтвердите безопасность одного или нескольких объектов RiskyAgent.

Свойства

Свойство Тип Описание
agentDisplayName String Имя агента.

Поддерживает $filter (eq, startsWith).
blueprintId String Идентификатор схемы , связанной с агентом. Допускается значение null.
id String Идентификатор объекта riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal или riskyAgentUser. Наследуется от сущности.

Поддерживает $filter (eq, startsWith).
IdentityType agentIdentityType Тип удостоверения агента. Допустимые значения: agentIdentity, agentUser, unknownFutureValue, agentIdentityBlueprintPrincipal. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующее значение в этой развиваемой перечислении: agentIdentityBlueprintPrincipal. Обязательно.

Поддерживает $filter (eq).
isDeleted Логический Указывает, удален ли агент.
isEnabled Boolean Указывает, включен ли агент.
IsProcessing Логический Указывает, обрабатывается ли рискованное состояние агента в серверной части.
riskDetail riskDetail Сведения об обнаружении риска агента.

Поддерживает $filter (eq).
riskLastModifiedDateTime DateTimeOffset Дата и время последнего обновления агента риска. Тип DateTimeOffset представляет сведения о дате и времени с использованием формата ISO 8601 и всегда указывает время в формате UTC. Например, полночь в формате UTC 1 января 2014 г. — 2014-01-01T00:00:00Z.

Поддерживает $filter (eq, le, и ge).
riskLevel riskLevel Уровень обнаруженного агента риска. Допустимые значения: low, medium, high, hidden, none, unknownFutureValue.

Поддерживает $filter (eq).
riskState riskState Состояние риска агента. Допустимые значения: none, confirmedSafe, dismissed, atRisk, confirmedCompromised, unknownFutureValue.

Поддерживает $filter (eq).

Связи

Отсутствуют.

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

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.riskyAgent",
  "id": "String (identifier)",
  "agentDisplayName": "String",
  "blueprintId": "String",
  "identityType": "String",
  "isDeleted": "Boolean",
  "isEnabled": "Boolean",
  "isProcessing": "Boolean",
  "riskLastModifiedDateTime": "String (timestamp)",
  "riskState": "String",
  "riskLevel": "String",
  "riskDetail": "String"
}