threatAssessmentRequest resource type
An abstract resource type used to represent a threat assessment request item.
A threat assessment request can be one of the following types:
- Mail (mailAssessmentRequest resource)
- Email file (emailFileAssessmentRequest resource)
- File (fileAssessmentRequest resource)
- URL (urlAssessmentRequest resource)
Methods
| Method | Return Type | Description |
|---|---|---|
| List | threatAssessmentRequest collection | List all threat assessment requests under tenant. |
| Create | threatAssessmentRequest | Create a new threat assessment request by posting a derived resource type: mailAssessmentRequest, emailFileAssessmentRequest, fileAssessmentRequest, urlAssessmentRequest. |
| Get | 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: 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 JSON representation shows the resource type.
{
"category": "String",
"contentType": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"expectedAssessment": "String",
"id": "String (identifier)",
"requestSource": "String",
"status": "String"
}