SQL Audit Settings - Update SQL Audit Settings

Υπηρεσία:: SQLDatabase

Έκδοση API:: v1

Ενημερώνει τις ρυθμίσεις ελέγχου στην καθορισμένη βάση δεδομένων SQL.

Δικαιώματα Πρόσβασης

Το πρόγραμμα κλήσης πρέπει να έχει δικαιώματα ανάγνωσης και εγγραφής για τη βάση δεδομένων SQL.

Απαιτούμενες εμβέλειες με ανάθεση

SQLDatabase.ReadWrite.All ή Item.ReadWrite.All

υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστήριξη
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Ναι

Διεπαφή

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
sqlDatabaseId	path	True	string (uuid)	Το αναγνωριστικό βάσης δεδομένων SQL.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

Κυρίως τμήμα αίτησης

Όνομα	Τύπος	Περιγραφή
auditActionsAndGroups	string[]	Ενέργειες και ομάδες ελέγχου. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και αυτή η ιδιότητα δεν παρέχεται, θα εφαρμοστούν προεπιλεγμένες ενέργειες και ομάδες ελέγχου.
predicateExpression	string	Η παράσταση κατηγορήματος που χρησιμοποιείται για το φιλτράρισμα των αρχείων καταγραφής ελέγχου. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και δεν παρέχεται αυτή η ιδιότητα, δεν θα εφαρμοστεί καμία παράσταση κατηγόρημα από προεπιλογή.
retentionDays	integer	Ημέρες διατήρησης. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και δεν παρέχεται αυτή η ιδιότητα, η ιδιότητα retentionDays θα οριστεί σε 0 (περίοδος διατήρησης επ' αόριστον) από προεπιλογή.
state	SqlAuditSettingsState	Τύπος κατάστασης ρυθμίσεων ελέγχου.

Αποκρίσεις

Όνομα Τύπος Περιγραφή

200 OK

Όνομα	Τύπος	Περιγραφή
200 OK	SqlDatabaseAuditSettings	Η αίτηση ολοκληρώθηκε με επιτυχία.
429 Too Many Requests	ErrorResponse	Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια `Retry-After` κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων. Κεφαλίδες Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.

SqlDatabaseAuditSettings

Η αίτηση ολοκληρώθηκε με επιτυχία.

429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.

Παραδείγματα

Update SQL audit settings example

Δείγμα αίτησης

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 ]%'"
}

Δείγμα απόκρισης

Κωδικός κατάστασης:: 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 ]%'"
}

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
SqlAuditSettingsState	Κατάσταση ρυθμίσεων sql Audit. Όταν ενεργοποιείτε την πολιτική ελέγχου για πρώτη φορά μετά τη δημιουργία της βάσης δεδομένων (ρυθμίζοντας την κατάσταση σε "Ενεργοποιημένο" χωρίς άλλες ιδιότητες), εφαρμόζονται προεπιλεγμένες τιμές. Για όλες τις επόμενες λειτουργίες ενεργοποίησης/απενεργοποίησης, διατηρούνται οι προηγούμενες ρυθμίσεις πολιτικής. Επιπλέον sqlAuditSettingsState μπορεί να προστεθεί με την πάροδο του χρόνου.
SqlDatabaseAuditSettings	Η τρέχουσα κατάσταση των ρυθμίσεων ελέγχου για μια βάση δεδομένων.
SqlDatabaseAuditSettingsUpdate	Αίτηση ενημέρωσης ρυθμίσεων ελέγχου βάσης δεδομένων.

ErrorRelatedResource

Αντικείμενο

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

Η απόκριση σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
isRetriable	boolean	Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την `Retry-After` κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string (uuid)	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

SqlAuditSettingsState

Απαρίθμηση

Κατάσταση ρυθμίσεων sql Audit. Όταν ενεργοποιείτε την πολιτική ελέγχου για πρώτη φορά μετά τη δημιουργία της βάσης δεδομένων (ρυθμίζοντας την κατάσταση σε "Ενεργοποιημένο" χωρίς άλλες ιδιότητες), εφαρμόζονται προεπιλεγμένες τιμές. Για όλες τις επόμενες λειτουργίες ενεργοποίησης/απενεργοποίησης, διατηρούνται οι προηγούμενες ρυθμίσεις πολιτικής. Επιπλέον sqlAuditSettingsState μπορεί να προστεθεί με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Enabled	Ενεργοποιήστε τον έλεγχο SQL.
Disabled	Απενεργοποιήστε τον έλεγχο SQL.

SqlDatabaseAuditSettings

Αντικείμενο

Η τρέχουσα κατάσταση των ρυθμίσεων ελέγχου για μια βάση δεδομένων.

Όνομα	Τύπος	Default value	Περιγραφή
auditActionsAndGroups	string[]	[ "BATCH_COMPLETED_GROUP", "FAILED_DATABASE_AUTHENTICATION_GROUP", "SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP" ]	Ενέργειες και ομάδες ελέγχου.
predicateExpression	string		Η παράσταση κατηγορήματος που χρησιμοποιείται για το φιλτράρισμα των αρχείων καταγραφής ελέγχου.
retentionDays	integer	0	Ημέρες διατήρησης. Το 0 υποδεικνύει περίοδο διατήρησης επ' αόριστον.
state	SqlAuditSettingsState		Τύπος κατάστασης ρυθμίσεων ελέγχου.
storageEndpoint	string		Το τελικό σημείο χώρου αποθήκευσης όπου αποθηκεύονται τα αρχεία καταγραφής ελέγχου.

SqlDatabaseAuditSettingsUpdate

Αντικείμενο

Αίτηση ενημέρωσης ρυθμίσεων ελέγχου βάσης δεδομένων.

Όνομα	Τύπος	Περιγραφή
auditActionsAndGroups	string[]	Ενέργειες και ομάδες ελέγχου. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και αυτή η ιδιότητα δεν παρέχεται, θα εφαρμοστούν προεπιλεγμένες ενέργειες και ομάδες ελέγχου.
predicateExpression	string	Η παράσταση κατηγορήματος που χρησιμοποιείται για το φιλτράρισμα των αρχείων καταγραφής ελέγχου. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και δεν παρέχεται αυτή η ιδιότητα, δεν θα εφαρμοστεί καμία παράσταση κατηγόρημα από προεπιλογή.
retentionDays	integer	Ημέρες διατήρησης. Για πρώτη φορά, όταν η κατάσταση οριστεί σε Ενεργοποιημένη και δεν παρέχεται αυτή η ιδιότητα, η ιδιότητα retentionDays θα οριστεί σε 0 (περίοδος διατήρησης επ' αόριστον) από προεπιλογή.
state	SqlAuditSettingsState	Τύπος κατάστασης ρυθμίσεων ελέγχου.