다음을 통해 공유


Iot Security Solutions Analytics Recommendation - Get

이 방법을 사용하여 IoT 보안 솔루션의 집계된 보안 분석 권장 사항을 가져옵니다. 이 집계는 권장 사항 이름으로 수행됩니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions/{solutionName}/analyticsModels/default/aggregatedRecommendations/{aggregatedRecommendationName}?api-version=2019-08-01

URI 매개 변수

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

string

이 쿼리에 대해 집계된 권장 사항의 이름입니다.

resourceGroupName
path True

string

사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

regex 패턴: ^[-\w\._\(\)]+$

solutionName
path True

string

IoT 보안 솔루션의 이름입니다.

subscriptionId
path True

string

Azure 구독 ID

regex 패턴: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

작업에 대한 API 버전

응답

Name 형식 Description
200 OK

IoTSecurityAggregatedRecommendation

그래

Other Status Codes

CloudError

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

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Get the aggregated security analytics recommendation of yours IoT Security solution

샘플 요청

GET https://management.azure.com/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/IoTEdgeResources/providers/Microsoft.Security/iotSecuritySolutions/default/analyticsModels/default/aggregatedRecommendations/OpenPortsOnDevice?api-version=2019-08-01

샘플 응답

{
  "id": "/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/IoTEdgeResources/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default/OpenPortsOnDevice",
  "name": "/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/IoTEdgeResources/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default/OpenPortsOnDevice",
  "type": "Microsoft.Security/iotSecuritySolutions/analyticsModels/aggregatedRecommendations",
  "properties": {
    "recommendationName": "OpenPortsOnDevice",
    "recommendationDisplayName": "Permissive firewall policy in one of the chains was found",
    "description": "An allowed firewall policy was found in main firewall Chains (INPUT/OUTPUT). The policy should Deny all traffic by default define rules to allow necessary communication to/from the device",
    "recommendationTypeId": "{20ff7fc3-e762-44dd-bd96-b71116dcdc23}",
    "detectedBy": "Microsoft",
    "reportedSeverity": "Low",
    "remediationSteps": "",
    "healthyDevices": 10000,
    "unhealthyDeviceCount": 200,
    "logAnalyticsQuery": "SecurityRecommendation | where tolower(AssessedResourceId) == tolower('/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/IoTEdgeResources/providers/Microsoft.Devices/IotHubs/t-ofdadu-hub') and tolower(RecommendationName) == tolower('OpenPortsOnDevice')"
  }
}

정의

Name Description
CloudError

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

CloudErrorBody

오류 세부 정보입니다.

ErrorAdditionalInfo

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

IoTSecurityAggregatedRecommendation

IoT 보안 솔루션 권장 사항 정보입니다.

reportedSeverity

평가된 경고 심각도입니다.

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

오류 대상입니다.

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

IoTSecurityAggregatedRecommendation

IoT 보안 솔루션 권장 사항 정보입니다.

Name 형식 Description
id

string

리소스 ID

name

string

리소스 이름

properties.description

string

의심되는 취약성 및 의미에 대한 설명입니다.

properties.detectedBy

string

권장 사항을 만든 조직의 이름입니다.

properties.healthyDevices

integer

IoT 보안 솔루션 내의 정상 디바이스 수입니다.

properties.logAnalyticsQuery

string

영향을 받는 디바이스/경고 목록을 가져오기 위한 Log Analytics 쿼리입니다.

properties.recommendationDisplayName

string

권장 사항 유형의 표시 이름입니다.

properties.recommendationName

string

권장 사항의 이름입니다.

properties.recommendationTypeId

string

권장 사항 유형 GUID입니다.

properties.remediationSteps

string

수정에 권장되는 단계

properties.reportedSeverity

reportedSeverity

평가된 권장 사항 심각도입니다.

properties.unhealthyDeviceCount

integer

IoT Security 솔루션 내의 비정상 디바이스 수입니다.

tags

object

리소스 태그

type

string

리소스 종류

reportedSeverity

평가된 경고 심각도입니다.

Name 형식 Description
High

string

Informational

string

Low

string

Medium

string