Тип ресурса mailAssessmentRequest

Статья
10/02/2023

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

Важно!

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

Используется для создания и получения оценки угроз почты, полученной из threatAssessmentRequest.

При создании запроса на оценку угроз почты сообщение должно быть получено пользователем, указанным в recipientEmail. Делегированные разрешения почты (Mail.Read или Mail.Read.Shared) необходимы для доступа к почте, полученной пользователем или переданной другим пользователем.

Методы

Метод	Возвращаемый тип	Описание
Создание объекта threatAssessmentRequest	mailAssessmentRequest	Создайте новый запрос на оценку почты, опубликовав объект mailAssessmentRequest .
Получение объекта threatAssessmentRequest	mailAssessmentRequest	Чтение свойств и связей объекта mailAssessmentRequest .

Свойства

Свойство	Тип	Описание
destinationRoutingReason	mailDestinationRoutingReason	Причина перенаправления почты в место назначения. Возможные значения: `none`, , `safeSendermailFlowRule`, `blockedSender`, `advancedSpamFiltering`, `domainAllowList`, `domainBlockList`, , `notInAddressBook`, `firstTimeSender`, `autoPurgeToInbox`, `autoPurgeToJunk`, `autoPurgeToDeleted`, `outbound`, , `notJunk`, . `junk`
messageUri	String	URI ресурса почтового сообщения для оценки.
recipientEmail	String	Получатель почты, политики которого используются для оценки почты.
category	threatCategory	Категория угроз. Возможные значения: `spam`, `phishing`, `malware`.
contentType	threatAssessmentContentType	Тип содержимого оценки угроз. Возможные значения: `mail`, `url`, `file`.
createdBy	identitySet	Создатель запроса на оценку угроз.
createdDateTime	DateTimeOffset	Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
expectedAssessment	threatExpectedAssessment	Ожидаемая оценка от отправителя. Возможные значения: `block`, `unblock`.
id	String	Идентификатор запроса на оценку угроз — это глобальный уникальный идентификатор (GUID).
requestSource	threatAssessmentRequestSource	Источник запроса на оценку угроз. Возможные значения: `user`, `administrator`.
status	threatAssessmentStatus	Состояние процесса оценки. Возможные значения: `pending`, `completed`.

Связи

Связь	Тип	Описание
results	Коллекция threatAssessmentResult	Коллекция результатов оценки угроз. Только для чтения. По умолчанию объект не возвращает это свойство, `GET /threatAssessmentRequests/{id}` если к нему не применяется `$expand` .

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

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

{
  "destinationRoutingReason": "String",
  "messageUri": "String",
  "recipientEmail": "String",
  "category": "String",
  "contentType": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "expectedAssessment": "String",
  "id": "String (identifier)",
  "requestSource": "String",
  "status": "String"
}