fileAssessmentRequest resource type

Used to create and retrieve a file threat assessment, derived from threatAssessmentRequest.

The file can be a text file or Word document or binary file received in an email attachment.

Methods

Method Return Type Description
Create fileAssessmentRequest Create a new file assessment request by posting a fileAssessmentRequest object.
Get fileAssessmentRequest Read the properties and relationships of a fileAssessmentRequest object.

Properties

Property Type Description
category threatCategory The threat category. Possible values are: spam, phishing, malware.
contentData String Base64 encoded file content. The file content can't fetch back because it isn't stored.
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.
fileName String The file name.
id String The threat assessment request ID is a globally unique identifier (GUID).
requestSource threatAssessmentRequestSource The source of threat assessment request. Possible values are: 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",
  "category": "String",
  "contentType": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "expectedAssessment": "String",
  "fileName": "String",
  "id": "String (identifier)",
  "requestSource": "String",
  "status": "String"
}