共用方式為


Alerts Suppression Rules - Update

如果現有規則不存在,請更新或建立新規則

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/alertsSuppressionRules/{alertsSuppressionRuleName}?api-version=2019-01-01-preview

URI 參數

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

string

隱藏警示規則的唯一名稱

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
properties.alertType True

string

要自動隱藏的警示類型。 針對所有警示類型,請使用 '*'

properties.reason True

string

關閉警示的原因

properties.state True

RuleState

規則的可能狀態

properties.comment

string

任何有關規則的批注

properties.expirationDateUtc

string

規則的到期日,如果未提供值或提供為 null,則完全不會到期

properties.suppressionAlertsScope

SuppressionAlertsScope

歸併條件

回應

名稱 類型 Description
200 OK

AlertsSuppressionRule

還行

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 模擬您的用戶帳戶

範例

Update or create suppression rule for subscription

範例要求

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/alertsSuppressionRules/dismissIpAnomalyAlerts?api-version=2019-01-01-preview

{
  "properties": {
    "alertType": "IpAnomaly",
    "expirationDateUtc": "2019-12-01T19:50:47.083633Z",
    "state": "Enabled",
    "reason": "FalsePositive",
    "comment": "Test VM",
    "suppressionAlertsScope": {
      "allOf": [
        {
          "field": "entities.ip.address",
          "in": [
            "104.215.95.187",
            "52.164.206.56"
          ]
        },
        {
          "field": "entities.process.commandline",
          "contains": "POWERSHELL.EXE"
        }
      ]
    }
  }
}

範例回覆

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/alertsSuppressionRules/dismissIpAnomalyAlerts",
  "name": "dismissIpAnomalyAlerts",
  "type": "Microsoft.Security/alertsSuppressionRules",
  "properties": {
    "alertType": "IpAnomaly",
    "lastModifiedUtc": "2019-07-31T19:50:47.083633Z",
    "expirationDateUtc": "2019-12-01T19:50:47.083633Z",
    "state": "Enabled",
    "reason": "FalsePositive",
    "comment": "Test VM",
    "suppressionAlertsScope": {
      "allOf": [
        {
          "field": "entities.ip.address",
          "in": [
            "104.215.95.187",
            "52.164.206.56"
          ]
        },
        {
          "field": "entities.process.commandline",
          "contains": "POWERSHELL.EXE"
        }
      ]
    }
  }
}

定義

名稱 Description
AlertsSuppressionRule

描述歸並規則

CloudError

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

CloudErrorBody

錯誤詳細數據。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

RuleState

規則的可能狀態

ScopeElement

更具體的範圍,用來識別要隱藏的警示。

SuppressionAlertsScope

AlertsSuppressionRule

描述歸並規則

名稱 類型 Description
id

string

資源標識碼

name

string

資源名稱

properties.alertType

string

要自動隱藏的警示類型。 針對所有警示類型,請使用 '*'

properties.comment

string

任何有關規則的批注

properties.expirationDateUtc

string

規則的到期日,如果未提供值或提供為 null,則完全不會到期

properties.lastModifiedUtc

string

上次修改此規則的時間

properties.reason

string

關閉警示的原因

properties.state

RuleState

規則的可能狀態

properties.suppressionAlertsScope

SuppressionAlertsScope

歸併條件

type

string

資源類型

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

其他信息類型。

RuleState

規則的可能狀態

名稱 類型 Description
Disabled

string

Enabled

string

Expired

string

ScopeElement

更具體的範圍,用來識別要隱藏的警示。

名稱 類型 Description
field

string

要隱藏的警示實體類型。

SuppressionAlertsScope

名稱 類型 Description
allOf

ScopeElement[]

內部的所有條件都必須為 true,才能隱藏警示