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 threatAssessmentRequest	fileAssessmentRequest	Create a new file assessment request by posting a fileAssessmentRequest object.
Get threatAssessmentRequest	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"
}