Тип ресурса mailAssessmentRequest

Статья
03/16/2023

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

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

Методы

Метод	Возвращаемый тип	Описание
Создание объекта threatAssessmentRequest	mailAssessmentRequest	Создайте новый запрос на оценку почты, опубликовав объект mailAssessmentRequest .
Получение объекта threatAssessmentRequest	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"
}