Alerts Suppression Rules - Update

Usługa:

Defender for Cloud

Wersja API:

2019-01-01-preview

Zaktualizuj istniejącą regułę lub utwórz nową regułę, jeśli nie istnieje

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

Parametry URI

Nazwa	W	Wymagane	Typ	Opis
alertsSuppressionRuleName	path	True	string	Unikatowa nazwa reguły alertu pomijania
subscriptionId	path	True	string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	Identyfikator subskrypcji platformy Azure
api-version	query	True	string	Wersja interfejsu API dla operacji

Ciało żądania

Nazwa	Wymagane	Typ	Opis
properties.alertType	True	string	Typ alertu do automatycznego pomijania. W przypadku wszystkich typów alertów użyj znaku "*"
properties.reason	True	string	Przyczyna odrzucenia alertu
properties.state	True	RuleState	Możliwe stany reguły
properties.comment		string	Dowolny komentarz dotyczący reguły
properties.expirationDateUtc		string (date-time)	Data wygaśnięcia reguły, jeśli wartość nie jest podana lub podana jako null, w ogóle nie wygaśnie
properties.suppressionAlertsScope		SuppressionAlertsScope	Warunki pomijania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AlertsSuppressionRule	OK
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update or create suppression rule for subscription

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:

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

Definicje

Nazwa	Opis
AlertsSuppressionRule	Opisuje regułę pomijania
CloudError	Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
CloudErrorBody	Szczegóły błędu.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
RuleState	Możliwe stany reguły
ScopeElement	Bardziej szczegółowy zakres używany do identyfikowania alertów do pomijania.
SuppressionAlertsScope

AlertsSuppressionRule

Sprzeciwiać się

Opisuje regułę pomijania

Nazwa	Typ	Opis
id	string	Identyfikator zasobu
name	string	Nazwa zasobu
properties.alertType	string	Typ alertu do automatycznego pomijania. W przypadku wszystkich typów alertów użyj znaku "*"
properties.comment	string	Dowolny komentarz dotyczący reguły
properties.expirationDateUtc	string (date-time)	Data wygaśnięcia reguły, jeśli wartość nie jest podana lub podana jako null, w ogóle nie wygaśnie
properties.lastModifiedUtc	string (date-time)	Ostatni raz ta reguła została zmodyfikowana
properties.reason	string	Przyczyna odrzucenia alertu
properties.state	RuleState	Możliwe stany reguły
properties.suppressionAlertsScope	SuppressionAlertsScope	Warunki pomijania
type	string	Typ zasobu

CloudError

Sprzeciwiać się

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa	Typ	Opis
error.additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
error.code	string	Kod błędu.
error.details	CloudErrorBody[]	Szczegóły błędu.
error.message	string	Komunikat o błędzie.
error.target	string	Element docelowy błędu.

CloudErrorBody

Sprzeciwiać się

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	CloudErrorBody[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorAdditionalInfo

Sprzeciwiać się

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

RuleState

Wyliczenie

Możliwe stany reguły

Wartość	Opis
Enabled
Disabled
Expired

ScopeElement

Sprzeciwiać się

Bardziej szczegółowy zakres używany do identyfikowania alertów do pomijania.

Nazwa	Typ	Opis
field	string	Typ jednostki alertu do pomijania.

SuppressionAlertsScope

Sprzeciwiać się

Nazwa	Typ	Opis
allOf	ScopeElement[]	Wszystkie warunki wewnątrz muszą być spełnione, aby pominąć alert