Database Security Alert Policies - Create Or Update
Crea o aggiorna i criteri di avviso di sicurezza di un database.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/securityAlertPolicies/Default?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nome del database. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
security
|
path | True |
Nome dei criteri di avviso di sicurezza. |
|
|
server
|
path | True |
string |
Il nome del server. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| properties.state | True |
Specifica lo stato del criterio, se è abilitato o disabilitato o se un criterio non è ancora stato applicato nel database specifico. |
|
| properties.disabledAlerts |
string[] |
Specifica una matrice di avvisi disabilitati. I valori consentiti sono: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force |
|
| properties.emailAccountAdmins |
boolean |
Specifica che l'avviso viene inviato agli amministratori dell'account. |
|
| properties.emailAddresses |
string[] |
Specifica una matrice di indirizzi di posta elettronica a cui viene inviato l'avviso. |
|
| properties.retentionDays |
integer (int32) |
Specifica il numero di giorni da mantenere nei log di controllo di rilevamento delle minacce. |
|
| properties.storageAccountAccessKey |
string |
Specifica la chiave di identificatore dell'account di archiviazione di controllo rilevamento minacce. |
|
| properties.storageEndpoint |
string |
Specifica l'endpoint di archiviazione BLOB , ad esempio |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Risorsa 'DatabaseSecurityAlertPolicy' con successo |
|
| 201 Created |
Risorsa 'DatabaseSecurityAlertPolicy' crea operazione con successo |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
| Update a database's threat detection policy with all parameters |
| Update a database's threat detection policy with minimal parameters |
Update a database's threat detection policy with all parameters
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb/securityAlertPolicies/Default?api-version=2025-01-01
{
"properties": {
"disabledAlerts": [
"Sql_Injection",
"Usage_Anomaly"
],
"emailAccountAdmins": true,
"emailAddresses": [
"test@microsoft.com",
"user@microsoft.com"
],
"retentionDays": 6,
"state": "Enabled",
"storageAccountAccessKey": "sdlfkjabc+sdlfkjsdlkfsjdfLDKFTERLKFDFKLjsdfksjdflsdkfD2342309432849328476458/3RSD==",
"storageEndpoint": "https://mystorage.blob.core.windows.net"
}
}
Risposta di esempio
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
"properties": {
"disabledAlerts": [
"Sql_Injection",
"Usage_Anomaly"
],
"emailAccountAdmins": true,
"emailAddresses": [
"test@microsoft.com",
"user@microsoft.com"
],
"retentionDays": 6,
"state": "Enabled",
"storageAccountAccessKey": "",
"storageEndpoint": "https://mystorage.blob.core.windows.net"
},
"systemData": {
"createdAt": "2020-04-03T04:41:33.937Z",
"createdBy": "string",
"createdByType": "User",
"lastModifiedAt": "2020-04-03T04:41:33.937Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User"
}
}
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
"properties": {
"disabledAlerts": [
"Access_Anomaly",
"Usage_Anomaly"
],
"emailAccountAdmins": true,
"emailAddresses": [
"test@microsoft.com",
"user@microsoft.com"
],
"retentionDays": 6,
"state": "Enabled",
"storageAccountAccessKey": "sdlfkjabc+sdlfkjsdlkfsjdfLDKFTERLKFDFKLjsdfksjdflsdkfD2342309432849328476458/3RSD==",
"storageEndpoint": "https://mystorage.blob.core.windows.net"
},
"systemData": {
"createdAt": "2020-04-03T04:41:33.937Z",
"createdBy": "string",
"createdByType": "User",
"lastModifiedAt": "2020-04-03T04:41:33.937Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User"
}
}
Update a database's threat detection policy with minimal parameters
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb/securityAlertPolicies/Default?api-version=2025-01-01
{
"properties": {
"state": "Enabled"
}
}
Risposta di esempio
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
"properties": {
"disabledAlerts": [],
"emailAccountAdmins": true,
"emailAddresses": [],
"retentionDays": 0,
"state": "Enabled",
"storageAccountAccessKey": "",
"storageEndpoint": ""
},
"systemData": {
"createdAt": "2020-04-03T04:41:33.937Z",
"createdBy": "string",
"createdByType": "User",
"lastModifiedAt": "2020-04-03T04:41:33.937Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User"
}
}
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/databases/testdb",
"properties": {
"disabledAlerts": [],
"emailAccountAdmins": true,
"emailAddresses": [],
"retentionDays": 0,
"state": "Enabled",
"storageAccountAccessKey": "",
"storageEndpoint": ""
},
"systemData": {
"createdAt": "2020-04-03T04:41:33.937Z",
"createdBy": "string",
"createdByType": "User",
"lastModifiedAt": "2020-04-03T04:41:33.937Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
created |
Tipo di identità che ha creato la risorsa. |
|
Database |
Criteri di avviso di sicurezza del database. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Security |
Nome dei criteri di avviso di sicurezza. |
|
Security |
Specifica lo stato del criterio, se è abilitato o disabilitato o se un criterio non è ancora stato applicato nel database specifico. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseSecurityAlertPolicy
Criteri di avviso di sicurezza del database.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.creationTime |
string (date-time) |
Specifica l'ora di creazione UTC del criterio. |
| properties.disabledAlerts |
string[] |
Specifica una matrice di avvisi disabilitati. I valori consentiti sono: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force |
| properties.emailAccountAdmins |
boolean |
Specifica che l'avviso viene inviato agli amministratori dell'account. |
| properties.emailAddresses |
string[] |
Specifica una matrice di indirizzi di posta elettronica a cui viene inviato l'avviso. |
| properties.retentionDays |
integer (int32) |
Specifica il numero di giorni da mantenere nei log di controllo di rilevamento delle minacce. |
| properties.state |
Specifica lo stato del criterio, se è abilitato o disabilitato o se un criterio non è ancora stato applicato nel database specifico. |
|
| properties.storageAccountAccessKey |
string |
Specifica la chiave di identificatore dell'account di archiviazione di controllo rilevamento minacce. |
| properties.storageEndpoint |
string |
Specifica l'endpoint di archiviazione BLOB , ad esempio |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
SecurityAlertPolicyName
Nome dei criteri di avviso di sicurezza.
| Valore | Descrizione |
|---|---|
| Default |
Valore predefinito |
SecurityAlertsPolicyState
Specifica lo stato del criterio, se è abilitato o disabilitato o se un criterio non è ancora stato applicato nel database specifico.
| Valore | Descrizione |
|---|---|
| Enabled |
Enabled |
| Disabled |
Disattivato |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Il timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |