SQL Audit Settings - Update SQL Audit Settings

Hizmet:: SQLDatabase

API Sürümü:: v1

Belirtilen SQL veritabanındaki denetim ayarlarını güncelleştirir.

İzinler

Çağıranın SQL veritabanı için okuma ve yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

SQLDatabase.ReadWrite.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

PATCH 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ı.

İstek Gövdesi

Name	Tür	Description
auditActionsAndGroups	string[]	Denetim eylemleri ve grupları. İlk kez, durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında, varsayılan denetim eylemleri ve grupları uygulanır.
predicateExpression	string	Denetim günlüklerini filtrelemek için kullanılan koşul ifadesi. İlk kez, durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında, varsayılan olarak hiçbir koşul ifadesi uygulanmaz.
retentionDays	integer	Bekletme günleri. İlk kez durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında retentionDays varsayılan olarak 0 (süresiz bekletme süresi) olarak ayarlanır.
state	SqlAuditSettingsState	Denetim ayarları durum türü.

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

Update SQL audit settings example

Örnek isteği

HTTP

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

{
  "state": "Enabled",
  "retentionDays": 10,
  "predicateExpression": "statement not like '[select ]%'"
}

Ö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.
SqlDatabaseAuditSettingsUpdate	Veritabanı denetim ayarları güncelleştirme isteği.

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ı.

SqlDatabaseAuditSettingsUpdate

Nesne

Veritabanı denetim ayarları güncelleştirme isteği.

Name	Tür	Description
auditActionsAndGroups	string[]	Denetim eylemleri ve grupları. İlk kez, durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında, varsayılan denetim eylemleri ve grupları uygulanır.
predicateExpression	string	Denetim günlüklerini filtrelemek için kullanılan koşul ifadesi. İlk kez, durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında, varsayılan olarak hiçbir koşul ifadesi uygulanmaz.
retentionDays	integer	Bekletme günleri. İlk kez durum Etkin olarak ayarlandığında ve bu özellik sağlanmadığında retentionDays varsayılan olarak 0 (süresiz bekletme süresi) olarak ayarlanır.
state	SqlAuditSettingsState	Denetim ayarları durum türü.