Secure Score Controls - List

Referentie

Service:: Defender for Cloud

API Version:: 2020-01-01

Alle beveiligingsbesturingselementen binnen een bereik ophalen

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/secureScoreControls?api-version=2020-01-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/secureScoreControls?api-version=2020-01-01&$expand=definition

URI-parameters

Name In Vereist Type Description

Name	In	Vereist	Type	Description
subscriptionId	path	True	string	Azure-abonnements-id Regex pattern: `^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$`
api-version	query	True	string	API-versie voor de bewerking
$expand	query		ExpandControlsEnum	OData uitvouwen. Optioneel.

subscriptionId

path

True

string

Azure-abonnements-id

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version

query

True

string

API-versie voor de bewerking

$expand

query

ExpandControlsEnum

OData uitvouwen. Optioneel.

Antwoorden

Name	Type	Description
200 OK	SecureScoreControlList	OK
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

List all secure scores controls

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScoreControls?api-version=2020-01-01&$expand=definition


/**
 * Samples for SecureScoreControls List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/
     * ListSecureScoreControls_example.json
     */
    /**
     * Sample code: List all secure scores controls.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listAllSecureScoresControls(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.secureScoreControls().list(null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/b43974e07d3204c4b6f8396627f5430994a7f7c9/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json
func ExampleSecureScoreControlsClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewSecureScoreControlsClient().NewListPager(&armsecurity.SecureScoreControlsClientListOptions{Expand: nil})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.SecureScoreControlList = armsecurity.SecureScoreControlList{
		// 	Value: []*armsecurity.SecureScoreControlDetails{
		// 		{
		// 			Name: to.Ptr("a9909064-42b4-4d34-8143-275477afe18b"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/a9909064-42b4-4d34-8143-275477afe18b"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Protect applications against DDoS attacks"),
		// 				HealthyResourceCount: to.Ptr[int32](0),
		// 				NotApplicableResourceCount: to.Ptr[int32](1),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](0),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](0),
		// 				Weight: to.Ptr[int64](0),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("34a42fb3-e6db-409c-b56b-7b1db6b8aee0"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/34a42fb3-e6db-409c-b56b-7b1db6b8aee0"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Enable MFA"),
		// 				HealthyResourceCount: to.Ptr[int32](1),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](10),
		// 					Max: to.Ptr[int32](10),
		// 					Percentage: to.Ptr[float64](1),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](0),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("76763537-9feb-42d3-b4f4-78c01117be80"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/76763537-9feb-42d3-b4f4-78c01117be80"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Implement security best practices"),
		// 				HealthyResourceCount: to.Ptr[int32](7),
		// 				NotApplicableResourceCount: to.Ptr[int32](1),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](0),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](0),
		// 				Weight: to.Ptr[int64](7),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("4db8d6cf-075b-4149-a813-da09ca2ae120"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/4db8d6cf-075b-4149-a813-da09ca2ae120"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Enable Advanced Threat Protection"),
		// 				HealthyResourceCount: to.Ptr[int32](0),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](0),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("27b24961-75ba-4fe4-8909-97286d5dd5ee"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/27b24961-75ba-4fe4-8909-97286d5dd5ee"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Enable auditing and logging"),
		// 				HealthyResourceCount: to.Ptr[int32](1),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0.2),
		// 					Max: to.Ptr[int32](1),
		// 					Percentage: to.Ptr[float64](0.2),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](4),
		// 				Weight: to.Ptr[int64](5),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("2d85f639-0bea-4a4a-b6c6-608952a1414a"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/2d85f639-0bea-4a4a-b6c6-608952a1414a"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Manage access and permissions"),
		// 				HealthyResourceCount: to.Ptr[int32](1),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](2),
		// 					Max: to.Ptr[int32](4),
		// 					Percentage: to.Ptr[float64](0.5),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](2),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("99fc8df2-e0f5-40f8-9415-a7f7ca948b5a"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Remediate security configurations"),
		// 				HealthyResourceCount: to.Ptr[int32](0),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](4),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("12136bd9-dc24-44f2-9587-7be3af6aac14"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/12136bd9-dc24-44f2-9587-7be3af6aac14"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Enable endpoint protection"),
		// 				HealthyResourceCount: to.Ptr[int32](0),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](2),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("61702b76-1fab-41f2-bcbc-50b7870dcf38"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/61702b76-1fab-41f2-bcbc-50b7870dcf38"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Apply system updates"),
		// 				HealthyResourceCount: to.Ptr[int32](0),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](0),
		// 					Max: to.Ptr[int32](6),
		// 					Percentage: to.Ptr[float64](0),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("0e55495e-034f-4abc-8293-767229250176"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/0e55495e-034f-4abc-8293-767229250176"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Encrypt data in transit"),
		// 				HealthyResourceCount: to.Ptr[int32](5),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](3.33),
		// 					Max: to.Ptr[int32](4),
		// 					Percentage: to.Ptr[float64](0.8325),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](1),
		// 				Weight: to.Ptr[int64](6),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("f9d5432b-8f7b-45e9-b90c-e214a30f6a02"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/f9d5432b-8f7b-45e9-b90c-e214a30f6a02"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Restrict unauthorized network access"),
		// 				HealthyResourceCount: to.Ptr[int32](1),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](4),
		// 					Max: to.Ptr[int32](4),
		// 					Percentage: to.Ptr[float64](1),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](0),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("8fd574ec-43cf-426e-a439-a67cbaf2d564"),
		// 			Type: to.Ptr("Microsoft.Security/secureScores/secureScoreControls"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/8fd574ec-43cf-426e-a439-a67cbaf2d564"),
		// 			Properties: &armsecurity.SecureScoreControlScoreDetails{
		// 				DisplayName: to.Ptr("Enable encryption at rest"),
		// 				HealthyResourceCount: to.Ptr[int32](1),
		// 				NotApplicableResourceCount: to.Ptr[int32](0),
		// 				Score: &armsecurity.ScoreDetails{
		// 					Current: to.Ptr[float64](4),
		// 					Max: to.Ptr[int32](4),
		// 					Percentage: to.Ptr[float64](1),
		// 				},
		// 				UnhealthyResourceCount: to.Ptr[int32](0),
		// 				Weight: to.Ptr[int64](1),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get all security controls within a scope
 *
 * @summary Get all security controls within a scope
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json
 */
