Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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"
}