다음을 통해 공유

Secure Score Controls - List

  • 참조
Service:
Defender for Cloud
API Version:
2020-01-01

scope 내의 모든 보안 컨트롤 가져오기

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 매개 변수

Name In(다음 안에) 필수 형식 Description
subscriptionId
 path True

string

Azure 구독 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 버전
$expand
 query

ExpandControlsEnum

OData expand. 선택 사항입니다.

응답

Name 형식 Description
200 OK

SecureScoreControlList

정상
Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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

정의

Name Description
AzureResourceLink

종류가 있는 Azure 리소스에 대해 설명합니다.
CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.
CloudErrorBody

오류 세부 정보입니다.
controlType

보안 제어 유형(예: BuiltIn)
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ExpandControlsEnum

OData expand. 선택 사항입니다.
SecureScoreControlDefinitionItem

보안 제어에 대한 정보입니다.
SecureScoreControlDefinitionSource

보안 컨트롤의 형식(예: BuiltIn)
SecureScoreControlDetails

보안 제어, 해당 점수 및 관련 리소스의 상태 상태 대한 세부 정보입니다.
SecureScoreControlList

보안 컨트롤 목록

종류가 있는 Azure 리소스에 대해 설명합니다.

Name 형식 Description
id

string

Azure 리소스 ID

CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.

Name 형식 Description
error.additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
error.code

string

오류 코드입니다.
error.details

CloudErrorBody[]

오류 세부 정보입니다.
error.message

string

오류 메시지입니다.
error.target

string

오류 대상입니다.

CloudErrorBody

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

CloudErrorBody[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

controlType

보안 제어 유형(예: BuiltIn)

Name 형식 Description
BuiltIn

string

클라우드용 Microsoft Defender 관리 평가
Custom

string

클라우드용 비 Microsoft Defender 관리 평가

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ExpandControlsEnum

OData expand. 선택 사항입니다.

Name 형식 Description
definition

string

각 컨트롤에 대한 정의 개체 추가

SecureScoreControlDefinitionItem

보안 제어에 대한 정보입니다.

Name 형식 Description
id

string

리소스 ID
name

string

리소스 이름
properties.assessmentDefinitions

AzureResourceLink[]

이 보안 제어에 포함된 평가 메타데이터 ID의 배열
properties.description

string

컨트롤에 대한 사용자 친화적인 설명
properties.displayName

string

컨트롤의 사용자에게 친숙한 표시 이름
properties.maxScore

integer

최대 제어 점수(0..10)
properties.source

SecureScoreControlDefinitionSource

컨트롤을 만든 원본 개체
type

string

리소스 유형

SecureScoreControlDefinitionSource

보안 컨트롤의 형식(예: BuiltIn)

Name 형식 Description
sourceType

controlType

보안 제어 유형(예: BuiltIn)

SecureScoreControlDetails

보안 제어, 해당 점수 및 관련 리소스의 상태 상태 대한 세부 정보입니다.

Name 형식 Description
id

string

리소스 ID
name

string

리소스 이름
properties.definition

SecureScoreControlDefinitionItem

보안 제어에 대한 정보입니다.
properties.displayName

string

컨트롤의 사용자에게 친숙한 표시 이름
properties.healthyResourceCount

integer

컨트롤의 정상 리소스 수
properties.notApplicableResourceCount

integer

컨트롤에 적용할 수 없는 리소스 수
properties.score.current

number

현재 점수
properties.score.max

integer

사용 가능한 최대 점수
properties.score.percentage

number

현재 점수의 비율을 최대값으로 나눈 값입니다. 소수점 뒤의 4자리 숫자로 반올림됨
properties.unhealthyResourceCount

integer

컨트롤의 비정상 리소스 수
properties.weight

integer

각 구독에서 이 특정 컨트롤의 상대적 가중치입니다. 모든 구독에서 이 컨트롤에 대해 집계된 점수를 계산할 때 사용됩니다.
type

string

리소스 유형

SecureScoreControlList

보안 컨트롤 목록

Name 형식 Description
nextLink

string

다음 페이지를 페치 위한 URI입니다.
value

SecureScoreControlDetails[]

이 페이지의 보안 컨트롤 컬렉션