Managed Database Security Events - List By Database

Dienst:
SQL Database
API-Version:
2025-01-01

Ruft eine Liste der Sicherheitsereignisse ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/securityEvents?api-version=2025-01-01
Mit optionalen Parametern: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/securityEvents?$filter={$filter}&$skip={$skip}&$top={$top}&$skiptoken={$skiptoken}&api-version=2025-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
 path True

string

Der Name der verwalteten Datenbank, für die die Sicherheitsereignisse abgerufen werden.
managedInstanceName
 path True

string

Der Name der verwalteten Instanz.
resourceGroupName
 path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
subscriptionId
 path True

string

Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version
 query True

string

Die API-Version, die für die Anforderung verwendet werden soll.
$filter
 query

string

Ein OData-Filterausdruck, der Elemente in der Auflistung filtert.
$skip
 query

integer (int64)

Die Anzahl der elemente in der Auflistung, die übersprungen werden sollen.
$skiptoken
 query

string

Ein undurchsichtiges Token, das einen Ausgangspunkt in der Sammlung identifiziert.
$top
 query

integer (int64)

Die Anzahl der Elemente, die aus der Auflistung zurückgegeben werden sollen.

Antworten

Name Typ Beschreibung
200 OK

SecurityEventCollection

Die Liste der Sicherheitsereignisse wurde erfolgreich abgerufen.
Other Status Codes

ErrorResponse

Fehlerantworten: ***

  • 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird

  • 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt

  • 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.

  • 404 SourceDatabaseNotFound – Die Quelldatenbank ist nicht vorhanden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

Beispiele

Get the managed database's security events with maximal parameters
Get the managed database's security events with minimal parameters

Get the managed database's security events with maximal parameters

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents?$filter=ShowServerRecords eq true&$skip=0&$top=1&$skiptoken=eyJCbG9iTmFtZURhdGVUaW1lIjoiXC9EYXRlKDE1MTIyODg4MTIwMTArMDIwMClcLyIsIkJsb2JOYW1lUm9sbG92ZXJJbmRleCI6IjAiLCJFbmREYXRlIjoiXC9EYXRlKDE1MTI0NjYyMDA1MjkpXC8iLCJJc1NraXBUb2tlblNldCI6ZmFsc2UsIklzVjJCbG9iVGltZUZvcm1hdCI6dHJ1ZSwiU2hvd1NlcnZlclJlY29yZHMiOmZhbHNlLCJTa2lwVmFsdWUiOjAsIlRha2VWYWx1ZSI6MTB9&api-version=2025-01-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "nextLink": "https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents?$skipToken=C9EYXRlKDE1MTIyODg4MTIwMTArMDIwMClcLyIsIkJsb2JOYW1lUm9sbC9EYXRlKDE1MTIyODg4MTIwMTArMDIwMClcLyIsIkJsb2JOYW1lUm9sbC9EYXRlKDE1MTIyODg4MTIwMTArMDIwMClcLyIsIkJsb2JOYW1lUm9sbC9EYXRlKDE1MTIyODg4MTIwMTArMDIwMClcLyIsIkJsb2JOYW1lUm9sb&api-version=2017-10-01-preview",
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents/06364798761800000000000000001",
      "name": "06364798761800000000000000001",
      "type": "Microsoft.Sql/servers/databases/securityEvents",
      "properties": {
        "eventTime": "2017-12-24T10:13:24.729Z",
        "securityEventType": "SqlInjectionExploit",
        "subscription": "00000000-1111-2222-3333-444444444444",
        "server": "testcl",
        "database": "database1",
        "clientIp": "10.166.113.220",
        "applicationName": "myApp",
        "principalName": "maliciousUser",
        "securityEventSqlInjectionAdditionalProperties": {
          "threatId": "1",
          "statement": "select * from sys.databases where database_id like '' or 1 = 1 --' and family = 'test11'",
          "statementHighlightOffset": 52,
          "statementHighlightLength": 13,
          "errorCode": 0,
          "errorSeverity": 0,
          "errorMessage": ""
        }
      }
    }
  ]
}

