Freigeben über


Database Security Alert Policies - Create Or Update

Erstellt oder aktualisiert die Sicherheitswarnungsrichtlinie einer Datenbank.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/securityAlertPolicies/default?api-version=2021-11-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
path True

string

Der Name der Datenbank, für die die Sicherheitswarnungsrichtlinie definiert ist.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

securityAlertPolicyName
path True

SecurityAlertPolicyName

Der Name der Sicherheitswarnungsrichtlinie.

serverName
path True

string

Name des Servers

subscriptionId
path True

string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True

string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.state True

SecurityAlertsPolicyState

Gibt den Status der Richtlinie an, unabhängig davon, ob sie aktiviert oder deaktiviert ist oder noch keine Richtlinie auf die bestimmte Datenbank angewendet wurde.

properties.disabledAlerts

string[]

Gibt ein Array von Warnungen an, die deaktiviert sind. Zulässige Werte sind: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force

properties.emailAccountAdmins

boolean

Gibt an, dass die Warnung an die Kontoadministratoren gesendet wird.

properties.emailAddresses

string[]

Gibt ein Array von E-Mail-Adressen an, an die die Warnung gesendet wird.

properties.retentionDays

integer

Gibt die Anzahl der Tage an, die in den Überwachungsprotokollen für die Bedrohungserkennung aufbewahrt werden soll.

properties.storageAccountAccessKey

string

Gibt den Bezeichnerschlüssel des Überwachungsspeicherkontos für die Bedrohungserkennung an.

properties.storageEndpoint

string

Gibt den Blobspeicherendpunkt an (z. B. https://MyAccount.blob.core.windows.net). Dieser Blobspeicher enthält alle Überwachungsprotokolle zur Bedrohungserkennung.

Antworten

Name Typ Beschreibung
200 OK

DatabaseSecurityAlertPolicy

Die Datenbanksicherheitswarnungsrichtlinie wurde erfolgreich festgelegt.

201 Created

DatabaseSecurityAlertPolicy

Die Datenbanksicherheitswarnungsrichtlinie wurde erfolgreich erstellt.

Other Status Codes

Fehlerantworten: ***

  • 400 UpdateNotAllowedOnPausedDatabase: Der Benutzer hat versucht, ein Update für eine angehaltene Datenbank auszuführen.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions : Unzureichende Lese- oder Schreibberechtigungen für das bereitgestellte Speicherkonto.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled: Das in der Bedrohungserkennungsrichtlinie angegebene Speicherkonto ist deaktiviert.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace – Unzureichender Speicherplatz zum Speichern von Metadaten der Sicherheitswarnungsrichtlinie in der Datenbank

  • 400 SecurityAlertPoliciesInvalidStorageAccountName: Das angegebene Speicherkonto ist ungültig oder nicht vorhanden.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials: Der angegebene Zugriffsschlüssel für das Speicherkonto ist ungültig.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest: Die Sicherheitswarnungsanforderung zum Erstellen der Datenbank-Bedrohungserkennung ist nicht vorhanden oder weist kein Eigenschaftenobjekt auf.

  • 400 DataSecurityInvalidUserSuppliedParameter: Vom Client wurde ein ungültiger Parameterwert bereitgestellt.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed: Fehler beim Speichern der Einstellungen für die Bedrohungserkennung. Versuchen Sie es später erneut.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed: Fehler beim Speichern der Einstellungen für die Bedrohungserkennung. Versuchen Sie es später erneut.

  • 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist.

  • 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.

  • 404 UpsertDatabaseSecurityAlertPolicyFailed: Fehler beim Speichern der Einstellungen für die Bedrohungserkennung. Versuchen Sie es später erneut.

  • 409 DatabaseSecurityAlertPolicyInProgress – Festlegen der Datenbanksicherheitswarnungsrichtlinie wird bereits ausgeführt

  • 409 UpsertDatabaseSecurityAlertPolicyFailed: Fehler beim Speichern der Einstellungen für die Bedrohungserkennung. Versuchen Sie es später erneut.

  • 500 DatabaseIsUnavailable: Fehler beim Laden. Versuchen Sie es später noch mal.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed: Fehler beim Speichern der Einstellungen für die Bedrohungserkennung. Versuchen Sie es später erneut.

  • 500 GetDatabaseSecurityAlertPolicyFailed: Fehler beim Abrufen der Einstellungen für die Bedrohungserkennung

Beispiele

Update a database's threat detection policy with all parameters
Update a database's threat detection policy with minimal parameters

Update a database's threat detection policy with all parameters

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb/securityAlertPolicies/default?api-version=2021-11-01

{
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@microsoft.com",
      "user@microsoft.com"
    ],
    "disabledAlerts": [
      "Sql_Injection",
      "Usage_Anomaly"
    ],
    "retentionDays": 6,
    "storageAccountAccessKey": "sdlfkjabc+sdlfkjsdlkfsjdfLDKFTERLKFDFKLjsdfksjdflsdkfD2342309432849328476458/3RSD==",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@microsoft.com",
      "user@microsoft.com"
    ],
    "disabledAlerts": [
      "Sql_Injection",
      "Usage_Anomaly"
    ],
    "retentionDays": 6,
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@microsoft.com",
      "user@microsoft.com"
    ],
    "disabledAlerts": [
      "Access_Anomaly",
      "Usage_Anomaly"
    ],
    "retentionDays": 6,
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Update a database's threat detection policy with minimal parameters

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb/securityAlertPolicies/default?api-version=2021-11-01

