article resource type
Namespace: microsoft.graph.security
Note
The Microsoft Graph API for Microsoft Defender Threat Intelligence requires an active Defender Threat Intelligence Portal license and API add-on license for the tenant.
Represents an article, which is a narrative that provides insight into threat actors, tooling, attacks, and vulnerabilities. Articles are not blog posts about threat intelligence; while they summarize different threats, they also link to actionable content and key indicators of compromise to help users take action.
Methods
| Method | Return type | Description |
|---|---|---|
| List articles | article collection | Get a list of the microsoft.graph.security.article objects and their properties. |
| Get article | article | Read the properties and relationships of a microsoft.graph.security.article object. |
| List article indicators | articleIndicator collection | Get the articleIndicator resources from the indicators navigation property. |
Properties
| Property | Type | Description |
|---|---|---|
| body | microsoft.graph.security.formattedContent | Formatted article contents. |
| createdDateTime | DateTimeOffset | The date and time when this article was created. 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. |
| isFeatured | Boolean | Indicates whether this article is currently featured by Microsoft. |
| id | String | The system-generated ID for this article. |
| imageUrl | String | URL of the header image for this article, used for display purposes. |
| lastUpdatedDateTime | DateTimeOffset | The most recent date and time when this article was updated. 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. |
| summary | microsoft.graph.security.formattedContent | A quick summary of this article. |
| tags | String collection | Tags for this article, communicating keywords, or key concepts. |
| title | String | The title of this article. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| indicators | microsoft.graph.security.articleIndicator collection | Indicators related to this article. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.security.article",
"body": {
"@odata.type": "microsoft.graph.security.formattedContent"
},
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"imageUrl": "String",
"isFeatured": "Boolean",
"lastUpdatedDateTime": "String (timestamp)",
"summary": {
"@odata.type": "microsoft.graph.security.formattedContent"
},
"tags": ["String"],
"title": "String"
}