Alerts Suppression Rules - Update

Služba:

Defender for Cloud

Verze rozhraní API:

2019-01-01-preview

Aktualizace existujícího pravidla nebo vytvoření nového pravidla, pokud neexistuje

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
alertsSuppressionRuleName	path	True	string	Jedinečný název pravidla upozornění potlačení
subscriptionId	path	True	string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	ID předplatného Azure
api-version	query	True	string	Verze rozhraní API pro operaci

Text požadavku

Name	Vyžadováno	Typ	Description
properties.alertType	True	string	Typ výstrahy, která se má automaticky potlačit. Pro všechny typy výstrah použijte *.
properties.reason	True	string	Důvod pro zavření výstrahy
properties.state	True	RuleState	Možné stavy pravidla
properties.comment		string	Jakýkoli komentář týkající se pravidla
properties.expirationDateUtc		string (date-time)	Datum vypršení platnosti pravidla, pokud hodnota není zadaná nebo zadaná jako hodnota null, nebude konec platnosti vůbec
properties.suppressionAlertsScope		SuppressionAlertsScope	Podmínky potlačení

Odpovědi

Name	Typ	Description
200 OK	AlertsSuppressionRule	OK
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Update or create suppression rule for subscription

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
AlertsSuppressionRule	Popisuje pravidlo potlačení.
CloudError	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
CloudErrorBody	Podrobnosti o chybě.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
RuleState	Možné stavy pravidla
ScopeElement	Konkrétnější obor používaný k identifikaci výstrah, které se mají potlačit.
SuppressionAlertsScope

AlertsSuppressionRule

Objekt

Popisuje pravidlo potlačení.

Name	Typ	Description
id	string	ID prostředku
name	string	Název prostředku
properties.alertType	string	Typ výstrahy, která se má automaticky potlačit. Pro všechny typy výstrah použijte *.
properties.comment	string	Jakýkoli komentář týkající se pravidla
properties.expirationDateUtc	string (date-time)	Datum vypršení platnosti pravidla, pokud hodnota není zadaná nebo zadaná jako hodnota null, nebude konec platnosti vůbec
properties.lastModifiedUtc	string (date-time)	Čas poslední změny tohoto pravidla
properties.reason	string	Důvod pro zavření výstrahy
properties.state	RuleState	Možné stavy pravidla
properties.suppressionAlertsScope	SuppressionAlertsScope	Podmínky potlačení
type	string	Typ prostředku

CloudError

Objekt

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
error.code	string	Kód chyby.
error.details	CloudErrorBody[]	Podrobnosti o chybě.
error.message	string	Chybová zpráva.
error.target	string	Cíl chyby.

CloudErrorBody

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	CloudErrorBody[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

RuleState

Výčet

Možné stavy pravidla

Hodnota	Description
Enabled
Disabled
Expired

ScopeElement

Objekt

Konkrétnější obor používaný k identifikaci výstrah, které se mají potlačit.

Name	Typ	Description
field	string	Typ entity výstrahy, který se má potlačit.

SuppressionAlertsScope

Objekt

Name	Typ	Description
allOf	ScopeElement[]	Aby bylo možné potlačit výstrahu, musí být splněny všechny podmínky uvnitř.