共用方式為

Iot Security Solutions Analytics Aggregated Alert - Get

  • 參考
服務:
Defender for Cloud
API 版本:
2019-08-01

使用此方法可取得IoT安全性解決方案的單一匯總警示。 此匯總是由警示名稱執行。

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

URI 參數

名稱 位於 必要 類型 Description
aggregatedAlertName
 path True

string

匯總警示的標識碼。
resourceGroupName
 path True

string

用戶訂用帳戶內的資源組名。 名稱不區分大小寫。

Regex 模式: ^[-\w\._\(\)]+$
solutionName
 path True

string

IoT 安全性解決方案的名稱。
subscriptionId
 path True

string

Azure 訂用帳戶標識碼

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

string

作業的 API 版本

回應

名稱 類型 Description
200 OK

IoTSecurityAggregatedAlert

還行
Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Get the aggregated security analytics alert of yours IoT Security solution. This aggregation is performed by alert name

範例要求

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/iotSecuritySolutions/default/analyticsModels/default/aggregatedAlerts/IoT_Bruteforce_Fail/2019-02-02?api-version=2019-08-01

範例回覆

狀態碼:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default/IoT_Bruteforce_Fail/2019-02-02",
  "name": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default/IoT_Bruteforce_Fail/2019-02-02",
  "type": "Microsoft.Security/iotSecuritySolutions/analyticsModels/aggregatedAlerts",
  "properties": {
    "alertType": "IoT_Bruteforce_Fail",
    "alertDisplayName": "Failed Bruteforce",
    "aggregatedDateUtc": "2019-02-02",
    "vendorName": "Microsoft",
    "reportedSeverity": "Low",
    "remediationSteps": "",
    "description": "Multiple unsuccsseful login attempts identified. A Bruteforce attack on the device failed.",
    "count": 50,
    "effectedResourceType": "IoT Device",
    "systemSource": "Devices",
    "actionTaken": "Detected",
    "logAnalyticsQuery": "SecurityAlert | where tolower(ResourceId) == tolower('/subscriptions/b77ec8a9-04ed-48d2-a87a-e5887b978ba6/resourceGroups/IoT-Solution-DemoEnv/providers/Microsoft.Devices/IotHubs/rtogm-hub') and tolower(AlertName) == tolower('Custom Alert - number of device to cloud messages in MQTT protocol is not in the allowed range') | extend DeviceId=parse_json(ExtendedProperties)['DeviceId'] | project DeviceId, TimeGenerated, DisplayName, AlertSeverity, Description, RemediationSteps, ExtendedProperties",
    "topDevicesList": [
      {
        "deviceId": "testDevice1",
        "alertsCount": 100,
        "lastOccurrence": "10:42"
      },
      {
        "deviceId": "testDevice2",
        "alertsCount": 80,
        "lastOccurrence": "15:42"
      }
    ]
  }
}

定義

名稱 Description
CloudError

所有 Azure Resource Manager API 的常見錯誤回應，以傳回失敗作業的錯誤詳細數據。 （這也遵循 OData 錯誤回應格式。）。
CloudErrorBody

錯誤詳細數據。
ErrorAdditionalInfo

資源管理錯誤其他資訊。
IoTSecurityAggregatedAlert

安全性解決方案匯總警示資訊
reportedSeverity

評估的警示嚴重性。
TopDevicesList

10 部裝置，此警示類型出現次數最多的裝置，在這一天。

CloudError

所有 Azure Resource Manager API 的常見錯誤回應，以傳回失敗作業的錯誤詳細數據。 （這也遵循 OData 錯誤回應格式。）。

名稱 類型 Description
error.additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
error.code

string

錯誤碼。
error.details

CloudErrorBody[]

錯誤詳細數據。
error.message

string

錯誤訊息。
error.target

string

錯誤目標。

CloudErrorBody

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
code

string

錯誤碼。
details

CloudErrorBody[]

錯誤詳細數據。
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。
type

string

其他信息類型。

IoTSecurityAggregatedAlert

安全性解決方案匯總警示資訊

名稱 類型 Description
id

string

資源標識碼
name

string

資源名稱
properties.actionTaken

string

IoT 安全性解決方案警示回應。
properties.aggregatedDateUtc

string

偵測日期。
properties.alertDisplayName

string

警示類型的顯示名稱。
properties.alertType

string

警示類型的名稱。
properties.count

integer

匯總時間範圍內發生的警示數目。
properties.description

string

可疑弱點和意義的描述。
properties.effectedResourceType

string

收到警示之資源的 Azure 資源識別符。
properties.logAnalyticsQuery

string

用於取得受影響裝置/警示清單的記錄分析查詢。
properties.remediationSteps

string

補救的建議步驟。
properties.reportedSeverity

reportedSeverity

評估的警示嚴重性。
properties.systemSource

string

警示資源的類型（Azure、非 Azure）。
properties.topDevicesList

TopDevicesList[]

10 部裝置，此警示類型出現次數最多的裝置，在這一天。
properties.vendorName

string

引發警示的組織名稱。
tags

object

資源標籤
type

string

資源類型

reportedSeverity

評估的警示嚴重性。

名稱 類型 Description
High

string

Informational

string

Low

string

Medium

string

TopDevicesList

10 部裝置，此警示類型出現次數最多的裝置，在這一天。

名稱 類型 Description
alertsCount

integer

此裝置引發的警示數目。
deviceId

string

裝置的名稱。
lastOccurrence

string

此裝置最近一次引發此裝置的警示。