Dela via

Database Security Alert Policies - List By Database

  • Referens
Tjänst:
SQL Database
API-version:
2021-11-01

Hämtar en lista över databasens principer för säkerhetsaviseringar.

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

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
 path True

string

Namnet på databasen som säkerhetsvarningsprincipen har definierats för.
resourceGroupName
 path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName
 path True

string

Namnet på servern.
subscriptionId
 path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version
 query True

string

DEN API-version som ska användas för begäran.

Svar

Name Typ Description
200 OK

DatabaseSecurityAlertListResult

Säkerhetsaviseringsprincipen för databasen har hämtats.
Other Status Codes

Felsvar: ***

  • 400 UpdateNotAllowedOnPausedDatabase – Användaren försökte utföra en uppdatering på en pausad databas.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions – Otillräckliga läs- eller skrivbehörigheter för det angivna lagringskontot.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled – Lagringskontot som anges i hotidentifieringsprincipen är inaktiverat.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace – Otillräckligt diskutrymme för att spara metadata för säkerhetsaviseringar i databasen

  • 400 SecurityAlertPoliciesInvalidStorageAccountName – det angivna lagringskontot är inte giltigt eller finns inte.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials – den angivna åtkomstnyckeln för lagringskontot är inte giltig.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest – Principbegäran om att skapa databashotidentifieringssäkerhet finns inte eller har inget egenskapsobjekt.

  • 400 DataSecurityInvalidUserSuppliedParameter – ett ogiltigt parametervärde angavs av klienten.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed – Ett fel uppstod när inställningar för hotidentifiering sparades. Försök igen senare

  • 400 UpsertDatabaseSecurityAlertPolicyFailed – Ett fel uppstod när inställningar för hotidentifiering sparades. Försök igen senare

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 UpsertDatabaseSecurityAlertPolicyFailed – Ett fel uppstod när inställningar för hotidentifiering sparades. Försök igen senare

  • 409 DatabaseSecurityAlertPolicyInProgress – Ange princip för databassäkerhetsaviseringar pågår redan

  • 409 UpsertDatabaseSecurityAlertPolicyFailed – Ett fel uppstod när inställningar för hotidentifiering sparades. Försök igen senare

  • 500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed – Ett fel uppstod när inställningar för hotidentifiering sparades. Försök igen senare

  • 500 GetDatabaseSecurityAlertPolicyFailed – Det gick inte att hämta inställningar för hotidentifiering

Exempel

Get the database's threat detection policies

Exempelbegäran

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

Exempelsvar

Statuskod:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-6852/providers/Microsoft.Sql/servers/securityalert-2080/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@consoto.com",
          "user@consoto.com"
        ],
        "disabledAlerts": [
          "Usage_Anomaly"
        ],
        "retentionDays": 0,
        "storageEndpoint": "",
        "creationTime": "2020-04-03T04:41:33.937Z"
      }
    }
  ]
}

Definitioner

Name Description
createdByType

Den typ av identitet som skapade resursen.
DatabaseSecurityAlertListResult

En lista över databasens principer för säkerhetsaviseringar.
DatabaseSecurityAlertPolicy

En princip för databassäkerhetsaviseringar.
SecurityAlertsPolicyState

Anger status för principen, om den är aktiverad eller inaktiverad eller om en princip ännu inte har tillämpats på den specifika databasen.
systemData

Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DatabaseSecurityAlertListResult

En lista över databasens principer för säkerhetsaviseringar.

Name Typ Description
nextLink

string

Länk för att hämta nästa sida med resultat.
value

DatabaseSecurityAlertPolicy[]

Matris med resultat.

DatabaseSecurityAlertPolicy

En princip för databassäkerhetsaviseringar.

Name Typ Description
id

string

Resurs-ID.
name

string

Resursnamn.
properties.creationTime

string

Anger utc-skapandetiden för principen.
properties.disabledAlerts

string[]

Anger en matris med aviseringar som är inaktiverade. Tillåtna värden är: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force
properties.emailAccountAdmins

boolean

Anger att aviseringen skickas till kontoadministratörerna.
properties.emailAddresses

string[]

Anger en matris med e-postadresser som aviseringen skickas till.
properties.retentionDays

integer

Anger hur många dagar som ska behållas i granskningsloggarna för hotidentifiering.
properties.state

SecurityAlertsPolicyState

Anger status för principen, om den är aktiverad eller inaktiverad eller om en princip ännu inte har tillämpats på den specifika databasen.
properties.storageAccountAccessKey

string

Anger identifierarnyckeln för granskningslagringskontot för hotidentifiering.
properties.storageEndpoint

string

Anger bloblagringsslutpunkten (t.ex. https://MyAccount.blob.core.windows.net). Den här bloblagringen innehåller alla granskningsloggar för hotidentifiering.
systemData

systemData

SystemData för SecurityAlertPolicyResource.
type

string

Resurstyp.

SecurityAlertsPolicyState

Anger status för principen, om den är aktiverad eller inaktiverad eller om en princip ännu inte har tillämpats på den specifika databasen.

Name Typ Description
Disabled

string

Enabled

string

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).
createdBy

string

Identiteten som skapade resursen.
createdByType

createdByType

Den typ av identitet som skapade resursen.
lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy

string

Identiteten som senast ändrade resursen.
lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.