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 |
---|---|---|---|---|
aggregated
|
path | True |
string |
이 쿼리에 대해 집계된 권장 사항의 이름입니다. |
resource
|
path | True |
string |
사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다. regex 패턴: |
solution
|
path | True |
string |
IoT 보안 솔루션의 이름입니다. |
subscription
|
path | True |
string |
Azure 구독 ID regex 패턴: |
api-version
|
query | True |
string |
작업에 대한 API 버전 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 |
---|---|
Cloud |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다. |
Cloud |
오류 세부 정보입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Io |
IoT 보안 솔루션 권장 사항 정보입니다. |
reported |
평가된 경고 심각도입니다. |
CloudError
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
Name | 형식 | Description |
---|---|---|
error.additionalInfo |
오류 추가 정보입니다. |
|
error.code |
string |
오류 코드입니다. |
error.details |
오류 세부 정보입니다. |
|
error.message |
string |
오류 메시지입니다. |
error.target |
string |
오류 대상입니다. |
CloudErrorBody
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
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 |
평가된 권장 사항 심각도입니다. |
|
properties.unhealthyDeviceCount |
integer |
IoT Security 솔루션 내의 비정상 디바이스 수입니다. |
tags |
object |
리소스 태그 |
type |
string |
리소스 종류 |
reportedSeverity
평가된 경고 심각도입니다.
Name | 형식 | Description |
---|---|---|
High |
string |
|
Informational |
string |
|
Low |
string |
|
Medium |
string |