SQL Audit Settings - Get SQL Audit Settings

Hizmet:: SQLDatabase

API Sürümü:: v1

Belirtilen SQL veritabanındaki denetim ayarlarını alır.

İzinler

Çağıranın okuyucu veya daha yüksek öğe izni olmalıdır.

Gerekli Temsilci Kapsamları

SQLDatabase.Read.All veya SQLDatabase.ReadWrite.All veya Item.Read.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Identity	Support
User	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/settings/sqlAudit

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
sqlDatabaseId	path	True	string (uuid)	SQL veritabanı kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı tanımlayıcısı.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	SqlDatabaseAuditSettings	İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı.

SqlDatabaseAuditSettings

İstek başarıyla tamamlandı.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - İstenen öğe bulunamadı.

Örnekler

Get SQL audit settings example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/settings/sqlAudit

Örnek yanıt

Durum kodu:: 200

{
  "state": "Enabled",
  "storageEndpoint": "https://onelake.blob.fabric.microsoft.com/f089354e-8366-4e18-aea3-4cb4a3a50b48/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/Audit/",
  "retentionDays": 10,
  "auditActionsAndGroups": [
    "BATCH_COMPLETED_GROUP",
    "FAILED_DATABASE_AUTHENTICATION_GROUP",
    "SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP"
  ],
  "predicateExpression": "statement not like '[select ]%'"
}

Tanımlar

Name	Description
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
SqlAuditSettingsState	Sql Denetimi ayarları durumu. Veritabanı oluşturulduktan sonra denetim ilkesini ilk kez etkinleştirirken (diğer özellikler olmadan durumu 'Etkin' olarak ayarlayarak), varsayılan değerler uygulanır. Sonraki tüm etkinleştirme/devre dışı bırakma işlemleri için önceki ilke ayarları korunur. Zaman içinde ek SqlAuditSettingsState eklenebilir.
SqlDatabaseAuditSettings	Veritabanı için denetim ayarlarının geçerli durumu.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

SqlAuditSettingsState

Numaralandırma

Sql Denetimi ayarları durumu. Veritabanı oluşturulduktan sonra denetim ilkesini ilk kez etkinleştirirken (diğer özellikler olmadan durumu 'Etkin' olarak ayarlayarak), varsayılan değerler uygulanır. Sonraki tüm etkinleştirme/devre dışı bırakma işlemleri için önceki ilke ayarları korunur. Zaman içinde ek SqlAuditSettingsState eklenebilir.

Değer	Description
Enabled	SQL denetimini etkinleştirin.
Disabled	SQL denetimini devre dışı bırakın.

SqlDatabaseAuditSettings

Nesne

Veritabanı için denetim ayarlarının geçerli durumu.

Name	Tür	Default value	Description
auditActionsAndGroups	string[]	[ "BATCH_COMPLETED_GROUP", "FAILED_DATABASE_AUTHENTICATION_GROUP", "SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP" ]	Denetim eylemleri ve grupları.
predicateExpression	string		Denetim günlüklerini filtrelemek için kullanılan koşul ifadesi.
retentionDays	integer	0	Bekletme günleri. 0 süresiz saklama süresini gösterir.
state	SqlAuditSettingsState		Denetim ayarları durum türü.
storageEndpoint	string		Denetim günlüklerinin depolandığı depolama uç noktası.