{
  "properties": {
    "state": "Enabled"
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [],
    "disabledAlerts": [],
    "retentionDays": 0,
    "storageEndpoint": ""
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [],
    "disabledAlerts": [],
    "retentionDays": 0,
    "storageEndpoint": ""
  }
}

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DatabaseSecurityAlertPolicy

Eine Datenbanksicherheitswarnungsrichtlinie.

SecurityAlertPolicyName

Der Name der Sicherheitswarnungsrichtlinie.

SecurityAlertsPolicyState

Gibt den Status der Richtlinie an, unabhängig davon, ob sie aktiviert oder deaktiviert ist oder noch keine Richtlinie auf die bestimmte Datenbank angewendet wurde.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

DatabaseSecurityAlertPolicy

Eine Datenbanksicherheitswarnungsrichtlinie.

Name Typ Beschreibung
id

string

Ressourcen-ID

name

string

Name der Ressource.

properties.creationTime

string

Gibt die UTC-Erstellungszeit der Richtlinie an.

properties.disabledAlerts

string[]

Gibt ein Array von Warnungen an, die deaktiviert sind. Zulässige Werte sind: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force

properties.emailAccountAdmins

boolean

Gibt an, dass die Warnung an die Kontoadministratoren gesendet wird.

properties.emailAddresses

string[]

Gibt ein Array von E-Mail-Adressen an, an die die Warnung gesendet wird.

properties.retentionDays

integer

Gibt die Anzahl der Tage an, die in den Überwachungsprotokollen für die Bedrohungserkennung aufbewahrt werden soll.

properties.state

SecurityAlertsPolicyState

Gibt den Status der Richtlinie an, unabhängig davon, ob sie aktiviert oder deaktiviert ist oder noch keine Richtlinie auf die bestimmte Datenbank angewendet wurde.

properties.storageAccountAccessKey

string

Gibt den Bezeichnerschlüssel des Überwachungsspeicherkontos für die Bedrohungserkennung an.

properties.storageEndpoint

string

Gibt den Blobspeicherendpunkt an (z. B. https://MyAccount.blob.core.windows.net). Dieser Blobspeicher enthält alle Überwachungsprotokolle zur Bedrohungserkennung.

systemData

systemData

SystemData von SecurityAlertPolicyResource.

type

string

Der Ressourcentyp.

SecurityAlertPolicyName

Der Name der Sicherheitswarnungsrichtlinie.

Name Typ Beschreibung
default

string

SecurityAlertsPolicyState

Gibt den Status der Richtlinie an, unabhängig davon, ob sie aktiviert oder deaktiviert ist oder noch keine Richtlinie auf die bestimmte Datenbank angewendet wurde.

Name Typ Beschreibung
Disabled

string

Enabled

string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.