Get the managed database's security events with minimal parameters

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents?api-version=2025-01-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents/06364798761800000000000000001",
      "name": "06364798761800000000000000001",
      "type": "Microsoft.Sql/servers/databases/securityEvents",
      "properties": {
        "eventTime": "2017-12-24T10:13:24.729Z",
        "securityEventType": "SqlInjectionExploit",
        "subscription": "00000000-1111-2222-3333-444444444444",
        "server": "testcl",
        "database": "database1",
        "clientIp": "10.166.113.220",
        "applicationName": "myApp",
        "principalName": "maliciousUser",
        "securityEventSqlInjectionAdditionalProperties": {
          "threatId": "1",
          "statement": "select * from sys.databases where database_id like '' or 1 = 1 --' and family = 'test11'",
          "statementHighlightOffset": 52,
          "statementHighlightLength": 13,
          "errorCode": 0,
          "errorSeverity": 0,
          "errorMessage": ""
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents/06364798761800000000000000002",
      "name": "06364798761800000000000000002",
      "type": "Microsoft.Sql/servers/databases/securityEvents",
      "properties": {
        "eventTime": "2017-12-24T10:11:14.121Z",
        "securityEventType": "SqlInjectionExploit",
        "subscription": "00000000-1111-2222-3333-444444444444",
        "server": "testcl",
        "database": "database1",
        "clientIp": "10.166.113.220",
        "applicationName": "myApp",
        "principalName": "maliciousUser",
        "securityEventSqlInjectionAdditionalProperties": {
          "threatId": "1",
          "statement": "select * from sys.databases where database_id like '' or 1 = 1 --' and family = 'test10'",
          "statementHighlightOffset": 52,
          "statementHighlightLength": 13,
          "errorCode": 0,
          "errorSeverity": 0,
          "errorMessage": ""
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/database1/securityEvents/06364798761800000000000000003",
      "name": "06364798761800000000000000003",
      "type": "Microsoft.Sql/servers/databases/securityEvents",
      "properties": {
        "eventTime": "2017-12-24T10:03:17.066Z",
        "securityEventType": "SqlInjectionExploit",
        "subscription": "00000000-1111-2222-3333-444444444444",
        "server": "testcl",
        "database": "database1",
        "clientIp": "10.166.113.220",
        "applicationName": "myApp",
        "principalName": "maliciousUser",
        "securityEventSqlInjectionAdditionalProperties": {
          "threatId": "1",
          "statement": "select * from sys.databases where database_id like '' or 1 = 1 --' and family = 'test9'",
          "statementHighlightOffset": 52,
          "statementHighlightLength": 13,
          "errorCode": 0,
          "errorSeverity": 0,
          "errorMessage": ""
        }
      }
    }
  ]
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort
SecurityEvent

Ein Sicherheitsereignis.
SecurityEventCollection

Eine Liste der Sicherheitsereignisse.
SecurityEventSqlInjectionAdditionalProperties

Die Eigenschaften eines Sql-Injection-Sicherheitsereignisses.
SecurityEventType

Der Typ des Sicherheitsereignisses.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

SecurityEvent

Objekt

Ein Sicherheitsereignis.

Name Typ Beschreibung
id

string

Ressourcen-ID
name

string

Ressourcenname.
properties.applicationName

string

Die Anwendung, die zum Ausführen der Anweisung verwendet wird.
properties.clientIp

string

Die IP-Adresse des Clients, der die Anweisung ausgeführt hat.
properties.database

string

Datenbankname
properties.eventTime

string (date-time)

Der Zeitpunkt, zu dem das Sicherheitsereignis aufgetreten ist.
properties.principalName

string

Der Hauptbenutzer, der die Anweisung ausgeführt hat
properties.securityEventSqlInjectionAdditionalProperties

SecurityEventSqlInjectionAdditionalProperties

Die zusätzlichen Eigenschaften der SQL-Einfügung werden nur ausgefüllt, wenn der Typ des Sicherheitsereignisses sql injection ist.
properties.securityEventType

SecurityEventType

Der Typ des Sicherheitsereignisses.
properties.server

string

Der Servername
properties.subscription

string

Der Abonnementname
type

string

Ressourcentyp.

SecurityEventCollection

Objekt

Eine Liste der Sicherheitsereignisse.

Name Typ Beschreibung
nextLink

string

Link zum Abrufen der nächsten Seite mit Ergebnissen.
value

SecurityEvent[]

Array von Ergebnissen.

SecurityEventSqlInjectionAdditionalProperties

Objekt

Die Eigenschaften eines Sql-Injection-Sicherheitsereignisses.

Name Typ Beschreibung
errorCode

integer (int32)

Sql-Fehlercode
errorMessage

string

Die SQL-Fehlermeldung
errorSeverity

integer (int32)

Sql-Fehlerschweregrad
statement

string

Die -Anweisung
statementHighlightLength

integer (int32)

Die Länge der Anweisung hervorheben
statementHighlightOffset

integer (int32)

Die Anweisung hebt den Offset hervor
threatId

string

Die Bedrohungs-ID.

SecurityEventType

Enumeration

Der Typ des Sicherheitsereignisses.

Wert Beschreibung
Undefined
SqlInjectionVulnerability
SqlInjectionExploit