用于创建和检索从 threatAssessmentRequest 派生的邮件威胁评估。
创建邮件威胁评估请求时，邮件应由 中指定的 recipientEmail用户接收。 访问用户接收的邮件或其他人共享的邮件需要委派 邮件权限 (Mail.Read 或 Mail.Read.Shared) 。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | mailAssessmentRequest | 通过发布 mailAssessmentRequest 对象创建新的邮件评估请求。 |
| Get | mailAssessmentRequest | 读取 mailAssessmentRequest 对象的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| “类别” | threatCategory | 威胁类别。 可能的值包括 spam、phishing、malware。 |
| contentType | threatAssessmentContentType | 威胁评估的内容类型。 可能的值包括 mail、url、file。 |
| createdBy | identitySet | 威胁评估请求创建者。 |
| createdDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| destinationRoutingReason | mailDestinationRoutingReason | 邮件路由到其目标的原因。 可能的值为：none、、safeSendermailFlowRule、domainAllowListadvancedSpamFilteringfirstTimeSenderautoPurgeToInboxblockedSenderdomainBlockListnotInAddressBook、、autoPurgeToJunkautoPurgeToDeleted、、、outbound、、 。 junknotJunk |
| expectedAssessment | threatExpectedAssessment | 提交者的预期评估。 可能的值为： block、 unblock。 |
| id | String | 威胁评估请求 ID 是 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"
}