Secure Score Controls - List

  • Reference
Service:
Defender for Cloud
API Version:
2020-01-01

Získání všech ovládacích prvků zabezpečení v rámci oboru

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
subscriptionId
 path True

string

ID předplatného Azure

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

string

Verze rozhraní API pro operaci
$expand
 query

ExpandControlsEnum

Rozbalte OData. Nepovinný parametr.

Odpovědi

Name Typ Description
200 OK

SecureScoreControlList

OK
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

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
      }
    }
  ]
}

Definice

Name Description
AzureResourceLink

Popisuje druh prostředku Azure.
CloudError

Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)
CloudErrorBody

Podrobnosti o chybě.
controlType

Typ ovládacího prvku zabezpečení (například BuiltIn)
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ExpandControlsEnum

Rozbalte OData. Nepovinný parametr.
SecureScoreControlDefinitionItem

Informace o ovládacím prvku zabezpečení
SecureScoreControlDefinitionSource

Typ ovládacího prvku zabezpečení (například BuiltIn)
SecureScoreControlDetails

Podrobnosti o kontrole zabezpečení, jeho skóre a stavu příslušných prostředků
SecureScoreControlList

Seznam bezpečnostních prvků

Popisuje druh prostředku Azure.

Name Typ Description
id

string

ID prostředku Azure

CloudError

Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)

Name Typ Description
error.additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě
error.code

string

Kód chyby
error.details

CloudErrorBody[]

Podrobnosti o chybě
error.message

string

Chybová zpráva
error.target

string

Cíl chyby.

CloudErrorBody

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě
code

string

Kód chyby
details

CloudErrorBody[]

Podrobnosti o chybě
message

string

Chybová zpráva
target

string

Cíl chyby.

controlType

Typ ovládacího prvku zabezpečení (například BuiltIn)

Name Typ Description
BuiltIn

string

Microsoft Defender pro hodnocení spravovaná v cloudu
Custom

string

Ne Microsoft Defender pro hodnocení spravovaná v cloudu

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ExpandControlsEnum

Rozbalte OData. Nepovinný parametr.

Name Typ Description
definition

string

Přidání definičního objektu pro každý ovládací prvek

SecureScoreControlDefinitionItem

Informace o ovládacím prvku zabezpečení

Name Typ Description
id

string

ID prostředku
name

string

Název prostředku
properties.assessmentDefinitions

AzureResourceLink[]

Pole ID metadat posouzení, která jsou součástí tohoto ovládacího prvku zabezpečení
properties.description

string

Uživatelsky přívětivý popis ovládacího prvku
properties.displayName

string

Uživatelsky přívětivý zobrazovaný název ovládacího prvku
properties.maxScore

integer

Maximální kontrolní skóre (0..10)
properties.source

SecureScoreControlDefinitionSource

Zdrojový objekt, ze kterého byl ovládací prvek vytvořen
type

string

Typ prostředku

SecureScoreControlDefinitionSource

Typ ovládacího prvku zabezpečení (například BuiltIn)

Name Typ Description
sourceType

controlType

Typ ovládacího prvku zabezpečení (například BuiltIn)

SecureScoreControlDetails

Podrobnosti o kontrole zabezpečení, jeho skóre a stavu příslušných prostředků

Name Typ Description
id

string

ID prostředku
name

string

Název prostředku
properties.definition

SecureScoreControlDefinitionItem

Informace o ovládacím prvku zabezpečení
properties.displayName

string

Uživatelsky přívětivý zobrazovaný název ovládacího prvku
properties.healthyResourceCount

integer

Počet prostředků, které jsou v pořádku, v ovládacím prvku
properties.notApplicableResourceCount

integer

Počet nepoužitých prostředků v ovládacím prvku
properties.score.current

number

Aktuální skóre
properties.score.max

integer

Maximální dostupné skóre
properties.score.percentage

number

Poměr aktuálního skóre dělený maximem. Zaokrouhleno na 4 číslice za desetinnou čárkou
properties.unhealthyResourceCount

integer

Počet prostředků, které nejsou v pořádku, v ovládacím prvku
properties.weight

integer

Relativní váha tohoto konkrétního ovládacího prvku v každém z vašich předplatných. Používá se při výpočtu agregovaného skóre pro tento ovládací prvek ve všech vašich předplatných.
type

string

Typ prostředku

SecureScoreControlList

Seznam bezpečnostních prvků

Name Typ Description
nextLink

string

Identifikátor URI pro načtení další stránky
value

SecureScoreControlDetails[]

Kolekce ovládacích prvků zabezpečení na této stránce