Edit

threatAssessmentRequest resource type

  • Article

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.

An abstract resource type used to represent a threat assessment request item.

A threat assessment request can be one of the following types:

Methods

Method Return Type Description
List threatAssessmentRequest threatAssessmentRequest collection List all threat assessment requests under tenant.
Create threatAssessmentRequest threatAssessmentRequest Create a new threat assessment request by posting a derived resource type: mailAssessmentRequest, emailFileAssessmentRequest, fileAssessmentRequest, urlAssessmentRequest.
Get threatAssessmentRequest threatAssessmentRequest Retrieve the properties and relationships of a specified threatAssessmentRequest resource.

Properties

Property Type Description
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 the 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} does not return this property unless you apply $expand on it.

JSON representation

The following is a JSON representation of the resource.

{
  "category": "String",
  "contentType": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "expectedAssessment": "String",
  "id": "String (identifier)",
  "requestSource": "String",
  "status": "String"
}