Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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"
}