urlAssessmentRequest resource type

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

Methods

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

Properties

Property Type Description
category threatCategory The threat category. Possible values are: spam, phishing, malware.
contentType threatAssessmentContentType The content type of the 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 the 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: administrator.
status threatAssessmentStatus The assessment process status. Possible values are: pending, completed.
url String The URL string.

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.

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