Aree di lavoro Microsoft.Synapse/sqlPools/auditingSettings

Definizione di risorsa Bicep

Il tipo di risorsa workspaces/sqlPools/auditingSettings può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces/sqlPools/auditingSettings, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01' = {
  parent: resourceSymbolicName
  name: 'default'
  properties: {
    auditActionsAndGroups: [
      'string'
    ]
    isAzureMonitorTargetEnabled: bool
    isStorageSecondaryKeyInUse: bool
    retentionDays: int
    state: 'string'
    storageAccountAccessKey: 'string'
    storageAccountSubscriptionId: 'string'
    storageEndpoint: 'string'
  }
}

Valori delle proprietà

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Nome Descrizione Valore
nome Nome della risorsa 'default' (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: aree di lavoro/sqlPools
proprietà Proprietà delle risorse. SqlPoolBlobAuditingPolicyProperties

SqlPoolBlobAuditingPolicyProperties

Nome Descrizione Valore
auditActionsAndGroups Specifica il Actions-Groups e le azioni da controllare.

Il set consigliato di gruppi di azioni da usare è la combinazione seguente: in questo modo verranno controllate tutte le query e le stored procedure eseguite sul database, nonché gli accessi riusciti e non riusciti:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Questa combinazione precedente è anche il set configurato per impostazione predefinita quando si abilita il controllo dal portale di Azure.

I gruppi di azioni supportati da controllare sono (nota: scegliere solo gruppi specifici che coprono le esigenze di controllo. L'uso di gruppi non necessari potrebbe causare grandi quantità di record di controllo:

APPLICAZIONE_RUOLO_CAMBIA_GRUPPO_PASSWORD
GRUPPO_DI_BACKUP_E_RIPRISTINO
Gruppo_Uscita_Database
Gruppo di modifiche degli oggetti del database
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
GRUPPO_OPERAZIONI_DATABASE
Gruppo di Modifica dei Permessi del Database
GRUPPO_DI_CAMBIO_DI_PRINCIPALE_DEL_DATABASE
Gruppo_di_Impersonificazione_Principale_Database
Gruppo di Cambio dei Membri del Ruolo del Database
AUTENTICAZIONE_DATABASE_FALLITA_GRUPPO
Gruppo di Accesso al Oggetto dello Schema
SCHEMA_OBJECT_CHANGE_GROUP
GRUPPO_CAMBIO_DI_PROPRIETÀ_OGGETTO_SCHEMA
GRUPPO_DI_CAMBIAMENTO_DELLA_AUTORIZZAZIONE_DELL'OGGETTO_SCHEMA
AUTENTICAZIONE_AL_DATABASE_RIUSCITA_GRUPPO
GRUPPO_CAMBIO_PASSWORD_UTENTE
BATCH_STARTED_GROUP
GRUPPO_BATCH_COMPLETATO

Si tratta di gruppi che coprono tutte le istruzioni SQL e le stored procedure eseguite sul database e non devono essere usati in combinazione con altri gruppi, in quanto ciò comporterà la duplicazione dei log di controllo.

Per altre informazioni, vedere Database-Level Controlla gruppi di azioni.

Per i criteri di controllo del database, è anche possibile specificare azioni specifiche. Si noti che non è possibile specificare azioni per i criteri di controllo del server. Le azioni supportate da controllare sono:
SELEZIONARE
AGGIORNARE
INSERIRE
CANCELLARE
ESEGUIRE
RICEVERE
REFERENZE

Il modulo generale per la definizione di un'azione da controllare è:
{azione} ON {object} BY {principal}

Si noti che <oggetto> nel formato precedente può fare riferimento a un oggetto come una tabella, una vista o una stored procedure oppure un intero database o uno schema. Per questi ultimi casi, vengono usati rispettivamente i moduli DATABASE::{db_name} e SCHEMA::{schema_name} .

Per esempio:
SELECT su dbo.myTable da parte del pubblico
SELECT su DATABASE::myDatabase da parte del pubblico
SELECT su SCHEMA::mySchema da parte del pubblico

Per altre informazioni, vedere Database-Level Azioni di controllo
string[]
isAzureMonitorTargetEnabled Specifica se gli eventi di controllo vengono inviati a Monitoraggio di Azure.
Per inviare gli eventi a Monitoraggio di Azure, specificare 'state' come 'Enabled' e 'isAzureMonitorTargetEnabled' come true.

Quando si usa l'API REST per configurare il controllo, è necessario creare anche le impostazioni di diagnostica con la categoria dei log di diagnostica "SQLSecurityAuditEvents" nel database.
Si noti che per il controllo a livello di server è consigliabile usare il database 'master' come {databaseName}.

Formato URI impostazioni di diagnostica:
METTERE https://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

Per altre informazioni, vedere 'API REST delle impostazioni di diagnostica
o Impostazioni di diagnostica di PowerShell
Bool
isStorageSecondaryKeyInUse Specifica se il valore storageAccountAccessKey è la chiave secondaria dell'archiviazione. Bool
giorni di ritenzione Specifica il numero di giorni da mantenere nei log di controllo nell'account di archiviazione. Int
stato Specifica lo stato dei criteri. Se lo stato è Abilitato, sono necessari storageEndpoint o isAzureMonitorTargetEnabled. 'Disabilitato'
'Enabled' (obbligatorio)
storageAccountAccessKey Specifica la chiave di identificatore dell'account di archiviazione di controllo. Se lo stato è Abilitato e viene specificato storageEndpoint, è necessario storageAccountAccessKey. corda
storageAccountSubscriptionId Specifica l'ID sottoscrizione dell'archiviazione BLOB. corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Specifica l'endpoint di archiviazione BLOB , ad esempio https://MyAccount.blob.core.windows.net. Se lo stato è Abilitato, storageEndpoint è obbligatorio. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa workspaces/sqlPools/auditingSettings può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces/sqlPools/auditingSettings, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Synapse/workspaces/sqlPools/auditingSettings",
  "apiVersion": "2021-06-01",
  "name": "string",
  "properties": {
    "auditActionsAndGroups": [ "string" ],
    "isAzureMonitorTargetEnabled": "bool",
    "isStorageSecondaryKeyInUse": "bool",
    "retentionDays": "int",
    "state": "string",
    "storageAccountAccessKey": "string",
    "storageAccountSubscriptionId": "string",
    "storageEndpoint": "string"
  }
}

Valori delle proprietà

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Nome Descrizione Valore
versione dell'API Versione dell'API '2021-06-01'
nome Nome della risorsa 'default' (obbligatorio)
proprietà Proprietà delle risorse. SqlPoolBlobAuditingPolicyProperties
digitare Tipo di risorsa 'Microsoft.Synapse/workspaces/sqlPools/auditingSettings'

SqlPoolBlobAuditingPolicyProperties

Nome Descrizione Valore
auditActionsAndGroups Specifica il Actions-Groups e le azioni da controllare.

Il set consigliato di gruppi di azioni da usare è la combinazione seguente: in questo modo verranno controllate tutte le query e le stored procedure eseguite sul database, nonché gli accessi riusciti e non riusciti:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Questa combinazione precedente è anche il set configurato per impostazione predefinita quando si abilita il controllo dal portale di Azure.

I gruppi di azioni supportati da controllare sono (nota: scegliere solo gruppi specifici che coprono le esigenze di controllo. L'uso di gruppi non necessari potrebbe causare grandi quantità di record di controllo:

APPLICAZIONE_RUOLO_CAMBIA_GRUPPO_PASSWORD
GRUPPO_DI_BACKUP_E_RIPRISTINO
Gruppo_Uscita_Database
Gruppo di modifiche degli oggetti del database
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
GRUPPO_OPERAZIONI_DATABASE
Gruppo di Modifica dei Permessi del Database
GRUPPO_DI_CAMBIO_DI_PRINCIPALE_DEL_DATABASE
Gruppo_di_Impersonificazione_Principale_Database
Gruppo di Cambio dei Membri del Ruolo del Database
AUTENTICAZIONE_DATABASE_FALLITA_GRUPPO
Gruppo di Accesso al Oggetto dello Schema
SCHEMA_OBJECT_CHANGE_GROUP
GRUPPO_CAMBIO_DI_PROPRIETÀ_OGGETTO_SCHEMA
GRUPPO_DI_CAMBIAMENTO_DELLA_AUTORIZZAZIONE_DELL'OGGETTO_SCHEMA
AUTENTICAZIONE_AL_DATABASE_RIUSCITA_GRUPPO
GRUPPO_CAMBIO_PASSWORD_UTENTE
BATCH_STARTED_GROUP
GRUPPO_BATCH_COMPLETATO

Si tratta di gruppi che coprono tutte le istruzioni SQL e le stored procedure eseguite sul database e non devono essere usati in combinazione con altri gruppi, in quanto ciò comporterà la duplicazione dei log di controllo.

Per altre informazioni, vedere Database-Level Controlla gruppi di azioni.

Per i criteri di controllo del database, è anche possibile specificare azioni specifiche. Si noti che non è possibile specificare azioni per i criteri di controllo del server. Le azioni supportate da controllare sono:
SELEZIONARE
AGGIORNARE
INSERIRE
CANCELLARE
ESEGUIRE
RICEVERE
REFERENZE

Il modulo generale per la definizione di un'azione da controllare è:
{azione} ON {object} BY {principal}

Si noti che <oggetto> nel formato precedente può fare riferimento a un oggetto come una tabella, una vista o una stored procedure oppure un intero database o uno schema. Per questi ultimi casi, vengono usati rispettivamente i moduli DATABASE::{db_name} e SCHEMA::{schema_name} .

Per esempio:
SELECT su dbo.myTable da parte del pubblico
SELECT su DATABASE::myDatabase da parte del pubblico
SELECT su SCHEMA::mySchema da parte del pubblico

Per altre informazioni, vedere Database-Level Azioni di controllo
string[]
isAzureMonitorTargetEnabled Specifica se gli eventi di controllo vengono inviati a Monitoraggio di Azure.
Per inviare gli eventi a Monitoraggio di Azure, specificare 'state' come 'Enabled' e 'isAzureMonitorTargetEnabled' come true.

Quando si usa l'API REST per configurare il controllo, è necessario creare anche le impostazioni di diagnostica con la categoria dei log di diagnostica "SQLSecurityAuditEvents" nel database.
Si noti che per il controllo a livello di server è consigliabile usare il database 'master' come {databaseName}.

Formato URI impostazioni di diagnostica:
METTERE https://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

Per altre informazioni, vedere 'API REST delle impostazioni di diagnostica
o Impostazioni di diagnostica di PowerShell
Bool
isStorageSecondaryKeyInUse Specifica se il valore storageAccountAccessKey è la chiave secondaria dell'archiviazione. Bool
giorni di ritenzione Specifica il numero di giorni da mantenere nei log di controllo nell'account di archiviazione. Int
stato Specifica lo stato dei criteri. Se lo stato è Abilitato, sono necessari storageEndpoint o isAzureMonitorTargetEnabled. 'Disabilitato'
'Enabled' (obbligatorio)
storageAccountAccessKey Specifica la chiave di identificatore dell'account di archiviazione di controllo. Se lo stato è Abilitato e viene specificato storageEndpoint, è necessario storageAccountAccessKey. corda
storageAccountSubscriptionId Specifica l'ID sottoscrizione dell'archiviazione BLOB. corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Specifica l'endpoint di archiviazione BLOB , ad esempio https://MyAccount.blob.core.windows.net. Se lo stato è Abilitato, storageEndpoint è obbligatorio. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa workspaces/sqlPools/auditingSettings può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces/sqlPools/auditingSettings, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      auditActionsAndGroups = [
        "string"
      ]
      isAzureMonitorTargetEnabled = bool
      isStorageSecondaryKeyInUse = bool
      retentionDays = int
      state = "string"
      storageAccountAccessKey = "string"
      storageAccountSubscriptionId = "string"
      storageEndpoint = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Nome Descrizione Valore
nome Nome della risorsa 'default' (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: aree di lavoro /sqlPools
proprietà Proprietà delle risorse. SqlPoolBlobAuditingPolicyProperties
digitare Tipo di risorsa "Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01"

SqlPoolBlobAuditingPolicyProperties

Nome Descrizione Valore
auditActionsAndGroups Specifica il Actions-Groups e le azioni da controllare.

Il set consigliato di gruppi di azioni da usare è la combinazione seguente: in questo modo verranno controllate tutte le query e le stored procedure eseguite sul database, nonché gli accessi riusciti e non riusciti:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Questa combinazione precedente è anche il set configurato per impostazione predefinita quando si abilita il controllo dal portale di Azure.

I gruppi di azioni supportati da controllare sono (nota: scegliere solo gruppi specifici che coprono le esigenze di controllo. L'uso di gruppi non necessari potrebbe causare grandi quantità di record di controllo:

APPLICAZIONE_RUOLO_CAMBIA_GRUPPO_PASSWORD
GRUPPO_DI_BACKUP_E_RIPRISTINO
Gruppo_Uscita_Database
Gruppo di modifiche degli oggetti del database
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
GRUPPO_OPERAZIONI_DATABASE
Gruppo di Modifica dei Permessi del Database
GRUPPO_DI_CAMBIO_DI_PRINCIPALE_DEL_DATABASE
Gruppo_di_Impersonificazione_Principale_Database
Gruppo di Cambio dei Membri del Ruolo del Database
AUTENTICAZIONE_DATABASE_FALLITA_GRUPPO
Gruppo di Accesso al Oggetto dello Schema
SCHEMA_OBJECT_CHANGE_GROUP
GRUPPO_CAMBIO_DI_PROPRIETÀ_OGGETTO_SCHEMA
GRUPPO_DI_CAMBIAMENTO_DELLA_AUTORIZZAZIONE_DELL'OGGETTO_SCHEMA
AUTENTICAZIONE_AL_DATABASE_RIUSCITA_GRUPPO
GRUPPO_CAMBIO_PASSWORD_UTENTE
BATCH_STARTED_GROUP
GRUPPO_BATCH_COMPLETATO

Si tratta di gruppi che coprono tutte le istruzioni SQL e le stored procedure eseguite sul database e non devono essere usati in combinazione con altri gruppi, in quanto ciò comporterà la duplicazione dei log di controllo.

Per altre informazioni, vedere Database-Level Controlla gruppi di azioni.

Per i criteri di controllo del database, è anche possibile specificare azioni specifiche. Si noti che non è possibile specificare azioni per i criteri di controllo del server. Le azioni supportate da controllare sono:
SELEZIONARE
AGGIORNARE
INSERIRE
CANCELLARE
ESEGUIRE
RICEVERE
REFERENZE

Il modulo generale per la definizione di un'azione da controllare è:
{azione} ON {object} BY {principal}

Si noti che <oggetto> nel formato precedente può fare riferimento a un oggetto come una tabella, una vista o una stored procedure oppure un intero database o uno schema. Per questi ultimi casi, vengono usati rispettivamente i moduli DATABASE::{db_name} e SCHEMA::{schema_name} .

Per esempio:
SELECT su dbo.myTable da parte del pubblico
SELECT su DATABASE::myDatabase da parte del pubblico
SELECT su SCHEMA::mySchema da parte del pubblico

Per altre informazioni, vedere Database-Level Azioni di controllo
string[]
isAzureMonitorTargetEnabled Specifica se gli eventi di controllo vengono inviati a Monitoraggio di Azure.
Per inviare gli eventi a Monitoraggio di Azure, specificare 'state' come 'Enabled' e 'isAzureMonitorTargetEnabled' come true.

Quando si usa l'API REST per configurare il controllo, è necessario creare anche le impostazioni di diagnostica con la categoria dei log di diagnostica "SQLSecurityAuditEvents" nel database.
Si noti che per il controllo a livello di server è consigliabile usare il database 'master' come {databaseName}.

Formato URI impostazioni di diagnostica:
METTERE https://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

Per altre informazioni, vedere 'API REST delle impostazioni di diagnostica
o Impostazioni di diagnostica di PowerShell
Bool
isStorageSecondaryKeyInUse Specifica se il valore storageAccountAccessKey è la chiave secondaria dell'archiviazione. Bool
giorni di ritenzione Specifica il numero di giorni da mantenere nei log di controllo nell'account di archiviazione. Int
stato Specifica lo stato dei criteri. Se lo stato è Abilitato, sono necessari storageEndpoint o isAzureMonitorTargetEnabled. 'Disabilitato'
'Enabled' (obbligatorio)
storageAccountAccessKey Specifica la chiave di identificatore dell'account di archiviazione di controllo. Se lo stato è Abilitato e viene specificato storageEndpoint, è necessario storageAccountAccessKey. corda
storageAccountSubscriptionId Specifica l'ID sottoscrizione dell'archiviazione BLOB. corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Specifica l'endpoint di archiviazione BLOB , ad esempio https://MyAccount.blob.core.windows.net. Se lo stato è Abilitato, storageEndpoint è obbligatorio. corda