mailAssessmentRequest 资源类型
用于创建和检索从 threatAssessmentRequest 派生的邮件威胁评估。
创建邮件威胁评估请求时,邮件应由 中指定的 recipientEmail
用户接收。 访问用户接收的邮件或其他人共享的邮件需要委派 邮件权限 (Mail.Read 或 Mail.Read.Shared) 。
方法
方法 | 返回类型 | 说明 |
---|---|---|
创建 | mailAssessmentRequest | 通过发布 mailAssessmentRequest 对象来Create新的邮件评估请求。 |
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 | 邮件路由到其目标的原因。 可能的值为:、、mailFlowRule 、、safeSender autoPurgeToInbox firstTimeSender domainAllowList blockedSender domainBlockList notInAddressBook advancedSpamFiltering 、autoPurgeToJunk 、autoPurgeToDeleted 、 。 junk outbound notJunk none |
expectedAssessment | threatExpectedAssessment | 提交者的预期评估。 可能的值是:block 、unblock 。 |
id | String | 威胁评估请求 ID 是 GUID) (全局唯一标识符。 |
messageUri | String | 用于评估的邮件的资源 URI。 |
recipientEmail | String | 其策略用于评估邮件的邮件收件人。 |
requestSource | threatAssessmentRequestSource | 威胁评估请求的来源。 可能的值为: administrator 。 |
status | threatAssessmentStatus | 评估过程状态。 可取值为:pending 、completed 。 |
Relationships
关系 | 类型 | 说明 |
---|---|---|
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"
}