async function listAllSecureScoresControls() {
  const subscriptionId =
    process.env["SECURITY_SUBSCRIPTION_ID"] || "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.secureScoreControls.list()) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.SecurityCenter;
using Azure.ResourceManager.SecurityCenter.Models;

// Generated from example definition: specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json
// this example is just showing the usage of "SecureScoreControls_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (SecureScoreControlDetails item in subscriptionResource.GetSecureScoreControlsAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/a9909064-42b4-4d34-8143-275477afe18b",
      "name": "a9909064-42b4-4d34-8143-275477afe18b",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Protect applications against DDoS attacks",
        "healthyResourceCount": 0,
        "unhealthyResourceCount": 0,
        "notApplicableResourceCount": 1,
        "score": {
          "max": 0,
          "current": 0,
          "percentage": 0
        },
        "weight": 0
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
      "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Enable MFA",
        "healthyResourceCount": 1,
        "unhealthyResourceCount": 0,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 10,
          "current": 10,
          "percentage": 1
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/76763537-9feb-42d3-b4f4-78c01117be80",
      "name": "76763537-9feb-42d3-b4f4-78c01117be80",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Implement security best practices",
        "healthyResourceCount": 7,
        "unhealthyResourceCount": 0,
        "notApplicableResourceCount": 1,
        "score": {
          "max": 0,
          "current": 0,
          "percentage": 0
        },
        "weight": 7
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/4db8d6cf-075b-4149-a813-da09ca2ae120",
      "name": "4db8d6cf-075b-4149-a813-da09ca2ae120",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Enable Advanced Threat Protection",
        "healthyResourceCount": 0,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 0,
          "current": 0,
          "percentage": 0
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/27b24961-75ba-4fe4-8909-97286d5dd5ee",
      "name": "27b24961-75ba-4fe4-8909-97286d5dd5ee",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Enable auditing and logging",
        "healthyResourceCount": 1,
        "unhealthyResourceCount": 4,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 1,
          "current": 0.2,
          "percentage": 0.2
        },
        "weight": 5
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/2d85f639-0bea-4a4a-b6c6-608952a1414a",
      "name": "2d85f639-0bea-4a4a-b6c6-608952a1414a",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Manage access and permissions",
        "healthyResourceCount": 1,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 4,
          "current": 2,
          "percentage": 0.5
        },
        "weight": 2
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
      "name": "99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Remediate security configurations",
        "healthyResourceCount": 0,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 4,
          "current": 0,
          "percentage": 0
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/12136bd9-dc24-44f2-9587-7be3af6aac14",
      "name": "12136bd9-dc24-44f2-9587-7be3af6aac14",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Enable endpoint protection",
        "healthyResourceCount": 0,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 2,
          "current": 0,
          "percentage": 0
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/61702b76-1fab-41f2-bcbc-50b7870dcf38",
      "name": "61702b76-1fab-41f2-bcbc-50b7870dcf38",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Apply system updates",
        "healthyResourceCount": 0,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 6,
          "current": 0,
          "percentage": 0
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/0e55495e-034f-4abc-8293-767229250176",
      "name": "0e55495e-034f-4abc-8293-767229250176",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Encrypt data in transit",
        "healthyResourceCount": 5,
        "unhealthyResourceCount": 1,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 4,
          "current": 3.33,
          "percentage": 0.8325
        },
        "weight": 6
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
      "name": "f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Restrict unauthorized network access",
        "healthyResourceCount": 1,
        "unhealthyResourceCount": 0,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 4,
          "current": 4,
          "percentage": 1
        },
        "weight": 1
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/8fd574ec-43cf-426e-a439-a67cbaf2d564",
      "name": "8fd574ec-43cf-426e-a439-a67cbaf2d564",
      "type": "Microsoft.Security/secureScores/secureScoreControls",
      "properties": {
        "displayName": "Enable encryption at rest",
        "healthyResourceCount": 1,
        "unhealthyResourceCount": 0,
        "notApplicableResourceCount": 0,
        "score": {
          "max": 4,
          "current": 4,
          "percentage": 1
        },
        "weight": 1
      }
    }
  ]
}

