Blob Auditing - List By Server

Egy kiszolgáló naplózási beállításait sorolja fel.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/auditingSettings?api-version=2020-11-01-preview

URI-paraméterek

Name In Required Type Description
resourceGroupName
path True
  • string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True
  • string

A kiszolgáló neve.

subscriptionId
path True
  • string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True
  • string

A kéréshez használni kívánt API-verzió.

Válaszok

Name Type Description
200 OK

Sikeresen lekérte a kiszolgáló naplózási beállításait.

Other Status Codes

Hibaválaszok: ***

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

Példák

List auditing settings of a server

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-4799/providers/Microsoft.Sql/servers/blobauditingtest-6440/auditingSettings?api-version=2020-11-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/auditingSettings/default",
      "name": "default",
      "type": "Microsoft.Sql/servers/auditingSettings",
      "properties": {
        "state": "Disabled",
        "storageEndpoint": "",
        "retentionDays": 0,
        "auditActionsAndGroups": [],
        "storageAccountSubscriptionId": "00000000-0000-0000-0000-000000000000",
        "isStorageSecondaryKeyInUse": false,
        "isAzureMonitorTargetEnabled": false
      }
    }
  ]
}

Definíciók

BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

ServerBlobAuditingPolicy

Kiszolgálói blobnaplózási szabályzat.

ServerBlobAuditingPolicyListResult

A kiszolgálónaplózási beállítások listája.

BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

Name Type Description
Disabled
  • string
Enabled
  • string

ServerBlobAuditingPolicy

Kiszolgálói blobnaplózási szabályzat.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.auditActionsAndGroups
  • string[]

A naplózandó Actions-Groups és műveletek megadása.

A javasolt műveletcsoportok a következő kombinációt használják – ez naplózni fogja az adatbázison végrehajtott összes lekérdezést és tárolt eljárást, valamint a sikeres és sikertelen bejelentkezéseket:

BATCH_COMPLETED_GROUP, SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP, FAILED_DATABASE_AUTHENTICATION_GROUP.

Ez a fenti kombináció az a készlet is, amely alapértelmezés szerint konfigurálva van, amikor engedélyezi a naplózást a Azure Portal.

