emailFileAssessmentRequest resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a resource that creates and retrieves an email file threat assessment. The email file can be an .eml file type.
Inherits from threatAssessmentRequest.
Methods
| Method | Return Type | Description |
|---|---|---|
| Create | emailFileAssessmentRequest | Create a new email file assessment request by posting an emailFileAssessmentRequest object. |
| Get | emailFileAssessmentRequest | Read the properties and relationships of an emailFileAssessmentRequest object. |
Properties
| Property | Type | Description |
|---|---|---|
| contentData | String | Base64 encoded .eml email file content. The file content can't fetch back because it isn't stored. |
| destinationRoutingReason | mailDestinationRoutingReason | The reason for mail routed to its destination. Possible values are: none, mailFlowRule, safeSender, blockedSender, advancedSpamFiltering, domainAllowList, domainBlockList, notInAddressBook, firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, autoPurgeToDeleted, outbound, notJunk, junk. |
| recipientEmail | String | The mail recipient whose policies are used to assess the mail. |
| category | threatCategory | The threat category. Possible values are: spam, phishing, malware. |
| contentType | threatAssessmentContentType | The content type of threat assessment. Possible values are: mail, url, file. |
| createdBy | identitySet | The threat assessment request creator. |
| createdDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| expectedAssessment | threatExpectedAssessment | The expected assessment from submitter. Possible values are: block, unblock. |
| id | String | The threat assessment request ID is a globally unique identifier (GUID). |
| requestSource | threatAssessmentRequestSource | The source of threat assessment request. Possible values are: user, administrator. |
| status | threatAssessmentStatus | The assessment process status. Possible values are: pending, completed. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| results | threatAssessmentResult collection | A collection of threat assessment results. Read-only. By default, a GET /threatAssessmentRequests/{id} doesn't return this property unless you apply $expand on it. |
JSON representation
The following JSON representation shows the resource type.
{
"contentData": "String",
"destinationRoutingReason": "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"
}