Sdílet prostřednictvím

Database Security Alert Policies - List By Database

  • Reference
Služba:
SQL Database
Verze rozhraní API:
2021-11-01

Získá seznam zásad výstrah zabezpečení databáze.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
databaseName
 path True

string

Název databáze, pro kterou je definována zásada výstrahy zabezpečení.
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
serverName
 path True

string

Název serveru.
subscriptionId
 path True

string

ID předplatného, které identifikuje předplatné Azure.
api-version
 query True

string

Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name Typ Description
200 OK

DatabaseSecurityAlertListResult

Úspěšně se načetly zásady upozornění zabezpečení databáze.
Other Status Codes

Chybové odpovědi: ***

  • 400 UpdateNotAllowedOnPausedDatabase – uživatel se pokusil provést aktualizaci pozastavené databáze.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions – Nedostatečná oprávnění ke čtení nebo zápisu pro zadaný účet úložiště.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled – Účet úložiště zadaný v zásadách detekce hrozeb je zakázaný.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace – Nedostatek místa na disku pro uložení metadat zásad upozornění zabezpečení v databázi

  • 400 SecurityAlertPoliciesInvalidStorageAccountName – Zadaný účet úložiště není platný nebo neexistuje.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials – Zadaný přístupový klíč účtu úložiště není platný.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest – Požadavek na zásadu zabezpečení detekce hrozeb pro vytvoření databáze neexistuje nebo nemá žádný objekt vlastností.

  • 400 DataSecurityInvalidUserSuppliedParameter – klient zadal neplatnou hodnotu parametru.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed – Při ukládání nastavení detekce hrozeb došlo k chybě. Zkuste to prosím znovu později.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed – Při ukládání nastavení detekce hrozeb došlo k chybě. Zkuste to prosím znovu později.

  • 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který v této instanci serveru neexistuje.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

  • 404 UpsertDatabaseSecurityAlertPolicyFailed – Při ukládání nastavení detekce hrozeb došlo k chybě. Zkuste to prosím znovu později.

  • 409 DatabaseSecurityAlertPolicyInProgress – Nastavení zásad upozornění zabezpečení databáze už probíhá

  • 409 UpsertDatabaseSecurityAlertPolicyFailed – při ukládání nastavení detekce hrozeb došlo k chybě. Zkuste to prosím znovu později.

  • 500 DatabaseIsUnavailable – Načtení se nezdařilo. Zkuste to prosím znovu později.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed – Při ukládání nastavení detekce hrozeb došlo k chybě. Zkuste to prosím znovu později.

  • 500 GetDatabaseSecurityAlertPolicyFailed – Nepodařilo se získat nastavení detekce hrozeb

Příklady

Get the database's threat detection policies

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
      }
    }
  ]
}

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.
DatabaseSecurityAlertListResult

Seznam zásad výstrah zabezpečení databáze.
DatabaseSecurityAlertPolicy

Zásady upozornění zabezpečení databáze.
SecurityAlertsPolicyState

Určuje stav zásady bez ohledu na to, jestli je povolená nebo zakázaná, nebo jestli se na konkrétní databázi ještě nepoužádá zásada.
systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota Description
Application
Key
ManagedIdentity
User

DatabaseSecurityAlertListResult

Objekt

Seznam zásad výstrah zabezpečení databáze.

Name Typ Description
nextLink

string

Odkaz na načtení další stránky výsledků
value

DatabaseSecurityAlertPolicy[]

Pole výsledků

DatabaseSecurityAlertPolicy

Objekt

Zásady upozornění zabezpečení databáze.

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku
properties.creationTime

string (date-time)

Určuje čas vytvoření zásady UTC.
properties.disabledAlerts

string[]

Určuje pole výstrah, které jsou zakázané. Povolené hodnoty jsou: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force
properties.emailAccountAdmins

boolean

Určuje, že se výstraha odešle správcům účtu.
properties.emailAddresses

string[]

Určuje pole e-mailových adres, na které se výstraha odešle.
properties.retentionDays

integer (int32)

Určuje počet dnů, které se mají uchovávat v protokolech auditu detekce hrozeb.
properties.state

SecurityAlertsPolicyState

Určuje stav zásady bez ohledu na to, jestli je povolená nebo zakázaná, nebo jestli se na konkrétní databázi ještě nepoužádá zásada.
properties.storageAccountAccessKey

string

Určuje klíč identifikátoru účtu úložiště pro detekci hrozeb.
properties.storageEndpoint

string

Určuje koncový bod úložiště objektů blob (např. https://MyAccount.blob.core.windows.net). Toto úložiště objektů blob bude obsahovat všechny protokoly auditu detekce hrozeb.
systemData

systemData

SystemData of SecurityAlertPolicyResource.
type

string

Typ zdroje.

SecurityAlertsPolicyState

Výčet

Určuje stav zásady bez ohledu na to, jestli je povolená nebo zakázaná, nebo jestli se na konkrétní databázi ještě nepoužádá zásada.

Hodnota Description
Disabled
Enabled

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).
createdBy

string

Identita, která prostředek vytvořila.
createdByType

createdByType

Typ identity, která prostředek vytvořila.
lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)
lastModifiedBy

string

Identita, která naposledy změnila prostředek.
lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.