Skip to main content

threat_intelligence

Creates, updates, deletes, gets or lists a threat_intelligence resource.

Overview

Namethreat_intelligence
TypeResource
Idazure.security_insight.threat_intelligence

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
createdByobjectThe UserInfo of the user/entity which originally created this TI object.
dataobjectThe core STIX object that this TI object represents.
firstIngestedTimeUtcstring (date-time)The timestamp for the first time this object was ingested.
ingestionRulesVersionstringThe ID of the rules version that was active when this TI object was last ingested.
kindstringThe kind of the TI object. Required. Known values are: "AttackPattern", "Identity", "Indicator", "Relationship", and "ThreatActor".
lastIngestedTimeUtcstring (date-time)The timestamp for the last time this object was ingested.
lastModifiedByobjectThe UserInfo of the user/entity which last modified this TI object.
lastUpdateMethodstringThe name of the method/application that initiated the last write to this TI object.
lastUpdatedDateTimeUtcstring (date-time)The timestamp for the last time this TI object was updated.
relationshipHintsarrayA dictionary used to help follow relationships from this object to other STIX objects. The keys are field names from the STIX object (in the 'data' field), and the values are lists of sources that can be prepended to the object ID in order to efficiently locate the target TI object.
sourcestringThe source name for this TI object.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
queryselectresource_group_name, workspace_name, ti_type, subscription_idGets all TI objects for the workspace.
countexecresource_group_name, workspace_name, ti_type, subscription_idGets the count of all TI objects for the workspace.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
ti_typestringTI type. "main" Required.
workspace_namestringThe name of the workspace. Required.

SELECT examples

Gets all TI objects for the workspace.

SELECT
id,
name,
createdBy,
data,
firstIngestedTimeUtc,
ingestionRulesVersion,
kind,
lastIngestedTimeUtc,
lastModifiedBy,
lastUpdateMethod,
lastUpdatedDateTimeUtc,
relationshipHints,
source,
systemData,
type
FROM azure.security_insight.threat_intelligence
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND workspace_name = '{{ workspace_name }}' -- required
AND ti_type = '{{ ti_type }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

Lifecycle Methods

Gets the count of all TI objects for the workspace.

EXEC azure.security_insight.threat_intelligence.count 
@resource_group_name='{{ resource_group_name }}' --required,
@workspace_name='{{ workspace_name }}' --required,
@ti_type='{{ ti_type }}' --required,
@subscription_id='{{ subscription_id }}' --required
@@json=
'{
"properties": "{{ properties }}"
}'
;