Тип ресурса 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"
}