Skip to main content

watchlists

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

Overview

Namewatchlists
TypeResource
Idazure.sentinel.watchlists

Fields

NameDatatypeDescription
descriptiontextfield from the properties object
content_typetextfield from the properties object
createdtextfield from the properties object
created_bytextfield from the properties object
default_durationtextfield from the properties object
display_nametextfield from the properties object
etagtextEtag of the azure resource
is_deletedtextfield from the properties object
items_search_keytextfield from the properties object
labelstextfield from the properties object
number_of_lines_to_skiptextfield from the properties object
providertextfield from the properties object
raw_contenttextfield from the properties object
resourceGroupNametextfield from the properties object
sourcetextfield from the properties object
subscriptionIdtextfield from the properties object
tenant_idtextfield from the properties object
updatedtextfield from the properties object
updated_bytextfield from the properties object
upload_statustextfield from the properties object
watchlistAliastextfield from the properties object
watchlist_aliastextfield from the properties object
watchlist_idtextfield from the properties object
watchlist_typetextfield from the properties object
workspaceNametextfield from the properties object

Methods

NameAccessible byRequired ParamsDescription
getSELECTresourceGroupName, subscriptionId, watchlistAlias, workspaceNameGet a watchlist, without its watchlist items.
listSELECTresourceGroupName, subscriptionId, workspaceNameGet all watchlists, without watchlist items.
create_or_updateINSERTresourceGroupName, subscriptionId, watchlistAlias, workspaceNameCreate or update a Watchlist and its Watchlist Items (bulk creation, e.g. through text/csv content type). To create a Watchlist and its Items, we should call this endpoint with rawContent and contentType properties.
deleteDELETEresourceGroupName, subscriptionId, watchlistAlias, workspaceNameDelete a watchlist.

SELECT examples

Get all watchlists, without watchlist items.

SELECT
description,
content_type,
created,
created_by,
default_duration,
display_name,
etag,
is_deleted,
items_search_key,
labels,
number_of_lines_to_skip,
provider,
raw_content,
resourceGroupName,
source,
subscriptionId,
tenant_id,
updated,
updated_by,
upload_status,
watchlistAlias,
watchlist_alias,
watchlist_id,
watchlist_type,
workspaceName
FROM azure.sentinel.vw_watchlists
WHERE resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND workspaceName = '{{ workspaceName }}';

INSERT example

Use the following StackQL query and manifest file to create a new watchlists resource.

/*+ create */
INSERT INTO azure.sentinel.watchlists (
resourceGroupName,
subscriptionId,
watchlistAlias,
workspaceName,
etag,
properties
)
SELECT
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ watchlistAlias }}',
'{{ workspaceName }}',
'{{ etag }}',
'{{ properties }}'
;

DELETE example

Deletes the specified watchlists resource.

/*+ delete */
DELETE FROM azure.sentinel.watchlists
WHERE resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND watchlistAlias = '{{ watchlistAlias }}'
AND workspaceName = '{{ workspaceName }}';