Поделиться через


Тип ресурса mailAssessmentRequest

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

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

Методы

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

Свойства

Свойство Тип Описание
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.
destinationRoutingReason mailDestinationRoutingReason Причина перенаправления почты в место назначения. Возможные значения: none, , safeSendermailFlowRule, blockedSender, advancedSpamFiltering, domainAllowList, domainBlockList, , notInAddressBook, firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, autoPurgeToDeleted, outbound, , notJunk, . junk
expectedAssessment threatExpectedAssessment Ожидаемая оценка от отправителя. Возможные значения: block, unblock.
id String Идентификатор запроса на оценку угроз — это глобальный уникальный идентификатор (GUID).
messageUri String URI ресурса почтового сообщения для оценки.
recipientEmail String Получатель почты, политики которого используются для оценки почты.
requestSource threatAssessmentRequestSource Источник запроса на оценку угроз. Возможные значения: 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"
}