你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Alerts Suppression Rules - Update

更新现有规则或创建新规则(如果不存在)

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

URI 参数

名称 必需 类型 说明
alertsSuppressionRuleName
path True

string

抑制警报规则的唯一名称

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 版本

请求正文

名称 必需 类型 说明
properties.alertType True

string

要自动取消的警报的类型。 对于所有警报类型,请使用“*”

properties.reason True

string

消除警报的原因

properties.state True

RuleState

规则的可能状态

properties.comment

string

有关规则的任何注释

properties.expirationDateUtc

string

规则的到期日期,如果未提供或提供值为 null,则根本不会过期

properties.suppressionAlertsScope

SuppressionAlertsScope

抑制条件

响应

名称 类型 说明
200 OK

AlertsSuppressionRule

确定

Other Status Codes

CloudError

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

Scopes

名称 说明
user_impersonation 模拟用户帐户

示例

Update or create suppression rule for subscription

Sample Request

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

Sample Response

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

定义

名称 说明
AlertsSuppressionRule

描述抑制规则

CloudError

对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。

CloudErrorBody

错误详细信息。

ErrorAdditionalInfo

资源管理错误附加信息。

RuleState

规则的可能状态

ScopeElement

一个更具体的范围,用于标识要取消的警报。

SuppressionAlertsScope

AlertsSuppressionRule

描述抑制规则

名称 类型 说明
id

string

资源 ID

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 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。

名称 类型 说明
error.additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

error.code

string

错误代码。

error.details

CloudErrorBody[]

错误详细信息。

error.message

string

错误消息。

error.target

string

错误目标。

CloudErrorBody

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

CloudErrorBody[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

RuleState

规则的可能状态

名称 类型 说明
Disabled

string

Enabled

string

Expired

string

ScopeElement

一个更具体的范围,用于标识要取消的警报。

名称 类型 说明
field

string

要抑制的警报实体类型。

SuppressionAlertsScope

名称 类型 说明
allOf

ScopeElement[]

若要取消警报,内部的所有条件都需要为 true