Delen via


Database Security Alert Policies - Get

Hiermee haalt u het beveiligingswaarschuwingsbeleid van een database op.

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

URI-parameters

Name In Vereist Type Description
databaseName
path True

string

De naam van de database waarvoor het beveiligingswaarschuwingsbeleid is gedefinieerd.

resourceGroupName
path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.

securityAlertPolicyName
path True

SecurityAlertPolicyName

De naam van het beveiligingswaarschuwingsbeleid.

serverName
path True

string

De naam van de server.

subscriptionId
path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.

api-version
query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name Type Description
200 OK

DatabaseSecurityAlertPolicy

Het beveiligingswaarschuwingsbeleid voor de database is opgehaald.

Other Status Codes

Foutreacties: ***

  • 400 UpdateNotAllowedOnPausedDatabase - Gebruiker heeft geprobeerd een update uit te voeren op een onderbroken database.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions - Onvoldoende lees- of schrijfmachtigingen voor het opgegeven opslagaccount.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled : het opslagaccount dat is opgegeven in het beleid voor detectie van bedreigingen is uitgeschakeld.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace - Onvoldoende schijfruimte om metagegevens van beveiligingswaarschuwingsbeleid op te slaan in de database

  • 400 SecurityAlertPoliciesInvalidStorageAccountName - Het opgegeven opslagaccount is niet geldig of bestaat niet.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials : de opgegeven toegangssleutel voor het opslagaccount is ongeldig.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest - De aanvraag voor het beveiligingswaarschuwingsbeleid voor het maken van de database Bedreigingsdetectie bestaat niet of heeft geen eigenschappenobject.

  • 400 DataSecurityInvalidUserSuppliedParameter - Er is een ongeldige parameterwaarde opgegeven door de client.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed - Er is een fout opgetreden tijdens het opslaan van instellingen voor bedreigingsdetectie. Probeer het later opnieuw

  • 400 UpsertDatabaseSecurityAlertPolicyFailed - Er is een fout opgetreden tijdens het opslaan van instellingen voor bedreigingsdetectie. Probeer het later opnieuw

  • 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaar.

  • 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden

  • 404 UpsertDatabaseSecurityAlertPolicyFailed - Er is een fout opgetreden tijdens het opslaan van instellingen voor detectie van bedreigingen. Probeer het later opnieuw

  • 409 DatabaseSecurityAlertPolicyInProgress - Beveiligingswaarschuwingsbeleid voor database instellen wordt al uitgevoerd

  • 409 UpsertDatabaseSecurityAlertPolicyFailed - Er is een fout opgetreden tijdens het opslaan van instellingen voor detectie van bedreigingen. Probeer het later opnieuw

  • 500 DatabaseIsUnavailable - Laden is mislukt. Probeert u het later nog eens.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed - Er is een fout opgetreden tijdens het opslaan van instellingen voor bedreigingsdetectie. Probeer het later opnieuw

  • 500 GetDatabaseSecurityAlertPolicyFailed - Kan instellingen voor detectie van bedreigingen niet ophalen

Voorbeelden

Get a database's threat detection policy

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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,
    "creationTime": "2020-04-03T04:41:33.937Z"
  }
}

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

DatabaseSecurityAlertPolicy

Een beveiligingswaarschuwingsbeleid voor databases.

SecurityAlertPolicyName

De naam van het beveiligingswaarschuwingsbeleid.

SecurityAlertsPolicyState

Hiermee geeft u de status van het beleid op, of het is ingeschakeld of uitgeschakeld of een beleid is nog niet toegepast op de specifieke database.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

DatabaseSecurityAlertPolicy

Een beveiligingswaarschuwingsbeleid voor databases.

Name Type Description
id

string

Resource-id.

name

string

Resourcenaam.

properties.creationTime

string

Hiermee geeft u de UTC-aanmaaktijd van het beleid op.

properties.disabledAlerts

string[]

Hiermee geeft u een matrix van waarschuwingen die zijn uitgeschakeld. Toegestane waarden zijn: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force

properties.emailAccountAdmins

boolean

Hiermee geeft u op dat de waarschuwing wordt verzonden naar de accountbeheerders.

properties.emailAddresses

string[]

Hiermee geeft u een matrix met e-mailadressen op waarnaar de waarschuwing wordt verzonden.

properties.retentionDays

integer

Hiermee geeft u het aantal dagen op dat moet worden bewaard in de auditlogboeken voor detectie van bedreigingen.

properties.state

SecurityAlertsPolicyState

Hiermee geeft u de status van het beleid op, of het is ingeschakeld of uitgeschakeld of een beleid is nog niet toegepast op de specifieke database.

properties.storageAccountAccessKey

string

Hiermee geeft u de id-sleutel van het auditopslagaccount bedreigingsdetectie op.

properties.storageEndpoint

string

Hiermee geeft u het eindpunt voor blobopslag op (bijvoorbeeld https://MyAccount.blob.core.windows.net). Deze blobopslag bevat alle auditlogboeken voor detectie van bedreigingen.

systemData

systemData

SystemData van SecurityAlertPolicyResource.

type

string

Resourcetype.

SecurityAlertPolicyName

De naam van het beveiligingswaarschuwingsbeleid.

Waarde Description
default

SecurityAlertsPolicyState

Hiermee geeft u de status van het beleid op, of het is ingeschakeld of uitgeschakeld of een beleid is nog niet toegepast op de specifieke database.

Waarde Description
Disabled
Enabled

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

Het tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.