Secure Score Controls - List

Referensi

Service:: Defender for Cloud

API Version:: 2020-01-01

Mendapatkan semua kontrol keamanan dalam cakupan

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi

Nama	Dalam	Diperlukan	Jenis	Deskripsi
subscriptionId	path	True	string	ID langganan Azure Regex pattern: `^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$`
api-version	query	True	string	Versi API untuk operasi
$expand	query		ExpandControlsEnum	Perluas OData. Opsional.

subscriptionId

path

True

string

ID langganan Azure

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

api-version

query

True

string

Versi API untuk operasi

$expand

query

ExpandControlsEnum

Perluas OData. Opsional.

Respons

Nama	Jenis	Deskripsi
200 OK	SecureScoreControlList	OK
Other Status Codes	CloudError	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/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
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AzureResourceLink	Menjelaskan sumber daya Azure dengan jenis
CloudError	Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
CloudErrorBody	Detail kesalahan.
controlType	Jenis kontrol keamanan (misalnya, BuiltIn)
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ExpandControlsEnum	Perluas OData. Pilihan.
SecureScoreControlDefinitionItem	Informasi tentang kontrol keamanan.
SecureScoreControlDefinitionSource	Jenis kontrol keamanan (Misalnya, BuiltIn)
SecureScoreControlDetails	Detail kontrol keamanan, skornya, dan status kesehatan sumber daya yang relevan.
SecureScoreControlList	Daftar kontrol keamanan

AzureResourceLink

Menjelaskan sumber daya Azure dengan jenis

Nama	Jenis	Deskripsi
id	string	Id sumber daya Azure

CloudError

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

Nama	Jenis	Deskripsi
error.additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
error.code	string	Kode kesalahan.
error.details	CloudErrorBody[]	Detail kesalahan.
error.message	string	Pesan kesalahan.
error.target	string	Target kesalahan.

CloudErrorBody

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	CloudErrorBody[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

controlType

Jenis kontrol keamanan (misalnya, BuiltIn)

Nama	Jenis	Deskripsi
BuiltIn	string	Microsoft Defender untuk penilaian yang dikelola Cloud
Custom	string	Penilaian yang tidak Microsoft Defender untuk Cloud managed

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ExpandControlsEnum

Perluas OData. Pilihan.

Nama	Jenis	Deskripsi
definition	string	Menambahkan objek definisi untuk setiap kontrol

SecureScoreControlDefinitionItem

Informasi tentang kontrol keamanan.

Nama	Jenis	Deskripsi
id	string	ID sumber daya
name	string	Nama sumber daya
properties.assessmentDefinitions	AzureResourceLink[]	Array ID metadata penilaian yang disertakan dalam kontrol keamanan ini
properties.description	string	Deskripsi kontrol yang mudah digunakan
properties.displayName	string	Nama tampilan kontrol yang mudah digunakan
properties.maxScore	integer	Skor kontrol maksimum (0,.10)
properties.source	SecureScoreControlDefinitionSource	Objek sumber tempat kontrol dibuat
type	string	Jenis Sumber Daya

SecureScoreControlDefinitionSource

Jenis kontrol keamanan (Misalnya, BuiltIn)

Nama	Jenis	Deskripsi
sourceType	controlType	Jenis kontrol keamanan (misalnya, BuiltIn)

SecureScoreControlDetails

Detail kontrol keamanan, skornya, dan status kesehatan sumber daya yang relevan.

Nama	Jenis	Deskripsi
id	string	ID sumber daya
name	string	Nama sumber daya
properties.definition	SecureScoreControlDefinitionItem	Informasi tentang kontrol keamanan.
properties.displayName	string	Nama tampilan kontrol yang mudah digunakan
properties.healthyResourceCount	integer	Jumlah sumber daya sehat dalam kontrol
properties.notApplicableResourceCount	integer	Jumlah sumber daya yang tidak berlaku dalam kontrol
properties.score.current	number	Skor saat ini
properties.score.max	integer	Skor maksimum yang tersedia
properties.score.percentage	number	Rasio skor saat ini dibagi dengan maksimum. Dibulatkan ke 4 digit setelah titik desimal
properties.unhealthyResourceCount	integer	Jumlah sumber daya yang tidak sehat dalam kontrol
properties.weight	integer	Bobot relatif untuk kontrol khusus ini di setiap langganan Anda. Digunakan saat menghitung skor agregat untuk kontrol ini di semua langganan Anda.
type	string	Jenis Sumber Daya

SecureScoreControlList

Daftar kontrol keamanan

Nama	Jenis	Deskripsi
nextLink	string	URI untuk mengambil halaman berikutnya.
value	SecureScoreControlDetails[]	Kumpulan kontrol keamanan di halaman ini

Share via

Secure Score Controls - List

Parameter URI

Respons

Keamanan

azure_auth

Scopes

Contoh

List all secure scores controls

Sample Request

Sample Response

Definisi

AzureResourceLink

CloudError

CloudErrorBody

controlType

ErrorAdditionalInfo

ExpandControlsEnum

SecureScoreControlDefinitionItem

SecureScoreControlDefinitionSource

SecureScoreControlDetails

SecureScoreControlList

Sumber Daya Tambahan: