Database Security Alert Policies - Get

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/securityAlertPolicies/default?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 jsou definovány zásady výstrah zabezpečení.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
securityAlertPolicyName	path	True	SecurityAlertPolicyName	Název zásady upozornění zabezpečení.
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	DatabaseSecurityAlertPolicy	Zásady upozornění zabezpečení databáze se úspěšně načetly.
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 u zadaného účtu úložiště. 400 SecurityAlertPoliciesStorageAccountIsDisabled – účet úložiště uvedený v zásadách detekce hrozeb je zakázaný. 400 SecurityAlertPoliciesInsufficientDiskSpace – nedostatek místa na disku k uložení metadat zásad výstrah 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 zásad zabezpečení detekce hrozeb na vytvoření databáze neexistuje nebo nemá žádný objekt properties. 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ý na této instanci serveru neexistuje. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 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 výstrah 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 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 a database's threat detection policy

Ukázkový požadavek

HTTP

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

Java

import com.azure.resourcemanager.sql.models.SecurityAlertPolicyName;

/**
 * Samples for DatabaseSecurityAlertPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseSecurityAlertGet.json
     */
    /**
     * Sample code: Get a database's threat detection policy.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSThreatDetectionPolicy(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseSecurityAlertPolicies().getWithResponse(
            "securityalert-6852", "securityalert-2080", "testdb", SecurityAlertPolicyName.DEFAULT,
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:

200

{
  "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"
  }
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DatabaseSecurityAlertPolicy	Zásady výstrah zabezpečení databáze.
SecurityAlertPolicyName	Název zásady upozornění zabezpečení.
SecurityAlertsPolicyState	Určuje stav zásady, jestli je zásada povolená nebo zakázaná nebo jestli se pro konkrétní databázi ještě nepoužádila.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DatabaseSecurityAlertPolicy

Zásady výstrah zabezpečení databáze.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.creationTime	string	Určuje čas vytvoření zásady v UTC.
properties.disabledAlerts	string[]	Určuje pole výstrah, které jsou zakázány. 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é je výstraha odeslána.
properties.retentionDays	integer	Určuje počet dnů, které se mají uchovávat v protokolech auditu detekce hrozeb.
properties.state	SecurityAlertsPolicyState	Určuje stav zásady, jestli je zásada povolená nebo zakázaná nebo jestli se pro konkrétní databázi ještě nepoužádila.
properties.storageAccountAccessKey	string	Určuje klíč identifikátoru účtu úložiště pro audit detekce 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 prostředku.

SecurityAlertPolicyName

Název zásady upozornění zabezpečení.

Name	Typ	Description
default	string

SecurityAlertsPolicyState

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

Name	Typ	Description
Disabled	string
Enabled	string

systemData

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

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identita, která vytvořila prostředek.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny prostředku (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.