secure_scores

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

Overview

Name	secure_scores
Type	Resource
Id	azure.security.secure_scores

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
name	string	The name of the resource.
displayName	string	The initiative's name.
score	object	score object.
systemData	object	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
weight	integer	The relative weight for each subscription. Used when calculating an aggregated secure score for multiple subscriptions.

list

Name	Datatype	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
name	string	The name of the resource.
displayName	string	The initiative's name.
score	object	score object.
systemData	object	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
weight	integer	The relative weight for each subscription. Used when calculating an aggregated secure score for multiple subscriptions.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	secure_score_name, subscription_id		Get secure score for a specific Microsoft Defender for Cloud initiative within your current scope. For the ASC Default initiative, use 'ascScore'.
list	select	subscription_id		List secure scores for all your Microsoft Defender for Cloud initiatives within your current scope.

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.

Name	Datatype	Description
secure_score_name	string	The initiative name. For the ASC Default initiative, use 'ascScore' as in the sample request below. Required.
subscription_id	string

SELECT examples

get

Get secure score for a specific Microsoft Defender for Cloud initiative within your current scope. For the ASC Default initiative, use 'ascScore'.

SELECT
id,
name,
displayName,
score,
systemData,
type,
weight
FROM azure.security.secure_scores
WHERE secure_score_name = '{{ secure_score_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

list

List secure scores for all your Microsoft Defender for Cloud initiatives within your current scope.

SELECT
id,
name,
displayName,
score,
systemData,
type,
weight
FROM azure.security.secure_scores
WHERE subscription_id = '{{ subscription_id }}' -- required
;