A naplózandó támogatott műveletcsoportok (megjegyzés: csak azokat a csoportokat válassza ki, amelyek megfelelnek a naplózási igényeknek. A szükségtelen csoportok használata nagyon nagy mennyiségű naplórekordhoz vezethet:

APPLICATION_ROLE_CHANGE_PASSWORD_GROUP BACKUP_RESTORE_GROUP DATABASE_LOGOUT_GROUP DATABASE_OBJECT_CHANGE_GROUP DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP DATABASE_OBJECT_PERMISSION_CHANGE_GROUP DATABASE_OPERATION_GROUP DATABASE_PERMISSION_CHANGE_GROUP DATABASE_PRINCIPAL_CHANGE_GROUP DATABASE_PRINCIPAL_IMPERSONATION_GROUP DATABASE_ROLE_MEMBER_CHANGE_GROUP FAILED_DATABASE_AUTHENTICATION_GROUP SCHEMA_OBJECT_ACCESS_GROUP SCHEMA_OBJECT_CHANGE_GROUP SCHEMA_OBJECT_ OWNERSHIP_CHANGE_GROUP SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP USER_CHANGE_PASSWORD_GROUP BATCH_STARTED_GROUP BATCH_COMPLETED_GROUP

Ezek olyan csoportok, amelyek lefedik az adatbázison végrehajtott összes SQL-utasítást és tárolt eljárást, és nem használhatók más csoportokkal együtt, mivel ez ismétlődő auditnaplókat eredményez.

További információ: Adatbázisszintű naplózási műveletcsoportok.

Az adatbázis-naplózási házirend esetében adott műveletek is megadhatóak (vegye figyelembe, hogy a kiszolgálónaplózási házirendhez nem adhatók meg műveletek). A naplózás támogatott műveletei a következők: SELECT UPDATE INSERT DELETE EXECUTE RECEIVE REFERENCES

A naplózandó művelet meghatározásának általános űrlapja: {action} ON {object} BY {principal}

Vegye figyelembe, hogy a fenti formátumban hivatkozhat egy objektumra, például egy táblára, nézetre vagy tárolt eljárásra, vagy egy teljes adatbázisra vagy sémára. Az utóbbi esetekben a RENDSZER a DATABASE::{db_name} és a SCHEMA::{schema_name} űrlapot használja.

Például: SELECT on dbo.myTable by public SELECT on DATABASE::myDatabase by public SELECT on SCHEMA::mySchema by public

További információ: Adatbázisszintű naplózási műveletek

properties.isAzureMonitorTargetEnabled
  • boolean

Meghatározza, hogy a rendszer elküldi-e a naplózási eseményeket az Azure Monitornak. Az események Azure Monitorba való küldéséhez adja meg az "Állapot" értéket "Engedélyezve" és az "IsAzureMonitorTargetEnabled" értéket igazként.

Ha REST API-val konfigurálja a naplózást, létre kell hoznia az adatbázis "SQLSecurityAuditEvents" diagnosztikai naplókategória-kategóriájával rendelkező diagnosztikai Gépház is. Vegye figyelembe, hogy a kiszolgálószintű naplózáshoz a "master" adatbázist {databaseName} néven kell használnia.

Diagnosztikai Gépház URI formátuma: PUThttps://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

További információ: Diagnosztikai Gépház REST API vagy diagnosztikai Gépház PowerShell

properties.isDevopsAuditEnabled
  • boolean

A devops-naplózás állapotát határozza meg. Ha az állapot engedélyezve van, a rendszer devops-naplókat küld az Azure Monitornak. Az események Azure Monitorba való küldéséhez az "Állapot" értéket adja meg "Engedélyezve", az "IsAzureMonitorTargetEnabled" értéket igazként, az "IsDevopsAuditEnabled" értéket pedig igazként.

Ha REST API-val konfigurálja a naplózást, létre kell hoznia a "DevOpsOperationsAudit" diagnosztikai naplókategória diagnosztikai Gépház a master adatbázisban.

Diagnosztikai Gépház URI formátuma: PUThttps://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

További információ: Diagnosztikai Gépház REST API vagy diagnosztikai Gépház PowerShell

properties.isStorageSecondaryKeyInUse
  • boolean

Meghatározza, hogy a storageAccountAccessKey érték a tároló másodlagos kulcsa-e.

properties.queueDelayMs
  • integer

Ezredmásodpercben adja meg az időt, amely a naplózási műveletek feldolgozásának kényszerítése előtt telik el. Az alapértelmezett minimális érték 1000 (1 másodperc). A maximális érték 2 147 483 647.

properties.retentionDays
  • integer

Megadja, hogy hány nap maradjon a tárfiók auditnaplóiban.

properties.state

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

properties.storageAccountAccessKey
  • string

Megadja a naplózási tárfiók azonosítókulcsát. Ha az állapot engedélyezve van, és a storageEndpoint meg van adva, a storageAccountAccessKey megadása nem fogja használni az SQL Server rendszer által hozzárendelt felügyelt identitását a tároló eléréséhez. A felügyelt identitás hitelesítésének használatának előfeltételei:

  1. Hozzárendelhet SQL Server egy rendszer által hozzárendelt felügyelt identitást Azure Active Directory (AAD).
  2. Adjon SQL Server identitáshoz való hozzáférést a tárfiókhoz úgy, hogy hozzáadja a "Storage blobadatok közreműködője" RBAC-szerepkört a kiszolgálói identitáshoz. További információ: Naplózás a tárolóba felügyelt identitás hitelesítésével
properties.storageAccountSubscriptionId
  • string

Megadja a Blob Storage-előfizetés azonosítóját.

properties.storageEndpoint
  • string

Megadja a blobtároló végpontját (pl. https://MyAccount.blob.core.windows.net). Ha az állapot engedélyezve van, a storageEndpoint vagy az IsAzureMonitorTargetEnabled szükséges.

type
  • string

Erőforrástípus.

ServerBlobAuditingPolicyListResult

A kiszolgálónaplózási beállítások listája.

Name Type Description
nextLink
  • string

Hivatkozás az eredmények következő oldalának lekéréséhez.

value

Eredmények tömbje.