Definities

Name	Description
AzureResourceLink	Beschrijft een Azure-resource met een soort
CloudError	Algemene foutreactie voor alle Azure Resource Manager API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de OData-foutreactieindeling.)
CloudErrorBody	De foutdetails.
controlType	Het type beveiligingsbeheer (bijvoorbeeld BuiltIn)
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ExpandControlsEnum	OData uitvouwen. Optioneel.
SecureScoreControlDefinitionItem	Informatie over het beveiligingsbeheer.
SecureScoreControlDefinitionSource	Het type van het beveiligingsbeheer (bijvoorbeeld BuiltIn)
SecureScoreControlDetails	Details van de beveiligingscontrole, de score en de status van de relevante resources.
SecureScoreControlList	Lijst met beveiligingsbesturingselementen

AzureResourceLink

Beschrijft een Azure-resource met een soort

Name	Type	Description
id	string	Azure-resource-id

CloudError

Algemene foutreactie voor alle Azure Resource Manager API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de OData-foutreactieindeling.)

Name	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
error.code	string	De foutcode.
error.details	CloudErrorBody[]	De foutdetails.
error.message	string	Het foutbericht.
error.target	string	Het foutdoel.

CloudErrorBody

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	CloudErrorBody[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

controlType

Het type beveiligingsbeheer (bijvoorbeeld BuiltIn)

Name	Type	Description
BuiltIn	string	Microsoft Defender voor door de cloud beheerde evaluaties
Custom	string	Niet-Microsoft Defender voor door de cloud beheerde evaluaties

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ExpandControlsEnum

OData uitvouwen. Optioneel.

Name	Type	Description
definition	string	Definitieobject toevoegen voor elk besturingselement

SecureScoreControlDefinitionItem

Informatie over het beveiligingsbeheer.

Name	Type	Description
id	string	Resource-id
name	string	Resourcenaam
properties.assessmentDefinitions	AzureResourceLink[]	Matrix met metagegevens-id's van evaluaties die zijn opgenomen in dit beveiligingsbeheer
properties.description	string	Gebruiksvriendelijke beschrijving van het besturingselement
properties.displayName	string	Gebruiksvriendelijke weergavenaam van het besturingselement
properties.maxScore	integer	Maximale controlescore (0..10)
properties.source	SecureScoreControlDefinitionSource	Bronobject van waaruit het besturingselement is gemaakt
type	string	Resourcetype

SecureScoreControlDefinitionSource

Het type van het beveiligingsbeheer (bijvoorbeeld BuiltIn)

Name	Type	Description
sourceType	controlType	Het type beveiligingsbeheer (bijvoorbeeld BuiltIn)

SecureScoreControlDetails

Details van de beveiligingscontrole, de score en de status van de relevante resources.

Name	Type	Description
id	string	Resource-id
name	string	Resourcenaam
properties.definition	SecureScoreControlDefinitionItem	Informatie over het beveiligingsbeheer.
properties.displayName	string	Gebruiksvriendelijke weergavenaam van het besturingselement
properties.healthyResourceCount	integer	Aantal resources met een goede status in het besturingselement
properties.notApplicableResourceCount	integer	Aantal niet-toepasselijke resources in het besturingselement
properties.score.current	number	Huidige score
properties.score.max	integer	Maximale score beschikbaar
properties.score.percentage	number	Verhouding van de huidige score gedeeld door het maximum. Afgerond op 4 cijfers na de decimale komma
properties.unhealthyResourceCount	integer	Aantal beschadigde resources in het besturingselement
properties.weight	integer	Het relatieve gewicht voor dit specifieke besturingselement in elk van uw abonnementen. Wordt gebruikt bij het berekenen van een geaggregeerde score voor dit besturingselement voor al uw abonnementen.
type	string	Resourcetype

SecureScoreControlList

Lijst met beveiligingsbesturingselementen

Name	Type	Description
nextLink	string	De URI om de volgende pagina op te halen.
value	SecureScoreControlDetails[]	Verzameling van beveiligingsbesturingselementen op deze pagina

Share via

Secure Score Controls - List

URI-parameters

Antwoorden

Beveiliging

azure_auth

Scopes

Voorbeelden

List all secure scores controls

Sample Request

Sample Response

Definities

AzureResourceLink

CloudError

CloudErrorBody

controlType

ErrorAdditionalInfo

ExpandControlsEnum

SecureScoreControlDefinitionItem

SecureScoreControlDefinitionSource

SecureScoreControlDetails

SecureScoreControlList

Aanvullende resources