Alerts Suppression Rules - Update
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 identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
alerts
|
path | True |
string |
Unikatowa nazwa reguły alertu pomijania |
subscription
|
path | True |
string |
Identyfikator subskrypcji platformy Azure Wzorzec wyrażenia regularnego: |
api-version
|
query | True |
string |
Wersja interfejsu API dla operacji |
Treść żą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 |
Możliwe stany reguły |
|
properties.comment |
string |
Dowolny komentarz dotyczący reguły |
|
properties.expirationDateUtc |
string |
Data wygaśnięcia reguły, jeśli wartość nie jest podana lub podana jako null, w ogóle nie wygaśnie |
|
properties.suppressionAlertsScope |
Warunki pomijania |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Update or create suppression rule for subscription
Przykładowe żądanie
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ź
{
"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 |
---|---|
Alerts |
Opisuje regułę pomijania |
Cloud |
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). |
Cloud |
Szczegóły błędu. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Rule |
Możliwe stany reguły |
Scope |
Bardziej szczegółowy zakres używany do identyfikowania alertów do pomijania. |
Suppression |
AlertsSuppressionRule
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 |
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 |
Ostatni raz ta reguła została zmodyfikowana |
properties.reason |
string |
Przyczyna odrzucenia alertu |
properties.state |
Możliwe stany reguły |
|
properties.suppressionAlertsScope |
Warunki pomijania |
|
type |
string |
Typ zasobu |
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).
Nazwa | Typ | Opis |
---|---|---|
error.additionalInfo |
Dodatkowe informacje o błędzie. |
|
error.code |
string |
Kod błędu. |
error.details |
Szczegóły błędu. |
|
error.message |
string |
Komunikat o błędzie. |
error.target |
string |
Element docelowy błędu. |
CloudErrorBody
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
RuleState
Możliwe stany reguły
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
Expired |
string |
ScopeElement
Bardziej szczegółowy zakres używany do identyfikowania alertów do pomijania.
Nazwa | Typ | Opis |
---|---|---|
field |
string |
Typ jednostki alertu do pomijania. |
SuppressionAlertsScope
Nazwa | Typ | Opis |
---|---|---|
allOf |
Wszystkie warunki wewnątrz muszą być spełnione, aby pominąć alert |